Fly.io

Fly.io kobles til med et API-token fra dashbordet ditt. Bruk den mest begrensede tokentypen: Polylane trenger bare lesetilgang. Tokenet ditt krypteres før det lagres, og agenten ser det aldri.

Oppsett

1. Åpne Fly.io Dashboard og gå til Tokens.
2. Opprett et nytt skrivebeskyttet token.
3. Kopier tokenet og lim det inn i Polylane.
4. Polylane validerer tokenet og begynner å synkronisere.

Polylane oppdager appene, maskinene, volumene, sertifikatene og de andre Fly.io-ressursene dine.

Tokentyper

Frakobling

Koble kontoen fra i Polylane, og trekk så tilbake tokenet fra Fly.io-dashbordet ditt under Tokens.

Å koble til Fly.io trenger ingen nettleser: det samme endepunktet konsollen kaller, passer i en CI-jobb. Én autentisert POST oppretter tilkoblingen og starter den første synkroniseringen.

Forutsetninger

• En Polylane-API-nøkkel med omfangene cloud_accounts:write og cloud_accounts:read. Se API-nøkler og OAuth.
• Workspace-ID-en din, som starter med ws_. Les den fra GET /v1/workspaces med den samme nøkkelen.
• Et skrivebeskyttet Fly.io-API-token, opprettet under Tokens i Fly.io-dashbordet.

Opprett tilkoblingen

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>"
  }'

Tokenet løses til én Fly.io-organisasjon, så ett kall kobler til én organisasjon.

• Organisasjonsoppdagelsen leser appene tokenet kan se, så et token som ikke når noen apper, feiler med en 400.

Svaret lister hva som ble koblet til, med den første synkroniseringen allerede i gang. Trimmet til de to feltene resten av flyten leser:

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

En konto som allerede er tilkoblet, lander i failures i stedet for accounts, så å gjenta kallet dupliserer aldri en tilkobling.

Vent på den første synkroniseringen

Spør etter hver returnert konto på id-en dens til status når ready (new ved registrering, syncing mens ressurser strømmer inn):

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

Gi løkken en frist slik at en feilet tilkobling får jobben til å feile i stedet for å henge. Når kontoen er ready, er ressursene dens i topologien, og Polylane har startet sin første sjekk.

Koble fra via API-et

Å slette tilkoblingen stopper hver synkronisering og sjekk og sletter legitimasjonen Polylane hadde. Kallet trenger omfanget cloud_accounts:delete:

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

Trekk så tilbake Fly.io-legitimasjonen på leverandørsiden, som beskrevet under Koble fra nedenfor.