Ambiente n8n de produção

Este guia descreve o ambiente de produção da 1Nort e os limites que devem ser preservados nas próximas alterações.

Endereços públicos

Editor e administração: https://workflows.1nort.com.br
Webhooks de produção: https://webhooks.1nort.com.br
MCP da instância: https://workflows.1nort.com.br/mcp-server/http

O editor não deve ser usado como endpoint de webhook. Os workflows devem sempre gerar URLs de produção usando o domínio de webhooks.

Arquitetura

O ambiente roda em Docker Swarm e utiliza execução em fila. Editor, processadores de webhook, workers e task runners são serviços independentes, mesmo quando administrados por stacks relacionadas no Portainer. Assim, a escala ou o limite de um worker pode ser alterado sem reiniciar o editor ou os webhooks.

O tráfego público passa pela Cloudflare e pelo Traefik v3. Os serviços internos não publicam portas diretamente. PostgreSQL e Redis são compartilhados no nível de infraestrutura, porém a produção utiliza database, namespace de fila e credenciais lógicas próprios.

Componentes

Componente	Responsabilidade
Editor/main	Interface, configuração, agendamentos e coordenação
Webhook processors	Recepção das chamadas públicas de produção
Workers	Execução dos workflows em fila
Task runners	Execução isolada de tarefas de código
PostgreSQL	Workflows, credenciais criptografadas e histórico permitido
Redis	Fila BullMQ e coordenação das execuções
Traefik v3	TLS e roteamento HTTP
Prometheus/Grafana	Métricas, dashboards e alertas

Regras de isolamento

O n8n anterior não é fonte de configuração para o ambiente novo.
Credenciais externas de produção são exclusivas por padrão.
A encryption key de produção nunca pode ser trocada sem um procedimento de migração validado.
Editor, webhooks, workers e runners devem permanecer na mesma versão do n8n.
Nenhuma credencial, token, cookie, payload real ou dado pessoal pode aparecer nesta documentação ou no GitHub.
Mudanças de escala devem observar fila, CPU, memória, OOM e impacto no ambiente existente.

Fonte versionada

A documentação técnica detalhada, manifests e exports sanitizados ficam no repositório privado 1Nort-Digital/n8n-workflows. O ReadMe é a visão operacional publicada; o GitHub preserva revisão, histórico e artefatos.

Alterações

Toda mudança deve registrar motivo, responsável, impacto, validação e rollback. Mudanças de proxy, banco, fila e encryption key são tratadas separadamente de mudanças comuns de workflow.