Render

Render forbindes med en API-nøgle fra dine kontoindstillinger. Din nøgle krypteres, før den gemmes, og agenten ser den aldrig.

Opsætning

1. Åbn Render Dashboard, og gå til Account Settings → API Keys.
2. Klik på Create API Key.
3. Kopiér nøglen, og indsæt den i Polylane.
4. Polylane validerer nøglen og begynder at synkronisere.

Polylane opdager dine web services, private services, background workers, cron jobs, databaser og andre Render-ressourcer.

Fejlfinding

Fejlen "Invalid API key"

• Sørg for, at du kopierede hele nøglen (den begynder med rnd_).
• Kontrollér, at nøglen ikke er blevet tilbagekaldt i Renders dashboard.
• Bekræft, at du bruger en API-nøgle og ikke et deploy hook-token.

Manglende ressourcer

• Render kan bruge et par minutter på at synkronisere alt.
• Udløs en manuel Sync fra kontohovedet for at opdatere.

Afbrydelse

Afbryd kontoen i Polylane, og tilbagekald derefter API-nøglen fra dit Render-dashboard.

Forbindelse af Render 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.
• En Render-API-nøgle (begynder med rnd_) fra Account Settings → API Keys.

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": "render",
    "workspaceId": "ws_0abc123",
    "apiKey": "rnd_..."
  }'

Ét kald forbinder hvert Render-workspace, nøglen kan nå; angiv det valgfrie ownerId (usr-… eller tea-…) for kun at forbinde ét.

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": "render",
    "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 Render-legitimationen på udbyderens side, som beskrevet under Afbryd nedenfor.