Turso

Turso łączy się tokenem API platformy:

1. Otwórz Turso, przejdź do strony API Tokens w ustawieniach konta albo uruchom turso auth api-tokens mint polylane z CLI.
2. Skopiuj token API platformy.
3. Wklej token do Polylane. Jeśli token ma dostęp do więcej niż jednej organizacji, wybierz tę do połączenia, gdy zostaniesz o to poproszony.
4. Polylane weryfikuje token i zaczyna synchronizację.

Każde połączenie obejmuje jedną organizację Turso. Polylane odkrywa jej grupy baz danych i bazy danych, łącznie z lokalizacjami, rozmieszczeniem, pochodzeniem gałęzi i statusem odczytu/zapisu. Tokeny są szyfrowane przed zapisaniem, a agent nigdy ich nie widzi. Polylane czyta wyłącznie Platform API; nigdy nie łączy się z twoimi bazami danych i nigdy nie przechowuje poświadczeń baz danych.

Platform API Turso raportuje użycie jako skumulowane liczniki okresu rozliczeniowego, a nie serie czasowe, więc bazy danych nie mają wykresów metryk. Monitorowanie odpytuje te liczniki i obserwuje zamiast tego różnice: wolumen odczytów i zapisów, ruch synchronizacji, wzrost pamięci, liczbę baz danych, wyczerpywanie kwoty względem twojego planu i najcięższe zapytania na bazę danych są każde sprawdzane względem własnej historii konta.

Rozwiązywanie problemów

Błąd "Invalid Turso API token"

• Tokeny Platform API różnią się od tokenów uwierzytelniających baz danych; wybij jeden poleceniem turso auth api-tokens mint albo w ustawieniach konta.
• Sprawdź, czy token nie został odwołany w ustawieniach Turso.

Błąd "Multiple Turso organizations are reachable"

• Token ma dostęp do więcej niż jednej organizacji, więc podaj nazwę tej do połączenia.
• Łącząc w konsoli, wybierz organizację, gdy zostaniesz o to poproszony po weryfikacji.
• Łącząc przez API, ustaw pole organization na slug organizacji.

Brakujące zasoby

• Turso może potrzebować kilku minut, aby zsynchronizować wszystko.
• Wywołaj ręczną Sync z nagłówka konta, aby odświeżyć.

Odłączanie

Odłącz konto w Polylane, a potem odwołaj token API w ustawieniach konta Turso albo poleceniem turso auth api-tokens revoke.

Połączenie Turso nie potrzebuje przeglądarki: ten sam punkt końcowy, który wywołuje konsola, mieści się w zadaniu CI. Jeden uwierzytelniony POST tworzy połączenie i uruchamia pierwszą synchronizację.

Wymagania wstępne

• Klucz API Polylane z zakresami cloud_accounts:write i cloud_accounts:read. Zobacz Klucze API i OAuth.
• Identyfikator twojego obszaru roboczego, zaczynający się od ws_. Odczytaj go z GET /v1/workspaces tym samym kluczem.
• Token API platformy Turso, wybity w ustawieniach konta albo poleceniem turso auth api-tokens mint polylane.

Utwórz połączenie

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

Jedno wywołanie łączy jedną organizację Turso.

• organization można pominąć tylko wtedy, gdy token ma dostęp do dokładnie jednej organizacji; w przeciwnym razie wywołanie kończy się błędem 400 wymieniającym slugi dostępnych organizacji.

Odpowiedź wymienia, co zostało połączone, z już działającą pierwszą synchronizacją. Przycięta do dwóch pól, które czyta reszta przepływu:

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

Konto, które jest już połączone, trafia do failures zamiast do accounts, więc powtórzenie wywołania nigdy nie duplikuje połączenia.

Poczekaj na pierwszą synchronizację

Odpytuj każde zwrócone konto po jego id, aż status osiągnie ready (new po rejestracji, syncing w trakcie napływu zasobów):

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

Daj pętli termin, aby nieudane połączenie kończyło zadanie błędem zamiast je zawieszać. Gdy konto jest ready, jego zasoby są w topologii, a Polylane uruchomiło pierwszą kontrolę.

Odłącz przez API

Usunięcie połączenia zatrzymuje każdą synchronizację i kontrolę oraz usuwa poświadczenia, które Polylane przechowywało. Wywołanie wymaga zakresu cloud_accounts:delete:

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

Potem odwołaj poświadczenie Turso po stronie dostawcy, jak opisano poniżej w sekcji Disconnect.