Trigger.dev

1. No Trigger.dev, abra a página API Keys do ambiente e crie uma chave com o preset "No restrictions".
2. Cole a chave no Polylane e pressione Connect. A chave nomeia o próprio projeto e ambiente, então não há mais nada a digitar.

O Polylane mapeia o ambiente, seu deployment, tarefas, agendamentos e filas. Uma tarefa vista em execuções mas ausente da versão atual permanece no mapa e é sinalizada. As chaves são criptografadas e o agente nunca as vê.

Webhooks de deploy e alerta

Os alertas webhook do Trigger.dev abrem um problema em uma execução com falha e resolvem alertas de deployment no próximo sucesso. Um alerta por ambiente:

1. Na página Alerts do ambiente, adicione um alerta webhook com a URL de Settings da conta, em Webhooks, e os eventos "Task run failure", "Deployment failure" e "Deployment success".
2. Cole o segredo de assinatura que o Trigger.dev mostra uma vez no mesmo cartão Webhooks.

Solução de problemas

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

• Chaves Trigger only, Observer, Deploy only, Task operator e Variables only não podem ser usadas: o Polylane lê a identidade do projeto por um endpoint que só uma chave "No restrictions" pode chamar. Crie uma chave "No restrictions" na página API Keys do ambiente e conecte-a.

"Trigger.dev did not recognize this key"

• Confira se a chave foi copiada inteira e não foi revogada.

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

• Use uma chave prod ou staging.

Recursos ausentes

• "Sync" no cabeçalho da conta atualiza antes da próxima passagem de 15 minutos.

Desconexão

Desconecte no Polylane e depois exclua a chave na página API Keys do ambiente.

Conectar o Trigger.dev não precisa de navegador: o mesmo endpoint que o console chama cabe em um job de CI. Um POST autenticado cria a conexão e inicia a primeira sincronização.

Pré-requisitos

• Uma chave de API do Polylane com os escopos cloud_accounts:write e cloud_accounts:read. Veja Chaves de API e OAuth.
• O ID do seu workspace, que começa com ws_. Leia-o em GET /v1/workspaces com a mesma chave.
• Uma chave secreta de ambiente do Trigger.dev (tr_prod_sk_… ou tr_stg_sk_…) do ambiente prod ou staging do seu projeto, em API Keys. Crie-a com o preset No restrictions: o Polylane lê a identidade do projeto por um endpoint que só uma chave "No restrictions" pode chamar, então chaves Trigger only, Observer, Deploy only, Task operator e Variables only são recusadas, assim como chaves dev e preview.

Criar a conexão

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

A chave nomeia o próprio projeto e ambiente, e uma chave pertence a exatamente um ambiente, então uma chamada conecta um ambiente: uma chave prod conecta a produção e uma chave staging conecta o staging, cada um como sua própria conta. Enviar uma chave para um ambiente que já está conectado substitui a chave da conta. Não há interruptor de ambiente para configurar. Conectar um ambiente é como você escolhe observá-lo.

A resposta lista o que foi conectado, com a primeira sincronização já em andamento. Reduzida aos dois campos que o restante do fluxo lê:

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

Uma chave que a API recusa aparece em failures em vez de accounts, com a mensagem dizendo por quê, então repetir a chamada nunca duplica uma conexão.

Aguardar a primeira sincronização

Consulte cada conta retornada pelo seu id até que status chegue a ready (new no registro, syncing enquanto os recursos chegam):

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

Dê um prazo ao loop para que uma conexão com falha faça o job falhar em vez de travá-lo. Quando a conta estiver ready, seus recursos estão na topologia e o Polylane já iniciou sua primeira verificação.

Desconectar pela API

Excluir a conexão interrompe todas as sincronizações e verificações e apaga as credenciais que o Polylane guardava. A chamada precisa do escopo cloud_accounts:delete:

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

Depois revogue a chave do Trigger.dev no lado do provedor, como descrito em Desconectar abaixo.