Terraform ile Gyro: state'i Gyro depolamada tutmak, gizli değerler, ek hizmetler ve CLI profili
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 |
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.
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.
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.
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_versionher 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_keysiçinde görünür (değerler değil). secretsilesecrets_woaynı serviste birlikte kullanılamaz.secrets'tansecrets_wo'ya geçerken anahtarlar arada silinmez.- İçe aktarılan (import) bir serviste ilk
applysecrets_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:
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;
destroyeki hemen kaldırır ve ücret durur. - Faturalı hizmetlerde fatura bakiyeden ödenir;
destroyeki API'den iptal edemez, yalnız Terraform'dan çıkarır (panelden iptal edin). - Alınabilecek ekleri
gyro service addons available <no>ile görebilirsiniz.
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:
provider "gyro" {
profile = "default" # ~/.config/gyro/config.toml içindeki profil
}
- Profil
gyro auth loginya dagyro configureile 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 daGYRO_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
- Temel kurulum: Terraform ile Gyro Bulut sunucusu
- Komut satırı: gyro CLI kurulumu ve ilk komutlar
Geri bildiriminiz için teşekkürler!
