Execute um workflow pelo terminal com a CLI

A Server CLI permite iniciar um workflow existente pelo ID. Você usa esse recurso no terminal da instalação, sem abrir o canvas para acionar o teste. No Docker, o comando roda dentro do container que guarda o workflow e acessa a configuração daquela instância.

Escolha um workflow de estudo

Abra o workflow no editor e confira o que ele faz antes de executá-lo. Use um exemplo que produza um resultado fácil de verificar, como uma transformação de campos. Se ele envia mensagens ou grava registros em um serviço externo, a execução pode produzir esses efeitos reais.

Confira também as credenciais selecionadas nos Nodes. Um workflow copiado de outra instalação pode manter referências a credenciais que ainda precisam ser configuradas. Resolva essas dependências antes de iniciar pelo terminal para não confundir uma falha de autenticação com um problema do comando.

Localize o ID

A documentação orienta localizar o ID na URL do workflow aberto no editor. Copie o identificador correspondente ao workflow, sem usar o nome exibido no canvas como substituto.

O ID precisa existir na instância consultada pela CLI. Com vários containers do n8n no computador, confira o nome escolhido com docker ps. Um ID copiado de outra instância não identifica automaticamente o mesmo workflow na instalação local.

Execute pelo terminal do computador

No exemplo abaixo, substitua ID_DO_WORKFLOW pelo identificador real. O container n8n-estudo é o definido no guia de Compose local:

1
docker exec -u node -it n8n-estudo n8n execute --id ID_DO_WORKFLOW

O trecho n8n execute --id é o comando documentado para iniciar um workflow gravado. O prefixo Docker executa esse processo como o usuário node dentro do container em execução. Você não precisa instalar outra cópia do n8n no computador para usar essa CLI.

Confira o resultado antes de repetir

Leia a saída do terminal e compare o resultado com a função do workflow escolhido. Para uma transformação, confira os campos esperados. Para uma integração de estudo, confira o registro ou a mensagem no serviço de destino.

Se aparecer erro, leia o Node e a mensagem indicados antes de executar novamente. Quando uma tentativa já produziu parte dos efeitos externos, repetir o comando pode repetir mensagens ou gravações. A conferência precisa considerar o resultado no serviço, além do encerramento do processo.

Este procedimento inicia uma execução específica pelo ID. A configuração de publicação e dos triggers continua sendo uma tarefa separada do workflow.