Auto-hospede o n8n com TrueFoundry

n8n é uma poderosa plataforma de automação de fluxo de trabalho de código aberto que permite criar fluxos de trabalho complexos usando uma interface visual baseada em nós. Embora o n8n ofereça uma versão em nuvem, a capacidade de auto-hospedar o n8n lhe dá controle total sobre seus dados, custos e desempenho da instância.

Com a plataforma de implantação da TrueFoundry, você pode facilmente auto-hospedar o n8n na sua própria infraestrutura sem se perder em configurações complexas do Kubernetes. Este guia o acompanhará por todo o processo para ter sua instância n8n auto-hospedada em execução, desde a configuração do armazenamento até a implantação do aplicativo.

Pré-requisitos para Implantar n8n

Antes de começar, certifique-se de ter o seguinte configurado. Estes são essenciais para uma experiência de implantação tranquila.

1. Conta e Cluster TrueFoundry: Você precisa de uma conta TrueFoundry ativa conectada ao seu cluster Kubernetes. Se ainda não o fez, siga nosso guia de configuração de conta.
2. CLI TrueFoundry: A Interface de Linha de Comando (CLI) da TrueFoundry é necessária para implantar a partir do seu terminal. Instale e configure-a usando nosso guia de configuração da CLI.
3. Workspace: Todas as implantações no TrueFoundry ocorrem dentro de um workspace. Crie um novo workspace ou identifique o workspace de destino no qual você deseja implantar o n8n. Você pode aprender mais sobre workspaces em nossa documentação de conceitos-chave.

Por que auto-hospedar o n8n? As Principais Vantagens

Embora as plataformas em nuvem ofereçam conveniência, auto-hospedar sua instância do n8n desbloqueia um novo nível de poder, controle e eficiência que é fundamental para empresas com sérios objetivos de automação. É como passar de um espaço alugado para ser dono da sua própria fábrica.

Aqui estão as principais vantagens:

Soberania e Segurança Completas dos Dados

• Mantenha Seus Dados Privados: Ao auto-hospedar, seus dados sensíveis — incluindo credenciais, informações de clientes e lógica de negócios proprietária dentro de seus fluxos de trabalho — nunca saem da sua própria infraestrutura.
• Cumpra a Conformidade de Frente: Para indústrias com regulamentações de dados rigorosas como GDPR, HIPAA ou SOC 2, a auto-hospedagem é frequentemente um requisito, não apenas uma preferência. Ela oferece um ambiente de processamento de dados claro e auditável.
• Controle Sua Postura de Segurança: Você define as políticas de rede, gerencia os controles de acesso e implementa protocolos de segurança que se alinham aos padrões da sua empresa.

Custo Previsível e Escala Ilimitada

• Fuja da Precificação por Execução: Em vez de pagar um custo variável para cada execução de fluxo de trabalho, seus custos estão atrelados à infraestrutura que você provisiona, tornando-os previsíveis e, muitas vezes, significativamente mais baixos em escala.
• Sem Limites Artificiais: Remova as restrições no número de fluxos de trabalho ativos, usuários ou tempos de execução impostas por planos de nuvem em camadas. Você é limitado apenas pelo poder da infraestrutura que você lhe oferece.

Desempenho e Personalização Incomparáveis

• Desempenho Dedicado: Sua instância n8n é executada em recursos dedicados. Isso significa tempos de execução mais rápidos e nenhum efeito de "vizinho barulhento", o que é crucial para automações sensíveis ao tempo.
• Personalização Completa: Precisa instalar um nó de comunidade personalizado ou um nó privado e interno? Com uma instância auto-hospedada, você tem a liberdade de estender e personalizar seu ambiente n8n sem restrições.

Seção 2: Os Desafios Comuns da Auto-Hospedagem do n8n

Embora os benefícios sejam claros, configurar e gerenciar uma instância n8n auto-hospedada e pronta para produção do zero pode ser um desafio técnico significativo. Desenvolvedores e equipes de plataforma frequentemente enfrentam uma curva de aprendizado acentuada e encontram vários obstáculos comuns:

1. Configuração Complexa do Kubernetes

• Sobrecarga de YAML: Escrever e manter manualmente arquivos YAML do Kubernetes para implantações, serviços, ingress e segredos é tedioso e altamente propenso a erros.
• Rede e Ingress: Configurar corretamente políticas de rede, configurar um controlador de ingress e gerenciar certificados SSL/TLS para expor o n8n de forma segura à internet é uma tarefa complexa.

2. Gerenciamento de Dados Persistentes

• Problemas de Aplicações Stateful: Como uma aplicação stateful, o n8n requer um volume persistente para armazenar dados de fluxo de trabalho e credenciais. Configurar corretamente PersistentVolumeClaims e garantir que o volume seja montado corretamente pode ser complicado.
• Gerenciamento de Banco de Dados: Para uso em produção, um banco de dados robusto como o PostgreSQL é recomendado em vez do SQLite padrão. Isso adiciona outro componente para implantar, gerenciar, proteger e conectar.

3. Escalabilidade para Cargas de Trabalho de Produção

• Além de uma Única Instância: Dimensionar o n8n para fluxos de trabalho de alto volume exige a mudança para uma configuração multi-nó com workers dedicados, o que envolve a configuração de filas (como Redis), balanceadores de carga e a garantia de alta disponibilidade.
• Monitoramento e Manutenção: Uma instância auto-hospedada requer monitoramento ativo para rastrear o uso de recursos (CPU/Memória) e garantir a disponibilidade. A atualização para novas versões do n8n também exige um processo manual e cuidadoso.

Esses desafios frequentemente desviam tempo valioso de engenharia da construção de automações para o gerenciamento da infraestrutura. É precisamente aqui que uma plataforma de implantação simplificada se torna essencial

Como auto-hospedar o n8n usando Truefoundry

Passo 1: Criar um Volume Persistente para n8n

Qualquer n8n auto-hospedado instância requer armazenamento persistente para salvar seus fluxos de trabalho, credenciais e dados de execução. Se a instância for reiniciada, este volume garante que todos os seus dados estejam seguros. Você pode criar este volume usando a interface do usuário (UI) do TrueFoundry ou nosso SDK Python.

Opção A: Usando a UI do TrueFoundry

Para uma abordagem sem código, você pode criar o volume necessário diretamente através da nossa interface web. Siga os passos detalhados em nosso guia de criação de volume.

Opção B: Usando Implantação Python

Para uma configuração baseada em código e repetível, você pode definir o volume em um script Python.

1. Crie um arquivo chamado volume_deploy.py.
2. Adicione o seguinte código. Lembre-se de substituir os valores de espaço reservado para storage_class e workspace_fqn.

import logging
from truefoundry.deploy import (
    DynamicVolumeConfig,
    Volume,
)

logging.basicConfig(level=logging.INFO)

# Define the persistent volume for n8n data
volume = Volume(
    name="n8n-volume",
    # Replace with your cluster's storage class size
    config=DynamicVolumeConfig(storage_class="efs-sc", size=2),
    workspace_fqn="<your-workspace-fqn>", # Paste your Workspace FQN here
)

# Deploy the volume to your workspace
volume.deploy(workspace_fqn="<your-workspace-fqn>", wait=False)

3. Execute o script a partir do seu terminal:

python volume_deploy.py

Passo 2: Implementar o Serviço n8n

Com o volume de armazenamento pronto, pode agora implementar a aplicação n8n. Este serviço irá executar o contentor Docker do n8n e conectá-lo ao volume que criou.

1. Crie um novo ficheiro chamado service_deploy.py.
2. Cole o seguinte código. Terá de substituir os marcadores de posição para host, volume_fqn, e workspace_fqn.

import logging
from truefoundry.deploy import (
    Image,
    VolumeMount,
    Service,
    Port,
)

logging.basicConfig(level=logging.INFO)

service = Service(
    name="n8n-svc",
    image=Image(image_uri="docker.n8n.io/n8nio/n8n"),
    ports=[
        Port(
            port=5678,
            protocol="TCP",
            expose=True,
            app_protocol="http",
            host="<your-host-name>", # e.g., n8n.your-company.com
        )
    ],
    env={}, # Add license keys or other env vars here
    mounts=[
        VolumeMount(
            mount_path="/home/node/.n8n",
            volume_fqn="<your-volume-fqn>", # Paste the FQN of the volume from Step 1
        )
    ],
    workspace_fqn="<your-workspace-fqn>", # Paste your Workspace FQN here
)

service.deploy(workspace_fqn="<your-workspace-fqn>", wait=False)

Notas de Configuração:

• host: Este é o URL público onde irá aceder ao n8n. Encontre o seu domínio de host disponível seguindo o nosso guia de portas e domínios.
• volume_fqn: Este é o Nome Totalmente Qualificado do volume que você criou na Etapa 1. Você pode encontrá-lo na página do volume no painel do TrueFoundry.
• workspace_fqn: O FQN do espaço de trabalho onde você deseja implantar o serviço.

3. Execute o script para implantar o serviço n8n:

python service_deploy.py

Etapa 3: Acesse Sua Instância n8n

Assim que a implantação for concluída, navegue até a URL do host que você configurou no arquivo service_deploy.py . Você será recebido pela tela de configuração do n8n.

Agora você pode:

• Criar automações de fluxo de trabalho poderosas.
• Conectar-se a centenas de serviços e APIs diferentes.
• Construir pipelines complexos de processamento de dados.
• Configurar tarefas agendadas e gatilhos para seus trabalhos.

Sua instância n8n está agora totalmente operacional e executando em sua própria infraestrutura com armazenamento persistente, garantindo que seus fluxos de trabalho e credenciais sejam preservados em qualquer reinício.

Desbloqueando Recursos Empresariais do n8n

Este guia implanta a edição comunitária do n8n. Se você tiver uma licença empresarial, poderá desbloquear recursos adicionais adicionando sua chave de licença ao dicionário env no service_deploy.py arquivo.

Você pode encontrar mais detalhes sobre variáveis de ambiente na documentação oficial do n8n.

Solução de problemas

Caso encontre problemas, verifique primeiro o seguinte:

• Classe de Armazenamento Inválida: Certifique-se de que a storage_class que você especificou em volume_deploy.py esteja disponível e seja compatível com o seu cluster.
• FQN Incorreto: Verifique novamente se os workspace_fqn e volume_fqn valores estão corretos e não contêm erros de digitação.
• Logs de Implantação: Se uma implantação falhar, verifique os logs do serviço no painel do TrueFoundry para mensagens de erro detalhadas.

Conclusão

Parabéns! Você aprendeu com sucesso como auto-hospedar o n8n usando o TrueFoundry. Esta configuração de n8n auto-hospedado não só lhe dá controle total sobre seus fluxos de trabalho e dados, mas também oferece uma base escalável e robusta para todas as suas necessidades de automação.