Skip to content

docs: record the Terraform repo boundary decision - #5

Merged
iflov merged 1 commit into
mainfrom
iflov/terraform-repo-boundary-doc
Aug 31, 2026
Merged

iflov merged 1 commit into
mainfrom
iflov/terraform-repo-boundary-doc

Conversation

@iflov

@iflov iflov commented Aug 31, 2026

Copy link
Copy Markdown
Owner

infra/terraform을 앱 저장소 밖으로 뺄지 3라운드 교차검증한 결과를 docs/terraform-repo-boundary.md에 남긴다. 결론은 미결정 상태이며, 이어서 진행할 시작점까지 포함한다.

핵심

저장소 경계는 선행 질문에 종속된다 — 파생 프로젝트가 terraform을 복제하는가(모델 A) 참조하는가(모델 B). 이게 정해지면 경계는 따라온다.

검증 중 드러난 것

  • 위치는 분리의 장애가 아니다. 앱 코드·CI 어디서도 infra/terraform을 참조하지 않고, resource address에 filesystem path가 들어가지 않아 state 이동 비용도 0이다. 게다가 한 번도 apply된 적이 없다 (.terraform/에 providers/만 존재).
  • 같은 저장소에 있는데도 app↔deployment 계약이 이미 어긋나 있다. 소비자 없는 SQS(compute.tf:89가 MESSAGE_QUEUE_URL을 주입하는데 앱은 안 읽음), 빠진 TRUST_PROXY_HOPS, backend 블록 부재, 이미지 전달 경로 없음 — 전부 분리 여부와 무관하게 고쳐야 한다.
  • compute 축은 기존 검증 기계를 재사용할 수 없다. deps에 HCL 파서가 없고 terraform 의미가 variables→locals→resource로 계산되어, check:scaffold의 Compose 검증 방식을 .tf에 적용할 수 없다.

정정된 판단

db_engine drift가 조용히 어긋난다고 본 초기 판단은 틀렸다 — src/config/env.validation.ts:106이 부팅을 거부한다. 다만 CI가 terraform을 돌리지 않으므로 발견 시점은 분리 여부와 무관하게 ECS task 기동 시점이다.

비고

루트는 README/CLAUDE/AGENTS만 두는 구성이라 docs/를 새로 만들었다. 코드 변경 없음.

🤖 Generated with Claude Code

https://claude.ai/code/session_01HdRAhnHdbr4NP3awtPpxQC

infra/terraform을 앱 저장소 밖으로 뺄지 3라운드 교차검증한 결과를 남긴다.
결론은 미결정 상태이며, 내일 이어서 진행할 시작점까지 포함한다.

핵심은 저장소 경계가 선행 질문에 종속된다는 것이다 — 파생 프로젝트가
terraform을 복제하는가(모델 A) 참조하는가(모델 B). 이게 정해지면 경계는
따라온다.

검증 중 드러난 것:

- 위치는 분리의 장애가 아니다. 앱 코드·CI 어디서도 infra/terraform을
  참조하지 않고, resource address에 filesystem path가 들어가지 않아
  state 이동 비용도 0이다. 게다가 한 번도 apply된 적이 없다.
- 같은 저장소에 있는데도 app↔deployment 계약이 이미 어긋나 있다.
  소비자 없는 SQS, 빠진 TRUST_PROXY_HOPS, backend 블록 부재,
  이미지 전달 경로 없음 — 전부 분리 여부와 무관하게 고쳐야 한다.
- compute 축을 ORM 축처럼 다루려 해도 deps에 HCL 파서가 없어
  기존 check:scaffold 검증 기계를 재사용할 수 없다.

db_engine drift가 조용히 어긋난다고 본 초기 판단은 틀렸다.
env.validation.ts가 부팅을 거부한다. 다만 CI가 terraform을 돌리지
않으므로 발견 시점은 분리 여부와 무관하게 ECS task 기동 시점이다.

루트는 README/CLAUDE/AGENTS만 두는 구성이라 docs/를 새로 만들었다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HdRAhnHdbr4NP3awtPpxQC
@iflov
iflov merged commit 087a162 into main Aug 31, 2026
1 check passed
@iflov
iflov deleted the iflov/terraform-repo-boundary-doc branch August 31, 2026 09:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant