[IaC] Terraform module 생성

📌테라폼 모듈이란?

https://developer.hashicorp.com/terraform/tutorials/modules/module

Modules overview | Terraform | HashiCorp Developer

테라폼 모듈은 단일 디렉토리에 있는 테라폼 구성 파일 세트이다. 단일 디렉토리와 하나 이상의 .tf 파일로 구성된 간단한 구성도 모듈이다. 이러한 디렉토리에서 직접 테라폼 명령을 실행하면 루트 모듈로 간주된다. 따라서 모든 테라폼 구성은 모듈의 일부이다. 다음과 같은 간단한 구성 파일 세트를 가질 수 있다.

.
├── LICENSE
├── README.md
├── main.tf
├── variables.tf
├── outputs.tf

📌모듈은 왜 필요한가?

테라폼 모듈은 인프라 구성의 복잡성을 줄이고, 일관성과 재사용성을 높여주는 중요한 도구이다. 다음과 같은 문제들을 해결하는 데 도움이 된다.

• 구성정리: 구성을 논리적인 단위로 나누어 관련된 리소스를 함께 관리할 수 있도록 도와줌. 수백~수천 줄의 코드를 구성할 때 특히 유용.
• 구성 캡슐화: 서로 다른 구성 요소를 분리해 예기치 않은 영향이나 실수를 방지할 수 있음.
• 구성 재사용: 한 번 작성한 코드를 여러 곳에서 재사용할 수 있어 시간과 노력을 절약할 수 있고, 팀원 간 또는 커뮤니티 간 공유도 가능.
• 일관성과 모범 사례 적용: 복잡한 설정을 일관되게 유지하고, 보안 등 중요한 설정을 실수 없이 적용할 수 있도록 도와줌.
• 셀프 서비스 제공: 다른 팀이 모듈을 쉽게 사용하게 하여, 인프라 구성에 익숙하지 않은 팀도 조직의 정책에 맞는 인프라를 직접 만들 수 있게 해줌.

📌로컬과 원격 모듈

모듈은 로컬 파일 시스템이나 원격 소스에서 불러올 수 있다. 테라폼은 다양한 원격 소스를 지원한다.

• Terraform Registry
• 대부분의 버전 관리 시스템 (예: GitHub, GitLab 등)
• HTTP URL
• HCP Terraform 또는 Terraform Enterprise의 프라이빗 모듈 레지스트리

모듈을 직접 작성해 로컬에서 불러올 수도 있고, 다른 사람이 만든 모듈을 원격 저장소에서 가져와 사용할 수도 있다.

---

 

📌모듈 생성

https://developer.hashicorp.com/terraform/tutorials/modules/module-create

Build and use a local module | Terraform | HashiCorp Developer

https://developer.hashicorp.com/terraform/tutorials/modules/pattern-module-creation

Module creation - recommended pattern | Terraform | HashiCorp Developer

테라폼 모듈은 일반적으로 디렉토리 구조로 관리된다.

modules/
└── example-module/
    ├── main.tf        # 리소스 정의 - 실제 인프라 리소스를 정의
    ├── variables.tf   # 입력 변수 정의 - 사용자로부터 입력받을 변수 선언
    └── outputs.tf     # 출력 변수 정의 - 모듈 사용자가 사용할 수 있도록 결과를 출력

✅테라폼 모듈 생성 워크플로우

1. 요구 사항을 적절한 모듈로 나눈다.
   • 모듈은 하나의 명확한 목적을 갖고, 작고 단순하게 시작하는 것이 좋다.
   • 세 가지 기준을 고려해 인프라를 그룹화
     • 캡슐화 - 항상 함께 배포되는 인프라는 하나의 모듈로 묶기. 그러나 너무 많은 리소스를 한 모듈에 담으면 이해하기 어려워짐.
     • 권한 경계 - 서로 다른 조직/팀이 책임지는 리소스를 한 모듈에 넣지 말기. 보안과 권한 분리를 유지해야 함.
     • 변동성 - 자주 변경되는 리소스와 잘 변경되지 않는 리소스는 분리. 상태를 보존해야 하는 리소스를 불필요한 변경으로부터 보호.
2. 모듈 MVP를 만든다.
   • 처음부터 완벽한 모듈을 만들려고 하지 않아도 괜찮다.
   • MVP 설계 시 유의사항
     • 희귀한 예외 케이스는 포함하지 말 것.
     • 조건문을 가능한 피하고, 단순한 구조 유지
     • 꼭 필요한 변수만 노출
     • 출력값은 최대한 많이 포함할 것.

---

추후 생성 예제 추가 예정