نشر تطبيق C# على Kubernetes: دليل أساسي عملي

نشر تطبيق C# على Kubernetes: دليل عملي لمطوري .NET

التطوير الحديث باستخدام C# (.NET) يتطلب بشكل متزايد ليس فقط كتابة كود عالي الجودة، ولكن أيضًا القدرة على نشر التطبيق بشكل صحيح في بيئة الإنتاج. أصبح Kubernetes (K8s) المعيار الفعلي لتنسيق الحاويات. في هذه المقالة، سنستعرض عملية نشر تطبيق C# على Kubernetes خطوة بخطوة - بدءًا من الحاويات وصولاً إلى إعداد Ingress.

1. تحضير تطبيق .NET وصورة Docker

قبل الوصول إلى Kubernetes، يجب حزم تطبيق C# الخاص بك في صورة Docker. لننظر في مثال بسيط لـ ASP.NET Core Web API.

أنشئ المشروع:

dotnet new webapi -n MyK8sApp\ncd MyK8sApp

أضف endpoint بسيط (ملف Program.cs):

var builder = WebApplication.CreateBuilder(args);\nvar app = builder.Build();\n\napp.MapGet("/", () => "Hello from C# on Kubernetes!");\n\napp.Run();

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

FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base\nWORKDIR /app\nEXPOSE 8080\n\nFROM mcr.microsoft.com/dotnet/sdk:8.0 AS build\nWORKDIR /src\nCOPY ["MyK8sApp.csproj", "."]\nRUN dotnet restore\nCOPY . .\nRUN dotnet publish -c Release -o /app/publish\n\nFROM base AS final\nWORKDIR /app\nCOPY --from=build /app/publish .\nENTRYPOINT ["dotnet", "MyK8sApp.dll"]

قم ببناء الصورة ودفعها إلى Docker Hub أو سجل محلي:

docker build -t yourdockerhub/my-k8s-app:v1 .\ndocker push yourdockerhub/my-k8s-app:v1

هام: في ASP.NET Core 8+، يستمع التطبيق افتراضيًا على المنفذ 8080، وهو مثالي لـ Kubernetes.

2. ملفات YAML الأساسية لـ Kubernetes

يدير Kubernetes الموارد من خلال ملفات YAML. لتشغيل تطبيق C#، سنحتاج على الأقل إلى Deployment و Service.

2.1. Deployment (deployment.yaml)

يتولى Deployment الحفاظ على العدد المطلوب من نسخ Pod.

apiVersion: apps/v1\nkind: Deployment\nmetadata:\n  name: my-k8s-app-deployment\nspec:\n  replicas: 3\n  selector:\n    matchLabels:\n      app: my-k8s-app\n  template:\n    metadata:\n      labels:\n        app: my-k8s-app\n    spec:\n      containers:\n      - name: my-k8s-app\n        image: yourdockerhub/my-k8s-app:v1\n        ports:\n        - containerPort: 8080\n        resources:\n          requests:\n            memory: "64Mi"\n            cpu: "250m"\n          limits:\n            memory: "128Mi"\n            cpu: "500m"\n        livenessProbe:\n          httpGet:\n            path: /health\n            port: 8080\n          initialDelaySeconds: 5\n          periodSeconds: 10

النقاط الرئيسية:

\n
• replicas: 3 — 3 نسخ من التطبيق
\n
• livenessProbe — فحص الصحة (يوصى بإضافة endpoint /health في C#)
\n
• الموارد requests/limits تساعد جدولة K8s
\n

2.2. Service (service.yaml)

يوفر Service نقطة دخول ثابتة إلى Pods.

apiVersion: v1\nkind: Service\nmetadata:\n  name: my-k8s-app-service\nspec:\n  selector:\n    app: my-k8s-app\n  ports:\n  - protocol: TCP\n    port: 80\n    targetPort: 8080\n  type: ClusterIP

ClusterIP — خدمة داخلية، يمكن الوصول إليها فقط داخل الكتلة. للوصول الخارجي نستخدم Ingress.

3. إعداد Ingress و ConfigMap

3.1. Ingress (ingress.yaml)

يفتح Ingress الوصول إلى الخدمة من الخارج عبر اسم النطاق.

apiVersion: networking.k8s.io/v1\nkind: Ingress\nmetadata:\n  name: my-k8s-app-ingress\n  annotations:\n    nginx.ingress.kubernetes.io/rewrite-target: /\nspec:\n  rules:\n  - host: myapp.example.com\n    http:\n      paths:\n      - path: /\n        pathType: Prefix\n        backend:\n          ser