Lab 16: Terraform 네이티브 테스트

terraform {
  required_version = ">= 1.6.0"   # terraform test는 1.6부터 지원

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

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

variable "bucket_name" {
  description = "버킷 이름 (lab16- 접두어, 소문자/숫자/하이픈만 허용)"
  type        = string

  validation {
    condition     = can(regex("^lab16-[a-z0-9-]+$", var.bucket_name))
    error_message = "bucket_name은 'lab16-'로 시작하고 소문자·숫자·하이픈만 사용해야 합니다."
  }
}

variable "environment" {
  description = "배포 환경"
  type        = string

  validation {
    condition     = contains(["dev", "stage", "prod"], var.environment)
    error_message = "environment는 dev, stage, prod 중 하나여야 합니다."
  }
}

variable "tags" {
  description = "버킷 태그 (Owner 키 필수)"
  type        = map(string)
  default     = {}
}

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

resource "aws_s3_bucket" "this" {
  bucket = "${var.bucket_name}-${var.environment}-${random_string.suffix.result}"

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

  lifecycle {
    # 배포 전 검사: Owner 태그가 없으면 plan 단계에서 실패
    precondition {
      condition     = contains(keys(var.tags), "Owner")
      error_message = "tags에 Owner 키는 필수입니다. 리소스 비용 추적에 사용됩니다."
    }

    # 결과 보증: 최종 버킷 이름은 63자를 넘을 수 없음 (S3 제약)
    postcondition {
      condition     = length(self.bucket) <= 63
      error_message = "버킷 이름이 S3 최대 길이(63자)를 초과했습니다."
    }
  }
}

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

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

# 파일 전역 변수 — 모든 run 블록의 기본 입력
variables {
  bucket_name = "lab16-test-app"
  environment = "dev"
  tags = {
    Owner = "platform-team"
  }
}

# ✅ 정상 케이스: 이름 규칙을 지키면 plan이 성공하고
#    최종 버킷 이름이 <bucket_name>-<environment>-<random suffix> 형식이어야 한다
run "valid_bucket_name" {
  command = plan

  assert {
    condition     = startswith(aws_s3_bucket.this.bucket, "lab16-test-app-dev-")
    error_message = "버킷 이름은 '<bucket_name>-<environment>-' 접두어로 시작해야 합니다."
  }
}

# ❌ 부정 테스트: 대문자 이름은 variable validation에서 거부되어야 한다
run "uppercase_name_rejected" {
  command = plan

  variables {
    bucket_name = "LAB16-INVALID"
  }

  # var.bucket_name의 validation 실패를 '기대'한다
  # 거부되지 않으면 테스트가 실패한다
  expect_failures = [
    var.bucket_name,
  ]
}

# ❌ 부정 테스트: 허용되지 않은 환경 이름은 거부되어야 한다
run "invalid_environment_rejected" {
  command = plan

  variables {
    environment = "production"   # prod가 아닌 오타
  }

  expect_failures = [
    var.environment,
  ]
}

variables {
  bucket_name = "lab16-test-app"
  environment = "prod"
  tags = {
    Owner = "platform-team"
    Team  = "sre"
  }
}

# ✅ 정상 케이스: 사용자 태그와 자동 태그가 병합되어야 한다
run "tags_are_merged" {
  command = plan

  assert {
    condition     = aws_s3_bucket.this.tags["Environment"] == "prod"
    error_message = "Environment 태그가 자동으로 붙어야 합니다."
  }

  assert {
    condition     = aws_s3_bucket.this.tags["ManagedBy"] == "terraform"
    error_message = "ManagedBy=terraform 태그가 자동으로 붙어야 합니다."
  }

  assert {
    condition     = aws_s3_bucket.this.tags["Owner"] == "platform-team"
    error_message = "사용자가 넘긴 Owner 태그가 유지되어야 합니다."
  }
}

# ❌ 부정 테스트: Owner 태그가 없으면 precondition에서 거부되어야 한다
run "missing_owner_tag_rejected" {
  command = plan

  variables {
    tags = {
      Team = "sre"   # Owner 누락
    }
  }

  expect_failures = [
    aws_s3_bucket.this,   # 리소스의 precondition 실패를 기대
  ]
}

# 생성된 리소스가 없는지 확인
aws s3 ls | grep lab16 || echo "생성된 버킷 없음 ✅"

# 만약 command = apply 테스트를 실험했다면 terraform test가
# 종료 시 자동으로 destroy하지만, 중단된 경우 수동 정리:
terraform destroy -auto-approve

# 테스트 캐시 정리 (선택)
rm -rf .terraform terraform.tfstate*