Self Host n8n con TrueFoundry

n8n es una potente plataforma de automatización de flujos de trabajo de código abierto que le permite crear flujos de trabajo complejos mediante una interfaz visual basada en nodos. Si bien n8n ofrece una versión en la nube, la capacidad de autohospedador n8n le brinda un control total sobre los datos, los costos y el rendimiento de las instancias.

Con la plataforma de implementación de TrueFoundry, puede autohospedador n8n en su propia infraestructura sin perderse en configuraciones complejas de Kubernetes. Esta guía lo guiará a través de todo el proceso para obtener su n8n autohospedado instancia en ejecución, desde la configuración del almacenamiento hasta la implementación de la aplicación.

Previos requisitos para la implementación de n8n

Antes de empezar, asegúrese de tener la siguiente configuración. Son esenciales para una experiencia de implementación fluida.

1. TrueFoundry Account and Cluster: Necesitas una cuenta de TrueFoundry activa conectada a tu clúster de Kubernetes. Si aún no lo has hecho, sigue nuestro guía de configuración de cuentas.
2. CLI de TrueFoundry: La interfaz de línea de comandos (CLI) de TrueFoundry es necesaria para la implementación desde su terminal. Instálala y configúrala usando nuestro CLI Configuration Guide.
3. Work space: Todas las implementaciones en TrueFoundry se realizan dentro de un espacio de trabajo. Cree un nuevo espacio de trabajo o identifique el espacio de trabajo de destino en el que desea implementar n8n. Puedes obtener más información sobre los espacios de trabajo en nuestra documentación de conceptos clave.

¿Por qué Self-Host n8n? Las principales ventajas

Si bien las plataformas en la nube ofrecen comodidad, el autohospedaje de su instancia n8n desbloquea un nuevo nivel de potencia, control y eficiencia que es fundamental para las empresas con objetivos de automatización serios. Se trata de pasar de un espacio alquilado a ser propietario de tu propia fábrica.

Estas son las principales ventajas:

Soberanía y seguridad completas de los datos

• Mantenga la privacidad de sus datos: Cuando se hospeda por sí mismo, sus datos confidenciales (incluidas las credenciales, la información de los clientes y la lógica empresarial patentada de sus flujos de trabajo) nunca salen de su propia infraestructura.
• Conozca el cumplimiento de manera frontal: Para los sectores con normas de datos restrictivas, como el RGPD, la HIPAA o el SOC 2, el autoalojamiento suele ser un requisito, no solo una preferencia. Proporciona un entorno de procesamiento de datos claro y auditable.
• Controle su postura de seguridad: Usted define las políticas de red, administra los controles de acceso e implementa protocolos de seguridad que se alinean con los estándares de su empresa.

Coste predecible y escala ilimitada

• Prices for Execution de Escape: En lugar de pagar un costo variable por cada ejecución de flujo de trabajo, sus costos están vinculados a la infraestructura que aprovisiona, lo que los hace predecibles y, a menudo, significativamente más bajos a escala.
• Sin límites artificiales: Elimine las restricciones en la cantidad de flujos de trabajo activos, usuarios o tiempos de ejecución impuestos por los planes de nube por niveles. Solo está limitado por la potencia de la infraestructura que le proporciona.

Rendimiento y personalización incomparables

• Rendimiento dedicado: Su instancia n8n se ejecuta en recursos dedicados. Esto se traduce en tiempos de ejecución más rápidos y en la ausencia del efecto de «vecino ruidoso», algo crucial para las automatizaciones urgentes.
• Personalización completa: ¿Necesitas instalar un nodo comunitario personalizado o un nodo interno privado? Con una instancia autohospedada, tiene la libertad de ampliar y personalizar su entorno n8n sin restricciones.

Sección 2: Los desafíos comunes del autohospedaje de n8n

Si bien las ventajas son evidentes, configurar y gestionar desde cero una instancia n8n autohospedada y lista para la producción puede suponer un importante desafío técnico. Los desarrolladores y los equipos de plataformas suelen enfrentarse a una curva de aprendizaje empinada y a varios obstáculos comunes:

1. Configuración compleja de Kubernetes

• YAML OVERLOAD: Escribir y mantener manualmente los archivos YAML de Kubernetes para las implementaciones, los servicios, el ingreso y los secretos es tedioso y muy propenso a errores.
• Creación de redes e ingreso: Configurar correctamente las políticas de red, configurar un controlador de entrada y administrar los certificados SSL/TLS para exponer n8n de forma segura a Internet es una tarea compleja.

2. Administración de datos persistentes

• Application problems with state: Como aplicación con estado, n8n requiere un volumen persistente para almacenar los datos de flujo de trabajo y credenciales. Configurar correctamente Reclamaciones de volumen persistentes y garantizar que el volumen esté correctamente montado puede resultar complicado.
• Administración de bases de datos: Para uso en producción, se recomienda una base de datos sólida como PostgreSQL en lugar de la SQLite predeterminada. Esto agrega otro componente para implementar, administrar, proteger y conectarse.

3. Escalamiento para cargas de trabajo de producción

• Más allá de una única instancia: Escalar n8n para flujos de trabajo de gran volumen requiere pasar a una configuración multinodo con trabajadores dedicados, lo que implica configurar colas (como Redis), balanceadores de carga y garantizar una alta disponibilidad.
• Supervisión y mantenimiento: Una instancia autohospedada requiere una supervisión activa para rastrear el uso de los recursos (CPU/memoria) y garantizar el tiempo de actividad. La actualización a las nuevas versiones de n8n también requiere un proceso manual y cuidadoso.

Estos desafíos a menudo desvían un valioso tiempo de ingeniería de la construcción de automatizaciones a la administración de la infraestructura. Precisamente aquí es donde resulta esencial contar con una plataforma de implementación optimizada

Cómo autohospedar n8n usando Truefoundry

Paso 1: Crear un volumen persistente para n8n

Any n8n autohospedado La instancia requiere almacenamiento persistente para guardar los flujos de trabajo, las credenciales y los datos de ejecución. Si la instancia se reinicia, este volumen garantiza que todos tus datos estén seguros. Puedes crear este volumen con la interfaz de usuario de TrueFoundry o nuestro SDK de Python.

Opción A: Uso de la interfaz de usuario de TrueFoundry

Para un enfoque sin código, puede crear el volumen requerido directamente a través de nuestra interfaz web. Siga los pasos detallados en nuestro guide de creación de volúmenes.

Opción B: uso de Python Deployment

Para una configuración repetible basada en código, puede definir el volumen en una secuencia de comandos de Python.

1. Crea un archivo con el nombre volume_deploy.py.
2. Añade el siguiente código. Recuerde reemplazar los valores de los marcadores de posición por clase_almacenamiento y 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. Ejecuta el script desde tu terminal:

python volume_deploy.py

Paso 2: Implementa el servicio n8n

Con el volumen de almacenamiento listo, ahora puede implementar la propia aplicación n8n. Este servicio ejecutará el contenedor Docker de n8n y lo conectará al volumen que creaste.

1. Crea un nuevo archivo con el nombre service_deploy.py.
2. Pegue el siguiente código. Tendrás que reemplazar los marcadores de posición por anfitrión, volumen_fqn, y 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)

Configuration notes:

• anfitrión: Esta es la URL pública desde la que accederás a n8n. Encuentra tu dominio de alojamiento disponible siguiendo nuestra guide of ports and domains.
• volumen_fqn: Es el nombre completo del volumen que creó en el paso 1. Puedes encontrarlo en la página del volumen, en el panel de control de TrueFoundry.
• workspace_fqn: El FQN del espacio de trabajo en el que desea implementar el servicio.

3. Ejecute el script para implementar el servicio n8n:

python service_deploy.py

Paso 3: Acceda a su instancia n8n

Una vez finalizada la implementación, navegue hasta la URL del host que configuró en el service_deploy.py archivo. Aparecerá la pantalla de configuración de n8n.

Ahora puede:

• Cree potentes automatizaciones de flujo de trabajo.
• Conéctese a cientos de servicios y API diferentes.
• Cree canales de procesamiento de datos complejos.
• Configure tareas y activadores programados para sus trabajos.

Su instancia n8n ahora está completamente operativa y se ejecuta en su propia infraestructura con almacenamiento persistente, lo que garantiza que sus flujos de trabajo y credenciales se conserven en cualquier reinicio.

Unlock of the functions of n8n Enterprise

Esta guía implementa la edición comunitaria de n8n. Si tiene una licencia empresarial, puede desbloquear funciones adicionales añadiendo su clave de licencia a la env diccionario in the service_deploy.py archivo.

Puede encontrar más información sobre las variables de entorno en documentación oficial de n8n.

Solução de problemas

Si tienes problemas, comprueba primero algunas cosas:

• Clase de almacenamiento no válida: Garantizar la clase_almacenamiento especificaste en volume_deploy.py está disponible y es compatible con su clúster.
• FQN incorrecto: Compruebe que el workspace_fqn y volumen_fqn los valores son correctos y no contienen errores tipográficos.
• Registros de implementación: Si una implementación falla, consulte los registros de servicio en el panel de TrueFoundry para ver los mensajes de error detallados.

Conclusión

¡Felicidades! Ha aprendido con éxito cómo autohospedador n8n usando TrueFoundry. Esto n8n autohospedado La configuración no solo le brinda un control total sobre sus flujos de trabajo y datos, sino que también proporciona una base sólida y escalable para todas sus necesidades de automatización.