Trigger.dev

1. Åpne i Trigger.dev miljøets side API Keys og opprett en nøkkel med forhåndsinnstillingen "No restrictions".
2. Lim nøkkelen inn i Polylane og trykk på Connect. Nøkkelen navngir selv sitt prosjekt og sitt miljø, så det er ikke noe mer å skrive inn.

Polylane kartlegger miljøet, dets deployment, oppgaver, tidsplaner og køer. En oppgave sett i kjøringer, men som mangler i gjeldende versjon, blir på kartet og flagges. Nøkler krypteres, og agenten ser dem aldri.

Deploy- og varsel-webhooks

Trigger.devs webhook-varsler åpner en sak ved en mislykket kjøring og løser deployment-varsler ved neste suksess. Ett varsel per miljø:

1. Legg til på miljøets Alerts-side et webhook-varsel med URL-en fra kontoens Settings under Webhooks og hendelsene "Task run failure", "Deployment failure" og "Deployment success".
2. Lim signeringshemmeligheten Trigger.dev viser én gang inn i samme Webhooks-kort.

Feilsøking

"Polylane needs a key created with the 'No restrictions' preset"

• Nøkler med Trigger only, Observer, Deploy only, Task operator og Variables only kan ikke brukes: Polylane leser prosjektets identitet gjennom et endepunkt som bare en "No restrictions"-nøkkel kan kalle. Opprett en "No restrictions"-nøkkel på miljøets API Keys-side og koble den til.

"Trigger.dev did not recognize this key"

• Sjekk at nøkkelen ble kopiert i sin helhet og ikke er trukket tilbake.

"Dev keys only work while trigger dev runs" og "Preview keys are per branch and not supported"

• Bruk en prod- eller staging-nøkkel.

Manglende ressurser

• "Sync" i kontoens topptekst oppdaterer før neste 15-minutters gjennomgang.

Frakobling

Koble fra i Polylane, og slett så nøkkelen på miljøets side API Keys.

Å koble til Trigger.dev 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.
• En miljøhemmelig nøkkel fra Trigger.dev (tr_prod_sk_… eller tr_stg_sk_…) fra prosjektets prod- eller staging-miljø, under API Keys. Opprett den med forhåndsinnstillingen No restrictions: Polylane leser prosjektets identitet gjennom et endepunkt som bare en "No restrictions"-nøkkel kan kalle, så nøkler med Trigger only, Observer, Deploy only, Task operator og Variables only avvises, og det samme gjør dev- og preview-nøkler.

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": "triggerdev",
    "workspaceId": "ws_0abc123",
    "apiKey": "<environment-secret-key>"
  }'

Nøkkelen navngir selv sitt prosjekt og sitt miljø, og en nøkkel tilhører nøyaktig ett miljø, så ett kall kobler til ett miljø: en prod-nøkkel kobler til produksjon og en staging-nøkkel kobler til staging, hver som sin egen konto. Å sende en nøkkel for et miljø som allerede er tilkoblet, erstatter kontoens nøkkel. Det finnes ingen miljøbryter å sette. Å koble til et miljø er slik du velger å overvåke det.

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": "triggerdev",
    "accounts": [{ "id": "acc_34gky74ibc92h8t2efn8csrh", "status": "syncing" }],
    "failures": []
  }
}

En nøkkel som API-et avviser, lander i failures i stedet for accounts, med en melding som sier hvorfor, 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 Trigger.dev-nøkkelen på leverandørsiden, som beskrevet under Koble fra nedenfor.