fix(gitignore): 하위 폴더의 실제 .env 파일도 git이 무시한다 #85

Merged
donghyeon.kang merged 3 commits from fix/gitignore-nested-env into main 2026-11-21 18:45:46 +00:00
Owner

무엇을, 왜

.gitignore의 /.env*는 저장소 루트의 .env만 무시한다. 재배치 커밋 1388c06a가 src/.env*와 예시 예외 둘을 지우고 루트 줄로 바꿨다. 그래서 src/.env, src/.env.local, 아무 하위 폴더의 .env.lane 같은 실제 환경 파일이 무시되지 않는다. git add -A 한 번이면 이 파일이 Gitea 이력에 들어간다. scripts/verify.sh는 미추적 파일로 rc=5를 내지만 사람의 커밋은 막지 못한다. 파생 서비스도 같은 .gitignore를 물려받는다.

이 PR은 env 줄을 **/.env*로 바꿔 어느 폴더든 실제 env 파일을 무시하고, 추적 중인 예시 둘만 !**/.env.example, !**/.env.local.example로 되살린다. 따로 있던 /.env.lane 줄은 이 줄에 들어가서 지웠다.

고른 방법과 버린 대안

  • 고른 안 **/.env* + 예시 예외 둘: C2·C3를 통과하고, .env.prod·.env.staging 같은 프로필 파일까지 막는다.
  • 버린 안 이름 나열(**/.env, **/.env.local, **/.env.lane): C2 경로는 모두 막고 C3도 같다. 다만 deep/a/b/.env.staging·sub-x/.env.prod가 rc=1(무시 안 됨)이다. 루트에서도 지금 /.env*가 막던 .env.<프로필>이 다시 열린다.
  • 버린 안 src/.env*만 되살리기: 재배치 뒤 다른 하위 폴더(compose-lanes 등)에 생기는 파일을 또 놓친다.
  • 버린 안 !**/.env*.example(예시를 넓게 되살리기): 지금 추적하는 예시는 둘뿐이다. 넓히면 .env.<무엇>.example 이름의 실제 파일도 열린다.
  • 버린 안 **/.env + **/.env.*로 좁히기(리뷰 Low): .envrc·.env-local·.env_prod가 다시 열린다. .envrc(direnv)는 보통 비밀 값을 export한다. 넓은 쪽이 틀리면 정상 파일을 git add가 거절하는 것으로 끝나고, ! 줄 하나로 푼다. 좁은 쪽이 틀리면 비밀 값이 이력에 남는다.

위험과 영향

  • 새 예시 파일(예: .env.lane.example)을 더하면 ! 줄 없이는 git이 무시한다. 막히는 쪽으로 실패하고, git add가 무시된 파일이라고 알린다. 주석에 적었다.
  • .gitignore는 이미 추적 중인 파일을 빼지 않는다. 이 repo에는 해당 파일이 없다(git ls-files -ci --exclude-standard 전후 빈 결과). 파생 서비스에 이미 추적 중인 하위 .env가 있으면 git rm --cached가 따로 필요하다.
  • .gitignore는 Gradle 입력이다(build-logic VerifyNoIgnoredSourcePackagesTask가 소스 경로마다 git check-ignore를 돈다). 그래서 desktop scripts/verify.sh pr을 돌렸다.
  • 스테이지된 .env 꼴 파일을 막는 pre-commit이나 CI 검사는 없다. 이 PR은 만들지 않는다(넘길 것).

검증

실제 .env는 열지 않았다. 깨끗한 detached worktree에서 없는 경로에 git check-ignore -q --no-index <경로>를 돌려 rc를 봤다(0 = 무시). -v는 ! 줄 일치도 rc=0으로 내서, rc는 -q로 따로 쟀다.

  • C1 RED: 고치기 전 b2bfb9bb(트리 3d387113d0)와 base 484264cb(트리 d9ec7ffb0d), 둘 다 .gitignore blob ae53be55. git check-ignore -q --no-index src/.env → rc=1.
  • C1 GREEN: 고친 커밋 8def6e05(트리 d7bbeade75). 같은 명령 → rc=0, -v는 .gitignore:36:**/.env*.
  • C2 무시됨(rc=0): .env, .env.local, .env.lane, src/.env, src/.env.local, src/.env.lane, sub-x/.env, sub-x/.env.local, sub-x/.env.lane, build-x/.env.lane, src/bootstrap/app/compose-lanes/.env, deep/a/b/.env.staging, sub-x/.env.prod. 고치기 전에는 루트 셋만 rc=0이고 나머지 10개는 rc=1.
  • C2 무시 안 됨(rc=1): .env.example, .env.local.example, src/.env.example, src/.env.local.example, sub-x/.env.example, sub-x/.env.local.example.
  • C3: git ls-files '*.env*' 전후 모두 .env.example, .env.local.example. git ls-files -ci --exclude-standard 전후 빈 결과.
  • 노트북 scripts/verify.sh docs rc=0(Ran 275, OK).
  • desktop scripts/verify.sh pr --log fix-gitignore-nested-env(기준 484264cb, 보낸 트리 d7bbeade = HEAD 트리): rc=0. :verifyNoIgnoredSourcePackages는 OK — 4482 Java sources are all committable.
  • 리뷰: 종류 A, reviewer 1회(sonnet, 렌즈 be-security). Critical 0 / High 0 / Medium 0 / Low 2. 둘 다 그대로 둔다. Low 1(좁히기)은 위 버린 안에 이유를 적었다. Low 2(예시 이름 고정)는 리뷰어도 그대로 두라고 했다.

리뷰어가 볼 곳

  • .gitignore 31~38행 하나다.

관련

  • Refs: REV-BE-0048
  • Fixes: 1388c06a9f ("refactor(layout)!: Gradle 루트와 계층 폴더를 옮긴다(옮기기만)")
## 무엇을, 왜 `.gitignore`의 `/.env*`는 저장소 루트의 `.env`만 무시한다. 재배치 커밋 1388c06a가 `src/.env*`와 예시 예외 둘을 지우고 루트 줄로 바꿨다. 그래서 `src/.env`, `src/.env.local`, 아무 하위 폴더의 `.env.lane` 같은 실제 환경 파일이 무시되지 않는다. `git add -A` 한 번이면 이 파일이 Gitea 이력에 들어간다. `scripts/verify.sh`는 미추적 파일로 rc=5를 내지만 사람의 커밋은 막지 못한다. 파생 서비스도 같은 `.gitignore`를 물려받는다. 이 PR은 env 줄을 `**/.env*`로 바꿔 어느 폴더든 실제 env 파일을 무시하고, 추적 중인 예시 둘만 `!**/.env.example`, `!**/.env.local.example`로 되살린다. 따로 있던 `/.env.lane` 줄은 이 줄에 들어가서 지웠다. ## 고른 방법과 버린 대안 - 고른 안 `**/.env*` + 예시 예외 둘: C2·C3를 통과하고, `.env.prod`·`.env.staging` 같은 프로필 파일까지 막는다. - 버린 안 이름 나열(`**/.env`, `**/.env.local`, `**/.env.lane`): C2 경로는 모두 막고 C3도 같다. 다만 `deep/a/b/.env.staging`·`sub-x/.env.prod`가 rc=1(무시 안 됨)이다. 루트에서도 지금 `/.env*`가 막던 `.env.<프로필>`이 다시 열린다. - 버린 안 `src/.env*`만 되살리기: 재배치 뒤 다른 하위 폴더(compose-lanes 등)에 생기는 파일을 또 놓친다. - 버린 안 `!**/.env*.example`(예시를 넓게 되살리기): 지금 추적하는 예시는 둘뿐이다. 넓히면 `.env.<무엇>.example` 이름의 실제 파일도 열린다. - 버린 안 `**/.env` + `**/.env.*`로 좁히기(리뷰 Low): `.envrc`·`.env-local`·`.env_prod`가 다시 열린다. `.envrc`(direnv)는 보통 비밀 값을 export한다. 넓은 쪽이 틀리면 정상 파일을 `git add`가 거절하는 것으로 끝나고, `!` 줄 하나로 푼다. 좁은 쪽이 틀리면 비밀 값이 이력에 남는다. ## 위험과 영향 - 새 예시 파일(예: `.env.lane.example`)을 더하면 `!` 줄 없이는 git이 무시한다. 막히는 쪽으로 실패하고, `git add`가 무시된 파일이라고 알린다. 주석에 적었다. - `.gitignore`는 이미 추적 중인 파일을 빼지 않는다. 이 repo에는 해당 파일이 없다(`git ls-files -ci --exclude-standard` 전후 빈 결과). 파생 서비스에 이미 추적 중인 하위 `.env`가 있으면 `git rm --cached`가 따로 필요하다. - `.gitignore`는 Gradle 입력이다(`build-logic` `VerifyNoIgnoredSourcePackagesTask`가 소스 경로마다 `git check-ignore`를 돈다). 그래서 desktop `scripts/verify.sh pr`을 돌렸다. - 스테이지된 `.env` 꼴 파일을 막는 pre-commit이나 CI 검사는 없다. 이 PR은 만들지 않는다(넘길 것). ## 검증 실제 `.env`는 열지 않았다. 깨끗한 detached worktree에서 없는 경로에 `git check-ignore -q --no-index <경로>`를 돌려 rc를 봤다(0 = 무시). `-v`는 `!` 줄 일치도 rc=0으로 내서, rc는 `-q`로 따로 쟀다. - **C1 RED:** 고치기 전 b2bfb9bb(트리 3d387113d0a1ab97226bf0208f34d2c8addbbf7c)와 base 484264cb(트리 d9ec7ffb0de2fdd3d40a45e929d05cf985363512), 둘 다 `.gitignore` blob ae53be55. `git check-ignore -q --no-index src/.env` → rc=1. - **C1 GREEN:** 고친 커밋 8def6e05(트리 d7bbeade758e8cf5750593c46f7bfacdaffd225d). 같은 명령 → rc=0, `-v`는 `.gitignore:36:**/.env*`. - **C2 무시됨(rc=0):** `.env`, `.env.local`, `.env.lane`, `src/.env`, `src/.env.local`, `src/.env.lane`, `sub-x/.env`, `sub-x/.env.local`, `sub-x/.env.lane`, `build-x/.env.lane`, `src/bootstrap/app/compose-lanes/.env`, `deep/a/b/.env.staging`, `sub-x/.env.prod`. 고치기 전에는 루트 셋만 rc=0이고 나머지 10개는 rc=1. - **C2 무시 안 됨(rc=1):** `.env.example`, `.env.local.example`, `src/.env.example`, `src/.env.local.example`, `sub-x/.env.example`, `sub-x/.env.local.example`. - **C3:** `git ls-files '*.env*'` 전후 모두 `.env.example`, `.env.local.example`. `git ls-files -ci --exclude-standard` 전후 빈 결과. - 노트북 `scripts/verify.sh docs` rc=0(Ran 275, OK). - desktop `scripts/verify.sh pr --log fix-gitignore-nested-env`(기준 484264cb, 보낸 트리 d7bbeade = HEAD 트리): rc=0. `:verifyNoIgnoredSourcePackages`는 `OK — 4482 Java sources are all committable`. - 리뷰: 종류 A, `reviewer` 1회(sonnet, 렌즈 be-security). Critical 0 / High 0 / Medium 0 / Low 2. 둘 다 그대로 둔다. Low 1(좁히기)은 위 버린 안에 이유를 적었다. Low 2(예시 이름 고정)는 리뷰어도 그대로 두라고 했다. ## 리뷰어가 볼 곳 - `.gitignore` 31~38행 하나다. ## 관련 - Refs: REV-BE-0048 - Fixes: 1388c06a9f18 ("refactor(layout)!: Gradle 루트와 계층 폴더를 옮긴다(옮기기만)")
donghyeon.kang added 1 commit 2026-11-21 17:38:44 +00:00
문제: .gitignore의 `/.env*`는 저장소 루트의 .env만 무시한다. 재배치
커밋 1388c06a가 `src/.env*`와 예시 예외 둘을 지우고 루트 줄로
바꿨다. 그래서 src/.env, src/.env.local, 아무 하위 폴더의 .env.lane이
무시되지 않고, `git add -A` 한 번이면 실제 환경 파일이 이력에 들어간다.
scripts/verify.sh는 미추적 파일로 rc=5를 내지만 사람의 커밋은 막지
못한다. 파생 서비스도 같은 .gitignore를 물려받는다.

고른 방법: `**/.env*`로 어느 폴더든 .env로 시작하는 파일을 무시하고,
추적 중인 예시 둘만 `!**/.env.example`, `!**/.env.local.example`로
되살린다. 따로 있던 `/.env.lane` 줄은 이 줄에 들어가서 지웠다.

버린 대안:
- 이름 나열(`**/.env`, `**/.env.local`, `**/.env.lane`): C2 경로는
  모두 막지만 .env.prod·.env.staging 같은 프로필 파일을 놓친다.
  루트에서는 지금 `/.env*`가 막던 .env.<프로필>이 다시 열린다.
- `src/.env*`만 되살리기: 재배치 뒤 다른 하위 폴더(compose-lanes 등)에
  생기는 파일을 또 놓친다.
- `!**/.env*.example`로 예시를 넓게 되살리기: 지금 추적하는 예시는 둘뿐이다.
  넓히면 .env.<무엇>.example 이름의 실제 파일도 열린다. 새 예시는 `!`
  줄을 하나 더하면 된다.

위험·한계: 새 예시 파일(예: .env.lane.example)을 더하면 `!` 줄 없이는
git이 무시한다. 막히는 쪽으로 실패하고, `git add`가 무시된 파일이라고
알린다. 이미 추적 중인 파일은 .gitignore가 빼지 않는다. 이 repo의
추적 목록에는 해당 파일이 없다(`git ls-files -ci --exclude-standard`
빈 결과). 스테이지된 .env 꼴 파일을 막는 pre-commit이나 CI 검사는 없고,
이 커밋도 만들지 않는다.

검증: 실제 .env는 열지 않고, 없는 경로에
`git check-ignore -q --no-index <경로>`를 돌려 rc를 봤다.
- C1: 고치기 전(b2bfb9bb·484264cb, .gitignore blob ae53be55)
  src/.env rc=1. 고친 뒤 rc=0(`**/.env*`).
- C2: .env, .env.local, .env.lane, src/.env, src/.env.local,
  src/.env.lane, sub-x/.env, sub-x/.env.local, sub-x/.env.lane,
  build-x/.env.lane, src/bootstrap/app/compose-lanes/.env,
  deep/a/b/.env.staging, sub-x/.env.prod 모두 rc=0.
  .env.example, .env.local.example, 같은 이름의 src/·sub-x/ 예시는
  모두 rc=1.
- C3: `git ls-files '*.env*'` 전후 모두 .env.example,
  .env.local.example. `git ls-files -ci --exclude-standard` 전후 빈 결과.

Refs: REV-BE-0048
Fixes: 1388c06a9f ("refactor(layout)!: Gradle 루트와 계층 폴더를 옮긴다(옮기기만)")
donghyeon.kang added 1 commit 2026-11-21 18:14:35 +00:00
Merge branch 'main' into fix/gitignore-nested-env
pr / done (pull_request) Canceled after 0s
a7d833e094
donghyeon.kang added 1 commit 2026-11-21 18:16:48 +00:00
Merge branch 'main' into fix/gitignore-nested-env
pr / done (pull_request) Successful in 1m56s
7f6ad1d645
donghyeon.kang merged commit c79ddf52aa into main 2026-11-21 18:45:46 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/clean-architecture-backend-template#85