نشر حاوية Windows Server على نظام مجموعة خدمة Azure Kubernetes ‏(AKS) باستخدام PowerShell

خدمة Azure Kubernetes (AKS) هي خدمة Kubernetes مُدارة تتيح لك نشر المجموعات وإدارتها بسرعة. في هذه المقالة، يمكنك استخدام Azure PowerShell لنشر نظام مجموعة AKS الذي يقوم بتشغيل حاويات Windows Server. يمكنك أيضًا نشر تطبيق نموذج ASP.NET في حاوية Windows Server إلى الكتلة.

إشعار

للبدء في توفير نظام مجموعة AKS بسرعة، تتضمن هذه المقالة خطوات لنشر نظام مجموعة بإعدادات افتراضية لأغراض التقييم فقط. قبل نشر نظام مجموعة جاهز للإنتاج، نوصيك بالتعرف على البنية المرجعية الأساسية لدينا للنظر في كيفية توافقها مع متطلبات عملك.

قبل البدء

يضمن هذا التشغيل السريع الفهم الأساسي لمفاهيم Kubernetes. لمزيد من المعلومات، راجع مفاهيم Kubernetes الأساسية الخاصة بخدمة خدمة Azure Kubernetes ‏(AKS).

إذا لم يكن لديك حساب Azure، فأنشئ حساباً مجانياً قبل أن تبدأ.
لسهولة الاستخدام، جرب بيئة PowerShell في Azure Cloud Shell. لمزيد من المعلومات، راجع التشغيل السريع ل Azure Cloud Shell.

إذا كنت ترغب في استخدام PowerShell محليا، فقم بتثبيت الوحدة النمطية Az PowerShell والاتصال بحساب Azure الخاص بك باستخدام Connect-AzAccount cmdlet. تأكد من تشغيل الأوامر بامتيازات إدارية. لمزيد من المعلومات، راجع تثبيت Azure PowerShell.
تأكد من أن الهوية التي تستخدمها لإنشاء نظام المجموعة الخاص بك لديها الحد الأدنى المناسب من الأذونات. لمزيد من التفاصيل حول الهوية وطريقة الوصول إلى AKS، راجع خيارات الوصول والهوية الخاصة بخدمة Azure Kubernetes (AKS).
إذا كان لديك أكثر من اشتراك Azure واحد، فقم بتعيين الاشتراك الذي ترغب في استخدامه لبدء التشغيل السريع عن طريق استدعاء الأمر Set-AzContext cmdlet. لمزيد من المعلومات، راجع إدارة اشتراكات Azure باستخدام Azure PowerShell.
يتطلب تحديد المعلمة OsSKU إصدار الوحدة النمطية PowerShell Az 9.2.0 أو أعلى.

إنشاء مجموعة موارد

مجموعة موارد Azure هي مجموعة منطقية يمكن من خلالها نشر وإدارة موارد Azure. عند إنشاء مجموعة موارد، سيُطلب منك تحديد موقع. هذا الموقع هو المكان الذي يتم فيه تخزين بيانات تعريف مجموعة الموارد وحيث يتم تشغيل مواردك في Azure إذا لم تحدد منطقة أخرى أثناء إنشاء الموارد.

إنشاء مجموعة موارد باستخدام New-AzResourceGroup cmdlet. في المثال التالي سيتم إنشاء مجموعة موارد تسمى myResourceGroup في منطقة الشرقيين.
```
New-AzResourceGroup -Name myResourceGroup -Location eastus
```
يوضح إخراج المثال التالي أنه تم إنشاء مجموعة الموارد بنجاح:
```
ResourceGroupName : myResourceGroup
Location          : eastus
ProvisioningState : Succeeded
Tags              :
ResourceId        : /subscriptions/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/resourceGroups/myResourceGroup
```

إنشاء نظام مجموعة AKS

في هذا القسم، نقوم بإنشاء نظام مجموعة AKS بالتكوين التالي:

يتم تكوين نظام المجموعة مع عقدتين للتأكد من أنه يعمل بشكل موثوق. العقدة هي جهاز ظاهري Azure (VM) يقوم بتشغيل مكونات عقدة Kubernetes ووقت تشغيل الحاوية.
تعين -WindowsProfileAdminUserName المعلمات و -WindowsProfileAdminUserPassword بيانات اعتماد المسؤول لأي عقد Windows Server على نظام المجموعة ويجب أن تفي بمتطلبات تعقيد كلمة مرور Windows Server.
يستخدم في تجمع العقدةVirtualMachineScaleSets.

استخدم الخطوات التالية لإنشاء نظام مجموعة AKS باستخدام Azure PowerShell:

إنشاء بيانات اعتماد المسؤول لحاويات Windows Server باستخدام الأمر التالي. يطالبك هذا الأمر بإدخال WindowsProfileAdminUserName و WindowsProfileAdminUserPassword. يجب أن تكون كلمة المرور 14 حرفا كحد أدنى وأن تفي بمتطلبات تعقيد كلمة مرور Windows Server.
```
$AdminCreds = Get-Credential `
    -Message 'Please create the administrator credentials for your Windows Server containers'
```
قم بإنشاء نظام المجموعة الخاص بك باستخدام New-AzAksCluster cmdlet وحدد المعلمات WindowsProfileAdminUserName و.WindowsProfileAdminUserPassword
```
New-AzAksCluster -ResourceGroupName myResourceGroup `
    -Name myAKSCluster `
    -NodeCount 2 `
    -NetworkPlugin azure `
    -NodeVmSetType VirtualMachineScaleSets `
    -WindowsProfileAdminUserName $AdminCreds.UserName `
    -WindowsProfileAdminUserPassword $secureString `
    -GenerateSshKey
```
بعد بضع دقائق، الأمر إكمال وإرجاع معلومات منسقة JSON حول الكتلة. في بعض الأحيان، قد يستغرق توفير نظام المجموعة أكثر من بضع دقائق. السماح بما يصل إلى 10 دقائق للتزويد.

إذا تلقيت خطأ في التحقق من صحة كلمة المرور، وكانت كلمة المرور التي قمت بتعيينها تفي بمتطلبات الطول والتعقيد، فحاول إنشاء مجموعة الموارد الخاصة بك في منطقة أخرى. ثم حاول إنشاء الكتلة مع مجموعة الموارد الجديدة.

إذا لم تحدد اسم مستخدم مسؤول وكلمة مرور عند إنشاء تجمع العقدة، يتم تعيين اسم المستخدم إلى azureuser ويتم تعيين كلمة المرور إلى قيمة عشوائية. لمزيد من المعلومات، راجع الأسئلة المتداولة حول Windows Server.

لا يمكن تغيير اسم مستخدم المسؤول، ولكن يمكنك تغيير كلمة مرور المسؤول التي يستخدمها نظام مجموعة AKS لعقد Windows Server باستخدام az aks update. لمزيد من المعلومات، راجع الأسئلة المتداولة حول Windows Server.

لتشغيل مجموعة AKS التي تدعم تجمعات العقد لحاويات Windows Server، تحتاج الكتلة الخاصة بك إلى استخدام نهج الشبكة الذي يستخدم المكون الإضافي للشبكة Azure CNI(متقدم). -NetworkPlugin azure تحدد المعلمة Azure CNI.

إضافة تجمع عقدة

بشكل افتراضي، يتم إنشاء كتلة AKS مع تجمع عقدة التي يمكن تشغيل حاويات لينكس. يجب إضافة تجمع عقدة آخر يمكنه تشغيل حاويات Windows Server جنبا إلى جنب مع تجمع عقدة Linux.

لإنشاء تجمع عقدة Windows، تحتاج إلى تحديد مدعوم OsType و OsSku. استخدم المعلومات الواردة في الجدول التالي لتحديد ما هو مناسب لنظام المجموعة الخاص بك:

`OsType`	`OsSku`	افترَاضي	إصدارات K8s المدعومة	التفاصيل
`windows`	`Windows2025`	قيد المعاينة حاليًا. ليس افتراضيا.	1.32+	الإعدادات الافتراضية المحدثة: containerd 2.0، يتم استخدام صورة الجيل 2 افتراضيا.
`windows`	`Windows2022`	الافتراضي في K8s 1.25-1.35	غير متوفر في K8s 1.36+	يتقاعد في مارس 2027. الإعدادات الافتراضية المحدثة: يتم تمكين FIPS افتراضيا.
`windows`	`Windows2019`	الافتراضي في K8s 1.24 والإصدارات الأقدم	غير متوفر في K8s 1.33+	يتقاعد في مارس 2026.

ويندوز سيرفر 2022 هو نظام التشغيل الافتراضي لإصدارات كوبيرنيتس 1.25-1.35. Windows Server 2019 هو نظام التشغيل الافتراضي للإصدارات السابقة. إذا لم تحدد نظام تشغيل SKU معينا، يقوم Azure بإنشاء تجمع عقدة جديد مع SKU الافتراضي لإصدار Kubernetes المستخدم من قبل نظام المجموعة.

مهم

ابتداء من 1 مارس 2026، لم تعد خدمة Azure Kubernetes ‏(AKS) تدعم مجموعات عقد Windows Server 2019. تجمعات العقد التي تعمل بإصدار Kubernetes إصدار 1.33+ لا يمكنها استخدام Windows Server 2019. ابتداء من 1 أبريل 2027، ستقوم AKS بإزالة جميع صور العقد الموجودة لنظام ويندوز سيرفر 2019، مما يعني أن عمليات التوسع ستفشل. لمزيد من المعلومات حول هذا التقاعد، راجع مشكلة GitHub للتقاعد وإعلان تقاعد تحديثات Azure. للبقاء على اطلاع بالإعلانات والتحديثات، تابع ملاحظات إصدار AKS.

مهم

ابتداء من 15 مارس 2027، لم تعد خدمة خدمة Azure Kubernetes ‏(AKS) تدعم مجموعات عقد Windows Server 2022. لا يمكن لتجمع العقد التي تعمل كوبيرنتيز إصدار 1.36+ استخدام ويندوز سيرفر 2022. بدءا من 1 أبريل 2028، ستقوم AKS بإزالة جميع صور العقد الموجودة لنظام Windows Server 2022، مما يعني أن عمليات التوسع ستفشل. لمزيد من المعلومات حول هذا التقاعد، راجع مشكلة GitHub للتقاعد وإعلان تقاعد تحديثات Azure. للبقاء على اطلاع بالإعلانات والتحديثات، تابع ملاحظات إصدار AKS.

أضف تجمع عقدة Windows Server باستخدام New-AzAksNodePool cmdlet. ينشئ الأمر التالي تجمع عقدة جديد يسمى npwin ويضيفه إلى myAKSCluster. يستخدم الأمر أيضا الشبكة الفرعية الافتراضية في الشبكة الظاهرية الافتراضية التي تم إنشاؤها عند تشغيل New-AzAksCluster:
```
New-AzAksNodePool -ResourceGroupName myResourceGroup `
    -ClusterName myAKSCluster `
    -VmSetType VirtualMachineScaleSets `
    -OsType Windows `
    -OsSKU Windows2022 `
    -Name npwin
```

الاتصال بنظام المجموعة

يمكنك استخدام kubectl، عميل سطر أوامر Kubernetes، لإدارة مجموعات Kubernetes الخاصة بك. kubectl والذي سيكون مثبتًا بالفعل في حال كنت تستخدم Azure Cloud Shell. إذا كنت ترغب في التثبيت kubectl محليا، يمكنك استخدام Install-AzAzAksCliTool cmdlet.

تكوين kubectl للاتصال بمجموعة Kubernetes باستخدام Import-AzAksCredential cmdlet. هذا الأمر يقوم بتحميل بيانات الاعتماد وضبط Kubernetes CLI لاستخدامها.
```
Import-AzAksCredential -ResourceGroupName myResourceGroup -Name myAKSCluster
```
تحقق من الاتصال بالمجموعة باستخدام kubectl get الأمر الذي يقوم بإرجاع قائمة بعقد نظام المجموعة.
```
kubectl get nodes
```
يعرض إخراج المثال التالي جميع العقد في نظام المجموعة. تأكد من أن حالة جميع العقد جاهزة:
```
NAME                                STATUS   ROLES   AGE   VERSION
aks-nodepool1-20786768-vmss000000   Ready    agent   22h   v1.27.7
aks-nodepool1-20786768-vmss000001   Ready    agent   22h   v1.27.7
aksnpwin000000                      Ready    agent   21h   v1.27.7
```

قم بنشر التطبيق

ملف بيان Kubernetes يعرف الحالة المطلوبة للكتلة، مثل ما صور الحاوية لتشغيل. في هذه المقالة، يمكنك استخدام بيان لإنشاء كافة الكائنات اللازمة لتشغيل نموذج التطبيق ASP.NET في حاوية Windows Server. يتضمن هذا البيان نشرKubernetes لتطبيق نموذج ASP.NET وخدمة Kubernetes خارجية للوصول إلى التطبيق من الإنترنت.

يتم توفير تطبيق نموذج ASP.NET كجزء من .NET Framework Samplesويتم تشغيله في حاوية Windows Server. يتطلب AKS أن تستند حاويات Windows Server إلى صورWindows Server 2019 أو أحدث. يجب أن يعرف ملف بيان Kubernetes أيضًامحدد عقدة لإخبار نظام المجموعة AKS لتشغيل جراب التطبيق الخاص بالعينة ASP.NET على عقدة يمكن تشغيلها Windows حاويات Server.

قم بإنشاء ملف باسم sample.yaml وانسخه بتعريف YAML التالي:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: sample
  labels:
    app: sample
spec:
  replicas: 1
  template:
    metadata:
      name: sample
      labels:
        app: sample
    spec:
      nodeSelector:
        "kubernetes.io/os": windows
      containers:
      - name: sample
        image: mcr.microsoft.com/dotnet/framework/samples:aspnetapp
        resources:
          limits:
            cpu: 1
            memory: 800M
        ports:
          - containerPort: 80
  selector:
    matchLabels:
      app: sample
---
apiVersion: v1
kind: Service
metadata:
  name: sample
spec:
  type: LoadBalancer
  ports:
  - protocol: TCP
    port: 80
  selector:
    app: sample

للحصول على تصنيف تفصيلي لملفات بيان YAML، راجع عمليات التوزيع وبيانات YAML.

إذا قمت بإنشاء ملف YAML وحفظه محليا، فيمكنك تحميل ملف البيان إلى الدليل الافتراضي في CloudShell عن طريق تحديد الزر تحميل/تنزيل الملفات وتحديد الملف من نظام الملفات المحلي.

انشر التطبيق باستخدام kubectl apply الأمر وحدد اسم بيان YAML.
```
kubectl apply -f sample.yaml
```
يوضح إخراج المثال التالي النشر والخدمة التي تم إنشاؤها بنجاح:
```
deployment.apps/sample created
service/sample created
```

اختبر التطبيق

عند تشغيل التطبيق، تعرض خدمة Kubernetes واجهة التطبيق الأمامية للإنترنت. قد تستغرق هذه العملية بضع دقائق حتى تكتمل. في بعض الأحيان، قد تستغرق الخدمة أكثر من بضع دقائق لتوفيرها. السماح بما يصل إلى 10 دقائق للتزويد.

تحقق من حالة pods المنشورة kubectl get pods باستخدام الأمر . جعل جميع الحجيرات قبل Running المتابعة.
```
kubectl get pods
```
راقب التقدم باستخدام الأمر ⁧kubectl get service⁩ مع الوسيطة --watch.
```
kubectl get service sample --watch
```
في البداية، يظهر الإخراج EXTERNAL-IP لنموذج الخدمة على أنه معلق:
```
NAME               TYPE           CLUSTER-IP   EXTERNAL-IP   PORT(S)        AGE
sample             LoadBalancer   10.0.37.27   <pending>     80:30572/TCP   6s
```
بمجرد تغيير عنوان EXTERNAL-IP من معلق إلى عنوان IP عام فعلي، استخدم CTRL-C لإيقاف عملية kubectl المراقبة.

يوضح المثال التالي إخراج لعنوان IP عام صالحاً تم تعيينه للخدمة:
```
sample  LoadBalancer   10.0.37.27   52.179.23.131   80:30572/TCP   2m
```
راجع نموذج التطبيق أثناء العمل عن طريق فتح مستعرض ويب على عنوان IP الخارجي للخدمة الخاصة بك.

حذف الموارد

إذا كنت لا تخطط للانتقال إلى البرنامج التعليمي AKS، فاحذف مجموعتك لتجنب تكبد رسوم Azure.

قم بإزالة مجموعة الموارد وخدمة الحاوية وجميع الموارد ذات الصلة باستخدام Remove-AzResourceGroup cmdlet.
```
Remove-AzResourceGroup -Name myResourceGroup
```
إشعار

تم إنشاء نظام مجموعة AKS بهوية مدارة معينة من قبل النظام (خيار الهوية الافتراضي المستخدم في هذا التشغيل السريع). يدير النظام الأساسي Azure هذه الهوية، لذلك لا يتطلب الإزالة.

الخطوات التالية

في هذا التشغيل السريع، قمت بنشر مجموعة Kubernetes ثم نشر نموذج تطبيق ASP.NET في حاوية Windows Server إليه. هذا التطبيق النموذجي هو لأغراض العرض التوضيحي فقط ولا يمثل جميع أفضل الممارسات لتطبيقات Kubernetes. للحصول على إرشادات حول إنشاء حلول كاملة باستخدام AKS للإنتاج، راجع إرشادات حل AKS.

لمعرفة المزيد حول AKS، وللسير عبر مثال كامل على التعليمات البرمجية للتوزيع، تابع إلى البرنامج التعليمي لنظام مجموعة Kubernetes.

البرنامج التعليمي AKS

الملاحظات

هل كانت هذه الصفحة مفيدة؟

Last updated on 2026-06-03