Convex

O Convex se conecta com um token de acesso de equipe criado no dashboard do Convex. Um token de acesso de equipe tem escopo em exatamente uma equipe, então um token conecta uma equipe. Os tokens são criptografados antes de serem armazenados, e o agente nunca os vê.

1. Abra o dashboard do Convex e vá em Team Settings → Access Tokens.
2. Clique em Create access token e copie o valor do token.
3. Cole o token no Polylane.
4. O Polylane valida o token e começa a sincronizar.

O Polylane descobre seus projetos e, dentro de cada um, seus deployments na nuvem: o deployment de produção mais quaisquer deployments de preview, desenvolvimento e personalizados, com suas regiões, URLs e classes de deployment.

Tokens de acesso de equipe concedem acesso de gerenciamento à equipe. A sincronização lê seus projetos e deployments com o token da equipe. Quando o agente ou o monitoramento em segundo plano lê os logs de função ou as métricas de um deployment, o Polylane emite uma deploy key de curta duração com escopo apenas naquela leitura (visualização de logs ou de métricas), usa-a para a única chamada e a exclui imediatamente depois, de modo que cada chave vive apenas enquanto durar a leitura que ela atende. Tudo o que o Polylane lê fica na superfície de gerenciamento: listagens de projetos e deployments, logs de função e métricas de deployment.

Solução de problemas

Erro "Not a team access token"

• Tokens com escopo de projeto e deploy keys não conseguem listar os projetos da equipe; crie o token em Team Settings → Access Tokens.
• Confira se o token não foi excluído no dashboard do Convex.

Recursos ausentes

• Deployments locais rodam nas máquinas de cada desenvolvedor e deliberadamente não são sincronizados.
• Um projeto criado sem deployment não mostra deployments até o primeiro deploy.
• Acione uma sincronização manual para atualizar antes da próxima passagem agendada.

Logs de auditoria

• O Convex restringe sua API de log de auditoria a planos pagos. Em uma equipe gratuita, leituras do log de auditoria retornam um erro claro e os agentes recorrem aos logs de função e ao grafo de contexto.

Desconectar

Desconecte a conta no Polylane, depois exclua o token de acesso nas configurações da sua equipe no Convex.

Conectar o Convex 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 acesso de equipe do Convex de Team Settings → Access Tokens.

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": "convex",
    "workspaceId": "ws_0abc123",
    "token": "<team-access-token>"
  }'

Um token de acesso de equipe tem escopo em exatamente uma equipe, então uma chamada conecta uma equipe.

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