Turso

Turso se conecta con un token de API de plataforma:

1. Abre Turso, ve a la página API Tokens de la configuración de tu cuenta, o ejecuta turso auth api-tokens mint polylane desde la CLI.
2. Copia el token de API de plataforma.
3. Pega el token en Polylane. Si el token puede alcanzar más de una organización, elige la que quieres conectar cuando se te pida.
4. Polylane valida el token y empieza a sincronizar.

Cada conexión cubre una única organización de Turso. Polylane descubre sus grupos de bases de datos y bases de datos, incluidas ubicaciones, colocación, parentesco de ramas y estado de lectura/escritura. Los tokens se cifran antes de almacenarse, y el agente nunca los ve. Polylane lee únicamente la Platform API; nunca se conecta a tus bases de datos ni guarda credenciales de base de datos.

La Platform API de Turso reporta el uso como contadores acumulados del periodo de facturación en lugar de series temporales, así que las bases de datos no llevan gráficos de métricas. La monitorización consulta esos contadores y vigila las diferencias: volumen de lecturas y escrituras, tráfico de sincronización, crecimiento del almacenamiento, número de bases de datos, consumo de cuota frente a tu plan y las consultas más pesadas por base de datos se comparan cada una con el propio historial de la cuenta.

Solución de problemas

Error "Invalid Turso API token"

• Los tokens de la Platform API son distintos de los tokens de autenticación de base de datos; acuña uno con turso auth api-tokens mint o desde la configuración de tu cuenta.
• Comprueba que el token no se haya revocado en la configuración de Turso.

Error "Multiple Turso organizations are reachable"

• El token puede alcanzar más de una organización, así que indica cuál quieres conectar.
• Al conectar en la consola, elige la organización cuando se te pida tras la validación.
• Al conectar mediante la API, establece el campo organization con el slug de la organización.

Faltan recursos

• Turso puede tardar unos minutos en sincronizar todo.
• Lanza un Sync manual desde la cabecera de la cuenta para actualizar.

Desconexión

Desconecta la cuenta en Polylane y luego revoca el token de API desde la configuración de tu cuenta de Turso o con turso auth api-tokens revoke.

Conectar Turso no necesita navegador: el mismo endpoint al que llama la consola cabe en un trabajo de CI. Un único POST autenticado crea la conexión e inicia la primera sincronización.

Requisitos previos

• Una clave de API de Polylane con los scopes cloud_accounts:write y cloud_accounts:read. Consulta Claves de API y OAuth.
• El ID de tu espacio de trabajo, que empieza por ws_. Léelo desde GET /v1/workspaces con la misma clave.
• Un token de API de plataforma de Turso, acuñado desde la configuración de tu cuenta o con turso auth api-tokens mint polylane.

Crear la conexión

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

Una sola llamada conecta una organización de Turso.

• organization solo puede omitirse cuando el token alcanza exactamente una organización; de lo contrario la llamada falla con un 400 que lista los slugs de las organizaciones alcanzables.

La respuesta lista lo que se conectó, con la primera sincronización ya en marcha. Recortada a los dos campos que lee el resto del flujo:

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

Una cuenta que ya está conectada acaba en failures en lugar de en accounts, así que repetir la llamada nunca duplica una conexión.

Esperar a la primera sincronización

Consulta cada cuenta devuelta por su id hasta que status llegue a ready (new al registrarse, syncing mientras los recursos van llegando):

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

Dale al bucle un plazo límite para que una conexión fallida haga fallar el trabajo en lugar de dejarlo colgado. Cuando la cuenta está ready, sus recursos están en la topología y Polylane ha iniciado su primera comprobación.

Desconectar desde la API

Eliminar la conexión detiene todas las sincronizaciones y comprobaciones y elimina las credenciales que Polylane guardaba. La llamada necesita el scope cloud_accounts:delete:

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

Después revoca la credencial de Turso del lado del proveedor, como se describe más abajo en Desconectar.