🚀 Terraform 6일차: 전문적인 Terraform 프로젝트 구조

Source: Dev.to

왜 Terraform 파일을 조직해야 할까요?

초보자는 모든 것을 하나의 파일에 넣는 경우가 많습니다:

• Providers
• Resources
• Variables
• Outputs
• Backend
• Locals

이는 아주 작은 프로젝트에만 해당됩니다. 인프라가 성장함에 따라 단일 파일은 다음과 같은 문제를 일으킵니다:

• ❌ 읽기 어려움
• ❌ 업데이트 어려움
• ❌ 오류 발생 가능성 증가
• ❌ 팀 작업에 부적합
• ❌ 확장 불가능

Day 6에서는 멀티 파일 접근 방식을 소개합니다. 이는 모듈, 환경, 재사용 가능한 인프라와 같은 향후 개념의 기반이 됩니다.

권장 Terraform 프로젝트 구조

Terraform은 파일 이름에 관계없이 모든 .tf 파일을 자동으로 로드합니다. 깔끔한 구조는 다음과 같습니다:

project/
├── main.tf          # resources
├── variables.tf     # input variables
├── outputs.tf       # output declarations
├── providers.tf     # provider configuration (AWS, etc.)
├── backend.tf       # remote backend configuration
├── locals.tf        # local reusable values
├── .gitignore       # exclude sensitive/state files
└── terraform.tfvars # default variable values (optional)

핵심 인사이트
Terraform은 파일 순서나 이름에 신경 쓰지 않으며, 내부적으로 모든 내용을 병합합니다. 위와 같은 명명 규칙은 가독성과 협업을 위한 베스트 프랙티스입니다.

실습: Terraform 파일 분할

Day 6 샘플 프로젝트를 사용해 강사는 설정을 전용 파일로 이동하는 과정을 보여주었습니다.

backend.tf

terraform {
  backend "s3" {
    bucket = "my-terraform-backend"
    key    = "dev/terraform.tfstate"
    region = "us-east-1"
  }
}

providers.tf

provider "aws" {
  region = var.region
}

• 입력 변수 → variables.tf
• 로컬 변수 → locals.tf
• 출력값 → outputs.tf
• 리소스 → main.tf

이러한 분리로 프로젝트가 깔끔해지고 오류를 더 쉽게 격리할 수 있습니다.

프로젝트 보안: .gitignore 만들기

Terraform 상태 파일이나 .terraform 디렉터리를 GitHub에 커밋하지 마세요.

.gitignore

.terraform/
terraform.tfstate
terraform.tfstate.backup
crash.log
*.tfvars

왜?

• 상태 파일에는 민감한 정보가 들어 있습니다.
• .terraform 폴더에는 플러그인 및 불필요한 메타데이터가 포함됩니다.
• 백업 파일과 크래시 로그는 내부 세부 정보를 노출시킬 수 있습니다.

이들을 버전 관리에서 제외하는 것은 보안과 깔끔한 레포 히스토리를 위해 필수입니다.

실제 프로젝트를 위한 계획: 기본을 넘어

1. 환경 폴더

environments/
├── dev/
├── stage/
└── prod/

각 환경은 자체 main.tf, variables.tf, terraform.tfvars, 그리고 백엔드 구성을 가질 수 있습니다.

2. 모듈 기반 구조

modules/
├── networking/
├── compute/
└── security/

모듈은 재사용성을 높이지만 더 깊은 이해가 필요합니다—이는 이후 챌린지에서 다룹니다.

3. 단일 코드베이스와 다중 tfvars

terraform apply -var-file=dev.tfvars
terraform apply -var-file=prod.tfvars

이 접근 방식은 엔터프라이즈 배포에 최대 유연성을 제공합니다. 초보자는 모듈에 뛰어들기 전에 파일 분리를 충분히 숙달해야 합니다.

결론

Day 6은 제가 Terraform 프로젝트를 바라보는 방식을 바꾸어 놓았습니다. 이제는 하나의 지저분한 파일 대신 다음을 이해하게 되었습니다:

• 올바른 Terraform 조직 방법
• 민감한 데이터 보안 방법
• 다중 환경 설정 준비 방법
• 전문적이고 모듈화된 인프라로 확장하는 방법

이 구조는 이후 모든 작업의 기반이 됩니다.

내일: Terraform 타입 제약 — 변수 검증 및 신뢰성을 보장합니다. 🚀