Turso

Turso forbindes med et platform-API-token:

1. Åbn Turso, gå til siden API Tokens i dine kontoindstillinger, eller kør turso auth api-tokens mint polylane fra CLI'en.
2. Kopiér platform-API-tokenet.
3. Indsæt tokenet i Polylane. Hvis tokenet kan nå mere end én organisation, vælger du den, der skal forbindes, når du bliver spurgt.
4. Polylane validerer tokenet og begynder at synkronisere.

Hver forbindelse dækker en enkelt Turso-organisation. Polylane opdager dens databasegrupper og databaser, inklusive placeringer, placement, branching-afstamning og læse-/skrivestatus. Tokens krypteres, før de gemmes, og agenten ser dem aldrig. Polylane læser kun Platform API'et; den forbinder aldrig til dine databaser og holder aldrig databaselegitimationsoplysninger.

Tursos Platform API rapporterer forbrug som kumulative tællere for faktureringsperioden og ikke som tidsserier, så databaser har ingen metrikdiagrammer. Overvågningen poller de tællere og holder i stedet øje med deltaerne: læse- og skrivevolumen, synkroniseringstrafik, lagervækst, antal databaser, kvoteforbrug i forhold til din plan og de tungeste forespørgsler per database kontrolleres hver mod kontoens egen historik.

Fejlfinding

Fejlen "Invalid Turso API token"

• Platform-API-tokens er forskellige fra database-auth-tokens; udsted ét med turso auth api-tokens mint eller fra dine kontoindstillinger.
• Kontrollér, at tokenet ikke er blevet tilbagekaldt i Tursos indstillinger.

Fejlen "Multiple Turso organizations are reachable"

• Tokenet kan nå mere end én organisation, så navngiv den, der skal forbindes.
• Forbinder du i konsollen, vælger du organisationen, når du bliver spurgt efter valideringen.
• Forbinder du via API'et, sætter du feltet organization til organisationens slug.

Manglende ressourcer

• Turso kan bruge et par minutter på at synkronisere alt.
• Udløs en manuel Sync fra kontohovedet for at opdatere.

Afbrydelse

Afbryd kontoen i Polylane, og tilbagekald derefter API-tokenet fra dine Turso-kontoindstillinger eller med turso auth api-tokens revoke.

Forbindelse af Turso kræver ingen browser: det samme endpoint, konsollen kalder, passer ind i et CI-job. Én autentificeret POST opretter forbindelsen og starter den første synkronisering.

Forudsætninger

• En Polylane-API-nøgle med scopes cloud_accounts:write og cloud_accounts:read. Se API-nøgler og OAuth.
• Dit arbejdsområde-id, som begynder med ws_. Læs det fra GET /v1/workspaces med den samme nøgle.
• Et Turso-platform-API-token, udstedt fra dine kontoindstillinger eller med turso auth api-tokens mint polylane.

Opret forbindelsen

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"
  }'

Ét kald forbinder én Turso-organisation.

• organization kan kun udelades, når tokenet når præcis én organisation; ellers fejler kaldet med en 400, der lister sluggene for de organisationer, der kan nås.

Svaret lister, hvad der blev forbundet, med den første synkronisering allerede i gang. Trimmet til de to felter, resten af flowet læser:

{
  "success": true,
  "result": {
    "provider": "turso",
    "accounts": [{ "id": "acc_34gky74ibc92h8t2efn8csrh", "status": "syncing" }],
    "failures": []
  }
}

En konto, der allerede er forbundet, lander i failures i stedet for accounts, så gentagelse af kaldet duplikerer aldrig en forbindelse.

Vent på den første synkronisering

Poll hver returneret konto efter dens id, indtil status når ready (new ved registrering, syncing mens ressourcer strømmer ind):

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

Giv løkken en deadline, så en fejlet forbindelse får jobbet til at fejle i stedet for at hænge. Når kontoen er ready, er dens ressourcer i topologien, og Polylane har startet sin første kontrol.

Afbryd fra API'et

Sletning af forbindelsen stopper hver synkronisering og kontrol og sletter de legitimationsoplysninger, Polylane opbevarede. Kaldet kræver scopet cloud_accounts:delete:

curl -X DELETE "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY"

Tilbagekald derefter Turso-legitimationen på udbyderens side, som beskrevet under Afbryd nedenfor.