Railway

Railway kobles til via OAuth: klikk på Continue to Railway, autoriser lesetilgang på Railway, og du omdirigeres tilbake med synkroniseringen allerede i gang. Tokener krypteres før de lagres, og agenten ser dem aldri.

Polylane oppdager prosjektene, miljøene, tjenestene, deployene, volumene, domenene og TCP-proxyene dine. Tjenestemetrikker driver diagrammer og anomalideteksjon. Variabelnavn synkroniseres for lenking på tvers av skyer; variabelverdier leses aldri. Flyktige miljøer (pull request) hoppes over.

Webhooker for deploy og varsler

Railway pusher endringer i deploystatus og bruksvarsler gjennom notifikasjonsregler. Å peke en av dem på Polylane varsler om feilede eller krasjede deployer, løser varselet ved neste vellykkede deploy og planlegger en ny synkronisering:

1. Kopier webhook-URL-en fra skykontoens Settings-side i Polylane (den slutter med Railway-workspace-ID-en din).
2. I Railway åpner du workspacets Notifications-innstillinger og legger til en webhook-regel som peker på den URL-en.
3. Velg Deployment-hendelsene du bryr deg om: Deployment.deployed, Deployment.failed, Deployment.crashed og Deployment.oom_killed dekker varslingsflyten (Railways suksesshendelse er Deployment.deployed; det finnes ingen Deployment.success).
4. Legg til VolumeAlert- og Monitor-hendelsene, inkludert VolumeAlert.resolved og Monitor.resolved, slik at volum- og monitorvarsler åpnes og lukkes automatisk i Polylane.

Feilsøking

Autorisasjonen feiler eller avbrytes

• Sørg for at du er logget inn på Railway med en konto som har tilgang til workspacet.
• Prøv igjen fra Continue to Railway; autorisasjonslenken er bare gyldig i noen få minutter.

Manglende ressurser

• Railway kan bruke noen minutter på å synkronisere alt.
• Flyktige miljøer (pull request) synkroniseres ikke.
• Utløs en manuell Sync fra kontooverskriften for å oppdatere.

Frakobling

Koble kontoen fra i Polylane, trekk så tilbake OAuth-tilgangen i Railway-kontoinnstillingene dine, og fjern notifikasjonsregelen hvis du opprettet en.

Å koble til Railway 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 Railway-workspace-token fra workspace-innstillingene dine. Konsollens OAuth-flyt trenger en nettleser; workspace-tokener gjør det ikke.

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": "railway",
    "workspaceId": "ws_0abc123",
    "token": "<railway-workspace-token>"
  }'

Ett kall kobler til hvert Railway-workspace tokenet kan nå; send den valgfrie railwayWorkspaceId for å koble til bare ett.

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": "railway",
    "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 Railway-legitimasjonen på leverandørsiden, som beskrevet under Koble fra nedenfor.