Render

Render si collega con una chiave API dalle impostazioni del tuo account. La chiave viene cifrata prima di essere archiviata e l'agente non la vede mai.

Configurazione

1. Apri la Render Dashboard e vai su Account Settings → API Keys.
2. Fai clic su Create API Key.
3. Copia la chiave e incollala in Polylane.
4. Polylane convalida la chiave e avvia la sincronizzazione.

Polylane scopre i tuoi web service, private service, background worker, cron job, database e le altre risorse Render.

Risoluzione dei problemi

Errore "Invalid API key"

• Assicurati di aver copiato la chiave completa (inizia con rnd_).
• Verifica che la chiave non sia stata revocata nella dashboard di Render.
• Controlla di stare usando una chiave API e non un token di deploy hook.

Risorse mancanti

• Render può impiegare qualche minuto per sincronizzare tutto.
• Avvia una Sync manuale dall'intestazione dell'account per aggiornare.

Scollegamento

Scollega l'account in Polylane, poi revoca la chiave API dalla dashboard di Render.

Collegare Render 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.
• Una chiave API Render (inizia con rnd_) da Account Settings → API Keys.

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

Una sola chiamata collega ogni workspace Render che la chiave può raggiungere; passa il campo facoltativo ownerId (usr-… o tea-…) per collegarne uno solo.

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": "render",
    "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 Render sul lato del provider, come descritto sotto Scollega qui sotto.