# 🔍 Terraform Modular EKS + Istio — The Part Nobody Explains

Context

Terraform 모듈화 초기 단계에서 코드와 폴더 구조는 정상이었으나 리소스 생성 순서가 예상과 달랐으며 의존성이 명시적이지 않아 디버깅이 복잡했다. 이는 Terraform을 선형 스크립트 실행 모델로 잘못 이해한 데서 비롯되었다.

Technical Solution

• Terraform의 실행 모델을 선형 흐름에서 의존성 그래프 기반 실행으로 인식: Terraform이 명령을 순차 실행하지 않고 모든 참조 관계를 먼저 분석한 후 자동으로 리소스 생성 순서 결정
• 모듈 간 통신을 Outputs → Inputs 패턴으로 표준화: VPC 모듈이 private_subnet_ids를 출력하고 EKS 모듈이 이를 입력값으로 참조하는 방식으로 느슨한 결합 구현
• 의존성 신호를 명시적 참조로 표현: module.iam.eks_cluster_role_arn과 같은 모듈 간 직접 참조를 통해 Terraform이 자동으로 생성 순서 추론하도록 설계
• 하드코드된 리소스 ID를 변수와 모듈 출력으로 대체: 환경별 values를 terraform.tfvars에서 관리하고 모듈 출력으로 다른 모듈에 전달하여 재사용성 확보
• main.tf를 오케스트레이터 역할로 정의: VPC, IAM, EKS Cluster, Node Groups 모듈을 연결하되 각 모듈이 데이터 흐름으로만 통신하도록 구조화
• S3 기반 Remote State 백엔드 설정: 팀 협업과 State Lock을 통한 동시 접근 제어 구현

Key Takeaway

Terraform은 인프라 스크립트가 아닌 데이터 흐름 기반 시스템 설계 도구이며, 모듈 간 의존성을 명시적 참조로 표현하면 Terraform이 자동으로 리소스 생성 순서를 결정하므로 환경 간 확장성과 유지보수성이 크게 향상된다.