n8n

El soporte de n8n está disponible a partir de Zylon 1.52

Integración de n8n

n8n es una herramienta de automatización de flujos que ahora está integrada en Zylon, permitiendo crear flujos conectando diferentes servicios y sistemas. El despliegue y la configuración de n8n son gestionados automáticamente por Zylon, requiriendo una configuración mínima por parte del usuario.

Consideraciones importantes

Gestión de versiones: Zylon gestiona la versión de n8n desplegada para asegurar la compatibilidad con el resto del sistema. Las actualizaciones manuales de n8n no están disponibles.
Acceso: n8n está disponible en su propio subdominio (por defecto: https://n8n.tu-instancia-zylon.com)
Gestión de usuarios: La gestión de usuarios en n8n es independiente de los usuarios de Zylon. Los usuarios deben crearse y gestionarse directamente dentro de la interfaz de n8n.

Configuración

Para habilitar n8n en tu entorno solo necesitas modificar la opción correspondiente en el archivo /etc/zylon/zylon-conf.yaml:

n8n:
  enabled: true  # Establecer en false para deshabilitar n8n
  host: ""  # (opcional) Especifica un host personalizado.
  publicApi:
    enabled: false  # Habilitar la API REST pública de n8n
  externalConnection:
    enabled: false  # Permitir conexiones salientes a servicios de n8n
  license:
    key: ""  # Clave de licencia de n8n
    type: ""  # Tipo de licencia (community or enterprise)

La API pública de n8n permite gestionar workflows, ejecuciones, credenciales y otros recursos de forma programática mediante endpoints REST (Documentación de la API)

Los campos de license solo aplican cuando externalConnection.enabled está configurado en true y se tiene conexión a internet.

En modo Semi/Full AirGap, externalConnection.enabled siempre estará en false independientemente del valor configurado.

Configuración de Certificados SSL (Opcional)

Esta sección es necesaria únicamente si no estás utilizando certificados de Let’s Encrypt

Si tu instalación de Zylon utiliza certificados SSL manuales (no Let’s Encrypt), necesitarás crear un secret adicional de Kubernetes específicamente para n8n.

Crear un Secret para n8n

Una vez tengas tus archivos de certificado listos (tls.crt y tls.key), crea un secret en el cluster de Kubernetes específicamente para n8n:

# Crear el secret SSL de n8n
sudo k0s kubectl create secret tls zylon-tls-n8n --key tls.key --cert tls.crt -n zylon

# Verifica que se creó correctamente
sudo k0s kubectl describe secret zylon-tls-n8n -n zylon

Después de crear el secret, recarga la configuración:

sudo zylon-cli sync

Tu instancia de n8n ahora utilizará HTTPS con los certificados SSL configurados.

External Connections

Cuando las conexiones externas están deshabilitadas, ciertas funcionalidades de n8n se desactivan automáticamente:

Paquetes de la comunidad: La instalación de paquetes desde el registro NPM está deshabilitada
Templates de flujos de trabajo: Los templates de flujos de trabajo de la comunidad están deshabilitados
Activación de licencias: Las licencias no se validan y no funcionarán en este modo

Estas restricciones aseguran que n8n opere sin dependencias externas.

Configuración de Proxy

n8n utiliza la configuración global de proxy de Zylon. El propio sistema se encarga de gestionar automáticamente los certificados y endpoints del proxy, por lo que no se requiere configuración adicional específica para n8n. Si tu organización usa un proxy, configúralo siguiendo la guía de configuración de proxy.

Solución de Problemas

DNS

Si experimentas problemas de resolución DNS con n8n (por ejemplo, búsquedas lentas o fallidas para servicios internos), puedes necesitar ajustar la configuración dnsConfig.options.ndots. Para aplicar configuraciones DNS personalizadas, añade lo siguiente a tu configuración:

n8n:
  dnsConfig:
    options:
      - name: ndots
        value: "1" # El valor por defecto es 5

Después de hacer cambios, ejecuta sudo zylon-cli sync para aplicarlos.

Rechazo de Certificados

Si tienes un certificado autofirmado, n8n podría rechazarlo. Para evitar la verificación TLS en llamadas internas puedes configurar el siguiente flag:

n8n:
  tlsRejectUnauthorized: 0  # El valor por defecto es 1

Después de hacer cambios, ejecuta sudo zylon-cli sync para aplicarlos.

Gestión de Backups

n8n utiliza PostgreSQL como base de datos, lo que significa que toda la información de n8n se incluye automáticamente en los backups estándar de base de datos de Zylon. Para más información sobre la gestión de backups, consulta la documentación de backups de Zylon. Para casos específicos de migración o transferencia de workflows entre entornos, consulta la sección Importación y Exportación de Workflows.

Aplicar Configuración

Después de modificar el archivo de configuración, aplica los cambios:

sudo zylon-cli sync

Importación y Exportación de Workflows

n8n proporciona comandos CLI que permiten la exportación e importación selectiva de entidades. Estos comandos son especialmente útiles para:

Migración desde otros entornos: Si se desea migrar a Zylon información de n8n desde otro entorno existente.
Importación selectiva: Exportar workflows específicos desde otros entornos e importarlos en Zylon sin necesidad de migrar la instancia completa.

Para más información sobre comandos CLI, consulta la documentación oficial de n8n.

Comandos básicos de Exportación

Exportar todos los workflows:

n8n export:workflow --all --output=/home/node/.n8n/workflows.json

Exportar un workflow específico:

n8n export:workflow --id=42 --output=/home/node/.n8n/workflow-42.json

Exportar credenciales:

n8n export:credentials --all --output=/home/node/.n8n/credentials.json

Exportar credenciales desencriptadas:

n8n export:credentials --all --output=/home/node/.n8n/credentials.json --decrypted

Usa la opción --decrypted cuando migres entre instancias con diferentes claves de encriptación.

Exportar instancia completa:

n8n export:entities --outputDir=./outputs --includeExecutionHistoryDataTables=true

Comandos básicos de Importación

Importar workflows:

n8n import:workflow --input=/home/node/.n8n/workflows.json

Importar un workflow específico:

n8n import:workflow --input=/home/node/.n8n/workflow-42.json

Importar credenciales:

n8n import:credentials --input=/home/node/.n8n/credentials.json

Importar instancia completa:

Solo funciona si el tipo de base de datos de exportación coincide con el tipo de base de datos de destino. Zylon n8n utiliza PostgreSQL.

n8n import:entities --inputDir ./outputs --truncateTables true

Transferir archivos desde tu máquina local

Si necesitas importar workflows, credenciales u otros archivos ubicados en tu máquina local, primero debes transferirlos al pod de n8n:

1. Obtener el ID del volumen persistente

# Obtener el ID del Persistent Volume de n8n
N8N_PV_ID=$(kubectl get pvc zylon-n8n-data -o jsonpath='{.spec.volumeName}' -n zylon)

# Construir la ruta del directorio
N8N_PV_DIR="/var/zylon/data/$N8N_PV_ID"

# Ver el resultado
echo $N8N_PV_DIR

2. Copiar archivos al volumen

# Copiar archivo desde tu máquina local
sudo cp /ruta/local/workflows.json $N8N_PV_DIR/

3. Acceder al pod y verificar el archivo

kubectl exec -it deployment/zylon-n8n -n zylon -- /bin/sh
# Dentro del pod, verifica que el archivo esté disponible
ls /home/node/.n8n/

Notas Importantes

Las entidades exportadas conservan sus IDs originales, por lo que importarlas sobrescribirá las entidades existentes con el mismo ID.

Los archivos de exportación deben ubicarse en un directorio accesible dentro del pod, típicamente /home/node/.n8n/.

Primeros pasos

Instalación

Mantenimiento y Operaciones

Backoffice

Configuración

Solución de Problemas

Seguridad

Auditabilidad y gobernanza de IA

Integración de n8n

Consideraciones importantes

Configuración

Configuración de Certificados SSL (Opcional)

Crear un Secret para n8n

External Connections

Configuración de Proxy

Solución de Problemas

DNS

Rechazo de Certificados

Gestión de Backups

Aplicar Configuración

Importación y Exportación de Workflows

Comandos básicos de Exportación

Comandos básicos de Importación

Transferir archivos desde tu máquina local

1. Obtener el ID del volumen persistente

2. Copiar archivos al volumen

3. Acceder al pod y verificar el archivo

Notas Importantes

​Integración de n8n

​Consideraciones importantes

​Configuración

​Configuración de Certificados SSL (Opcional)

​Crear un Secret para n8n

​External Connections

​Configuración de Proxy

​Solución de Problemas

​DNS

​Rechazo de Certificados

​Gestión de Backups

​Aplicar Configuración

​Importación y Exportación de Workflows

​Comandos básicos de Exportación

​Comandos básicos de Importación

​Transferir archivos desde tu máquina local

​1. Obtener el ID del volumen persistente

​2. Copiar archivos al volumen

​3. Acceder al pod y verificar el archivo

​Notas Importantes

Integración de n8n

Consideraciones importantes

Configuración

Configuración de Certificados SSL (Opcional)

Crear un Secret para n8n

External Connections

Configuración de Proxy

Solución de Problemas

DNS

Rechazo de Certificados

Gestión de Backups

Aplicar Configuración

Importación y Exportación de Workflows

Comandos básicos de Exportación

Comandos básicos de Importación

Transferir archivos desde tu máquina local

1. Obtener el ID del volumen persistente

2. Copiar archivos al volumen

3. Acceder al pod y verificar el archivo

Notas Importantes