İçeriğe geç
0850 554 5439 [email protected]

Size nasıl yardımcı olabiliriz?

Rehberlerimizde ve eğitimlerimizde arama yapın ya da aşağıdaki kategorilere göz atın.

Terraform ile Gyro: state'i Gyro depolamada tutmak, gizli değerler, ek hizmetler ve CLI profili

Geliştiriciler: API, CLI, Terraform 65 görüntülenme Kullanım rehberi Son doğrulama: Markdown
Bu rehberde ne öğreneceksinizTerraform state dosyasını Gyro depolamada kilitli ve sürümlü tutmayı, kapsayıcı gizli değerlerini state'e hiç yazmadan yönetmeyi, yeni bir sunucuyu Ağ Güvenlik Duvarı ekiyle tek apply'da kurmayı ve API anahtarını gyro CLI profilinden (işletim sistemi anahtar zinciri dahil) okutmayı.
Süre10 dakika
Kimin içinGyro altyapısını Terraform ile yöneten geliştiriciler ve DevOps ekipleri.
GerekenlerTerraform 1.11 ya da sonrası (secrets_wo için; state kilidi 1.10+), sağlayıcı gyro-hosting/gyro 0.37.0 ya da sonrası, state için bir Korumalı Depolama hizmeti ve erişim anahtarı.

1. State'i Gyro depolamada tutmak

Terraform'un s3 arka ucu (backend) iki Gyro depolama ürünüyle de çalışır. Fark state kilidindedir (use_lockfile): kilit, sunucunun koşullu yazmayı (If-None-Match: *) desteklemesini ister.

Uç nokta use_lockfile Eski state sürümleri
Korumalı Depolama (önerilen) https://s3-kilit.gyrohosting.com çalışır: ikinci apply "Error acquiring the state lock" ile durur saklanır (sürümleme her zaman açık)
Nesne Depolama https://s3.gyrohosting.com uygulanmaz: kullanmayın saklanmaz
hcl
terraform {
  backend "s3" {
    bucket    = "gyro-proje-tfstate"
    key       = "prod/terraform.tfstate"
    region    = "tr-ist-1"
    endpoints = { s3 = "https://s3-kilit.gyrohosting.com" }

    use_path_style              = true
    use_lockfile                = true
    skip_credentials_validation = true
    skip_region_validation      = true
    skip_requesting_account_id  = true
    skip_metadata_api_check     = true
    skip_s3_checksum            = true
  }
}

Erişim anahtarını ortam değişkeni olarak verin: export AWS_ACCESS_KEY_ID=… ve export AWS_SECRET_ACCESS_KEY=… (Korumalı Depolama hizmetinizin Erişim anahtarları sekmesinden, kovada okuma ve yazma izniyle). Ardından terraform init.

Dikkat

Nesne Depolama'da use_lockfile hata vermez ama kilidi uygulamaz; iki çalıştırma aynı anda state'i yazabilir. Nesne Depolama'yı yalnız tek bir CI işinin apply yaptığı durumda ve use_lockfile olmadan kullanın.

Bilgi

Kovaya nesne kilidi kuralı eklerseniz süreyi kısa tutun: state her apply'da yeniden yazılır ve kilitli sürümler süre dolana kadar silinemez.

2. Gizli değerleri state'e yazmadan yönetmek

gyro_container_service.secrets değerleri state'te durur. Terraform 1.11 ve sonrasında yalnız yazılır (write-only) argümanı kullanın: değerler plana ve state'e hiç girmez.

hcl
resource "gyro_container_service" "worker" {
  service_id         = gyro_container_environment.app.id
  name               = "worker"
  image              = "ghcr.io/gyro-proje/worker:1.0"
  secrets_wo         = { DB_PASSWORD = var.db_password, RABBITMQ_URL = var.rabbitmq_url }
  secrets_wo_version = 1
}
  • Değerler servis oluşurken ve secrets_wo_version her değiştiğinde gönderilir. Yeni değerleri göndermek için sürümü artırın (1 → 2).
  • Haritadan çıkardığınız anahtarlar silinir; gönderilen anahtar adları secrets_wo_keys içinde görünür (değerler değil).
  • secrets ile secrets_wo aynı serviste birlikte kullanılamaz. secrets'tan secrets_wo'ya geçerken anahtarlar arada silinmez.
  • İçe aktarılan (import) bir serviste ilk apply secrets_wo'yu bir kez gönderir.

3. Yeni sunucu + Ağ Güvenlik Duvarı tek apply'da

gyro_firewall ve gyro_server_security_groups sunucuda Ağ Güvenlik Duvarı ekinin açık olmasını ister. gyro_server_addon eki satın alır ve etkin olana kadar bekler:

hcl
resource "gyro_server_addon" "firewall" {
  service_id = tonumber(gyro_server.db.id)
  addon      = "Ağ Güvenlik Duvarı"     # ya da addon_id / option_id
}

resource "gyro_firewall" "db" {
  server_id      = tonumber(gyro_server.db.id)
  default_action = "deny"
  rule {
    action   = "allow"
    protocol = "tcp"
    port     = "22"
    source   = "203.0.113.10/32"
  }
  depends_on = [gyro_server_addon.firewall]
}
  • Ön ödemeli hizmetlerde (Gyro Bulut İstanbul, Kapsayıcı) ek saatlik olarak bakiyeden ücretlenir; destroy eki hemen kaldırır ve ücret durur.
  • Faturalı hizmetlerde fatura bakiyeden ödenir; destroy eki API'den iptal edemez, yalnız Terraform'dan çıkarır (panelden iptal edin).
  • Alınabilecek ekleri gyro service addons available <no> ile görebilirsiniz.
Bilgi

VPC kapısını (gateway_enabled = true) aynı yapılandırmada açıyorsanız hesapta önce bir ön ödemeli İstanbul sunucusu olmalıdır: gyro_vpc'ye depends_on = [gyro_server.<ad>] ekleyin.

4. API anahtarını gyro CLI profilinden okumak

GYRO_TOKEN ortam değişkeni yerine gyro CLI'nin kaydettiği profili kullanabilirsiniz:

hcl
provider "gyro" {
  profile = "default"   # ~/.config/gyro/config.toml içindeki profil
}
  • Profil gyro auth login ya da gyro configure ile oluşur. Anahtar işletim sistemi anahtar zincirinde saklandıysa (macOS Keychain, Windows Kimlik Bilgisi Yöneticisi, Linux Secret Service) sağlayıcı oradan okur.
  • Sıra: sağlayıcıdaki token > GYRO_TOKEN > profile (ya da GYRO_PROFILE, yoksa CLI'nin varsayılan profili).

5. 0.37.0 ile gelen diğer küçük özellikler

Kaynak Yenilik
gyro_vpc first_subnet_name, first_subnet_cidr: VPC ile açılan ilk subnetin adı ve aralığı (yalnız oluştururken)
gyro_port_forward name: yönlendirmeye ad (yerinde değişir, kapıya dokunmaz)
gyro_service_label manage_nickname = false: yalnız etiketleri yönetir; ad gyro_container_environment.name / gyro_storage.name ile kalır
gyro_server_agent misafir ajanını güncel tutar (eski sunucularda özel ağ ve public IP kapatma için gerekli)
gyro_container_registry_policy imaj deposu temizlik politikası (keep, untagged_days)

6. Sık sorulan sorular

State'i Nesne Depolama'da tutabilir miyim?

Tutabilirsiniz ama kilit uygulanmaz. Aynı anda birden çok apply olabilecekse Korumalı Depolama kullanın.

State dosyası eski sürüme dönebilir mi?

Korumalı Depolama'da her yazım önceki sürümü saklar; bozulan bir state'i kova sürümlerinden geri alabilirsiniz.

secrets_wo neden Terraform 1.11 istiyor?

Yalnız yazılır argümanlar Terraform 1.11 ile geldi. Daha eski sürümlerde secrets kullanın ve state'i kısıtlı erişimli bir arka uçta tutun.

gyro_server_addon ek hizmeti iki kez satın alır mı?

Hayır. Her apply tek istek gönderir ve isteğe benzersiz bir anahtar (Idempotency-Key) eklenir; ek kaynak state'te durduğu sürece yeniden alınmaz.

Sıradaki adım

Faydalı oldu mu?

Geri bildiriminiz için teşekkürler!

Hâlâ Yardıma mı İhtiyacınız Var?

Yukarıda bulamadığınız her şey için destek ekibimiz her zaman yanınızda.