Fly.io

Fly.io panosundan alınan bir API tokenıyla bağlanır. En kısıtlayıcı token türünü kullan: Polylane yalnızca okuma erişimine ihtiyaç duyar. Tokenın saklanmadan önce şifrelenir ve ajan onu asla görmez.

Kurulum

1. Fly.io Dashboard'u aç ve Tokens'a git.
2. Yeni bir salt okunur token oluştur.
3. Tokenı kopyala ve Polylane'e yapıştır.
4. Polylane tokenı doğrular ve eşitlemeye başlar.

Polylane uygulamalarını, makinelerini, volume'larını, sertifikalarını ve diğer Fly.io kaynaklarını keşfeder.

Token türleri

Bağlantıyı kesme

Hesabın Polylane ile bağlantısını kes, sonra tokenı Fly.io panosunda Tokens altından iptal et.

Fly.io'yu bağlamak tarayıcı gerektirmez: konsolun çağırdığı aynı uç nokta bir CI işine sığar. Kimliği doğrulanmış tek bir POST bağlantıyı oluşturur ve ilk eşitlemeyi başlatır.

Ön koşullar

• cloud_accounts:write ve cloud_accounts:read kapsamlı bir Polylane API anahtarı. Bkz. API anahtarları ve OAuth.
• ws_ ile başlayan çalışma alanı kimliğin. Aynı anahtarla GET /v1/workspaces üzerinden oku.
• Fly.io panosunda Tokens altında oluşturulmuş salt okunur bir Fly.io API tokenı.

Bağlantıyı oluştur

curl -X POST https://api.polylane.com/v1/cloud_accounts \
  -H "x-api-key: $POLYLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "fly",
    "workspaceId": "ws_0abc123",
    "token": "<fly-api-token>"
  }'

Token tek bir Fly.io organizasyonuna çözümlenir, bu yüzden bir çağrı bir organizasyon bağlar.

• Organizasyon keşfi tokenın görebildiği uygulamaları okur, bu yüzden hiçbir uygulamaya ulaşamayan bir token 400 ile başarısız olur.

Yanıt, ilk eşitleme zaten çalışıyor halde neyin bağlandığını listeler. Akışın geri kalanının okuduğu iki alana kırpılmış hali:

{
  "success": true,
  "result": {
    "provider": "fly",
    "accounts": [{ "id": "acc_34gky74ibc92h8t2efn8csrh", "status": "syncing" }],
    "failures": []
  }
}

Zaten bağlı olan bir hesap accounts yerine failures içine düşer, bu yüzden çağrıyı yinelemek asla bir bağlantıyı çoğaltmaz.

İlk eşitlemeyi bekle

Döndürülen her hesabı id değeriyle, status değeri ready olana kadar yokla (kayıtta new, kaynaklar akarken syncing):

until [ "$(curl -s "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY" | jq -r '.result.status')" = "ready" ]; do
  sleep 15
done

Başarısız bir bağlama işi askıda bırakmak yerine başarısız kılsın diye döngüye bir son tarih ver. Hesap ready olduğunda kaynakları topolojidedir ve Polylane ilk kontrolünü başlatmıştır.

API'den bağlantıyı kes

Bağlantıyı silmek her eşitlemeyi ve kontrolü durdurur ve Polylane'in tuttuğu kimlik bilgilerini siler. Çağrı cloud_accounts:delete kapsamını gerektirir:

curl -X DELETE "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY"

Sonra Fly.io kimlik bilgisini, aşağıda Bağlantıyı kesme altında anlatıldığı gibi sağlayıcı tarafında iptal et.