Ir para o conteúdo
Promovaweb

Filas e pub/sub nos apps

Uma fila no Redis é uma chave que guarda as tarefas gravadas pelo app web até um worker, em outro processo, retirar e executar cada uma. O app responde ao navegador assim que grava a tarefa, enquanto o Redis repassa cada tarefa a um só worker, por isso um pico de mensagens no Chatwoot ou de execuções no n8n espera na fila até um worker ficar livre.

Ficha e sumário da página

Referência técnica
Redis 8.10.3
Revisão
13 de novembro de 2026
Conteúdo
Documentação oficial consultada
  1. Por que os apps põem uma fila no meio
  2. Chatwoot: o Sidekiq e as filas por prioridade
  3. n8n: o modo fila com workers
  4. Laravel: a conexão redis das filas
  5. Pub/sub: aviso para vários, sem guardar nada

Por que os apps põem uma fila no meio

Enviar um e-mail, baixar um anexo do WhatsApp ou rodar um workflow com dez Nodes leva de segundos a minutos. Se o processo web fizesse esse trabalho dentro da requisição, o navegador esperaria até o fim, enquanto um pico de mensagens ocuparia todos os processos web de uma vez. A fila tira esse trabalho da requisição: os workers executam as tarefas em outro processo, pela ordem das filas, no ritmo que a VPS aguenta.

O Redis cumpre bem esse papel por dois motivos. A gravação e a retirada são comandos únicos, que o servidor aplica por inteiro, de modo que dois workers não recebem a mesma tarefa da lista. O worker também espera na conexão com comandos como BRPOP, que só respondem quando chega uma tarefa ou quando o prazo acaba, sem consultar o Redis em laço.

Chatwoot: o Sidekiq e as filas por prioridade

O Chatwoot é um app Rails com as tarefas em segundo plano no Sidekiq, num container separado do serviço web. O Sidekiq grava cada tarefa com LPUSH numa lista queue:<nome> e o worker retira com BRPOP, esperando até dois segundos por chamada, valor fixo no arquivo fetch.rb do Sidekiq.

O arquivo config/sidekiq.yml do Chatwoot declara 18 filas em ordem, começando por critical, high, medium e default, com mailers e low mais abaixo. Como as filas não têm pesos, o comentário do próprio arquivo explica a consequência: uma fila de posição mais baixa só é atendida quando as de cima estão vazias, de modo que um volume grande na critical deixa a low esperando. A concorrência padrão é de dez tarefas por processo, ajustável pela variável SIDEKIQ_CONCURRENCY.

n8n: o modo fila com workers

O n8n usa o Redis só no modo fila, ligado pela variável EXECUTIONS_MODE=queue na instância principal e em cada worker. A documentação oficial descreve o percurso de uma execução assim:

  1. Instância principal

    EXECUTIONS_MODE=queue

    Recebe o gatilho, como um webhook ou um timer. Gera a execução sem rodar o workflow.

  2. Fila no Redis

    QUEUE_BULL_REDIS_HOST

    Recebe o ID da execução e guarda a fila de execuções pendentes.

  3. Worker

    n8n worker

    O próximo worker livre retira o ID da fila.

  4. Banco de dados

    O worker lê o workflow pelo ID e grava o resultado da execução.

  5. Aviso de fim

    O worker avisa o Redis que terminou. O Redis notifica a instância principal.

O modo fila do n8n, conforme a documentação oficial: a instância principal recebe o gatilho, o Redis guarda a fila de execuções e o worker executa e avisa o fim.

Dois detalhes da documentação explicam falhas comuns nessa montagem. Todos os workers precisam da mesma chave de criptografia da instância principal, porque leem do banco as credenciais cifradas por ela. O n8n também procura o Redis, por padrão, em localhost na porta 6379, sem senha, de modo que num Compose a variável QUEUE_BULL_REDIS_HOST precisa apontar para o nome do serviço do Redis. Cada worker é um processo Node.js capaz de rodar várias execuções ao mesmo tempo, por isso você aumenta a capacidade acrescentando workers.

Laravel: a conexão redis das filas

O Laravel oferece uma API única de filas sobre vários backends, como o banco de dados, o Amazon SQS e o Redis. Com QUEUE_CONNECTION=redis, os jobs vão para o Redis pela conexão default do config/database.php. O comando php artisan queue:work roda o worker que retira e executa os jobs. A opção --queue=high,default define a ordem das filas que o worker atende, no mesmo espírito das prioridades do Sidekiq.

A documentação do Laravel registra dois limites da conexão redis nas filas. As opções serializer e compression do cliente Redis não funcionam no driver de fila. Num Redis Cluster, o nome da fila precisa de uma hash tag, como {default}, para todas as chaves da fila caírem no mesmo slot. Para acompanhar as filas por um painel, o Laravel tem o Horizon, feito para filas no Redis.

Pub/sub: aviso para vários, sem guardar nada

No pub/sub, cada mensagem vai para vários destinos de uma vez: quando um processo publica uma mensagem num canal com PUBLISH, o Redis repassa a mensagem, no mesmo instante, a todos os clientes inscritos naquele canal com SUBSCRIBE. Ninguém retira a mensagem, que também não fica guardada no Redis. A documentação classifica esse comportamento como at-most-once, no máximo uma vez: um assinante desconectado durante a publicação perde a mensagem.

Fila em lista

  • Cada tarefa vai para um único worker.
  • A tarefa espera na lista até um worker retirar.
  • Um worker parado não perde tarefas, que acumulam na lista.
  • Uso nas stacks: Sidekiq, n8n e filas do Laravel.

Pub/sub em canal

  • Cada mensagem vai para todos os inscritos.
  • A mensagem existe só no instante da publicação.
  • Um assinante desconectado perde o que foi publicado.
  • Uso nas stacks: ActionCable do Chatwoot.

O Chatwoot usa o pub/sub no ActionCable, configurado com o adaptador redis no config/cable.yml. Quando o worker do Sidekiq registra uma mensagem nova, o Rails publica o aviso num canal do Redis, de onde o processo web que mantém a conexão do navegador do atendente recebe o aviso e atualiza a tela. Uma mensagem perdida ali só atrasa a atualização da tela, porque a conversa já está gravada no PostgreSQL.

Quando a mensagem precisa ficar guardada até um consumidor confirmar o processamento, a documentação do pub/sub indica os streams, que gravam cada entrada num log e aceitam grupos de consumidores com confirmação por XACK. Como uma fila também precisa sobreviver a um reinício do Redis, a página Persistência: RDB e AOF mostra quanto de escrita cada modo de gravação em disco preserva.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.