Despliegue de tu API

1.Qué significa desplegar

Hasta ahora tu API vive en localhost: solo tú puedes llamarla, y solo mientras tu computadora está encendida. Desplegar es ponerla en un servidor que esté siempre encendido y tenga una dirección pública (por ejemplo https://mi-api.ejemplo.app) para que cualquiera, o cualquier aplicación, pueda usarla.

Existen muchas plataformas que ejecutan aplicaciones de Node leyendo tu repositorio (Render, Railway, Fly.io, entre otras). Cambian la interfaz y los planes gratuitos, pero el proceso es el mismo, y esa es la parte que aprenderás: preparar el proyecto para que funcione en cualquier sitio.

2.Preparar el proyecto

Haz este repaso antes de subir nada. Cada punto evita un error típico de «en mi computadora funcionaba».

1. Un script start

La plataforma arrancará tu app con npm start. Define ese script sin --watch (que es solo para desarrollo):

{
  "name": "api-tareas",
  "version": "1.0.0",
  "type": "module",
  "main": "index.js",
  "scripts": {
    "start": "node index.js",
    "dev": "node --watch --env-file=.env index.js"
  },
  "engines": {
    "node": ">=20"
  },
  "dependencies": {
    "express": "^5.1.0",
    "cors": "^2.8.5"
  }
}

El campo engines indica la versión de Node que necesita tu proyecto; muchas plataformas lo leen para elegir la correcta. Las herramientas que solo usas mientras programas van en devDependencies (npm install -D nombre), no en dependencies.

2. El puerto lo decide la plataforma

En producción no puedes elegir el puerto: la plataforma te lo entrega en la variable PORT. Por eso tu código debe leerlo (lección 6) y no escribirlo a mano:

const PORT = Number(process.env.PORT) || 3000;
app.listen(PORT, () => console.log(`API escuchando en el puerto ${PORT}`));

3. Nada de secretos en el código

Claves, contraseñas y direcciones de otras apps van en variables de entorno. Comprueba que .env y node_modules estén en .gitignore (git status no debe mostrarlos).

4. Una ruta de salud

Muchas plataformas comprueban que tu app responde. Una ruta simple lo facilita, y a ti te sirve para saber si está viva:

const inicio = Date.now();

app.get("/salud", (req, res) => {
  res.json({ estado: "ok", uptimeSegundos: Math.floor((Date.now() - inicio) / 1000) });
});

5. Prueba el arranque limpio

La plataforma instalará las dependencias desde cero. Simúlalo tú:

rm -rf node_modules       # en PowerShell: Remove-Item -Recurse -Force node_modules
npm ci --omit=dev          # instala exactamente lo del package-lock.json, sin devDependencies
NODE_ENV=production npm start

npm ci usa el package-lock.json (¡súbelo a Git!) para instalar versiones idénticas en todas partes y falla si el lock y el package.json no coinciden.

3.Variables de entorno en producción

El archivo .env no viaja a la nube (está en .gitignore). En su lugar, la plataforma tiene un panel donde escribes cada variable con su valor. Debes crear allí las mismas que en tu .env:

Una función que lea y valide la configuración al arrancar evita sorpresas: si falta algo, el programa avisa de inmediato en lugar de fallar a mitad de una petición.

4.Publicar paso a paso

El recorrido típico, sea cual sea la plataforma:

1. Sube tu proyecto a GitHub. Crea un repositorio, git add ., git commit -m "API lista" y git push. Verifica en la web que .env no está.
2. Crea una cuenta en la plataforma elegida y un nuevo «servicio web» a partir de tu repositorio.
3. Configura los comandos: instalación npm ci (o npm install) y arranque npm start.
4. Carga las variables de entorno en el panel (NODE_ENV, claves, orígenes).
5. Despliega. La plataforma instala, arranca y te da una URL pública con HTTPS.
6. Prueba la ruta de salud y el resto con curl.

curl https://tu-api.ejemplo.app/salud
curl https://tu-api.ejemplo.app/tareas

{"estado":"ok","uptimeSegundos":42}
[]

Cada vez que hagas git push a la rama configurada, la mayoría de plataformas vuelven a desplegar solas. Si algo falla, abre los registros (logs) en el panel: ahí aparecerán tus console.log y los errores.

Cuando algo sale mal

5.Errores frecuentes

• Dejar el puerto fijo: la plataforma asigna el puerto con PORT.
• Usar node --watch en start: ese modo es solo para desarrollo.
• Subir .env o node_modules al repositorio.
• Olvidar subir package-lock.json: las versiones instaladas pueden cambiar.
• Poner en devDependencies algo que se usa en producción: falla al arrancar.
• Olvidar crear las variables de entorno en el panel de la plataforma.
• Guardar datos en un archivo en una plataforma con disco efímero y perderlos en cada reinicio.

6.Glosario