Terraform State Nedir ve Neden Bu Kadar Önemli?

Terraform'a yeni başlayanların en çok kafasının karıştığı konu state'tir. Oysa Terraform'un tüm mantığı buna dayanır: state, Terraform'un gerçek dünyada ne oluşturduğunu hatırladığı defterdir.

State tam olarak nedir?

terraform apply çalıştırdığında Terraform, oluşturduğu her kaynağın kimliğini (ID'sini) ve özniteliklerini bir JSON dosyasına (terraform.tfstate) yazar. Bir sonraki plan/apply'da, kodundaki 'istenen durum' ile state'teki 'mevcut durumu' karşılaştırıp aradaki farkı hesaplar.

State olmasaydı Terraform, bir AWS instance'ının senin mi yönettiğin yoksa başka birinin mi oluşturduğunu bilemezdi. State, kod ile gerçek altyapı arasındaki köprüdür.

Neden yerel state tehlikelidir?

• Ekipteki herkeste farklı bir state kopyası olur → çakışma ve kaynak silinmesi.
• State dosyası kaybolursa Terraform altyapını 'tanımaz' hale gelir.
• State içinde parolalar/gizli anahtarlar düz metin olarak durabilir — laptop'ta güvensiz.

Çözüm: uzak state + kilit (locking)

Üretimde state'i uzak bir backend'de tut (S3, GCS, Terraform Cloud). Kilit mekanizması, aynı anda iki kişinin apply çalıştırıp state'i bozmasını engeller.

terraform {
  backend "s3" {
    bucket         = "sirket-terraform-state"
    key            = "prod/network.tfstate"
    region         = "eu-west-1"
    dynamodb_table = "terraform-locks"  # kilit için
    encrypt        = true
  }
}

State'i bozmadan yönetmek

• Asla terraform.tfstate'i elle düzenleme.
• Kaynağı yeniden adlandırırken 'terraform state mv' kullan.
• Elle oluşturulmuş bir kaynağı Terraform'a devretmek için 'terraform import' kullan.
• State'i her zaman versiyonlanan ve şifrelenen bir backend'de tut.

Vaka: 'state lock' çakışması ve drift

İki gerçek olay ve çözümü. Önce: bir arkadaşının apply'ı yarıda kaldı, seninki 'state locked' diye hata veriyor.

$ terraform apply
Error: Error acquiring the state lock
  Lock Info: ID: 8f3c...  Who: ci@runner  Created: 2 min ago
# Önce SAHİBİNİ teyit et (CI hâlâ çalışıyor olabilir!). Emin ol, sonra:
$ terraform force-unlock 8f3c...
Terraform state has been successfully unlocked!   # ✓ kilit açıldı

Drift: kod ile gerçek altyapı ayrıştı

1. 1terraform plan → beklenmedik değişiklikler mi çıkıyor? (biri konsoldan elle değiştirmiş)
2. 2terraform refresh yerine plan çıktısını oku: fark nerede?
3. 3Elle yapılan doğruysa kodu güncelle; değilse apply ile geri al
4. 4Hiç yönetilmeyen bir kaynağı devral: terraform import

$ terraform plan
  ~ aws_security_group.web  ingress: [80] -> [80, 22]   # biri elle 22'yi açmış
# Karar: 22 istenmiyorsa apply ile geri al; isteniyorsa kodda tanımla.
$ terraform import aws_s3_bucket.assets my-existing-bucket
Import successful!   # ✓ elle kurulmuş bucket artık state'te

State'i anladığında Terraform gizemini yitirir ve güçlü bir araca dönüşür. Cloudpuz'daki Terraform lab'larında bu kavramları gerçek bir uzak backend üzerinde uygularsın.