Modal

Modal kobles til med et token opprettet i Modal-innstillingene dine. Et Modal-token løses til nøyaktig ett workspace, så ett token kobler til ett workspace. Tokener krypteres før de lagres, og agenten ser dem aldri.

1. Åpne Modal, gå til Settings → Tokens.
2. Klikk på New token og kopier både token ID (starter med ak-) og token secret (starter med as-).
3. Lim begge verdiene inn i Polylane.
4. Polylane validerer paret og begynner å synkronisere.

Polylane oppdager miljøene dine og, innenfor hvert av dem, appene, funksjonene inkludert webendepunkter, kjørende sandkasser, volumer, hemmeligheter, køer og dicts. Hemmeligheter kartlegges bare etter navn: Modal eksponerer aldri hemmelige verdier.

Modal har ingen skrivebeskyttet tokentype, så et token bærer tillatelsene til kontoen som opprettet det. Polylane leser bare fra Modal under synkronisering.

Feilsøking

Feilen «Invalid token»

• Både token-ID-en og tokenhemmeligheten kreves; den ene alene kan ikke autentisere.
• Sjekk at tokenet ikke er trukket tilbake i Modals innstillinger.
• Bekreft at du kopierte hele verdien, inkludert prefiksene ak- og as-.

Manglende ressurser

• Funksjoner oppdages gjennom appen sin, så en app som aldri har blitt deployet, har ingen funksjoner å vise.
• Avsluttede sandkasser hoppes over: bare kjørende vises.
• Utløs en manuell synkronisering for å oppdatere før neste planlagte gjennomgang.

Metrikker og kostnad

• Apper har to diagrammer: stderr-logglinjer per bøtte, og målt forbruk per time. Modal rapporterer bare øyeblikksmålere for alt annet, så funksjoner, sandkasser og volumer har ingen egne diagrammer.
• Stderr-tellinger er logglinjer og ikke feil: én Python-traceback er flere linjer.
• Modal beholder logger i 24 timer, så et diagram går aldri lenger tilbake enn det.
• Forbruk tilordnes per app, og Modal materialiserer en time først når den er over, så den nyeste timen leser lavt til den har satt seg.

Å koble til Modal 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 Modal-tokenpar fra Settings → Tokens: token-ID-en (starter med ak-) og tokenhemmeligheten (starter med as-).

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": "modal",
    "workspaceId": "ws_0abc123",
    "tokenId": "ak-...",
    "tokenSecret": "as-..."
  }'

Tokenet løses til nøyaktig ett Modal-workspace, så ett kall kobler til ett workspace.

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