· kaynak Hacker News – Front Page (native)
Rehber, gerçek altyapıya dokunmadan önce hataları yakalamak için Terraform apply'ı AWS'nin Emulator'üne karşı çalıştırıyor
Hacker News ana sayfasına çıkan bir rehber, apply aşamasındaki hataları canlı altyapıya ulaşmadan önce yakalamak için Terraform plan ve apply işlemlerini, gerçek AWS API'lerinin yerel bir ikamesi olan AWS Emulator'üne karşı çalıştırıyor.

Hacker News ana sayfasına ulaşan uygulamalı bir rehber, gerçek bir hesaba dokunmadan önce Terraform apply işlemlerini AWS'nin yerel bir ikamesi üzerinde provadan geçirmeyi gösteriyor. notes.hatedabamboo.me'de yayımlanan yazı, yazara göre AWS'nin yakın zamanda gerçek AWS API endpoint'lerini taklit etmek için piyasaya sürdüğü Emulator'ü kullanıyor.
Başlangıç noktası tanıdık bir başarısızlık senaryosu: plan job'u yeşil geçiyor, apply job'u ardından değiştirilemeyen bir kaynakla ilgili muğlak bir hatayla düşüyor ve çözüm başka bir pull request ve bir tur daha beklemek anlamına geliyor.
Plan ile apply arasındaki uçurum
Yazıda açıklandığı gibi, terraform plan statik tanımlamalarla çalışıyor — beklenen uygulama sırası, gerekli parametreler ve konfigürasyon değerleri — ve çatışmaları ortaya çıkaracak canlı API çağrılarını yapamıyor. Konfigürasyonda adı geçen bir bucket'ın hesapta zaten mevcut olduğunu ya da PostgreSQL RDS'nin 14 sürümünden 18 sürümüne yükseltmesinin açık bir apply-immediately bayrağı olmadan başarısız olacağını bilebilmesi mümkün değil. Manuel olarak gerçek bir ortama apply yapmak alışılagelmiş bir çözüm, ancak yazar buna bu yöntemin otomatik bir iş akışının amacını ortadan kaldırdığını savunuyor.
Yazıya göre mevcut araçlar AWS servislerini kısmen veya tamamen taklit edebiliyor, ancak her servisin mimarisine dair gerçek bilgiden yoksunlar ve bu küçük farklar kendi başlarına sorunlara yol açabiliyor. Emulator'ün vaadi özünde AWS API'nin kendisi olmak, yalnızca geçici olarak.
Üç aşamalı bir iş akışı
Emulator, kendi başına çalışan bir binary ya da Docker container olarak geliyor ve yerel olarak ya da CI içinde çalışabiliyor. Bu, alışılmış plan-sonra-apply hattını şöyle dönüştürüyor: önce plan, ardından planı test etmek için emüle edilen AWS'ye apply, en sonunda gerçek altyapıya apply. Job'lar bir miktar uzuyor, bunu yazar kabul ediyor; ancak pull request sonrası apply'lar main branch'e yapılan commit'lerde çalıştığında, provası yapılan bu adım sadece bir hatayı düzeltmek için düzeltme branch'i açmayı önlüyor.
Yerel olarak çalıştırma
Rehber imajı Docker ile derliyor — yaklaşık 1.24GB ağırlığında olduğuna dikkat çekiyor — ve -a off bayrağıyla istek doğrulaması kapatılarak 9297 portunu dinleyen bir container başlatıyor. Başlangıç çıktısı dikkat edilmesi gereken uyarılar içeriyor: auth kapalıyken emulator imzalı olsun ya da olmasın her isteği kabul ediyor ve varsayılan olarak 0.0.0.0'a bağlanıyor, yani porta erişebilen her makine onu çağırabiliyor. Emulator ayrıca varsayılan olarak kullanım ve hata telemetrisi topluyor; EMULATOR_TELEMETRY=off veya config dosyasıyla kapatılabiliyor. Yazıda atıf yapılan AWS dokümantasyonu, container için 2GB bellek ve swap sınırı öneriyor. /__admin/health endpoint'ine yapılacak bir curl, servisin ayakta olduğunu doğruluyor.
Terraform'u ona yönlendirmek
Terraform tarafında provider block'u birkaç küçük düzenleme gerektiriyor. Emulator HTTPS'yi kendi imzaladığı bir sertifikayla sunduğundan, insecure = true doğrulamayı atlıyor; s3_use_path_style = true bucket adlarını yola taşıyor çünkü emulator tek bir endpoint kullanıyor. Skip bayrakları kimlik bilgisi doğrulamasını, metadata API'sini, hesap ID isteklerini ve bölge doğrulamasını devre dışı bırakıyor; böylece hiçbir şey gerçek AWS'ye çağrı yapmıyor. Kullanılan her servis — örnek EC2, Lambda, IAM, STS, CloudWatch, logs, events ve SNS'yi kapsıyor — emulator'ün yerel adresini gösteren bir endpoints override'ı alıyor.
Bu bağlantılar tamamlandığında, yazarın 15 kaynaklık örnek yığını — bir Lambda fonksiyonu, bir SNS topic'i, bir CloudWatch alarmı, bir events rule ve bilinen VPC parçalarını kapsıyor — hem plan hem apply'ı sorunsuz tamamlıyor ve çıktılarda ARN'lerde sıfırlardan oluşan hesap ID'si gibi yer tutucu tarzı tanımlayıcılar döndürüyor. Öne çıkan bir kaba kenar var: çalışan container aldığı API isteklerini loglamıyor, dolayısıyla perde arkasında neler olduğuna dair görünürlük sınırlı.
Neden önemli
Temiz bir plan ile başarısız bir apply arasındaki mesafe, infrastructure-as-code çalışmasında tekrar eden bir maliyet — başarısız pipeline çalışmaları, takip branch'leri ve geciken dağıtımlarla ölçülüyor. API'ye sadık bir emulator bu keşfi daha erken bir noktaya taşıyor: sıralama ve parametre doğrulaması dahil tam apply yolu, bulut harcaması ya da etki alanı olmadan sınanabiliyor ve tümü sıradan bir container olarak CI içine sığıyor. Rehberdeki uyarılar — varsayılan olarak açık telemetri, gevşek ağ ve doğrulama varsayılanları, 1.24GB'lık imaj ve istek loglamasının olmayışı — genç bir araca işaret ediyor; ama geçici ve gerçek AWS API'lerine karşı apply provası yapma desenini, plan-yeşil, apply-kırmızı döngüsüne sıkışmış ekiplerin takip etmek isteyeceği bir yaklaşım.
- #terraform
- #aws
- #infrastructure-as-code
- #devops
- #testing