Esta guía explica cómo implementar n8n utilizando su imagen Docker oficial en la plataforma Jelastic Cloud (PaaS de Infomaniak).

Introducción

• A diferencia de herramientas como Zapier o Make, n8n, una herramienta de automatización de flujos de trabajo con código abierto, puede alojarse de forma autónoma, lo que le permite mantener el control total sobre sus datos y, al mismo tiempo, conectar cientos de servicios a través de una interfaz visual intuitiva.
• La imagen oficial utilizada es n8nio/n8n.
• Se recomienda encarecidamente el uso de una base de datos externa (PostgreSQL) para garantizar la estabilidad y la gestión de grandes volúmenes de datos.
• El puerto interno predeterminado es el 5678.

1. Creación del entorno Jelastic

Siga estos pasos para configurar su topología:

1. Inicie sesión en el panel de control de Jelastic Cloud.
2. Haga clic en Nuevo entorno.
3. En el asistente de creación:
   • Vaya a la pestaña Docker.
   • Haga clic en Seleccionar una imagen y busque n8nio/n8n. Especifique una versión (por ejemplo, latest o una versión específica como 1.75.0).
   • Balanceador de carga: agregue un nodo (por ejemplo, Nginx) para gestionar el SSL y el acceso público.
   • Base de datos: agregue un nodo PostgreSQL (se recomienda la versión 14+).
4. Asigne suficientes Cloudlets (se recomiendan 8 Cloudlets como mínimo para n8n en producción) y asigne un nombre a su entorno.
5. Haga clic en Crear.

2. Configuración del almacenamiento y la persistencia

Por defecto, los datos de Docker son efímeros. Es imprescindible montar un volumen:

1. En el nodo n8n, haga clic en el icono Configuración (el engranaje).
2. Vaya a la sección Volúmenes.
3. Haga clic en Añadir:
   • Ruta local: /home/node/.n8n
4. Guarde los cambios; los archivos de configuración y el cifrado local se conservarán a partir de ahora.

3. Variables de entorno esenciales

Acceda a la sección Variables de entorno del contenedor n8n para definir los siguientes parámetros:

Conexión con PostgreSQL

Para utilizar la base de datos externa, añada también:

• DB_TYPE: postgresdb
• DB_POSTGRESDB_HOST: Dirección IP interna o nombre de dominio (DNS) del nodo de Postgres.
• DB_POSTGRESDB_PORT: 5432
• DB_POSTGRESDB_DATABASE: Nombre de la base de datos (por ejemplo, n8n).
• DB_POSTGRESDB_USER: Su nombre de usuario.
• DB_POSTGRESDB_PASSWORD: Su contraseña.

4. Primer acceso y seguridad

1. Una vez que se haya reiniciado el contenedor, abra la URL de su entorno.
2. Creación de la cuenta: n8n le pedirá que cree la primera cuenta de administrador.
3. SSL: si utiliza un dominio personalizado, instale el complemento Let's Encrypt en el nodo del equilibrador de carga.

5. Verificación posterior a la instalación

• Cree un flujo de trabajo de prueba con un nodo Webhook y compruebe que la URL generada es https.
• Compruebe en los registros del contenedor si aparecen errores de conexión a la base de datos.