3.8 KiB

Raw Blame History

Guía de Despliegue y Puesta en Producción: n8n + Gemini Gratuito + Cloudflare

Esta guía contiene los pasos exactos para tener tu agente conversacional funcionando en producción 100% gratis.

Paso 1: Obtener la API Key Gratuita de Google Gemini

Ingresa en Google AI Studio.
Inicia sesión con tu cuenta de Google.
Haz clic en "Get API key" -> "Create API key in new project".
Copia tu API key generada.
- Nota: La capa gratuita de Gemini 2.0 Flash / 1.5 Flash incluye 15 RPM (peticiones por minuto) y 1,500 peticiones diarias gratis, con 1,000,000 de tokens de contexto, lo cual cubre de sobra el tráfico de tu portafolio.

Paso 2: Despliegue de n8n en Oracle Cloud Always Free (o Localmente)

Opción A: En tu VPS Gratuito de Oracle Cloud (Recomendado 24/7)

Inicia sesión en tu consola de Oracle Cloud (Always Free).
Crea una instancia Compute gratuita (ej. Ubuntu 24.04 ARM Ampere o AMD x86 micro).

Instala Docker y Docker Compose:

sudo apt update && sudo apt install -y docker.io docker-compose
sudo usermod -aG docker $USER

Clona o copia la carpeta automation/n8n/ en tu servidor.
Inicia el contenedor:
```
cd automation/n8n
docker compose up -d
```
n8n estará corriendo en el puerto interno 5678.

Opción B: Probar primero en tu máquina local

En tu terminal (Arch Linux):

cd /home/bryan/Projects/PORTFOLIO/automation/n8n
docker compose up -d

Abre tu navegador en http://localhost:5678.

Paso 3: Conectar Cloudflare Tunnel (SSL Gratuito y Sin Puertos Abiertos)

Dado que tu dominio y frontend ya están en Cloudflare:

Ve a Cloudflare Zero Trust Dashboard -> Networks -> Tunnels.
Haz clic en "Create a Tunnel" (nombre: portfolio-n8n).
Selecciona Docker y copia el token provisto (eyJh...).

En el archivo automation/n8n/.env (o directamente en tu servidor):

CLOUDFLARE_TUNNEL_TOKEN=eyJh...tu_token_aqui...
N8N_PUBLIC_WEBHOOK_URL=https://chat-api.tudominio.com/

En la pestaña Public Hostname del túnel en Cloudflare:
- Subdomain: chat-api (o n8n)
- Domain: Tu dominio gestionado en Cloudflare (ej. bryanbano.com)
- Service: HTTP -> n8n:5678 (o localhost:5678 si ejecutas cloudflared como servicio).
¡Listo! Tu n8n tendrá URL pública segura https://chat-api.tudominio.com con HTTPS y protección anti-DDoS sin tocar puertos de router.

Paso 4: Importar el Flujo de Trabajo en n8n

Abre tu panel de n8n (http://localhost:5678 o tu subdominio de Cloudflare).
Crea tu cuenta de administrador de n8n en el primer inicio.
En el menú de la izquierda, haz clic en "Workflows" -> botón de "..." (arriba a la derecha) -> "Import from File".
Selecciona el archivo portfolio-chat-workflow.json.
En el nodo "Google Gemini Chat Model":
- Haz clic en Credentials -> Create New.
- Pega tu API Key obtenida en el Paso 1.
Haz clic en Save y enciende el interruptor "Active" (arriba a la derecha).
La URL de tu webhook será: https://chat-api.tudominio.com/webhook/portfolio-chat (o http://localhost:5678/webhook/portfolio-chat en local).

Paso 5: Probar el Webhook desde la Terminal

Puedes verificar que n8n responde correctamente antes de probar el frontend ejecutando:

curl -X POST http://localhost:5678/webhook/portfolio-chat \
  -H "Content-Type: application/json" \
  -d '{"message": "¿Cuál es tu stack principal Bryan?", "sessionId": "test-123"}'

Respuesta esperada:

{
  "reply": "Hola. Mi stack principal es .NET 8/9 con Clean Architecture y CQRS en backend, y Angular con Signals en frontend...",
  "sessionId": "test-123"
}

3.8 KiB Raw Blame History