모듈 설계 고도화: 범용 vs 서비스 전용, 버전 관리

# 범용 VPC 모듈 - 모든 옵션을 노출
module "vpc" {
  source = "terraform-aws-modules/vpc/aws"

  name                 = var.name
  cidr                 = var.cidr
  azs                  = var.availability_zones
  private_subnets      = var.private_subnets
  public_subnets       = var.public_subnets
  enable_nat_gateway   = var.enable_nat_gateway
  single_nat_gateway   = var.single_nat_gateway
  enable_dns_hostnames = var.enable_dns_hostnames
  # ... 수십 개의 변수
}

# 우리 회사 표준 VPC 모듈 - 필수 입력만 요구
module "vpc" {
  source = "git::https://github.com/company/terraform-modules.git//vpc?ref=v2.1.0"

  name        = var.service_name    # 이것만 필요
  environment = var.environment     # dev / stage / prod
  # 나머지는 회사 표준으로 고정됨
}

# 나쁜 예: 내부 구현 세부사항을 모두 노출
variable "vpc_cidr_block" { ... }
variable "subnet_1_cidr" { ... }
variable "subnet_2_cidr" { ... }
variable "subnet_3_cidr" { ... }
variable "nat_gateway_eip_allocation_id" { ... }

# 좋은 예: 비즈니스 의미를 가진 변수만 노출
variable "environment" {
  description = "배포 환경 (dev/stage/prod)"
  type        = string
}
variable "vpc_size" {
  description = "VPC 크기 (small/medium/large)"
  type        = string
  default     = "medium"
}

# 새 버전 태그 생성
git tag -a v1.2.0 -m "Add RDS support"
git push origin v1.2.0

module "vpc" {
  # 태그로 버전 고정 (필수)
  source = "git::https://github.com/company/terraform-modules.git//modules/vpc?ref=v1.2.0"
}

# Terraform Registry 사용 시
module "vpc" {
  source  = "terraform-aws-modules/vpc/aws"
  version = "~> 5.1"    # 5.1.x 허용, 5.2 이상 금지
}

# v1.x: 변수명 변경 전
variable "vpc_name" { ... }

# v2.0.0 (Breaking): 변수명이 변경됨 → 기존 사용처 수정 필요
variable "name" { ... }

# 전환 기간 동안 두 변수를 모두 지원
variable "vpc_name" {
  description = "DEPRECATED: name 변수를 사용하세요. v3.0에서 제거됩니다."
  type        = string
  default     = null
}

variable "name" {
  description = "VPC 이름"
  type        = string
  default     = null
}

locals {
  # 하위호환성 처리
  name = coalesce(var.name, var.vpc_name)
}

## 모듈 카탈로그

| 모듈 | 최신 버전 | 담당자 | 상태 |
|------|---------|--------|------|
| vpc  | v2.1.0  | @infra-team | 안정 |
| eks  | v1.3.0  | @platform-team | 안정 |
| rds  | v1.5.2  | @infra-team | 안정 |