Esta guía detallada explica el proceso para desplegar la herramienta de automatización n8n utilizando la imagen Docker oficial en su plataforma PaaS Jelastic Cloud en Infomaniak.

Preámbulo

• n8n es una aplicación Node.js que a menudo se despliega a través de Docker para garantizar un entorno coherente e aislado (contenedorización).
• La imagen utilizada es n8nio/n8n, disponible en Docker Hub, asegurando una instalación estandarizada.
• Aunque n8n utiliza SQLite para el almacenamiento por defecto, una base de datos externa (PostgreSQL o MariaDB) es obligatoria para la producción para garantizar el rendimiento, la resiliencia y la escalabilidad.
• El puerto de escucha interno predeterminado de n8n es 5678/TCP.

1. Creación del entorno Jelastic, despliegue del contenedor

Para configurar el entorno:

1. Inicie sesión en el panel de control de su Jelastic Cloud.
2. Haga clic en el botón Nuevo Entorno.
3. En el selector de topología:
   • Seleccione la pestaña Docker Engine (el contenedor de la aplicación).
   • En el campo Seleccionar la imagen, utilice la función de búsqueda para encontrar y agregar la imagen oficial: n8nio/n8n (puede especificar una etiqueta como latest).
4. (Recomendación de producción): Agregue un nodo de base de datos.
   • Seleccione el nodo SQL (por ejemplo, PostgreSQL o MariaDB).
   • Configure sus recursos (Cloudlets) y las credenciales de acceso.
5. Ajuste los recursos del contenedor Docker (n8n): defina el número de Cloudlets (recursos asignados) para el contenedor n8n según la carga esperada (memoria y CPU).
6. Especifique un nombre de entorno y haga clic en el botón Crear. Jelastic aprovisiona los nodos.

2. Configuración del almacenamiento persistente y las variables de entorno

Una vez que el entorno esté activo, la configuración es esencial:

1. Localice su motor de contenedores Docker (n8n) en la lista de nodos del entorno Jelastic.
2. Haga clic en el ícono Configuración (el engranaje) junto al contenedor n8n.

Configuración de Volúmenes (almacenamiento persistente)

1. Vaya a la sección Volúmenes.
2. Agregue un nuevo volumen de tipo Montaje de volumen para persistir los datos de n8n (flujos de trabajo, claves de API, etc.).
3. Ruta interna del contenedor (destino): /home/node/.n8n.
4. Ruta externa en el nodo (origen): Elija una carpeta en el nodo (por ejemplo, /mnt/n8n_data) o un volumen de almacenamiento compartido (NFS) si está disponible.

Configuración de Variables de Entorno

1. Vaya a la sección Variables de Entorno.
2. Agregue al menos las variables de seguridad y de red:
   • N8N_HOST: El nombre de host o la URL pública de su entorno Jelastic (por ejemplo, n8n-env.jpc.infomaniak.cloud).
   • WEBHOOK_URL: La URL completa y accesible públicamente a través de la cual n8n recibe los webhooks (por ejemplo, https://n8n-env.jpc.infomaniak.cloud/).
   • N8N_BASIC_AUTH_ACTIVE: true (para proteger la interfaz).
   • N8N_BASIC_AUTH_USER: Un identificador de administrador seguro.
   • N8N_BASIC_AUTH_PASSWORD: Una contraseña segura.
3. Si ha añadido una base de datos externa, configure las variables de conexión (ejemplos para PostgreSQL):
   • DB_TYPE: postgresdb
   • DB_HOST: La dirección IP o el nombre de host del nodo PostgreSQL.
   • DB_USER, DB_PASSWORD, DB_DATABASE: Las credenciales de la base de datos.
4. Después de la modificación, vuelva al panel de control y utilice la opción Reiniciar el nodo en el contenedor n8n para aplicar todas las nuevas configuraciones.

Otros ajustes son posibles:

• Definir GENERIC_TIMEZONE para la zona horaria deseada.
• Agregar EXECUTIONS_PROCESS=main si es necesario.
• Definir N8N_ENCRYPTION_KEY con una clave fuerte para cifrar las credenciales.
• Asegúrese de que el volumen persistente esté montado antes de iniciar el contenedor.

3. Acceso y verificación

El acceso final a la aplicación:

1. En el panel de control de Jelastic, haga clic en el botón Abrir en el navegador junto al contenedor Docker Engine o al Balanceador de carga (si ha configurado uno frente a n8n).
2. El navegador debería cargar la interfaz de usuario de n8n.
3. Si la autenticación básica está activada (a través de N8N_BASIC_AUTH_ACTIVE: true), el navegador solicitará inmediatamente las credenciales configuradas.

Verificación del almacenamiento

Después de crear un primer flujo de trabajo, conectarse al contenedor Docker a través de SSH (WebSSH Jelastic o cliente externo) y verificar que los archivos de configuración y los flujos de trabajo se almacenan correctamente en el volumen persistente en la ruta /home/node/.n8n.

Verifique también que el puerto 5678 esté expuesto públicamente o a través de un Balanceador de carga HTTPS para los webhooks. Utilice HTTPS en producción (certificado Let’s Encrypt a través de Jelastic/Infomaniak).