نشر TypeScript على Kubernetes: دليل أساسي للمبتدئين

نشر TypeScript على Kubernetes: دليل أساسي للمبتدئين

تطوير الويب الحديث لا يمكن تصوره بدون الحاويات والتنسيق. إذا كنت تكتب بلغة TypeScript وتريد أن يعمل تطبيقك بثبات، ويتوسع تلقائيًا، ويكون مقاومًا للأعطال — فإن Kubernetes (K8s) سيكون أفضل صديق لك. في هذا الدليل، سنشرح خطوة بخطوة كيفية حزم تطبيق TypeScript في Docker ونشره في مجموعة Kubernetes. المادة موجهة للمبتدئين: لا سحر، فقط أمثلة وشروحات واضحة.

1. تحضير تطبيق TypeScript

قبل التفكير في Kubernetes، يجب التأكد من أن تطبيقك جاهز للعمل في حاوية. سننشئ خادم HTTP بسيط باستخدام Express مع TypeScript.

1.1. تهيئة المشروع

أنشئ مجلد المشروع وقم بالتهيئة:

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

أنشئ ملف 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. كود التطبيق

أنشئ مجلد src وملف 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. البناء والتشغيل

أضف البرامج النصية في package.json:

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

تحقق من التشغيل المحلي: npm run dev وافتح http://localhost:3000.

2. الحاويات باستخدام Docker

يعمل Kubernetes مع الحاويات. نحتاج إلى إنشاء صورة Docker لتطبيق TypeScript الخاص بنا.

2.1. ملف Dockerfile

أنشئ ملف Dockerfile في جذر المشروع:

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

نستخدم بناء متعدد المراحل: أولاً نترجم TypeScript، ثم ننشئ صورة نهائية خفيفة الوزن.

2.2. بناء الصورة

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

تحقق محليًا:

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

2.3. ملف .dockerignore

لتجنب نسخ الملفات غير الضرورية، أنشئ .dockerignore:

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

3. النشر في Kubernetes

الآن بعد أن أصبح لدينا صورة Docker، يمكننا الانتقال إلى Kubernetes. للاختبار المحلي، أوصي باستخدام Minikube أو Kind.

3.1. تشغيل Minikube

minikube start --driver=docker\nminikube status

3.2. تحميل الصورة إلى Minikube

لكي يتمكن Kubernetes من العثور على صورتنا، سنقوم بتحميلها إلى بيئة Minikube:

minikube image load my-ts-app:latest

3.3. إنشاء Deployment

أنشئ ملف 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