Bereitstellung von TypeScript auf Kubernetes: Ein grundlegender Leitfaden für Anfänger

Bereitstellung von TypeScript auf Kubernetes: Ein grundlegender Leitfaden für Anfänger

Moderne Webentwicklung ist ohne Containerisierung und Orchestrierung nicht denkbar. Wenn Sie in TypeScript schreiben und möchten, dass Ihre Anwendung stabil läuft, sich automatisch skaliert und ausfallsicher ist, wird Kubernetes (K8s) Ihr bester Freund. In diesem Leitfaden gehen wir Schritt für Schritt durch, wie Sie eine TypeScript-Anwendung in Docker verpacken und in einem Kubernetes-Cluster bereitstellen. Das Material richtet sich an Anfänger: keine Magie, nur verständliche Beispiele und Erklärungen.

1. Vorbereitung der TypeScript-Anwendung

Bevor Sie an Kubernetes denken, müssen Sie sicherstellen, dass Ihre Anwendung bereit für den Betrieb in einem Container ist. Wir erstellen einen einfachen HTTP-Server mit Express und TypeScript.

1.1. Projektinitialisierung

Erstellen Sie einen Projektordner und führen Sie die Initialisierung durch:

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. TypeScript-Konfiguration

Erstellen Sie die Datei 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. Anwendungscode

Erstellen Sie den Ordner src und die Datei 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. Build und Ausführung

Fügen Sie Skripte in package.json hinzu:

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

Überprüfen Sie die lokale Ausführung: npm run dev und öffnen Sie http://localhost:3000.

2. Containerisierung mit Docker

Kubernetes arbeitet mit Containern. Wir müssen ein Docker-Image unserer TypeScript-Anwendung erstellen.

2.1. Dockerfile

Erstellen Sie die Datei Dockerfile im Projektstammverzeichnis:

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"]

Wir verwenden einen Multi-Stage-Build: Zuerst wird TypeScript kompiliert, dann erstellen wir ein leichtes finales Image.

2.2. Image-Build

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

Überprüfen Sie lokal:

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

2.3. .dockerignore

Um unnötige Dateien nicht zu kopieren, erstellen Sie .dockerignore:

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

3. Bereitstellung in Kubernetes

Da wir nun ein Docker-Image haben, können wir zu Kubernetes übergehen. Für lokale Tests empfehle ich Minikube oder Kind.

3.1. Minikube starten

minikube start --driver=docker\nminikube status

3.2. Image in Minikube laden

Damit Kubernetes unser Image finden kann, laden wir es in die Minikube-Umgebung:

minikube image load my-ts-app:latest

3.3. Deployment erstellen

Erstellen Sie die Datei 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