[설계 가이드] Terraform 모듈 설계, 원칙 없이 만들면 반드시 무너진다

Terraform을 사용할 때 모듈 설계 원칙이 없으면 코드가 복잡하게 뒤엉키거나, 팀원 간 협업이 어려워지고, 모듈 수정 시 의도치 않게 다른 환경이 망가지는 문제가 발생한다.

Terraform은 클라우드에 종속되지 않는 Cloud-Agnostic 특성, 상태를 기술하는 선언형(Declarative) 언어인 HCL 사용, 그리고 거대한 커뮤니티 생태계 덕분에 IaC(Infrastructure as Code)의 표준으로 자리 잡았다.

HashiCorp가 권장하는 좋은 모듈의 3가지 설계 원칙은 다음과 같다.

• 캡슐화(Encapsulation): 항상 함께 배포되는 리소스만 하나의 모듈로 묶어야 한다. 예를 들어 VNet, 서브넷, NSG는 하나의 모듈로 구성하는 것이 적절하다.
• 권한 경계(Privileges): 관리 주체가 다른 리소스는 분리해야 한다. 네트워크 팀과 개발팀의 리소스를 분리하여 권한 오남용을 구조적으로 막아야 한다.
• 변동성(Volatility): 수명이 긴 인프라와 자주 바뀌는 인프라를 분리해야 한다. 네트워크나 DB처럼 변동성이 낮은 리소스와 애플리케이션 서버처럼 변동성이 높은 리소스를 분리하여 변경 위험을 최소화한다.

표준 모듈 구조는 main.tf, variables.tf, outputs.tf, README.md를 기본 필수 요소로 하며, 필요에 따라 중첩 모듈을 위한 modules/ 디렉토리와 사용 예시를 담은 examples/ 디렉토리를 추가하여 관리한다.