Turso

Turso kobles til med et plattform-API-token:

1. Åpne Turso, gå til API Tokens-siden i kontoinnstillingene dine, eller kjør turso auth api-tokens mint polylane fra CLI-en.
2. Kopier plattform-API-tokenet.
3. Lim tokenet inn i Polylane. Hvis tokenet kan nå mer enn én organisasjon, velger du den som skal kobles til når du blir spurt.
4. Polylane validerer tokenet og begynner å synkronisere.

Hver tilkobling dekker én enkelt Turso-organisasjon. Polylane oppdager databasegruppene og databasene dens, inkludert plasseringer, lokasjon, branch-opphav og lese-/skrivestatus. Tokener krypteres før de lagres, og agenten ser dem aldri. Polylane leser bare Platform API; den kobler seg aldri til databasene dine og holder aldri databaselegitimasjon.

Tursos Platform API rapporterer bruk som kumulative tellere for faktureringsperioden i stedet for tidsserier, så databaser har ingen metrikkdiagrammer. Overvåkingen spør de tellerne og følger med på deltaene i stedet: lese- og skrivevolum, synkroniseringstrafikk, lagringsvekst, antall databaser, kvoteforbruk mot planen din, og de tyngste spørringene per database sjekkes hver mot kontoens egen historikk.

Feilsøking

Feilen «Invalid Turso API token»

• Plattform-API-tokener er noe annet enn autentiseringstokener for databaser; lag ett med turso auth api-tokens mint eller fra kontoinnstillingene dine.
• Sjekk at tokenet ikke er trukket tilbake i Tursos innstillinger.

Feilen «Multiple Turso organizations are reachable»

• Tokenet kan nå mer enn én organisasjon, så navngi den som skal kobles til.
• Kobler du til i konsollen, velger du organisasjonen når du blir spurt etter validering.
• Kobler du til via API-et, setter du feltet organization til organisasjonssluggen.

Manglende ressurser

• Turso kan bruke noen minutter på å synkronisere alt.
• Utløs en manuell Sync fra kontooverskriften for å oppdatere.

Frakobling

Koble kontoen fra i Polylane, og trekk så tilbake API-tokenet fra kontoinnstillingene dine i Turso eller med turso auth api-tokens revoke.

Å koble til Turso 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 Turso-plattform-API-token, laget fra kontoinnstillingene dine eller med turso auth api-tokens mint polylane.

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": "turso",
    "workspaceId": "ws_0abc123",
    "token": "<platform-api-token>",
    "organization": "my-org-slug"
  }'

Ett kall kobler til én Turso-organisasjon.

• organization kan bare utelates når tokenet når nøyaktig én organisasjon; ellers feiler kallet med en 400 som lister sluggene til organisasjonene som kan nås.

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