Turso

Turso подключается с помощью API-токена платформы:

1. Откройте Turso, перейдите на страницу API Tokens в настройках аккаунта или выполните turso auth api-tokens mint polylane в CLI.
2. Скопируйте API-токен платформы.
3. Вставьте токен в Polylane. Если токен имеет доступ к нескольким организациям, выберите нужную, когда появится запрос.
4. Polylane проверяет токен и начинает синхронизацию.

Каждое подключение охватывает одну организацию Turso. Polylane обнаруживает её группы баз данных и базы данных, включая локации, размещение, родительские связи веток и статус чтения/записи. Токены шифруются перед сохранением, и агент никогда их не видит. Polylane читает только Platform API; он никогда не подключается к вашим базам данных и не хранит учётные данные баз данных.

Platform API Turso отдаёт использование как накопительные счётчики за расчётный период, а не как временные ряды, поэтому у баз данных нет графиков метрик. Мониторинг опрашивает эти счётчики и следит за приращениями: объём чтения и записи, трафик синхронизации, рост хранилища, число баз данных, расход квоты по вашему плану и самые тяжёлые запросы по каждой базе сравниваются с собственной историей аккаунта.

Устранение неполадок

Ошибка «Invalid Turso API token»

• API-токены платформы отличаются от токенов аутентификации баз данных; выпустите токен командой turso auth api-tokens mint или в настройках аккаунта.
• Проверьте, что токен не был отозван в настройках Turso.

Ошибка «Multiple Turso organizations are reachable»

• Токен имеет доступ к нескольким организациям, поэтому укажите, какую подключить.
• При подключении в консоли выберите организацию, когда появится запрос после проверки токена.
• При подключении через API задайте в поле organization slug организации.

Отсутствуют ресурсы

• Turso может синхронизировать всё в течение нескольких минут.
• Запустите ручную Sync из заголовка аккаунта, чтобы обновить данные.

Отключение

Отключите аккаунт в Polylane, затем отозовите API-токен в настройках аккаунта Turso или командой turso auth api-tokens revoke.

Для подключения Turso браузер не нужен: тот же эндпоинт, который вызывает консоль, помещается в CI-задание. Один аутентифицированный POST создаёт подключение и запускает первую синхронизацию.

Требования

• API-ключ Polylane с областями cloud_accounts:write и cloud_accounts:read. См. API-ключи и OAuth.
• ID вашего рабочего пространства, который начинается с ws_. Прочитайте его из GET /v1/workspaces тем же ключом.
• API-токен платформы Turso, выпущенный в настройках аккаунта или командой turso auth api-tokens mint polylane.

Создайте подключение

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

Один вызов подключает одну организацию Turso.

• organization можно опустить, только если токен имеет доступ ровно к одной организации; иначе вызов завершается ошибкой 400 со списком slug'ов доступных организаций.

Ответ перечисляет, что было подключено, с уже запущенной первой синхронизацией. Сокращён до двух полей, которые читает остальная часть процесса:

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

Уже подключённый аккаунт попадает в failures, а не в accounts, поэтому повторный вызов никогда не дублирует подключение.

Дождитесь первой синхронизации

Опрашивайте каждый возвращённый аккаунт по его id, пока status не достигнет ready (new при регистрации, syncing пока ресурсы поступают):

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

Задайте циклу предельное время, чтобы неудачное подключение проваливало задание, а не подвешивало его. Как только аккаунт в состоянии ready, его ресурсы находятся в топологии, и Polylane начал свою первую проверку.

Отключение через API

Удаление подключения останавливает все синхронизации и проверки и удаляет учётные данные, которые хранил Polylane. Вызову нужна область cloud_accounts:delete:

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

Затем отозовите учётные данные Turso на стороне провайдера, как описано ниже в разделе Отключение.