البرنامج التعليمي - نشر تطبيق إلى خدمة Azure Kubernetes (AKS)

يُقدم Kubernetes نظاماً أساسياً موزعاً للتطبيقات المعبأة في حاويات. يمكنك إنشاء ونشر التطبيقات والخدمات الخاصة بك في مجموعة Kubernetes والسماح للمجموعة بإدارة التوفر والاتصال.

في هذا البرنامج التعليمي، يمكنك نشر نموذج تطبيق في مجموعة Kubernetes. ‏‫ستتعلم كيفية:

• تحديث ملف بيان Kubernetes.
• تشغيل تطبيق في Kubernetes.
• اختبار التطبيق.

تلميح

باستخدام AKS، يمكنك استخدام الأساليب التالية لإدارة التكوين:

• GitOps: تمكين إعلانات حالة نظام المجموعة لتطبيقها تلقائيا على نظام المجموعة. لمعرفة كيفية استخدام GitOps لنشر تطبيق مع مجموعة AKS، راجع المتطلبات الأساسية لمجموعات خدمة Azure Kubernetes في البرنامج التعليمي GitOps مع Flux v2 .

• DevOps: يمكنك من إنشاء واختبار ونشر مع التكامل المستمر (CI) والتسليم المستمر (CD). للاطلاع على أمثلة حول كيفية استخدام DevOps لنشر تطبيق مع نظام مجموعة AKS، راجع الإنشاء والتوزيع إلى AKS باستخدام Azure Pipelines أو GitHub Actions للنشر في Kubernetes.

قبل البدء

في البرامج التعليمية السابقة، قمت بحزم تطبيق في صورة حاوية، وتحميل الصورة إلى Azure Container Registry، وإنشاء مجموعة Kubernetes. لإكمال هذا البرنامج التعليمي، تحتاج إلى ملف بيان Kubernetes الذي تم aks-store-quickstart.yaml إنشاؤه مسبقا. تم تنزيل هذا الملف في التعليمات البرمجية المصدر للتطبيق من البرنامج التعليمي 1 - إعداد التطبيق ل AKS.

Azure CLI

يتطلب هذا البرنامج التعليمي الإصدار 2.0.53 من Azure CLI أو أحدث. تحقق من الإصدار الخاص بك باستخدام az --version. للتثبيت أو الترقية، يُرجى الرجوع إلى تثبيت Azure CLI.

Azure PowerShell

يتطلب هذا البرنامج التعليمي Azure PowerShell الإصدار 5.9.0 أو أحدث. تحقق من الإصدار الخاص بك باستخدام Get-InstalledModule -Name Az. للترقية أو التثبيت، راجع تثبيت Azure PowerShell.

Azure Developer CLI

يتطلب هذا البرنامج التعليمي الإصدار 1.5.1 من Azure Developer CLI (azd) أو أحدث. تحقق من الإصدار الخاص بك باستخدام azd version. للترقية أو التثبيت، راجع تثبيت Azure Developer CLI.

تحديث ملف البيان

في هذه البرامج التعليمية، يخزن مثيل Azure Container Registry (ACR) صور الحاوية لنموذج التطبيق. لنشر التطبيق، يجب تحديث أسماء الصور في ملف بيان Kubernetes لتضمين اسم خادم تسجيل الدخول إلى ACR.

Azure CLI

1. احصل على عنوان خادم تسجيل الدخول باستخدام az acr list الأمر والاستعلام لخادم تسجيل الدخول.

   az acr list --resource-group myResourceGroup --query "[].{acrLoginServer:loginServer}" --output table
   

2. تأكد من أنك في دليل aks-store-demo المستنسخ، ثم افتح aks-store-quickstart.yaml ملف البيان باستخدام محرر نص.

3. قم بتحديث الخاصية image للحاويات عن طريق استبدال ghcr.io/azure-samples باسم خادم تسجيل الدخول ACR الخاص بك.

   containers:
   ...
   - name: order-service
     image: <acrName>.azurecr.io/aks-store-demo/order-service:latest
   ...
   - name: product-service
     image: <acrName>.azurecr.io/aks-store-demo/product-service:latest
   ...
   - name: store-front
     image: <acrName>.azurecr.io/aks-store-demo/store-front:latest
   ...
   

4. احفظ الملف وأغلقه.

Azure PowerShell

1. احصل على عنوان خادم تسجيل الدخول الخاص بك باستخدام Get-AzContainerRegistry cmdlet والاستعلام عن خادم تسجيل الدخول الخاص بك. تأكد من استبدال <acrName> باسم مثيل ACR الخاص بك.

   (Get-AzContainerRegistry -ResourceGroupName myResourceGroup -Name $ACRNAME).LoginServer
   

2. تأكد من أنك في دليل aks-store-demo المستنسخ، ثم افتح aks-store-quickstart.yaml ملف البيان باستخدام محرر نص.

3. قم بتحديث الخاصية image للحاويات عن طريق استبدال ghcr.io/azure-samples باسم خادم تسجيل الدخول ACR الخاص بك.

   containers:
   ...
   - name: order-service
     image: <acrName>.azurecr.io/aks-store-demo/order-service:latest
   ...
   - name: product-service
     image: <acrName>.azurecr.io/aks-store-demo/product-service:latest
   ...
   - name: store-front
     image: <acrName>.azurecr.io/aks-store-demo/store-front:latest
   ...
   

4. احفظ الملف وأغلقه.

Azure Developer CLI

azd لا يتطلب خطوة تسجيل حاوية لأنه في القالب.

شغّل التطبيق

Azure CLI

1. نشر التطبيق باستخدام kubectl apply الأمر الذي يوزع ملف البيان وينشئ كائنات Kubernetes المعرفة.

   kubectl apply -f aks-store-quickstart.yaml
   

   يظهر المثال التالي للناتج الموارد التي تم إنشاؤها بنجاح في مجموعة AKS:

   statefulset.apps/rabbitmq created
   configmap/rabbitmq-enabled-plugins created
   service/rabbitmq created
   deployment.apps/order-service created
   service/order-service created
   deployment.apps/product-service created
   service/product-service created
   deployment.apps/store-front created
   service/store-front created
   

2. تحقق من نجاح النشر عن طريق عرض pods باستخدام kubectl get pods الأمر .

   kubectl get pods
   

Azure PowerShell

1. نشر التطبيق باستخدام kubectl apply الأمر الذي يوزع ملف البيان وينشئ كائنات Kubernetes المعرفة.

   kubectl apply -f aks-store-quickstart.yaml
   

   يظهر المثال التالي للناتج الموارد التي تم إنشاؤها بنجاح في مجموعة AKS:

   statefulset.apps/rabbitmq created
   configmap/rabbitmq-enabled-plugins created
   service/rabbitmq created
   deployment.apps/order-service created
   service/order-service created
   deployment.apps/product-service created
   service/product-service created
   deployment.apps/store-front created
   service/store-front created
   

2. تحقق من نجاح النشر عن طريق عرض pods باستخدام kubectl get pods الأمر .

   kubectl get pods
   

Azure Developer CLI

يتم تقسيم النشر في azd إلى مراحل متعددة ممثلة بخطافات. azd يتم النشر مع جميع الخطافات بشكل افتراضي.

1. انشر التطبيق باستخدام azd up الأمر .

   azd up
   

2. حدد الاشتراك والمنطقة لاستضافة موارد Azure.

   ? Select an Azure Subscription to use:  [Use arrows to move, type to filter]
   > 1. My Azure Subscription (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)
   Select an Azure location to use:  [Use arrows to move, type to filter]
   > 43. (US) East US 2 (eastus2)
   

   يمكنك تحديث المتغيرات من داخل AZURE_LOCATION الملف ومنه AZURE_SUBSCRIPTION_ID.azure/<your-env-name>/.env .

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

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

سطر الأوامر

1. راقب التقدم باستخدام الأمر ⁧kubectl get service⁩ مع الوسيطة --watch.

   kubectl get service store-front --watch
   

   في البداية، EXTERNAL-IP يظهر للخدمة store-front على النحو <pending>التالي:

   store-front   LoadBalancer   10.0.34.242   <pending>     80:30676/TCP   5s
   

2. EXTERNAL-IP عندما يتغير العنوان من <pending> إلى عنوان IP عام، استخدم CTRL-C لإيقاف kubectl عملية المراقبة.

   يوضح المثال التالي إخراج لعنوان IP عام صالحاً تم تعيينه للخدمة:

   store-front   LoadBalancer   10.0.34.242   52.179.23.131   80:30676/TCP   67s
   

3. اعرض التطبيق أثناء العمل عن طريق فتح مستعرض ويب والانتقال إلى عنوان IP الخارجي للخدمة الخاصة بك: http://<external-ip>.

   

إذا لم يتم تحميل التطبيق، فقد تكون مشكلة تخويل في سجل الصور. لعرض حالة الحاويات الخاصة بك، استخدم kubectl get pods الأمر. إذا لم تتمكن من سحب صور الحاوية، فشاهد المصادقة باستخدام Azure Container Registry من Azure Kubernetes Service.

مدخل Azure

انتقل إلى مدخل Microsoft Azure للعثور على معلومات النشر الخاصة بك.

1. انتقل إلى مورد نظام مجموعة AKS الخاص بك.

2. من قائمة الخدمة، ضمن موارد Kubernetes، حدد الخدمات والدخول.

3. انسخ عنوان IP الخارجي الموضح في عمود store-front الخدمة.

4. الصق عنوان IP في المستعرض لزيارة صفحة المتجر.

   

تنظيف الموارد

نظرا لأنك تحققت من صحة وظيفة التطبيق، يمكنك الآن إزالة نظام المجموعة من التطبيق. سننشر التطبيق مرة أخرى في البرنامج التعليمي التالي.

1. قم بإيقاف وإزالة مثيلات الحاوية والموارد باستخدام kubectl delete الأمر .

   kubectl delete -f aks-store-quickstart.yaml
   

2. تحقق من إزالة جميع pods التطبيق باستخدام kubectl get pods الأمر .

   kubectl get pods
   

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

في هذا البرنامج التعليمي، قمت بنشر نموذج تطبيق Azure إلى مجموعة Kubernetes في AKS. لقد تعرفت على كيفية:

• تحديث ملف بيان Kubernetes.
• تشغيل تطبيق في Kubernetes.
• اختبار التطبيق.

في البرنامج التعليمي التالي، ستتعلم كيفية استخدام خدمات PaaS لأحمال العمل ذات الحالة في Kubernetes.

استخدام خدمات PaaS لأحمال العمل ذات الحالة في AKS