Fly.io

O Fly.io se conecta com um token de API do seu dashboard. Use o tipo de token mais restritivo: o Polylane só precisa de acesso de leitura. Seu token é criptografado antes de ser armazenado, e o agente nunca o vê.

Configuração

1. Abra o Fly.io Dashboard e vá em Tokens.
2. Crie um novo token somente leitura.
3. Copie o token e cole-o no Polylane.
4. O Polylane valida o token e começa a sincronizar.

O Polylane descobre seus apps, machines, volumes, certificados e outros recursos do Fly.io.

Tipos de token

Desconectar

Desconecte a conta no Polylane, depois revogue o token no seu dashboard do Fly.io em Tokens.

Conectar o Fly.io não precisa de navegador: o mesmo endpoint que o console chama cabe em um job de CI. Um POST autenticado cria a conexão e inicia a primeira sincronização.

Pré-requisitos

• Uma chave de API do Polylane com os escopos cloud_accounts:write e cloud_accounts:read. Veja Chaves de API e OAuth.
• O ID do seu workspace, que começa com ws_. Leia-o em GET /v1/workspaces com a mesma chave.
• Um token de API somente leitura do Fly.io, criado em Tokens no dashboard do Fly.io.

Criar a conexão

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

O token resolve para uma organização do Fly.io, então uma chamada conecta uma organização.

• A descoberta da organização lê os apps que o token consegue ver, então um token que não alcança nenhum app falha com um 400.

A resposta lista o que foi conectado, com a primeira sincronização já em andamento. Reduzida aos dois campos que o restante do fluxo lê:

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

Uma conta que já está conectada aparece em failures em vez de accounts, então repetir a chamada nunca duplica uma conexão.

Aguardar a primeira sincronização

Consulte cada conta retornada pelo seu id até que status chegue a ready (new no registro, syncing enquanto os recursos chegam):

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

Dê um prazo ao loop para que uma conexão com falha faça o job falhar em vez de travá-lo. Quando a conta estiver ready, seus recursos estão na topologia e o Polylane já iniciou sua primeira verificação.

Desconectar pela API

Excluir a conexão interrompe todas as sincronizações e verificações e apaga as credenciais que o Polylane guardava. A chamada precisa do escopo cloud_accounts:delete:

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

Depois revogue a credencial do Fly.io no lado do provedor, como descrito em Desconectar abaixo.