Lab 11: 모듈 버전 관리와 레지스트리

terraform {
  required_version = ">= 1.0.0"

  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 5.0"
    }
  }
}

# v1.0.0 인터페이스: 버킷 이름 (v2.0.0에서 name으로 개명 예정 — Breaking Change)
variable "bucket_name" {
  description = "생성할 S3 버킷 이름"
  type        = string
}

variable "tags" {
  description = "버킷에 부여할 태그"
  type        = map(string)
  default     = {}
}

# S3 버킷 생성 (모듈 v1.0.0)
resource "aws_s3_bucket" "this" {
  bucket = var.bucket_name

  tags = merge(var.tags, {
    ManagedBy = "terraform"
  })
}

# v1.1.0에서 추가할 선택적 버저닝 리소스 예시 (하위 호환 Minor 업그레이드)
# variable "enable_versioning" { type = bool, default = false } 를 variables.tf에 추가한 뒤 아래 블록을 활성화합니다.
# resource "aws_s3_bucket_versioning" "this" {
#   count  = var.enable_versioning ? 1 : 0
#   bucket = aws_s3_bucket.this.id
#
#   versioning_configuration {
#     status = "Enabled"
#   }
# }

output "bucket_id" {
  description = "생성된 버킷 이름"
  value       = aws_s3_bucket.this.id
}

output "bucket_arn" {
  description = "생성된 버킷 ARN"
  value       = aws_s3_bucket.this.arn
}

terraform {
  required_version = ">= 1.0.0"

  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 5.0"
    }
    random = {
      source  = "hashicorp/random"
      version = "~> 3.0"
    }
  }
}

provider "aws" {
  region = "ap-northeast-2"
}

# 버킷 이름 중복 방지를 위한 무작위 접미사
resource "random_string" "suffix" {
  length  = 8
  special = false
  upper   = false
}

# Git 태그(v1.0.0)로 버전을 고정한 모듈 호출
# 실습에서는 로컬 Git 저장소(file://)를 사용하고,
# 실무에서는 GitHub 등 원격 저장소 URL을 사용합니다.
# ref를 v1.1.0 -> v2.0.0으로 올릴 때는 반드시 `terraform init -upgrade`가 필요합니다.
module "app_bucket" {
  source = "git::file:///절대경로/lab11-module-versioning/s3-module?ref=v1.0.0"
  # 실무 예시:
  # source = "git::https://github.com/my-org/terraform-aws-s3-module.git?ref=v1.0.0"

  bucket_name = "lab11-module-versioning-app-${random_string.suffix.result}"

  tags = {
    Name = "lab11-app"
  }
}

# Terraform Registry 공개 모듈 사용 예시 (보너스) — 버전 제약 연산자로 4.x 최신만 허용, 5.0은 차단
module "registry_bucket" {
  source  = "terraform-aws-modules/s3-bucket/aws"
  version = "~> 4.0"

  bucket = "lab11-registry-example-${random_string.suffix.result}"

  tags = {
    Name = "lab11-registry"
  }
}

output "bucket_id" {
  value = module.app_bucket.bucket_id
}

output "bucket_arn" {
  value = module.app_bucket.bucket_arn
}

output "registry_bucket_id" {
  value = module.registry_bucket.s3_bucket_id
}

output "registry_bucket_arn" {
  value = module.registry_bucket.s3_bucket_arn
}

# 1. 모듈 저장소에 세 개의 버전 태그 존재
cd ../s3-module && git tag
# v1.0.0
# v1.1.0
# v2.0.0

# 2. 소비자가 어떤 버전을 쓰는지 확인
cd ../consumer
cat .terraform/modules/modules.json | python3 -m json.tool
# "Source": "git::file:///...?ref=v2.0.0"  ← ref가 그대로 기록됨 ✅

# 3. 버저닝이 실제로 켜졌는지 확인 (v1.1.0 기능)
# 버킷 이름은 random_string.suffix가 붙으므로 terraform output으로 실제 이름을 먼저 확인합니다
terraform output bucket_id
aws s3api get-bucket-versioning --bucket "$(terraform output -raw bucket_id)"
# { "Status": "Enabled" } ✅

# 4. plan이 깨끗한지 최종 확인
terraform plan
# No changes. Your infrastructure matches the configuration. ✅

module "registry_bucket" {
  source  = "terraform-aws-modules/s3-bucket/aws"
  version = "~> 4.0"   # 4.x의 최신 버전 사용, 5.0은 차단

  bucket = "lab11-registry-example-${random_string.suffix.result}"

  tags = {
    Name = "lab11-registry"
  }
}

cd lab11-module-versioning/consumer
terraform destroy -auto-approve