n8n em modo fila: quando separar os workers

Um fluxo que processa milhares de itens começa a rodar e, enquanto isso, os webhooks dos clientes demoram a responder. No modo padrão, tudo divide o mesmo processo. O modo fila muda isso.

Como funciona

A instância principal recebe os gatilhos e webhooks e coloca cada execução numa fila no Redis. Os workers pegam as execuções da fila e rodam os fluxos. Se a fila cresce, você sobe mais workers sem mexer na principal.

O que ele exige

Banco Postgres, porque o SQLite não funciona no modo fila, um Redis e a mesma variável N8N_ENCRYPTION_KEY em todas as instâncias, já que é com ela que as credenciais são lidas. A principal e os workers usam EXECUTIONS_MODE=queue:

services:
  n8n:
    image: n8nio/n8n
    environment:
      - EXECUTIONS_MODE=queue
      - QUEUE_BULL_REDIS_HOST=redis
  worker:
    image: n8nio/n8n
    command: worker --concurrency=5
    environment:
      - EXECUTIONS_MODE=queue
      - QUEUE_BULL_REDIS_HOST=redis
  redis:
    image: redis:7

O exemplo traz só as linhas do modo fila. As variáveis do Postgres e da chave entram nos dois serviços do n8n.

Quando ligar

Ligue quando o atraso vem de execuções disputando o mesmo processo. Banco cheio e arquivo grande na memória têm outras soluções, e o guia de como medir o n8n ajuda a separar os casos. A principal, os workers, o Redis e o Postgres cabem numa máquina só; dividir em várias máquinas fica para quando a fila não der conta. Se o n8n ainda está no SQLite, a migração para o Postgres vem antes.