Trigger.dev

1. En Trigger.dev, abre la página API Keys del entorno y crea una clave con el preajuste "No restrictions".
2. Pega la clave en Polylane y pulsa Connect. La clave nombra su propio proyecto y entorno, así que no hay nada más que escribir.

Polylane mapea el entorno, su despliegue, tareas, programaciones y colas. Una tarea vista en ejecuciones pero ausente de la versión actual permanece en el mapa y queda marcada. Las claves se cifran y el agente nunca las ve.

Webhooks de despliegue y alertas

Las alertas webhook de Trigger.dev abren un problema al fallar una ejecución y resuelven las alertas de despliegue con el siguiente éxito. Una alerta por entorno:

1. En la página Alerts del entorno, añade una alerta webhook con la URL de Settings de la cuenta, en Webhooks, y los eventos "Task run failure", "Deployment failure" y "Deployment success".
2. Pega el secreto de firma que Trigger.dev muestra una sola vez en la misma tarjeta Webhooks.

Solución de problemas

"Polylane needs a key created with the 'No restrictions' preset"

• Las claves Trigger only, Observer, Deploy only, Task operator y Variables only no se pueden usar: Polylane lee la identidad del proyecto a través de un endpoint que solo una clave "No restrictions" puede llamar. Crea una clave "No restrictions" en la página API Keys del entorno y conéctala.

"Trigger.dev did not recognize this key"

• Comprueba que la clave se copió entera y no ha sido revocada.

"Dev keys only work while trigger dev runs" y "Preview keys are per branch and not supported"

• Usa una clave prod o staging.

Recursos que faltan

• "Sync" en la cabecera de la cuenta refresca antes de la siguiente pasada de 15 minutos.

Desconexión

Desconecta en Polylane y luego elimina la clave en la página API Keys del entorno.

Conectar Trigger.dev 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.
• Una clave secreta de entorno de Trigger.dev (tr_prod_sk_… o tr_stg_sk_…) del entorno prod o staging de tu proyecto, en API Keys. Créala con el preajuste No restrictions: Polylane lee la identidad del proyecto a través de un endpoint que solo una clave "No restrictions" puede llamar, así que las claves Trigger only, Observer, Deploy only, Task operator y Variables only se rechazan, igual que las claves dev y preview.

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": "triggerdev",
    "workspaceId": "ws_0abc123",
    "apiKey": "<environment-secret-key>"
  }'

La clave nombra su propio proyecto y entorno, y una clave pertenece exactamente a un entorno, así que una llamada conecta un entorno: una clave prod conecta producción y una clave staging conecta staging, cada uno como su propia cuenta. Enviar una clave para un entorno que ya está conectado reemplaza la clave de la cuenta. No hay interruptor de entorno que configurar. Conectar un entorno es la forma de elegir vigilarlo.

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": "triggerdev",
    "accounts": [{ "id": "acc_34gky74ibc92h8t2efn8csrh", "status": "syncing" }],
    "failures": []
  }
}

Una clave que la API rechaza acaba en failures en lugar de en accounts, con el mensaje que dice por qué, 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 clave de Trigger.dev del lado del proveedor, como se describe más abajo en Desconectar.