8000 GitHub - LeoZanini/workshop-n8n: Workshop n8n - ambiente Docker pronto para usar · GitHub
[go: up one dir, main page]

Skip to content

About

Workshop n8n - ambiente Docker pronto para usar

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

12 Commits

Folders and files

Repository files navigation

n8n: o backend que você não deve ignorar

Ambiente completo do workshop com n8n em queue mode, PostgreSQL, Redis e Evolution API — tudo em um único docker compose up.

Windows: abra o Docker Desktop antes de rodar os comandos abaixo.

macOS / Linux:

git clone https://github.com/LeoZanini/workshop-n8n.git
cd workshop-n8n
cp .env.example .env
docker compose up -d

Windows (PowerShell):

git clone https://github.com/LeoZanini/workshop-n8n.git
cd workshop-n8n
Copy-Item .env.example .env
docker compose up -d
n8n:           http://localhost:5678
Evolution API: http://localhost:8080

Pré-requisitos

Windows e macOS

  • Docker Desktop instalado
  • Docker Desktop deve estar aberto e rodando antes de qualquer comando Docker (verifique o ícone na bandeja do sistema — deve estar verde/ativo)

Linux

  • Docker Engine + plugin Compose (sem necessidade de Docker Desktop):
# Ubuntu/Debian
sudo apt update && sudo apt install -y docker.io docker-compose-plugin
sudo usermod -aG docker $USER   # adiciona seu usuário ao grupo docker
newgrp docker                   # aplica sem precisar fazer logout

Como subir o ambiente

1. Clone o repositório

Windows (PowerShell) / macOS / Linux:

git clone https://github.com/LeoZanini/workshop-n8n.git
cd workshop-n8n

2. Crie o arquivo de variáveis de ambiente

Windows (PowerShell):

Copy-Item .env.example .env

macOS / Linux:

cp .env.example .env

O .env.example já tem todos os valores preenchidos para o workshop. Após copiar, não é necessário alterar nada.

3. Suba os containers

docker compose up -d

Na primeira execução o Docker vai baixar todas as imagens (pode demorar alguns minutos). São 5 serviços no total:

Serviço URL Descrição
n8n http://localhost:5678 Editor de workflows
n8n-worker — Processa execuções da fila (sem UI)
evolution-api http://localhost:8080 API WhatsApp
postgres porta 5432 Banco de dados
redis porta 6379 Fila e cache

4. Acesse o n8n

Abra o navegador e acesse:

http://localhost:5678

Na primeira vez, o n8n vai pedir para criar uma conta de administrador local. Preencha com qualquer e-mail e senha — esses dados ficam apenas na sua máquina.


Comandos úteis

Ação Comando
Subir o container docker compose up -d
Parar o container docker compose down
Ver logs em tempo real docker compose logs -f
Reiniciar o container docker compose restart
Atualizar o n8n docker compose pull && docker compose up -d

Persistência de dados

Os seus workflows, credenciais e configurações são armazenados em um volume Docker chamado n8n_data. Eles não são apagados quando você roda docker compose down. Para apagar tudo e começar do zero:

docker compose down -v

⚠️ O flag -v apaga o volume. Use com cuidado.


Versões fixadas

Serviço Versão
n8n 2.17.7
Evolution API v2.2.3
PostgreSQL 16
Redis 7

Versões fixadas garantem que todos os alunos rodem o mesmo ambiente.


Queue mode

O n8n está configurado com EXECUTIONS_MODE=queue. Isso significa:

  • O container n8n só serve a UI e a API
  • O container n8n-worker é quem realmente executa os workflows
  • A comunicação entre eles passa pelo Redis (Bull queue)

Essa é a arquitetura de produção do n8n — horizontal scalable, com múltiplos workers.

Para ver os logs do worker:

docker compose logs -f n8n-worker

Evolution API

A Evolution API expõe uma interface HTTP para enviar e receber mensagens do WhatsApp.

Você vai precisar de um número de WhatsApp para parear (pode ser um número secundário ou chip de teste).


Workflows do workshop

A pasta workflows/ contém os fluxos prontos de cada aula em formato .json.

Como importar um workflow no n8n

  1. Abra o n8n em http://localhost:5678
  2. Menu superior direito → Import from file
  3. Selecione o .json da aula desejada
  4. O workflow já vai aparecer com sticky notes explicando o conteúdo

Estrutura

workflows/
  aula-01-hello-world.json     ← primeiro workflow, só pra testar
  aula-02-http-request.json    ← chamando uma API externa

Troubleshooting

open //./pipe/dockerDesktopLinuxEngine: O sistema não pode encontrar o arquivo especificado (Windows)

O Docker Desktop não está rodando. Abra o Docker Desktop pela bandeja do sistema ou pelo menu Iniciar e aguarde o ícone ficar verde antes de rodar docker compose up -d.

permission denied while trying to connect to the Docker daemon socket (Linux)

Seu usuário não está no grupo docker. Rode:

sudo usermod -aG docker $USER
newgrp docker

port is already allocated — porta 5678 ou 8080 em uso

Algum outro processo está usando a porta. Para identificar:

# Linux/macOS
lsof -i :5678

# Windows (PowerShell)
netstat -ano | findstr :5678

Encerre o processo conflitante ou edite o .env para trocar a porta.

Containers sobem mas o n8n não abre no navegador

Aguarde ~30 segundos — o PostgreSQL precisa inicializar antes do n8n conectar. Verifique:

docker compose logs -f n8n

About

Workshop n8n - ambiente Docker pronto para usar

Resources

Stars

2 stars

Watchers

0 watching

Fo 3892 rks

Releases

Packages

Contributors

Languages

0