Subindo N8N com Postgresql e Docker Compose

Neste artigo vou conduzir você na criação do seu ambiente usando docke-compose.

Tecnologias utilizadas:

• ubuntu 22.04 rodando sobre o wsl2
• docker
• postgres
• n8n

Estrutura de Diretórios do Projeto

Primeiro passo é criarmos o diretório de trabalho, afinal, a organização ajuda na produtividade. Eu costumo me organizar da seguinte forma:

1. crio um diretório chamado "projetos"
2. dentro do diretório projetos crio um diretório de trabalho com o nome do meu projeto, neste caso chamei de "n8n"
3. dentro do diretório n8n criei outro diretório chamado init-data.sh, que é onde ficará meu arquivo de inicialização do banco de dados postgres.

Agora, com os diretórios criados, é hora de iniciarmos a criação do nosso arquivo docker-compose.yaml, vou deixar o arquivo aqui abaixo pra você estudá-lo!

volumes:
db_storage:
n8n_storage:


services:
postgres:
  image: postgres:16
  restart: always
  environment:
    - POSTGRES_USER
    - POSTGRES_PASSWORD
    - POSTGRES_DB
    - POSTGRES_NON_ROOT_USER
    - POSTGRES_NON_ROOT_PASSWORD
  volumes:
    - db_storage:/var/lib/postgresql/data
    - ./init-data.sh:/docker-entrypoint-initdb.d
  healthcheck:
    test: ['CMD-SHELL', 'pg_isready -h localhost -U ${POSTGRES_USER} -d ${POSTGRES_DB}']
    interval: 5s
    timeout: 5s
    retries: 10


n8n:
  image: docker.n8n.io/n8nio/n8n
  restart: always
  environment:
    - DB_TYPE=postgresdb
    - DB_POSTGRESDB_HOST=postgres
    - DB_POSTGRESDB_PORT=5432
    - DB_POSTGRESDB_DATABASE=${POSTGRES_DB}
    - DB_POSTGRESDB_USER=${POSTGRES_NON_ROOT_USER}
    - DB_POSTGRESDB_PASSWORD=${POSTGRES_NON_ROOT_PASSWORD}
  ports:
    - 5678:5678
  links:
    - postgres
  volumes:
    - n8n_storage:/home/node/.n8n
  depends_on:
    postgres:
      condition: service_healthy

Explicando o código

Iniciamos dois arquivos criando dois volumes.

volumes:
db_storage:
n8n_storage:

O objetivo é termos os dados persistidos, afinal, você não quer desligar o seu ambiente docker e perder tudo que fez, não é? Um volume para o postgresql e outro para o n8n. Faremos o mapeamento logo em seguida nas configurações dos serviços no nosso docker-compose.yaml.

Serviços:

postgres

postgres:
  image: postgres:16
  restart: always
  environment:
    - POSTGRES_USER
    - POSTGRES_PASSWORD
    - POSTGRES_DB
    - POSTGRES_NON_ROOT_USER
    - POSTGRES_NON_ROOT_PASSWORD
  volumes:
    - db_storage:/var/lib/postgresql/data
    - ./init-data.sh:/docker-entrypoint-initdb.d
  healthcheck:
    test: ['CMD-SHELL', 'pg_isready -h localhost -U ${POSTGRES_USER} -d ${POSTGRES_DB}']
    interval: 5s
    timeout: 5s
    retries: 10

Criamos este serviço para rodar um container com Postgres na versão 16. Por padrão o N8N configura um sqlite3 para uso, o que fizemos aqui foi criar um serviço postgresql para usarmos no lugar do sqlite3.

Perceba que usamos a diretiva restart: always, isso garante que se o container cair ele o docker irá tentar subi-lo novamente.

Em seguida passamos as variáveis de ambiente, as quais estão setadas num arquivo .env, dentro do projeto.

Mapeamos o volume na diretiva vlumes e temos um trecho interessante: - ./init-data.sh:/docker-entrypoint-initdb.d, fizemos um mapeamento de um arquivo init-data.sh para o entrypoint initdb.d do container, o qual tem como finalidade criar o banco de dados e permitir que nosso n8n rode e armazene nossos dados. Colocarei estes arquivos citado no fim do artigo.

Por fim, fizemos a checagem da saúde do container usando a diretiva healthcheck.

n8n

Criamos também o nosso principal serviço o N8N.

n8n:
  image: docker.n8n.io/n8nio/n8n
  restart: always
  environment:
    - DB_TYPE=postgresdb
    - DB_POSTGRESDB_HOST=postgres
    - DB_POSTGRESDB_PORT=5432
    - DB_POSTGRESDB_DATABASE=${POSTGRES_DB}
    - DB_POSTGRESDB_USER=${POSTGRES_NON_ROOT_USER}
    - DB_POSTGRESDB_PASSWORD=${POSTGRES_NON_ROOT_PASSWORD}
  ports:
    - 5678:5678
  links:
    - postgres
  volumes:
    - n8n_storage:/home/node/.n8n
  depends_on:
    postgres:
      condition: service_healthy

Usamos uma imagem n8n para tal.

Setamos as variáveis de ambiente e aqui tem um detalhe, fizemos o mapeamento de algumas variáveis para valores do nosso postgredb, criado acima. Para isso, perceba que sempre usamos a estrutura de varíavel do unix: ${alguma_variavel}.

Logo abaixo usamos uma diretiva chamada links, ela serve para estabelecer comunicação entre o serviço do N8N e o serviço do POSTGRES. Eu sei, essa diretiva foi descontinuada e não é mais necessário seu uso, afinal, o docker já faz isso de forma dinâmica, mas o projeto é meu e eu faço como quero!

Brincadeiras à parte, logo em seguida mapeamos o volume do n8n.

Por fim, usamos a diretiva depends-on para garantir que o n8n só suba quando o banco de dados estiver saudável.

Arquivo .env

POSTGRES_USER=postgres
POSTGRES_PASSWORD=postgres
POSTGRES_DB=n8n


POSTGRES_NON_ROOT_USER=admin
POSTGRES_NON_ROOT_PASSWORD=admin

Arquivo 01-init.sql

Antes de te entregar o arquivo, preciso dizer que este arquivo serve para criar seu banco de dados e dar os devidos privilégios para que seja possível que o n8n crie suas tabelas a partir do usuário que estamos criado. Os valores do user estão fixo como admin, mas também poderiam ser passados por variável.

-- Cria um usuário sem permissão root se não existir
DO $$ BEGIN
CREATE USER admin WITH PASSWORD 'admin';
EXCEPTION WHEN DUPLICATE_OBJECT THEN
NULL;
END $$;


-- Concede privilégios ao user admin no banco de dados
GRANT ALL PRIVILEGES ON DATABASE n8n TO admin;


-- Concede privilégios ao user admin no schema public
GRANT ALL PRIVILEGES ON SCHEMA public TO admin;
GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO admin;
GRANT ALL PRIVILEGES ON ALL SEQUENCES IN SCHEMA public TO admin;


-- Configura privilégios padrões para novos objetos para o usuário admin
ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT ALL PRIVILEGES ON TABLES TO admin;
ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT ALL PRIVILEGES ON SEQUENCES TO admin;

Este arquivo foi criado dentro do diretório init-data.sh

Aplicação rodando no docker

Interface N8N