Versioning #

# Workflow rilis module:

# 1. Pastikan semua perubahan sudah di-commit dan di-test
git add -A
git commit -m "feat: tambah support NAT Gateway per-AZ"

# 2. Buat tag dengan format v<MAJOR>.<MINOR>.<PATCH>
git tag v1.3.0

# 3. Push tag ke remote
git push origin v1.3.0

# 4. Opsional: buat GitHub Release dengan changelog
# (bisa lewat UI atau GitHub CLI)
gh release create v1.3.0 \
  --title "v1.3.0 — NAT Gateway per-AZ" \
  --notes "NEW: Support NAT Gateway per-AZ via variable enable_nat_per_az"

# Pemanggil menggunakan tag sebagai referensi versi
module "vpc" {
  source = "git::https://github.com/org/terraform-module-vpc.git?ref=v1.3.0"

  cidr_block  = "10.0.0.0/16"
  environment = var.environment
}

# Terraform Registry — versi dikontrol dengan version constraint
module "vpc" {
  source  = "terraform-aws-modules/vpc/aws"
  version = "~> 5.1"
  # ~> 5.1 = >=5.1.0, <6.0.0

  name = "production-vpc"
  cidr = "10.0.0.0/16"
}

# Constraint yang lebih ketat untuk production
module "eks" {
  source  = "terraform-aws-modules/eks/aws"
  version = "= 20.2.1"
  # Pin ke versi exact — tidak ada surprise update
}

# ANTI-PATTERN: Tanpa version constraint di Registry module
module "vpc" {
  source = "terraform-aws-modules/vpc/aws"
  # Tidak ada version — setiap terraform init bisa mendapat versi berbeda!
}

# WORKFLOW UPGRADE MODULE:

# 1. Baca CHANGELOG versi baru — cari breaking change
# 2. Test di environment dev/staging dulu
# 3. Jalankan terraform plan setelah update versi

# Perubahan di konfigurasi:
# Dari:
# source = "git::...?ref=v1.2.0"
# Ke:
# source = "git::...?ref=v2.0.0"

# 4. Baca output plan dengan cermat
terraform plan
# Perhatikan resource mana yang akan di-replace
# Breaking change di module sering menyebabkan resource di-replace

# 5. Jika ada replace yang tidak diinginkan, pertimbangkan:
#    - Apakah perlu moved block untuk rename resource?
#    - Apakah perlu tahap migrasi sebelum upgrade penuh?

# Contoh: module merename resource internal dari v1 ke v2
# Tanpa moved block, Terraform akan destroy + create

# Di konfigurasi root (bukan di module):
moved {
  from = module.vpc.aws_subnet.public
  to   = module.vpc.aws_subnet.public_tier  # Nama baru di module v2
}

# STRATEGI 1: Deprecation dengan backward compatibility sementara
# Beri masa transisi sebelum benar-benar hapus variable/output lama

variable "subnet_id" {
  description = "DEPRECATED: Gunakan subnet_ids. Akan dihapus di v3.0."
  type        = string
  default     = null

  validation {
    condition     = var.subnet_id == null
    error_message = "subnet_id sudah deprecated, gunakan subnet_ids (list)."
    # Atau biarkan berjalan tapi log warning via null_resource
  }
}

variable "subnet_ids" {
  description = "List ID subnet. Gantikan subnet_id yang deprecated."
  type        = list(string)
  default     = []
}

locals {
  # Kompatibilitas backward: jika subnet_id diisi, jadikan list
  effective_subnet_ids = (
    length(var.subnet_ids) > 0
    ? var.subnet_ids
    : var.subnet_id != null ? [var.subnet_id] : []
  )
}

# PATCH (x.y.Z): Perbaikan bug yang tidak mengubah interface
# Contoh: fix typo di description, perbaiki tag yang salah
# Tidak ada breaking change → consumer tidak perlu ubah apapun
git tag v1.2.1

# MINOR (x.Y.z): Fitur baru yang backward-compatible
# Contoh: tambah output baru, tambah optional variable baru
# Consumer existing tidak terpengaruh → bisa upgrade dengan aman
git tag v1.3.0

# MAJOR (X.y.z): Breaking change
# Contoh: hapus variable, ubah tipe output, hapus resource
# Consumer HARUS review dan update → upgrade perlu perencanaan
git tag v2.0.0

# Eksak — hanya versi tertentu (terlalu ketat untuk production)
module "vpc" {
  source = "terraform-aws-modules/vpc/aws"
  version = "5.1.2"  # Tidak akan pernah auto-update
}

# Pessimistic — patch update saja (recommended untuk stability)
module "vpc" {
  source = "terraform-aws-modules/vpc/aws"
  version = "~> 5.1"  # >= 5.1.0, < 5.2.0
}

# Minor update — termasuk minor dan patch
module "vpc" {
  source = "terraform-aws-modules/vpc/aws"
  version = ">= 5.1.0, < 6.0.0"  # Semua 5.x tapi bukan 6.0
}

# Untuk module internal (di kontrol kamu sendiri):
module "app" {
  source  = "./modules/app"
  version = "~> 2.1"  # Boleh patch update
}

# Untuk module eksternal (tidak kamu kontrol):
module "vpc" {
  source  = "terraform-aws-modules/vpc/aws"
  version = "~> 5.0"  # Lebih ketat — hanya patch
}

# Untuk provider (stabilitas sangat penting):
terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 5.0"  # Pessimistic ~> untuk stability
    }
  }
}

# Cek versi yang tersedia
terraform providers lock -platform=linux_amd64
# Generate lock file untuk konsistensi cross-platform

# Update provider ke versi terbaru
terraform init -upgrade
# Hati-hati: bisa mengubah behavior

# Di dalam module, JANGAN pin provider version
# Biarkan root module yang menentukan

# Module (modules/networking/main.tf):
terraform {
  required_providers {
    aws = {
      source = "hashicorp/aws"
      # JANGAN tentukan version di sini
      # Biarkan root module menentukan
    }
  }
}

# Root module (main.tf):
terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 5.0"  # Version ditentukan di root
    }
  }
}

# .terraform.lock.hcl — commit ke version control
# File ini memastikan semua developer dan CI/CD
# menggunakan versi provider yang sama

# Generate lock file untuk multiple platforms
terraform providers lock   -platform=linux_amd64   -platform=darwin_arm64   -platform=windows_amd64

# Update provider ke versi terbaru
terraform init -upgrade

# Review perubahan lock file
git diff .terraform.lock.hcl

# OPERATORS:
# =  (exact):    version = "5.0.0"
# != (exclude):  version != "5.0.0"
# >  (gt):       version > "5.0.0"
# >= (gte):      version >= "5.0.0"
# <  (lt):       version < "6.0.0"
# <= (lte):      version <= "5.5.0"
# ~> (pessimistic): version ~> "5.0" (allows 5.x but not 6.0)

# CONTOH:
# ~> 5.0  = >= 5.0, < 6.0
# ~> 5.1  = >= 5.1, < 6.0
# >= 5.0, < 6.0  = sama dengan ~> 5.0

# BEST PRACTICE:
# Module di registry:  gunakan ~> untuk minor version
# Provider:            gunakan ~> untuk major version
# Internal module:     pin exact version