Fly.io

Fly.io łączy się tokenem API z twojego panelu. Użyj najbardziej restrykcyjnego typu tokenu: Polylane potrzebuje tylko dostępu do odczytu. Twój token jest szyfrowany przed zapisaniem, a agent nigdy go nie widzi.

Konfiguracja

1. Otwórz Fly.io Dashboard i przejdź do Tokens.
2. Utwórz nowy token tylko do odczytu.
3. Skopiuj token i wklej go do Polylane.
4. Polylane weryfikuje token i zaczyna synchronizację.

Polylane odkrywa twoje aplikacje, maszyny, wolumeny, certyfikaty i inne zasoby Fly.io.

Typy tokenów

Odłączanie

Odłącz konto w Polylane, a potem odwołaj token w swoim panelu Fly.io w Tokens.

Połączenie Fly.io nie potrzebuje przeglądarki: ten sam punkt końcowy, który wywołuje konsola, mieści się w zadaniu CI. Jeden uwierzytelniony POST tworzy połączenie i uruchamia pierwszą synchronizację.

Wymagania wstępne

• Klucz API Polylane z zakresami cloud_accounts:write i cloud_accounts:read. Zobacz Klucze API i OAuth.
• Identyfikator twojego obszaru roboczego, zaczynający się od ws_. Odczytaj go z GET /v1/workspaces tym samym kluczem.
• Token API Fly.io tylko do odczytu, utworzony w Tokens w panelu Fly.io.

Utwórz połączenie

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 odpowiada jednej organizacji Fly.io, więc jedno wywołanie łączy jedną organizację.

• Odkrywanie organizacji czyta aplikacje widoczne dla tokenu, więc token, który nie sięga do żadnej aplikacji, kończy się błędem 400.

Odpowiedź wymienia, co zostało połączone, z już działającą pierwszą synchronizacją. Przycięta do dwóch pól, które czyta reszta przepływu:

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

Konto, które jest już połączone, trafia do failures zamiast do accounts, więc powtórzenie wywołania nigdy nie duplikuje połączenia.

Poczekaj na pierwszą synchronizację

Odpytuj każde zwrócone konto po jego id, aż status osiągnie ready (new po rejestracji, syncing w trakcie napływu zasobów):

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

Daj pętli termin, aby nieudane połączenie kończyło zadanie błędem zamiast je zawieszać. Gdy konto jest ready, jego zasoby są w topologii, a Polylane uruchomiło pierwszą kontrolę.

Odłącz przez API

Usunięcie połączenia zatrzymuje każdą synchronizację i kontrolę oraz usuwa poświadczenia, które Polylane przechowywało. Wywołanie wymaga zakresu cloud_accounts:delete:

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

Potem odwołaj poświadczenie Fly.io po stronie dostawcy, jak opisano poniżej w sekcji Disconnect.