Migration #

# Langkah 2: Tambahkan backend configuration ke providers.tf atau backend.tf

# SEBELUM (tidak ada backend block — menggunakan local):
terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 5.0"
    }
  }
}

# SESUDAH (dengan remote backend):
terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 5.0"
    }
  }

  backend "s3" {
    bucket         = "my-terraform-state"
    key            = "production/terraform.tfstate"
    region         = "ap-southeast-1"
    dynamodb_table = "terraform-state-lock"
    encrypt        = true
  }
}

# Langkah 3: Jalankan init dengan flag migrate-state
terraform init -migrate-state

# Output:
# Initializing the backend...
# Do you want to copy existing state to the new backend?
#   Pre-existing state was found while migrating the previous "local" backend to
#   the newly configured "s3" backend. An existing non-empty state already exists
#   in the new backend. The two states have been merged. Please check the output
#   above to ensure this is correct before continuing.
#
#   Enter a value: yes

# Verifikasi state berhasil dipindahkan
terraform state list  # Harus menampilkan resource yang sama seperti sebelumnya

# Langkah 6: Hapus state lokal (setelah yakin remote state berhasil)
rm terraform.tfstate terraform.tfstate.backup

# Langkah 1: Pull state saat ini ke lokal sebagai backup
terraform state pull > state-backup-$(date +%Y%m%d-%H%M%S).tfstate

# Langkah 2: Update konfigurasi backend ke backend baru
# (edit backend.tf)

# Langkah 3: Jalankan init dengan migrate-state
terraform init -migrate-state

# Langkah 4: Verifikasi
terraform plan  # Seharusnya "No changes"

# Langkah 5: Simpan backup state di tempat yang aman
# Jangan hapus backup sampai yakin migrasi berhasil

# CARA MEMECAH STATE — menggunakan terraform state mv

# 1. Siapkan direktori baru untuk workspace compute
mkdir -p environments/production/compute
cd environments/production/compute

# Buat konfigurasi Terraform untuk compute resources
# (pindahkan resource yang relevan dari konfigurasi monolitik)

# 2. Inisialisasi workspace baru dengan remote backend yang berbeda
terraform init

# 3. Pindahkan resource dari state lama ke state baru
# (jalankan dari direktori monolitik)
cd ../  # kembali ke direktori monolitik

terraform state mv \
  -state-out=compute/terraform.tfstate \
  aws_instance.web[0] \
  aws_instance.web[0]

# Untuk banyak resource, gunakan script:
for i in 0 1; do
  terraform state mv \
    -state-out="../compute/terraform.tfstate" \
    "aws_instance.web[$i]" \
    "aws_instance.web[$i]"
done

# 4. Push state yang sudah dimodifikasi ke remote backend
cd ../compute
terraform state push terraform.tfstate

# 5. Verifikasi kedua workspace
terraform state list  # compute
cd ../networking
terraform state list  # networking

# SELALU backup state sebelum migrasi apapun

# Pull state terkini
terraform state pull > pre-migration-backup.tfstate

# Verifikasi backup bisa dibaca
cat pre-migration-backup.tfstate | python3 -m json.tool > /dev/null
echo "Backup valid: $?"

# Simpan di tempat aman (bukan hanya lokal)
aws s3 cp pre-migration-backup.tfstate \
  s3://my-backup-bucket/terraform-state-backups/$(date +%Y%m%d-%H%M%S).tfstate

# Jika migrasi menghasilkan state yang tidak benar:

# Opsi 1: Restore dari backup
terraform state push pre-migration-backup.tfstate
# PERHATIAN: Ini menimpa state saat ini dengan backup

# Opsi 2: Revert backend configuration
# - Hapus atau comment blok backend dari konfigurasi
# - Jalankan terraform init -reconfigure
# - Terraform kembali ke local state atau backend sebelumnya

# Opsi 3: Jika pakai S3 dengan versioning aktif
# Restore versi sebelumnya dari S3 console atau CLI
aws s3api list-object-versions \
  --bucket my-terraform-state \
  --prefix production/terraform.tfstate

aws s3api get-object \
  --bucket my-terraform-state \
  --key production/terraform.tfstate \
  --version-id VERSION_ID \
  restored-state.tfstate

# CHECKLIST SEBELUM MIGRASI STATE:

# 1. Backup state saat ini
terraform state pull > backup-$(date +%Y%m%d-%H%M%S).tfstate
ls -la backup-*.tfstate  # Verifikasi file ada dan ukurannya wajar

# 2. Pastikan tidak ada perubahan tertunda
terraform plan
# Harusnya "No changes" — jika ada, apply dulu atau resolve

# 3. Pastikan tidak ada lock aktif
terraform state pull  # Jika berhasil, tidak ada lock

# 4. Verifikasi tidak ada yang sedang bekerja
# Cek CI/CD pipeline, komunikasi dengan tim

# 5. Siapkan rollback plan
cp backup-*.tfstate emergency-rollback.tfstate

# Scenario: Pindah dari local ke S3

# 1. Konfigurasi backend baru (belum di-init)
terraform {
  backend "s3" {
    bucket = "my-terraform-state"
    key    = "prod/terraform.tfstate"
    region = "ap-southeast-1"
  }
}

# 2. Jalankan init — Terraform akan mendeteksi backend berubah
terraform init
# Output: "Backend configuration changed. Do you want to copy existing state?"
# Answer: yes

# 3. Terraform otomatis copy state dari local ke S3
# 4. Verifikasi: terraform plan harus "No changes"

# ROLLBACK jika ada masalah:
# 1. Ubah backend config kembali ke local
# 2. Jalankan terraform init
# 3. Copy state backup ke direktori lokal

# State file mengandung SEMUA informasi resource:
# - ID, ARN, IP address
# - Password, API keys (jika didefinisikan di Terraform)
# - Semua attribute dari semua managed resource

# JANGAN:
# - Commit state ke Git
# - Simpan di local filesystem untuk production
# - Share state file tanpa enkripsi

# HARUS:
# - Simpan di encrypted backend (S3+KMS, GCS, TFC)
# - Enable access logging
# - Restrict IAM access (hanya CI/CD role)