Gyro DNS'i API, gyro CLI ve Terraform ile yönetin

1. Hizmet numarası ve kimlik

Tüm DNS uçları Gyro DNS hizmet numaranızla çalışır: /cloud/dns/{id}/.... Bu numarayı müşteri panelindeki hizmet adresinde ya da hizmetin Yönetim → Bağlantı ve API sayfasında görürsünüz; o sayfadaki CLI ve Terraform örneklerinde numaranız hazır yazılıdır.

API listesinden de bulabilirsiniz: hizmet listesinde Gyro DNS hizmetleri product_line: "dns" ile döner.

Anahtarı ortam değişkenine koyun:

read -rs GYRO_TOKEN && export GYRO_TOKEN

2. Uç listesi

Tam alan listesi ve yanıt örnekleri: geliştirici belgeleri ("Managed DNS" bölümü).

3. API ile (curl)

Bir kayıt kümesi yazın. Aynı ad ve tipte küme varsa tamamen değiştirilir:

curl -s -X PUT "https://www.gyrohosting.com/api/v1/client/cloud/dns/12345/zones/ornekfirma.com/records" \
  -H "Authorization: Bearer $GYRO_TOKEN" -H "Content-Type: application/json" \
  -d '{"name":"www","type":"A","ttl":300,"records":["203.0.113.10","203.0.113.11"]}'

• name: zone'a göre ad (@ kök, * joker) ya da sonu noktalı tam ad.
• records: her değer ayrı öğe, zone dosyası yazımıyla (MX için "10 mx1.ornekfirma.com."; TXT'de tırnak isteğe bağlı).

Kayıt kümesini silin:

curl -s -X DELETE "https://www.gyrohosting.com/api/v1/client/cloud/dns/12345/zones/ornekfirma.com/records?name=www&type=A&confirm=true" \
  -H "Authorization: Bearer $GYRO_TOKEN"

Zone ekleyin (ad sunucuları zaten Gyro DNS'teyse hemen yayına girer; değilse yanıttaki txt_name ve txt_value ile doğrulayın):

curl -s -X POST "https://www.gyrohosting.com/api/v1/client/cloud/dns/12345/zones" \
  -H "Authorization: Bearer $GYRO_TOKEN" -H "Content-Type: application/json" \
  -d '{"name":"ornekfirma.com"}'

4. gyro CLI ile

gyro aracını kurmadıysanız: gyro CLI kurulumu ve ilk komutlar. DNS komutları dört grupta durur (v1.5.0 ve sonrası):

Örnekler (12345 = Gyro DNS hizmet numaranız):

gyro dns zone list 12345
gyro dns zone create 12345 --name ornekfirma.com
gyro dns rrset set 12345 ornekfirma.com --name www --type A --ttl 300 --records 203.0.113.10,203.0.113.11
gyro dns rrset set 12345 ornekfirma.com --name @ --type MX --records "10 mx1.ornekfirma.com."
gyro dns rrset delete 12345 ornekfirma.com --name www --type A --yes
gyro dns zone export 12345 ornekfirma.com -o text --query bind > ornekfirma.com.zone
gyro dns dnssec enable 12345 ornekfirma.com
gyro dns health create 12345 --zone ornekfirma.com --name @ --type A \
  --primary 203.0.113.10 --backup 198.51.100.20 --check https --port 443 --path /saglik --ttl 60

• Silme, kapatma ve içe aktarma komutları onay sorar; betiklerde --yes ekleyin (içe aktarmada gyro 1.5.1 ve sonrası gerekir; gyro version --check ile sürümünüze bakın, eskiyse kurulum komutunu yeniden çalıştırın).

• --records virgülle ayrılmış birden çok değer alır. Değerin kendisinde virgül varsa (ör. bazı TXT kayıtları) --data '{"name":"@","type":"TXT","records":["..."]}' ile JSON gövde verin.

• Zone dosyası içe aktarma:

  bash

  gyro dns zone import 12345 ornekfirma.com --bind "$(cat ornekfirma.com.zone)" --mode merge --yes
  

• --mode merge dosyadaki kayıtları ekler/değiştirir, diğerlerine dokunmaz; --mode replace dosyada olmayanları siler.

5. Terraform ile

Gyro sağlayıcısının 0.5.0 ve üstü gyro_dns_zone ve gyro_dns_record kaynaklarını içerir. Sağlayıcıyı ilk kez kullanıyorsanız: Terraform ile Gyro Bulut.

terraform {
  required_providers {
    gyro = {
      source  = "gyro-hosting/gyro"
      version = ">= 0.5.0"
    }
  }
}

provider "gyro" {}   # anahtarı GYRO_TOKEN ortam değişkeninden okur

resource "gyro_dns_zone" "ornek" {
  service_id = 12345           # Gyro DNS hizmet numaranız
  name       = "ornekfirma.com"
  dnssec     = true
}

resource "gyro_dns_record" "www" {
  service_id = gyro_dns_zone.ornek.service_id
  zone       = gyro_dns_zone.ornek.name
  name       = "www"
  type       = "A"
  ttl        = 300
  records    = ["203.0.113.10"]
}

resource "gyro_dns_record" "mx" {
  service_id = gyro_dns_zone.ornek.service_id
  zone       = gyro_dns_zone.ornek.name
  name       = "@"
  type       = "MX"
  records    = ["10 mx1.ornekfirma.com."]
}

output "ad_sunuculari" { value = gyro_dns_zone.ornek.nameservers }
output "dogrulama_txt" { value = "${gyro_dns_zone.ornek.verification_txt_name} = ${gyro_dns_zone.ornek.verification_txt_value}" }
output "ds"            { value = gyro_dns_zone.ornek.ds_records }

Bilmeniz gerekenler:

• gyro_dns_record için zone'un yayında olması gerekir. Zone status = "pending" iken önce ad sunucularını değiştirin ya da dogrulama_txt çıktısındaki TXT kaydını ekleyin; sonra terraform apply'ı yeniden çalıştırın.
• zone_file alanı yalnız zone ilk oluşturulurken bir kez içe aktarılır; sonraki değişiklikleri gyro_dns_record kaynaklarıyla yönetin.
• Mevcut zone ve kayıtları içe alma: terraform import gyro_dns_zone.ornek 12345/ornekfirma.com ve terraform import gyro_dns_record.www 12345/ornekfirma.com/www/A (kök için ad @).
• terraform destroy zone'u ve kayıtlarını ad sunucularımızdan hemen kaldırır.

6. Sınırlar

7. Sık hatalar

8. Sık sorulan sorular