🚀 2.11 · Deploy: lleva tu API de localhost a internet

🎯 Objetivo del tema

🗺️ Mapa del tema

Construir la API es solo la mitad del trabajo: la otra mitad es llevarla a internet. En la era del cloud, el deploy es sorprendentemente fácil: subes tu código a GitHub, conectas una plataforma de deploy (Railway, Render, Vercel), y en 2 minutos tienes tu API en producción con HTTPS automático. Vamos a ver el flujo completo, las mejores plataformas de 2024-2025, y los errores más comunes del primer deploy.

2.11.1 Las 3 mejores plataformas de deploy para Node.js

En 2024-2025 hay 3 plataformas que dominan el deploy moderno de Node.js: Railway, Render y Vercel. Las 3 tienen plan gratuito, HTTPS automático, y deploy con cada push a GitHub. La elección depende de tu caso de uso, no del precio (las 3 son baratas o gratis para empezar).

2.11.2 El flujo completo: de GitHub a producción

El deploy moderno es RIDÍCULAMENTE simple: subes tu código a GitHub, conectas tu repo a una plataforma, y cada vez que hagas push, la plataforma redespliega automáticamente. CI/CD gratis y sin configurar nada.

Paso a paso: tu primer deploy en Railway

• 1. Sube tu código a GitHub: git init, git add, git commit, git push.
• 2. Crea cuenta en railway.app con tu GitHub.
• 3. 'New Project' > 'Deploy from GitHub repo' > selecciona tu repo.
• 4. Railway detecta automáticamente que es Node.js (gracias al package.json).
• 5. Configura las variables de entorno: pestaña 'Variables' > agrega las de tu .env (excepto las que ya inyecta Railway).
• 6. Railway instala dependencias (npm install) y ejecuta 'npm start' automáticamente.
• 7. En 2-3 minutos, tu API está en producción en una URL tipo https://mi-app.railway.app.
• 8. Cada push a main redespliega automáticamente. Magia.

2.11.3 Variables de entorno en producción

Las variables de entorno son el mecanismo para configurar tu app según el entorno: desarrollo, staging, producción. En desarrollo las pones en .env (con dotenv); en producción las configuras en la plataforma. NUNCA subas el .env a Git: cada entorno tiene las suyas.

// .env (desarrollo, NUNCA subir a Git)
PORT=3000
MONGODB_URI=mongodb://localhost:27017/mi_app
JWT_SECRET=secreto_para_desarrollo
NODE_ENV=development

// .gitignore (CRÍTICO)
.env
.env.local
.env.production
node_modules/

// config.js: leer variables con validación
import dotenv from 'dotenv';
dotenv.config();  // lee el .env

export const config = {
  port: process.env.PORT || 3000,
  mongoUri: process.env.MONGODB_URI,
  jwtSecret: process.env.JWT_SECRET,
  nodeEnv: process.env.NODE_ENV || 'development',
};

// Validar que las variables críticas existan
if (!config.jwtSecret || config.jwtSecret.length < 32) {
  throw new Error('JWT_SECRET debe existir y tener al menos 32 caracteres');
}

Variables de entorno: .env, .gitignore, config.js

2.11.4 Dominio personalizado y HTTPS

Tu API empieza en mi-app.railway.app. Para profesionalizar, usas un dominio personalizado: api.mi-dominio.com. Las 3 plataformas (Railway, Render, Vercel) tienen HTTPS automático con Let's Encrypt: tu sitio se sirve por HTTPS sin que tengas que configurar nada.

Cómo configurar un dominio personalizado

• 1. Compra el dominio en Namecheap, Google Domains, Cloudflare (~$10/año).
• 2. En tu plataforma (Railway > Settings > Domains), agrega api.mi-dominio.com.
• 3. La plataforma te da un CNAME: api.mi-dominio.com CNAME mi-app.railway.app.
• 4. En tu registrador de dominios, configura ese CNAME.
• 5. Espera 5-30 minutos a que propague el DNS.
• 6. La plataforma automáticamente emite un certificado Let's Encrypt y activa HTTPS.
• 7. Configura redirects: HTTP -> HTTPS, www -> sin www (en la plataforma o en Cloudflare).

2.11.5 Monitoreo y logs en producción

En producción, necesitas saber si tu API está caída, si tiene errores, y cómo está rindiendo. Las 3 plataformas (Railway, Render, Vercel) te dan logs en tiempo real, métricas básicas (CPU, RAM, requests), y alertas. Para cosas más avanzadas, hay herramientas gratuitas como UptimeRobot (monitoreo 24/7) y Sentry (tracking de errores).

2.11.6 Errores comunes del primer deploy

El primer deploy SIEMPRE tiene errores. Es normal, es humano, y es la mejor forma de aprender. Aquí están los 7 problemas más comunes y cómo solucionarlos en menos de 5 minutos cada uno.

📚 Contenido ampliado

Material adicional, referencias externas verificadas y ejemplos extendidos.