Laboratorio 08: n8n Productivo en OCI con Docker Compose

Validación del despliegue completo: contenedor n8n + PostgreSQL sobre una instancia Oracle Cloud, con persistencia y clave de cifrado correctamente generada.

Objetivo del Laboratorio

Montar paso a paso un contenedor de n8n con Docker Compose incluyendo: definición de redes, volúmenes, variables de entorno (con N8N_ENCRYPTION_KEY aleatoria), exposición del puerto en el security group de OCI, y verificación 200 OK a la URL final.

Configuración Técnica

Componente Valor Esperado
Instancia OCI Ampere A1 · Ubuntu 22.04 · 2 OCPUs · 12 GB
Puerto n8n 5678 mapeado 5678:5678
Volumen n8n_data:/home/node/.n8n
Base de datos PostgreSQL 16 en contenedor hermano
Clave de cifrado openssl rand -hex 24 — resguardada en gestor
Security List Regla de ingreso: TCP 5678 desde tu IP

Generar la encryption key

openssl rand -hex 24
# Ejemplo de salida: 4f9a8b2c3d1e5f6a7b8c9d0e1f2a3b4c5d6e7f8a
# CÓPIALA y GUÁRDALA. Se necesita en cada arranque de n8n.

Ejecución del Flujo

  1. Crea la instancia A1 en OCI (Ubuntu 22.04) y conéctate por SSH.
  2. Instala Docker + Compose: sudo apt install -y docker.io docker-compose-v2
  3. Crea el archivo docker-compose.yml con los servicios n8n y postgres (patrón del Módulo 12).
  4. Genera la key: openssl rand -hex 24 y pégala en N8N_ENCRYPTION_KEY.
  5. Ejecuta docker compose up -d.
  6. Abre el security list de OCI: añade ingreso TCP 5678 desde tu IP pública.
  7. Verifica con curl -I http://IP_PUBLICA:5678 → espera 200 OK o redirección al login.
  8. Confirma persistencia: docker compose restart y verifica que tus workflows siguen ahí.
Hito Alcanzado

Tu n8n corre en producción sobre infraestructura gratuita, con base de datos externa, persistencia total y clave de cifrado segura. Este es el estándar que el cliente percibe como "profesional".

Verificación final del laboratorio 08

Cuando hayas ejecutado la práctica, marca cada punto para confirmar que completaste el trabajo. Solo tú decides si estás listo — sé honesto contigo.

💡 Este botón desbloquea la siguiente puerta del Máster.