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.
• Ідентифікатор вашого робочого простору, який починається з 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 на боці провайдера, як описано в розділі Відключення нижче.