Terragrunt Module Hierarchies (TGMH)

개요

Terragrunt Module Hierarchies(TGMH)는 인프라 구성 관리 도구인 Terragrunt에서 Terraform 모듈을 계층적(hierarchical)으로 구성함으로써, 환경별 재사용성과 유지보수성을 극대화하는 전략적 패턴입니다. 특히 조직 내 수많은 환경(dev, stage, prod)과 리전, 서비스 구성을 효과적으로 추상화하고 공통 코드를 중복 없이 관리하는 데 매우 유용합니다. 본 글에서는 TGMH의 구조, 구성 방식, 적용 시 고려사항을 설명합니다.

---

1. 개념 및 정의

TGMH는 Terragrunt를 사용하여 Terraform 모듈의 반복 사용을 줄이고, 공통 구성은 상위 계층에서 상속하며, 환경별 세부 설정은 하위 계층에 위치시키는 구조적 접근 방식입니다.

• 목적: Terraform 모듈의 코드 재사용, 구성 통일, 관리 용이성 확보
• 필요성: 규모 확장에 따른 환경 간 설정 차이 최소화 및 코드 중복 방지
• 적용 대상: 클라우드 인프라 운영 조직, IaC 자동화 환경

---

2. 특징

구분	설명	비고
DRY 원칙 준수	중복 제거를 위한 계층적 재사용 구조	Don't Repeat Yourself
계층 기반 디렉토리 구성	root > region > env > service 등	환경별 구분 명확화
공통 설정 상속	공통 backend, provider 설정 등 위계적 상속	include 블록 사용

TGMH는 코드 품질 향상과 구조 일관성을 동시에 제공합니다.

---

3. 구성 요소

구성 요소	설명	예시
root.hcl	최상위 공통 설정	backend, provider 공통 정의
region-level.hcl	리전별 설정 구성	us-east-1, ap-northeast-2 등
env-level.hcl	환경(dev, stage, prod) 설정	dev.tfvars, stage.tfvars 등 포함
service-level.hcl	서비스 단위 설정	VPC, EKS, RDS 등 개별 모듈 구성

Terragrunt는 include, dependencies, locals 등의 키워드로 계층 간 연결을 수행합니다.

---

4. 기술 요소

기술 요소	설명	적용 예시
include	상위 설정을 하위에서 재사용	include { path = find_in_parent_folders() }
dependency	다른 모듈의 output 참조	VPC ID → EKS 입력으로 전달
inputs	하위 모듈 변수 전달	inputs = { region = "ap-northeast-2" }
locals	공통 변수 정의	region, env 등 조건 분기 활용

Terraform의 기능을 Terragrunt가 래핑하여 계층 관리를 단순화합니다.

---

5. 장점 및 이점

장점	설명	기대 효과
모듈 재사용성 극대화	상위 계층 구성 재활용	코드 유지보수 비용 감소
환경 간 구성 통일성	prod, stage, dev 간 설정 구조 일관	배포 안정성 향상
변경 범위 최소화	계층 분리로 영향도 제한	CI/CD 적용 시 안전성 증가

TGMH는 팀 단위 협업과 버전 관리 전략에도 유리합니다.

---

6. 주요 활용 사례 및 고려사항

사례	내용	고려사항
글로벌 클라우드 인프라 구성	multi-region, multi-env 구조에서 재사용 극대화	환경간 차이 최소화 전략 필요
보안/네트워크 공통 모듈화	VPC, IAM, KMS 등 재사용 모듈 구성	모듈 간 dependency 충돌 주의
CI/CD 파이프라인 통합	환경 단위로 Terragrunt plan/apply 자동화	폴더 기준 조건 실행 설계 필요

디렉토리 구조, 모듈 경로 관리, 린트 규칙 설정이 성공적 도입의 핵심입니다.

---

7. 결론

Terragrunt Module Hierarchies는 IaC(Infrastructure as Code) 전략에서 유지보수성과 재사용성을 극대화할 수 있는 강력한 설계 패턴입니다. 대규모 인프라를 운영하는 조직일수록 TGMH 도입을 통해 환경 간 차이점을 최소화하고, 코드 중복을 제거하여 일관된 인프라 구성을 유지할 수 있습니다. GitOps, CI/CD와의 연계 시에도 강력한 구조적 기반을 제공합니다.