Convex

Convex si collega con un team access token creato nella dashboard di Convex. Un team access token è limitato a esattamente un team, quindi un token collega un team. I token vengono cifrati prima di essere archiviati e l'agente non li vede mai.

1. Apri la dashboard di Convex e vai su Team Settings → Access Tokens.
2. Fai clic su Create access token e copia il valore del token.
3. Incolla il token in Polylane.
4. Polylane convalida il token e avvia la sincronizzazione.

Polylane scopre i tuoi progetti e, in ciascuno, i suoi deployment cloud: il deployment di produzione più eventuali deployment di preview, sviluppo e personalizzati, con regioni, URL e classi di deployment.

I team access token concedono accesso di gestione al team. La sincronizzazione legge progetti e deployment con il token del team. Quando l'agente o il monitoraggio in background legge i log delle funzioni o le metriche di un deployment, Polylane genera una deploy key di breve durata limitata a quella sola lettura (vista dei log o vista delle metriche), la usa per quell'unica chiamata e la elimina subito dopo, così ogni chiave vive solo quanto la lettura che serve. Tutto ciò che Polylane legge sta sulla superficie di gestione: elenchi di progetti e deployment, log delle funzioni e metriche dei deployment.

Risoluzione dei problemi

Errore "Not a team access token"

• I token limitati a un progetto e le deploy key non possono elencare i progetti del team; crea il token sotto Team Settings → Access Tokens.
• Verifica che il token non sia stato eliminato nella dashboard di Convex.

Risorse mancanti

• I deployment locali girano sulle macchine dei singoli sviluppatori e non vengono sincronizzati di proposito.
• Un progetto creato senza deployment non mostra deployment fino al primo deploy.
• Avvia una sincronizzazione manuale per aggiornare prima del prossimo passaggio pianificato.

Log di audit

• Convex riserva l'API dei log di audit ai piani a pagamento. Su un team gratuito le letture dei log di audit restituiscono un errore chiaro e gli agenti ricorrono ai log delle funzioni e al grafo di contesto.

Scollegamento

Scollega l'account in Polylane, poi elimina l'access token dalle impostazioni del team in Convex.

Collegare Convex non richiede un browser: lo stesso endpoint che chiama la console sta in un job CI. Una sola POST autenticata crea il collegamento e avvia la prima sincronizzazione.

Prerequisiti

• Una chiave API Polylane con gli scope cloud_accounts:write e cloud_accounts:read. Vedi Chiavi API e OAuth.
• L'ID del tuo workspace, che inizia con ws_. Leggilo da GET /v1/workspaces con la stessa chiave.
• Un team access token Convex da Team Settings → Access Tokens.

Crea il collegamento

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

Un team access token è limitato a esattamente un team, quindi una sola chiamata collega un team.

La risposta elenca ciò che è stato collegato, con la prima sincronizzazione già in corso. Ridotta ai due campi che il resto del flusso legge:

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

Un account già collegato finisce in failures invece che in accounts, quindi ripetere la chiamata non duplica mai un collegamento.

Attendi la prima sincronizzazione

Interroga ogni account restituito tramite il suo id finché status non raggiunge ready (new alla registrazione, syncing mentre le risorse arrivano):

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

Dai al ciclo una scadenza, così un collegamento fallito fa fallire il job invece di bloccarlo. Una volta che l'account è ready, le sue risorse sono nella topologia e Polylane ha avviato il suo primo controllo.

Scollega dall'API

Eliminare il collegamento interrompe ogni sincronizzazione e ogni controllo ed elimina le credenziali che Polylane conservava. La chiamata richiede lo 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"

Poi revoca la credenziale Convex sul lato del provider, come descritto sotto Scollega qui sotto.