🚀 Terraform Day 20: 맞춤 Terraform 모듈을 사용한 프로덕션 인프라 구축

Source: Dev.to

🧠 Terraform 모듈이란?

Terraform 모듈은 재사용 가능한, 자체 포함된 Terraform 코드 패키지입니다.

모듈에 일반적으로 포함되는 파일:

• main.tf – 리소스
• variables.tf – 입력값
• outputs.tf – 노출되는 값

Terraform은 모든 디렉터리를 모듈로 취급합니다.

모듈을 사용하면:

• 복잡성 캡슐화
• 표준 강제 적용
• 인프라 패턴 재사용
• 팀 및 환경 전반에 걸친 깔끔한 확장

🧩 Terraform 모듈 종류

1️⃣ 퍼블릭 모듈

• Terraform Registry에서 제공
• 공급자 또는 커뮤니티가 유지 관리
• 내부에서 수정할 수 없음

2️⃣ 파트너 모듈

• HashiCorp와 파트너가 공동 관리
• 검증된 프로덕션 준비 상태
• 여전히 외부에서 제어

3️⃣ 커스텀 모듈 (Day 20의 초점)

• 여러분이나 조직이 직접 생성·유지 관리
• 코드, 버전 관리, 보안, 업데이트에 대한 완전한 제어

프로덕션 시스템은 커스텀 모듈에 크게 의존합니다.

🏗 루트 모듈 vs 커스텀 모듈

🔹 루트 모듈

• Terraform 프로젝트의 진입점
• terraform init와 terraform apply가 실행되는 위치
• 전체 인프라를 오케스트레이션
• 커스텀 모듈을 소스하고 연결

🔹 커스텀 모듈

• 루트 모듈 내부의 서브디렉터리로 저장
• 각 모듈은 단일 책임을 가짐
• 서로 직접 통신하지 않음
• 루트 모듈이 중앙 코디네이터 역할 수행

📂 전형적인 프로젝트 구조 (Day 20 스타일)

terraform-project/
├── main.tf          # Root module
├── variables.tf
├── outputs.tf
├── modules/
│   ├── vpc/
│   │   ├── main.tf
│   │   ├── variables.tf
│   │   └── outputs.tf
│   ├── eks/
│   │   ├── main.tf
│   │   ├── variables.tf
│   │   └── outputs.tf
│   ├── iam/
│   └── secrets/

각 모듈은 하나의 인프라 도메인을 캡슐화합니다.

🔁 모듈 간 상호작용 (매우 중요)

커스텀 모듈은 서로 직접 통신하지 않습니다. 모든 통신은 루트 모듈을 통해 이루어집니다:

1. 루트 모듈이 커스텀 모듈을 호출합니다.
2. 입력 변수들을 전달합니다.
3. 커스텀 모듈이 리소스를 생성합니다.
4. 커스텀 모듈이 출력값을 노출합니다.
5. 루트 모듈이 출력값을 사용합니다.
6. 출력값이 다른 모듈의 입력값으로 전달됩니다.

이렇게 하면:

• 느슨한 결합
• 명확한 의존 흐름
• 유지 보수 가능한 아키텍처

🔗 예시: VPC → EKS 의존 흐름

• VPC 모듈이 vpc_id를 출력합니다.
• 루트 모듈이 vpc_id를 받아 저장합니다.
• 루트 모듈이 vpc_id를 EKS 모듈에 전달합니다.
• EKS 리소스가 올바른 VPC 안에서 생성됩니다.

인프라가 성장함에 따라 이 패턴은 깔끔하게 확장됩니다.

📥 모듈형 설계에서 변수와 출력

변수

• 모듈이 기대하는 값을 정의합니다.
• 루트 모듈에서 전달됩니다.
• 모듈을 유연하게 유지합니다.

출력

• 모듈이 외부에 노출하는 값을 정의합니다.
• 루트 모듈에서 사용됩니다.
• 모듈 간 조정을 가능하게 합니다.

모듈은 함수와 같이 동작합니다: 입력 → 처리 → 출력.

🏁 결론

Day 20은 Terraform을 학습 단계에서 아키텍처 단계로 전환합니다. 이번 세션을 통해 강조되는 점은:

• Terraform은 단순히 리소스를 관리하는 것이 아니라.
• Terraform은 시스템을 설계하는 도구이다.
• 커스텀 모듈이 프로덕션 IaC의 핵심이다.

모듈형 Terraform 아키텍처를 마스터하면 대규모, 유지 보수 가능한 엔터프라이즈 급 클라우드 플랫폼을 구축할 수 있는 능력을 얻게 됩니다—실제 현장에서 Terraform이 어떻게 사용되는지를 보여줍니다.