Trigger.dev

1. Dans Trigger.dev, ouvrez la page API Keys de l'environnement et créez une clé avec le préréglage "No restrictions".
2. Collez la clé dans Polylane et appuyez sur Connect. La clé nomme elle-même son projet et son environnement, il n'y a donc rien d'autre à saisir.

Polylane cartographie l'environnement, son déploiement, les tâches, les planifications et les files. Une tâche vue dans des exécutions mais absente de la version actuelle reste sur la carte et est signalée. Les clés sont chiffrées et l'agent ne les voit jamais.

Webhooks de déploiement et d'alerte

Les alertes webhook de Trigger.dev ouvrent un incident à l'échec d'une exécution et résolvent les alertes de déploiement au succès suivant. Une alerte par environnement :

1. Sur la page Alerts de l'environnement, ajoutez une alerte webhook avec l'URL des Settings du compte, sous Webhooks, et les événements "Task run failure", "Deployment failure" et "Deployment success".
2. Collez le secret de signature que Trigger.dev affiche une seule fois dans la même carte Webhooks.

Dépannage

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

• Les clés Trigger only, Observer, Deploy only, Task operator et Variables only ne peuvent pas être utilisées : Polylane lit l'identité du projet via un point de terminaison que seule une clé "No restrictions" peut appeler. Créez une clé "No restrictions" sur la page API Keys de l'environnement et connectez-la.

"Trigger.dev did not recognize this key"

• Vérifiez que la clé a été copiée en entier et n'a pas été révoquée.

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

• Utilisez une clé prod ou staging.

Ressources manquantes

• "Sync" dans l'en-tête du compte rafraîchit avant le prochain passage de 15 minutes.

Déconnexion

Déconnectez dans Polylane, puis supprimez la clé sur la page API Keys de l'environnement.

Connecter Trigger.dev ne nécessite aucun navigateur : le même point d'accès que la console appelle tient dans un job de CI. Un seul POST authentifié crée la connexion et démarre la première synchronisation.

Prérequis

• Une clé API Polylane avec les scopes cloud_accounts:write et cloud_accounts:read. Voir Clés API et OAuth.
• L'identifiant de ton espace de travail, qui commence par ws_. Lis-le depuis GET /v1/workspaces avec la même clé.
• Une clé secrète d'environnement Trigger.dev (tr_prod_sk_… ou tr_stg_sk_…) depuis l'environnement prod ou staging de ton projet, sous API Keys. Crée-la avec le préréglage No restrictions : Polylane lit l'identité du projet via un point de terminaison que seule une clé "No restrictions" peut appeler, donc les clés Trigger only, Observer, Deploy only, Task operator et Variables only sont refusées, tout comme les clés dev et preview.

Créer la connexion

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 clé nomme elle-même son projet et son environnement, et une clé appartient à exactement un environnement, donc un appel connecte un environnement : une clé prod connecte la production et une clé staging connecte le staging, chacun comme compte à part. Envoyer une clé pour un environnement déjà connecté remplace la clé du compte. Il n'y a pas d'interrupteur d'environnement à régler. Connecter un environnement est la façon de choisir de le surveiller.

La réponse liste ce qui a été connecté, avec la première synchronisation déjà en cours. Réduite aux deux champs que le reste du flux lit :

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

Une clé que l'API refuse atterrit dans failures au lieu de accounts, avec le message qui dit pourquoi, donc répéter l'appel ne duplique jamais une connexion.

Attendre la première synchronisation

Interroge chaque compte renvoyé par son id jusqu'à ce que status atteigne ready (new à l'enregistrement, syncing pendant que les ressources arrivent) :

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

Donne une échéance à la boucle pour qu'une connexion échouée fasse échouer le job au lieu de le bloquer. Une fois que le compte est ready, ses ressources sont dans la topologie et Polylane a démarré sa première vérification.

Déconnecter depuis l'API

Supprimer la connexion arrête chaque synchronisation et chaque vérification et supprime les identifiants que Polylane détenait. L'appel nécessite le 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"

Révoque ensuite la clé Trigger.dev côté fournisseur, comme décrit sous Disconnect ci-dessous.