Despliegue de TypeScript en Kubernetes: guía básica para principiantes

Despliegue de TypeScript en Kubernetes: guía básica para principiantes

El desarrollo web moderno es impensable sin contenerización y orquestación. Si escribes en TypeScript y quieres que tu aplicación funcione de manera estable, se escale automáticamente y sea tolerante a fallos — Kubernetes (K8s) será tu mejor amigo. En esta guía, desglosaremos paso a paso cómo empaquetar una aplicación TypeScript en Docker y desplegarla en un clúster de Kubernetes. El material está pensado para principiantes: nada de magia, solo ejemplos claros y explicaciones.

1. Preparación de la aplicación TypeScript

Antes de pensar en Kubernetes, debemos asegurarnos de que tu aplicación esté lista para funcionar en un contenedor. Crearemos un servidor HTTP simple con Express y TypeScript.

1.1. Inicialización del proyecto

Crea una carpeta para el proyecto e inicialízalo:

mkdir my-ts-app && cd my-ts-app\nnpm init -y\nnpm install express\nnpm install -D typescript @types/node @types/express ts-node nodemon

1.2. Configuración de TypeScript

Crea el archivo tsconfig.json:

{\n  "compilerOptions": {\n    "target": "ES2020",\n    "module": "commonjs",\n    "outDir": "./dist",\n    "rootDir": "./src",\n    "strict": true,\n    "esModuleInterop": true,\n    "skipLibCheck": true\n  },\n  "include": ["src/**/*"],\n  "exclude": ["node_modules", "dist"]\n}

1.3. Código de la aplicación

Crea la carpeta src y el archivo index.ts:

import express, { Request, Response } from 'express';\n\nconst app = express();\nconst PORT = process.env.PORT || 3000;\n\napp.get('/', (req: Request, res: Response) => {\n  res.json({ message: 'Hello from TypeScript on Kubernetes!' });\n});\n\napp.listen(PORT, () => {\n  console.log(`Server running on port ${PORT}`);\n});

1.4. Compilación y ejecución

Añade los scripts en package.json:

"scripts": {\n  "build": "tsc",\n  "start": "node dist/index.js",\n  "dev": "ts-node src/index.ts"\n}

Verifica la ejecución local: npm run dev y abre http://localhost:3000.

2. Contenerización con Docker

Kubernetes trabaja con contenedores. Necesitamos crear una imagen Docker de nuestra aplicación TypeScript.

2.1. Dockerfile

Crea el archivo Dockerfile en la raíz del proyecto:

FROM node:18-alpine AS builder\nWORKDIR /app\nCOPY package*.json ./\nRUN npm ci\nCOPY . .\nRUN npm run build\n\nFROM node:18-alpine AS production\nWORKDIR /app\nCOPY --from=builder /app/dist ./dist\nCOPY --from=builder /app/package*.json ./\nRUN npm ci --only=production\nEXPOSE 3000\nCMD ["node", "dist/index.js"]

Usamos una compilación multi-etapa: primero compilamos TypeScript, luego creamos una imagen final ligera.

2.2. Compilación de la imagen

docker build -t my-ts-app:latest .

Verifica localmente:

docker run -p 3000:3000 my-ts-app:latest

2.3. .dockerignore

Para no copiar archivos innecesarios, crea .dockerignore:

node_modules\ndist\n.git\n*.md

3. Despliegue en Kubernetes

Ahora que tenemos la imagen Docker, podemos pasar a Kubernetes. Para pruebas locales recomiendo Minikube o Kind.

3.1. Iniciar Minikube

minikube start --driver=docker\nminikube status

3.2. Cargar la imagen en Minikube

Para que Kubernetes pueda encontrar nuestra imagen, cárgala en el entorno de Minikube:

minikube image load my-ts-app:latest

3.3. Crear el Deployment

Crea el archivo deployment.yaml:

apiVersion: apps/v1\nkind: Deployment\nmetadata:\n  name: my-ts-app-deployment\nspec:\n  replicas: 2\n  selector:\n    matchLabels:\n      app: my-ts