Como fazer deploy do n8n com um clique na Nodion

O n8n é uma ferramenta de automatização de workflows com um editor visual e passos de código. No entanto, executar uma instância própria exige mais do que um contentor: o n8n precisa de uma base de dados, de armazenamento persistente para os seus ficheiros, de uma chave de encriptação e de um URL público para webhooks. O preset do n8n na Nodion configura tudo isto de uma só vez.

O que é preciso

Uma conta Nodion. Se ainda não tiver uma, registe-se primeiro. Nada mais: sem Docker, sem servidor, sem ficheiros de configuração.

O preset fornece uma instância funcional do n8n, com base de dados, volume, chave de encriptação e URL público. Não configura task runners externos, pelo que o n8n os executa em modo interno. O n8n considera este modo inseguro por conceção e recomenda o modo externo em produção e em qualquer instância que guarde dados sensíveis. Use esta configuração para começar e planeie a utilização de task runners externos antes de nela colocar workflows sensíveis.

Passo 1: abra o preset do n8n

Aceda à página do n8n no catálogo e clique em Deploy to Nodion. Abre-se o formulário de criação no dashboard, com o preset do n8n já selecionado. No dashboard, também pode aceder-lhe por Applications → New, depois Preset e n8n.

Passo 2: escolha o projeto, a região e o nome

O formulário preenche tudo aquilo de que o n8n precisa:

• a imagem oficial n8nio/n8n como processo web na porta 5678,
• uma base de dados PostgreSQL n8n-db, ligada através das variáveis DB_POSTGRESDB_*,
• um volume de 10 GB n8n-data, montado em /home/node/.n8n,
• uma chave de encriptação gerada (N8N_ENCRYPTION_KEY), além de N8N_HOST e WEBHOOK_URL definidos para o endereço da aplicação.

Escolha o projeto, a região e um nome. O n8n precisa de pelo menos 2 GB de memória, por isso mantenha um plano desse tamanho ou superior.

Passo 3: crie a aplicação

Crie a aplicação. A Nodion configura primeiro a base de dados e o volume, e a primeira release arranca assim que a base de dados estiver pronta. Pode acompanhá-la no separador Deployments.

Passo 4: crie a conta de proprietário

Abra o URL da aplicação. O n8n pede-lhe que crie a conta de proprietário (owner); não existe uma palavra-passe por omissão. Faça-o logo após a primeira release: enquanto a conta de proprietário não existir, qualquer pessoa que abra o URL vê a página de configuração inicial.

Passo 5: teste um webhook

Crie um workflow que comece com um nó Webhook. O URL de produção que o n8n mostra já usa o endereço da sua aplicação, porque o preset define WEBHOOK_URL. Ative o workflow, copie o Production URL do nó Webhook e envie-lhe um pedido, por exemplo com curl (substitua o marcador pelo URL que copiou):

curl -X POST <production-url-from-the-webhook-node> \
  -H "Content-Type: application/json" \
  -d '{"hello": "world"}'

A execução aparece na lista de execuções do n8n e, a partir daí, pode adicionar os passos seguintes.

Próximos passos

• Domínio próprio: adicione-o no separador Domains da aplicação e, depois, aponte N8N_HOST e WEBHOOK_URL para ele no separador Environment.
• Backups: ative os backups de n8n-db e guarde uma cópia de N8N_ENCRYPTION_KEY. Os ficheiros no volume n8n-data (/home/node/.n8n) não fazem parte dos backups da base de dados, por isso proteja ou exporte separadamente os ficheiros de que precisa.

Fazer deploy do n8n