여러 저장소를 운영하다 보면 가장 번거로운 순간이 같은 설정 파일을 손으로 복사하는 일입니다. 서버를 다시 만들거나 담당자를 추가할 때마다 값을 붙여 넣다가, 어느 저장소가 최신본인지 모르게 되기도 합니다. private 저장소라면 변경 이력과 PR 리뷰까지 활용할 수 있으니, 환경변수 분리만 제대로 된다면 설정 관리에는 오히려 유리한 선택지가 됩니다.
‘.env는 커밋 금지’가 아니라 값별로 판단해야 한다
원문의 프로젝트는 Docker 저장소, backend 저장소, indexer 저장소로 나뉘며 각 저장소가 자체.env 파일을 보유합니다. 파일 내용에는 DB 비밀번호와 API 키, 토큰 같은 비밀정보뿐 아니라 고정 서버의 private IP, VPS 크기와 부하에 따라 조정하는 backend 튜닝 파라미터도 들어갑니다.
여기서 ‘비밀번호를 Git에 넣지 않는다’와 ‘비밀이 없는 설정 파일을 private 저장소에서도 관리하지 않는다’는 서로 다른 결정입니다. 비밀정보는 저장소 밖에서 주입하고, 비밀이 없는 설정만 Git으로 관리할 수 있습니다..env는 설정을 전달하는 형식일 뿐이며 보안 경계가 아닙니다. 위험 여부는 파일명이 아니라 포함된 값과 접근 방식에서 결정됩니다.
private 저장소 역시 완전한 격리 공간은 아닙니다. 저장소 권한이 넓거나 계정 관리가 실패하면 내부 주소와 운영 구조가 함께 노출될 수 있습니다. 특히 private IP는 자격 증명 자체는 아니더라도 내부 토폴로지를 드러내므로, 외부 공개가 허용되는 팀과 개인의 접근 범위를 먼저 정해야 합니다. 튜닝 파라미터도 다른 인증 수단과 결합해 권한을 넓히지 않는지 확인한 뒤 분류합니다.
세 가지 등급으로 값을 분리한다
비밀정보에는 DB 비밀번호, API 키, 토큰처럼 유출 시 계정 탈취나 데이터 접근으로 이어지는 값을 배치합니다. 이들은 Git에 저장하지 않고 배포 시 환경변수나 파일로 주입합니다. private IP처럼 내부 구조를 드러내지만 단독 사용으로 권한이 생기지 않는 값은 민감 설정으로 분리해 접근 가능한 구성원을 제한합니다. 공개 정보에 가깝고 노출 피해가 제한적인 튜닝 파라미터는 일반 설정으로 분류해 Git 변경 이력과 PR 리뷰를 활용할 수 있습니다.
판단 기준은 값마다 다음 질문을 기록하는 것입니다. 누가 읽는가, 노출되면 어떤 피해가 발생하는가, 어느 실행 주체가 값을 읽는가. 이 세 가지 중 하나라도 모호하다면 일반 설정으로 확정하지 말고 먼저 소유 팀과 접근 범위를 합의합니다. 비밀값과 결합할 때 의미가 커지는 주소나 계정 정보도 비밀정보와 같은 취급이 필요합니다.
여러 저장소의 설정은 중앙값과 차이로 나눈다
공통 설정이 각 저장소에 복제되면 수정 시 일부 파일만 바뀌고 값이 어긋납니다. 공유 설정은 별도 설정 저장소나 배포 산출물로 모으고, 각 저장소에는 필요한 키만 표시하는.env.example을 둡니다. 환경별 차이는 override 파일로 분리하면 됩니다.
예를 들어 공통 저장소에는 일반 설정과 환경별 override를 versioning하고, Docker 저장소는 배포에 필요한 compose 파일, backend 저장소는 애플리케이션 설정 템플릿, indexer 저장소는 수집기 설정 템플릿을 각각 소유하게 할 수 있습니다. 실제 비밀값은 공통 저장소에도 넣지 않고 각 배포 환경에서 주입합니다.
git grep -nE '(PASSWORD|SECRET|TOKEN|API_KEY)' -- ':!*.example'
git ls-files --.env
git log --all --oneline --.env
위 명령은 저장소에 남아 있을 수 있는 비밀 키와.env 추적 상태, 과거 변경을 점검하는 기본 흐름입니다. 탐지 결과는 자동으로 제거된 것이 아니므로 현재 파일과 과거 이력을 함께 확인해야 합니다. Git은 한 번 커밋된 내용을 이력에 남기므로 비밀정보를 삭제한 커밋만으로는 노출 이력을 없앨 수 없습니다. 노출이 의심되면 먼저 해당 자격 증명을 회전하고 접근 로그를 확인한 뒤 이력 정리 절차를 진행합니다.
비밀 주입은 배포 경계에서 끝낸다
환경변수 분리는 비밀정보 저장소를 따로 만드는 데서 그치지 말고, 접근 주체를 최소화하고 배포 시 필요한 서비스에만 값을 전달하는 데서 끝나야 합니다. 암호화한 값을 Git에 보관하더라도 복호화 키는 저장소 밖에 두어야 합니다. 이 방식도 키 관리가 무너지면 보호가 함께 사라지므로, 키의 보관 위치와 읽을 수 있는 주체, 회전 주기와 담당자를 운영 절차에 남깁니다.
반대로 모든 값을 비밀 주입 체계로 옮기면 설정 변경마다 배포 파이프라인과 권한 관리가 복잡해집니다. 분류표를 먼저 만들고 일반 설정은 PR로 검토하며, 비밀정보만 별도 경로로 주입하는 방식이 유지보수 부담을 줄입니다. 원문의 구성은 설정 전용.env 커밋 논의에서 확인할 수 있습니다.
실무에서는 현재.env 값을 비밀정보, 민감 설정, 일반 설정으로 나누고 각 값의 노출 피해와 참조 주체를 기록하는 점검부터 시작할 수 있습니다. 이후 git grep과 Git 이력에서 비밀정보의 노출 여부를 확인하고,.env.example와 환경별 override로 설정 구조를 정리합니다. private 저장소 권한은 필요한 구성원으로 제한하고 변경 절차를 PR 리뷰에 포함합니다. 과거 이력에서 비밀정보가 발견되면 값을 삭제하기 전에 자격 증명을 회전하고 접근 로그를 확인해야 합니다.
참고 원문
이 기사는 다음 원문을 확인해 작성했습니다: r/devops — Is committing config-only.env files (no secrets) to a private repo really a security sin?

답글 남기기