Fly.io

Fly.io se connecte avec un token d'API depuis ton tableau de bord. Utilise le type de token le plus restrictif : Polylane n'a besoin que d'un accès en lecture. Ton token est chiffré avant d'être stocké, et l'agent ne le voit jamais.

Configuration

1. Ouvre le Fly.io Dashboard et va dans Tokens.
2. Crée un nouveau token en lecture seule.
3. Copie le token et colle-le dans Polylane.
4. Polylane valide le token et commence la synchronisation.

Polylane découvre tes apps, machines, volumes, certificats et autres ressources Fly.io.

Types de tokens

Déconnexion

Déconnecte le compte dans Polylane, puis révoque le token depuis ton tableau de bord Fly.io sous Tokens.

Connecter Fly.io ne nécessite aucun navigateur : le même point d'accès que la console appelle tient dans un job de CI. Un seul POST authentifié crée la connexion et démarre la première synchronisation.

Prérequis

• Une clé API Polylane avec les scopes cloud_accounts:write et cloud_accounts:read. Voir Clés API et OAuth.
• L'identifiant de ton espace de travail, qui commence par ws_. Lis-le depuis GET /v1/workspaces avec la même clé.
• Un token d'API Fly.io en lecture seule, créé sous Tokens dans le tableau de bord Fly.io.

Créer la connexion

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

Le token correspond à une seule organisation Fly.io, donc un appel connecte une organisation.

• La découverte de l'organisation lit les apps que le token peut voir, donc un token qui n'atteint aucune app échoue avec un 400.

La réponse liste ce qui a été connecté, avec la première synchronisation déjà en cours. Réduite aux deux champs que le reste du flux lit :

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

Un compte déjà connecté atterrit dans failures au lieu de accounts, donc répéter l'appel ne duplique jamais une connexion.

Attendre la première synchronisation

Interroge chaque compte renvoyé par son id jusqu'à ce que status atteigne ready (new à l'enregistrement, syncing pendant que les ressources arrivent) :

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

Donne une échéance à la boucle pour qu'une connexion échouée fasse échouer le job au lieu de le bloquer. Une fois que le compte est ready, ses ressources sont dans la topologie et Polylane a démarré sa première vérification.

Déconnecter depuis l'API

Supprimer la connexion arrête chaque synchronisation et chaque vérification et supprime les identifiants que Polylane détenait. L'appel nécessite le scope cloud_accounts:delete :

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

Révoque ensuite l'identifiant Fly.io côté fournisseur, comme décrit sous Disconnect ci-dessous.