Convex

Convex kobles til med et team-tilgangstoken opprettet i Convex-dashbordet. Et team-tilgangstoken er avgrenset til nøyaktig ett team, så ett token kobler til ett team. Tokener krypteres før de lagres, og agenten ser dem aldri.

1. Åpne Convex-dashbordet, gå til Team Settings → Access Tokens.
2. Klikk på Create access token og kopier tokenverdien.
3. Lim tokenet inn i Polylane.
4. Polylane validerer tokenet og begynner å synkronisere.

Polylane oppdager prosjektene dine og, innenfor hvert av dem, sky-deploymentene deres: produksjonsdeploymenten pluss eventuelle forhåndsvisnings-, utviklings- og egendefinerte deploymenter, med regioner, URL-er og deployment-klasser.

Team-tilgangstokener gir administrasjonstilgang til teamet. Synkroniseringen leser prosjektene og deploymentene dine med team-tokenet. Når agenten eller bakgrunnsovervåkingen leser en deployments funksjonslogger eller metrikker, lager Polylane en kortlivet deploy key avgrenset til bare den lesingen (loggvisning eller metrikkvisning), bruker den til det ene kallet og sletter den umiddelbart etterpå, så hver nøkkel lever bare så lenge som lesingen den tjener. Alt Polylane leser, ligger på administrasjonsflaten: prosjekt- og deployment-lister, funksjonslogger og deployment-metrikker.

Feilsøking

Feilen «Not a team access token»

• Prosjektavgrensede tokener og deploy keys kan ikke liste teamets prosjekter; opprett tokenet under Team Settings → Access Tokens.
• Sjekk at tokenet ikke er slettet i Convex-dashbordet.

Manglende ressurser

• Lokale deploymenter kjører på individuelle utviklermaskiner og synkroniseres med hensikt ikke.
• Et prosjekt opprettet uten en deployment viser ingen deploymenter før den første deployen.
• Utløs en manuell synkronisering for å oppdatere før neste planlagte gjennomgang.

Revisjonslogger

• Convex legger revisjonslogg-API-et sitt bak betalte planer. På et gratis team returnerer lesing av revisjonslogger en tydelig feil, og agenter faller tilbake på funksjonslogger og kontekstgrafen.

Frakobling

Koble kontoen fra i Polylane, og slett så tilgangstokenet fra Convex-teaminnstillingene dine.

Å koble til Convex trenger ingen nettleser: det samme endepunktet konsollen kaller, passer i en CI-jobb. Én autentisert POST oppretter tilkoblingen og starter den første synkroniseringen.

Forutsetninger

• En Polylane-API-nøkkel med omfangene cloud_accounts:write og cloud_accounts:read. Se API-nøkler og OAuth.
• Workspace-ID-en din, som starter med ws_. Les den fra GET /v1/workspaces med den samme nøkkelen.
• Et Convex-team-tilgangstoken fra Team Settings → Access Tokens.

Opprett tilkoblingen

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

Et team-tilgangstoken er avgrenset til nøyaktig ett team, så ett kall kobler til ett team.

Svaret lister hva som ble koblet til, med den første synkroniseringen allerede i gang. Trimmet til de to feltene resten av flyten leser:

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

En konto som allerede er tilkoblet, lander i failures i stedet for accounts, så å gjenta kallet dupliserer aldri en tilkobling.

Vent på den første synkroniseringen

Spør etter hver returnert konto på id-en dens til status når ready (new ved registrering, syncing mens ressurser strømmer inn):

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

Gi løkken en frist slik at en feilet tilkobling får jobben til å feile i stedet for å henge. Når kontoen er ready, er ressursene dens i topologien, og Polylane har startet sin første sjekk.

Koble fra via API-et

Å slette tilkoblingen stopper hver synkronisering og sjekk og sletter legitimasjonen Polylane hadde. Kallet trenger omfanget cloud_accounts:delete:

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

Trekk så tilbake Convex-legitimasjonen på leverandørsiden, som beskrevet under Koble fra nedenfor.