Turso

O Turso se conecta com um token de API da plataforma:

1. Abra o Turso e vá à página API Tokens das configurações da sua conta, ou execute turso auth api-tokens mint polylane na CLI.
2. Copie o token de API da plataforma.
3. Cole o token no Polylane. Se o token puder alcançar mais de uma organização, escolha a que deseja conectar quando solicitado.
4. O Polylane valida o token e começa a sincronizar.

Cada conexão cobre uma única organização do Turso. O Polylane descobre seus grupos de bancos de dados e bancos de dados, incluindo localizações, posicionamento, parentesco de branching e status de leitura/escrita. Os tokens são criptografados antes de serem armazenados, e o agente nunca os vê. O Polylane lê apenas a Platform API; ele nunca se conecta aos seus bancos de dados e nunca guarda credenciais de banco de dados.

A Platform API do Turso reporta o uso como contadores cumulativos do período de cobrança, não como séries temporais, então os bancos de dados não trazem gráficos de métricas. O monitoramento consulta esses contadores e observa as variações: volume de leitura e escrita, tráfego de sincronização, crescimento do armazenamento, quantidade de bancos de dados, consumo de cota em relação ao seu plano e as consultas mais pesadas por banco de dados são comparados com o próprio histórico da conta.

Solução de problemas

Erro "Invalid Turso API token"

• Tokens de API da plataforma são diferentes dos tokens de autenticação de banco de dados; emita um com turso auth api-tokens mint ou nas configurações da sua conta.
• Confira se o token não foi revogado nas configurações do Turso.

Erro "Multiple Turso organizations are reachable"

• O token alcança mais de uma organização, então informe qual conectar.
• Conectando no console, escolha a organização quando solicitado após a validação.
• Conectando via API, defina o campo organization com o slug da organização.

Recursos ausentes

• O Turso pode levar alguns minutos para sincronizar tudo.
• Acione um Sync manual a partir do cabeçalho da conta para atualizar.

Desconectar

Desconecte a conta no Polylane, depois revogue o token de API nas configurações da sua conta no Turso ou com turso auth api-tokens revoke.

Conectar o Turso 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 da plataforma do Turso, emitido nas configurações da sua conta ou com turso auth api-tokens mint polylane.

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": "turso",
    "workspaceId": "ws_0abc123",
    "token": "<platform-api-token>",
    "organization": "my-org-slug"
  }'

Uma chamada conecta uma organização do Turso.

• organization só pode ser omitido quando o token alcança exatamente uma organização; caso contrário a chamada falha com um 400 que lista os slugs das organizações alcançáveis.

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": "turso",
    "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 Turso no lado do provedor, como descrito em Desconectar abaixo.