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

https://www.gyrohosting.com/bilgi-bankasi/makale/terraform-state-ve-ileri-ozellikler

- **Bu rehberde ne öğreneceksiniz**: Terraform 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üre**: 10 dakika
- **Kimin için**: Gyro altyapısını Terraform ile yöneten geliştiriciler ve DevOps ekipleri.
- **Gerekenler**: Terraform 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 |

```
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.

```
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:

```
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:

```
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

- Temel kurulum: [Terraform ile Gyro Bulut sunucusu](https://www.gyrohosting.com/bilgi-bankasi/makale/terraform-ile-gyro-bulut)
- Komut satırı: [gyro CLI kurulumu ve ilk komutlar](https://www.gyrohosting.com/bilgi-bankasi/makale/gyro-cli-kurulum)
