Convex

Convex se conecta con un token de acceso de equipo creado en el panel de Convex. Un token de acceso de equipo está limitado exactamente a un equipo, así que un token conecta un equipo. Los tokens se cifran antes de almacenarse, y el agente nunca los ve.

1. Abre el panel de Convex y ve a Team Settings → Access Tokens.
2. Haz clic en Create access token y copia el valor del token.
3. Pega el token en Polylane.
4. Polylane valida el token y empieza a sincronizar.

Polylane descubre tus proyectos y, dentro de cada uno, sus despliegues en la nube: el despliegue de producción más cualquier despliegue de preview, desarrollo y personalizado, con sus regiones, URLs y clases de despliegue.

Los tokens de acceso de equipo conceden acceso de gestión al equipo. La sincronización lee tus proyectos y despliegues con el token de equipo. Cuando el agente o la monitorización en segundo plano leen los logs de funciones o las métricas de un despliegue, Polylane acuña una clave de despliegue de corta duración limitada solo a esa lectura (vista de logs o vista de métricas), la usa para esa única llamada y la elimina inmediatamente después, así que cada clave vive solo lo que dura la lectura a la que sirve. Todo lo que Polylane lee está en la superficie de gestión: listados de proyectos y despliegues, logs de funciones y métricas de despliegue.

Solución de problemas

Error "Not a team access token"

• Los tokens limitados a un proyecto y las claves de despliegue no pueden listar los proyectos del equipo; crea el token en Team Settings → Access Tokens.
• Comprueba que el token no se haya eliminado en el panel de Convex.

Faltan recursos

• Los despliegues locales se ejecutan en las máquinas de cada desarrollador y deliberadamente no se sincronizan.
• Un proyecto creado sin despliegue no muestra despliegues hasta el primer deploy.
• Lanza una sincronización manual para actualizar antes de la siguiente pasada programada.

Logs de auditoría

• Convex reserva su API de logs de auditoría a los planes de pago. En un equipo gratuito, las lecturas de logs de auditoría devuelven un error claro y los agentes recurren a los logs de funciones y al grafo de contexto.

Desconexión

Desconecta la cuenta en Polylane y luego elimina el token de acceso desde la configuración de tu equipo en Convex.

Conectar Convex 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 acceso de equipo de Convex de Team Settings → Access Tokens.

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": "convex",
    "workspaceId": "ws_0abc123",
    "token": "<team-access-token>"
  }'

Un token de acceso de equipo está limitado exactamente a un equipo, así que una llamada conecta un equipo.

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": "convex",
    "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 Convex del lado del proveedor, como se describe más abajo en Desconectar.