Pular para o conteúdo

n8n

O template n8n instancia um Postgres gerenciado e o serviço n8n ligado a ele. O procedimento de instanciar é o de Templates de 1 clique, com o id n8n e sem parâmetros.

Janela do terminal
NAME="n8n-$(date +%s)-$RANDOM"
H="Authorization: Bearer $NEBULAR_TOKEN"
P=$(curl -sS -X POST "$NEBULAR_API/v1/projects" -H "$H" -H "Content-Type: application/json" \
-d "{\"name\": \"$NAME\"}" | jq -r .id)
curl -sS -X POST "$NEBULAR_API/v1/projects/$P/templates/n8n" \
-H "$H" -H "Content-Type: application/json" \
-H "Idempotency-Key: $NAME-n8n" -d '{}'
{"template_id": "n8n", "version": 1, "project_id": "01j9zkk07fhzv5zsmn996cdwpb", "services": [{"id": "01j9zkff8y1dmcwa49fanx9qak", "name": "db", "kind": "database"}, {"id": "01j9zkwf4q15w38y0taf680jvv", "name": "web", "kind": "app"}], "deploy_started": true}
Serviço Tipo Detalhes
db database, motor postgres cota de 1024 MB, só do n8n
web app, público imagem n8nio/n8n fixada por digest, porta 5678, 1 GB de memória e 1 vCPU, healthcheck em /healthz, volume de 5 GB em /home/node/.n8n
  • Roda como 1000:1000, com tmpfs em /home/node/.cache.
  • Postgres próprio: o n8n guarda workflows, credenciais e execuções no db. As variáveis DB_POSTGRESDB_* vêm por referência (${{db.PGHOST}} etc.) e a conexão usa TLS com verificação do certificado.
  • Chave de criptografia gerada: N8N_ENCRYPTION_KEY é gerada por instância com {{generate:secret64}} (CSPRNG) e gravada como variável sensível. É ela que cifra as credenciais que você cadastra no n8n.
  • URL de webhook: N8N_WEBHOOK_URL e N8N_EDITOR_BASE_URL apontam para a URL pública do web (${{web.PUBLIC_URL}}), com HTTPS. Os webhooks que você criar já nascem com o endereço público correto. Se mudar o endereço do app, revise essas duas variáveis.
  • Também ficam definidos: fuso America/Sao_Paulo, cookie seguro, um salto de proxy, e telemetria e avisos de versão desligados.

Abra a URL pública do web. O n8n pede para criar o usuário dono na primeira visita: faça isso logo após o deploy, antes de divulgar a URL.

Você precisa guardar três coisas. Sem a chave, o backup do banco não recupera as credenciais.

  1. Banco db: peça um backup sob demanda (POST /v1/projects/{p}/databases/{s}/backups) e veja a política de backups diários em Backup e restore. Antes de atualizar a versão do n8n, faça um backup.
  2. Chave N8N_ENCRYPTION_KEY: copie o valor para um cofre seu. Ler variável sensível exige o escopo env:reveal e confirmação de identidade (Confirmação de identidade). Para restaurar em outro projeto, defina a mesma chave antes do primeiro start, ou as credenciais salvas ficam ilegíveis.
  3. Volume /home/node/.n8n: guarda arquivos locais do n8n. As definições de workflow ficam no banco, mas exporte também os seus workflows pelo próprio n8n (menu do workflow, Download) como cópia portátil.

Cada mudança de variável vira uma versão no Histórico de configuração; o restore reaplica os valores originais sem expô-los.