Este guia explica como implantar o n8n usando sua imagem Docker oficial na plataforma Jelastic Cloud (PaaS Infomaniak).

Introdução

• Ao contrário de ferramentas como Zapier ou Make, o n8n, uma ferramenta de automação de fluxo de trabalho com código aberto, pode ser auto-hospedado, permitindo que você mantenha o controle total sobre seus dados e conecte centenas de serviços por meio de uma interface visual intuitiva.
• A imagem oficial utilizada é n8nio/n8n.
• O uso de um banco de dados externo (PostgreSQL) é fortemente recomendado para garantir a estabilidade e o gerenciamento de grandes volumes de dados.
• A porta interna padrão é a 5678.

1. Criação do ambiente Jelastic

Siga os passos abaixo para configurar a sua topologia:

1. Faça login no painel de controle do Jelastic Cloud.
2. Clique em Novo ambiente.
3. No assistente de criação:
   • Vá para a aba Docker.
   • Clique em Selecionar uma imagem e procure por n8nio/n8n. Defina uma versão (ex: latest ou uma versão específica como 1.75.0).
   • Balanceador de carga: adicione um nó (ex: Nginx) para gerenciar o SSL e o acesso público.
   • Base de dados: adicione um nó PostgreSQL (versão 14+ recomendada).
4. Atribua Cloudlets suficientes (8 min. recomendados para n8n em produção) e dê um nome ao seu ambiente.
5. Clique em Criar.

2. Configuração do armazenamento e da persistência

Por padrão, os dados do Docker são efêmeros. É imperativo montar um volume:

1. No nó n8n, clique no ícone Configuração (o ícone de engrenagem).
2. Acesse a seção Volumes.
3. Clique em Adicionar:
   • Caminho local: /home/node/.n8n
4. Salve; os arquivos de configuração e a criptografia local serão preservados.

3. Variáveis de ambiente essenciais

Acesse a seção Variáveis de ambiente do contêiner n8n para definir os seguintes parâmetros:

Ligação com o PostgreSQL

Para utilizar a base de dados externa, adicione também:

• DB_TYPE: postgresdb
• DB_POSTGRESDB_HOST: Endereço IP interno ou DNS do nó Postgres.
• DB_POSTGRESDB_PORT: 5432
• DB_POSTGRESDB_DATABASE: Nome da base de dados (ex: n8n).
• DB_POSTGRESDB_USER: Seu nome de usuário.
• DB_POSTGRESDB_PASSWORD: A sua senha.

4. Primeiro acesso e segurança

1. Após reiniciar o contêiner, abra o URL do seu ambiente.
2. Criação da conta: o n8n solicitará que você crie a primeira conta de administrador.
3. SSL: se você estiver usando um domínio personalizado, instale o complemento Let's Encrypt no nó do balanceador de carga.

5. Verificação pós-instalação

• Crie um fluxo de trabalho de teste com um nó Webhook e verifique se a URL gerada está em https.
• Verifique nos logs do contêiner se não há erros de conexão com o banco de dados.