Convex

Convex forbindes med et team-adgangstoken oprettet i Convex-dashboardet. Et team-adgangstoken er afgrænset til præcis ét team, så ét token forbinder ét team. Tokens krypteres, før de gemmes, og agenten ser dem aldrig.

1. Åbn Convex-dashboardet, og gå til Team Settings → Access Tokens.
2. Klik på Create access token, og kopiér tokenværdien.
3. Indsæt tokenet i Polylane.
4. Polylane validerer tokenet og begynder at synkronisere.

Polylane opdager dine projekter og, inden for hvert af dem, dets cloud-deployments: produktions-deploymentet plus eventuelle preview-, udviklings- og brugerdefinerede deployments, med deres regioner, URL'er og deployment-klasser.

Team-adgangstokens giver administrationsadgang til teamet. Synkronisering læser dine projekter og deployments med team-tokenet. Når agenten eller baggrundsovervågningen læser et deployments funktionslogs eller metrikker, udsteder Polylane en kortlivet deploy-nøgle afgrænset til netop den læsning (logvisning eller metrikvisning), bruger den til det ene kald og sletter den straks bagefter, så hver nøgle kun lever så længe som den læsning, den tjener. Alt, hvad Polylane læser, ligger på administrationsoverfladen: projekt- og deployment-lister, funktionslogs og deployment-metrikker.

Fejlfinding

Fejlen "Not a team access token"

• Projektafgrænsede tokens og deploy-nøgler kan ikke liste teamets projekter; opret tokenet under Team Settings → Access Tokens.
• Kontrollér, at tokenet ikke er blevet slettet i Convex-dashboardet.

Manglende ressourcer

• Lokale deployments kører på individuelle udviklermaskiner og synkroniseres med vilje ikke.
• Et projekt oprettet uden et deployment viser ingen deployments før det første deploy.
• Udløs en manuel synkronisering for at opdatere tidligere end den næste planlagte gennemgang.

Audit-logs

• Convex lægger sit audit-log-API bag betalte planer. På et gratis team returnerer læsning af audit-logs en klar fejl, og agenter falder tilbage til funktionslogs og kontekstgrafen.

Afbrydelse

Afbryd kontoen i Polylane, og slet derefter adgangstokenet fra dine Convex-teamindstillinger.

Forbindelse af Convex kræver ingen browser: det samme endpoint, konsollen kalder, passer ind i et CI-job. Én autentificeret POST opretter forbindelsen og starter den første synkronisering.

Forudsætninger

• En Polylane-API-nøgle med scopes cloud_accounts:write og cloud_accounts:read. Se API-nøgler og OAuth.
• Dit arbejdsområde-id, som begynder med ws_. Læs det fra GET /v1/workspaces med den samme nøgle.
• Et Convex-team-adgangstoken fra Team Settings → Access Tokens.

Opret forbindelsen

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-adgangstoken er afgrænset til præcis ét team, så ét kald forbinder ét team.

Svaret lister, hvad der blev forbundet, med den første synkronisering allerede i gang. Trimmet til de to felter, resten af flowet læser:

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

En konto, der allerede er forbundet, lander i failures i stedet for accounts, så gentagelse af kaldet duplikerer aldrig en forbindelse.

Vent på den første synkronisering

Poll hver returneret konto efter dens id, indtil status når ready (new ved registrering, syncing mens ressourcer strømmer ind):

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

Giv løkken en deadline, så en fejlet forbindelse får jobbet til at fejle i stedet for at hænge. Når kontoen er ready, er dens ressourcer i topologien, og Polylane har startet sin første kontrol.

Afbryd fra API'et

Sletning af forbindelsen stopper hver synkronisering og kontrol og sletter de legitimationsoplysninger, Polylane opbevarede. Kaldet kræver scopet cloud_accounts:delete:

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

Tilbagekald derefter Convex-legitimationen på udbyderens side, som beskrevet under Afbryd nedenfor.