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

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

يمكنك نشر نموذج التطبيق بطريقتين:

• قم بنشرها مباشرة إلى عنقود AKS من محطة عملك.
• قم بالنشر باستخدام خطوط النشر الأتمتة. في Azure، يمكنك استخدام:
  • مسارات Azure
  • GitHub Actions
  • كلاود نيتيف GitOps

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

• تحديث ملف بيان Kubernetes.
• نشر تطبيق في Kubernetes.
• اختبار التطبيق.
• عرض صحة التطبيقات، السجلات، المقاييس، والتركيب في سطح مكتب AKS.

قبل البدء

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

هذا الدرس ينشئ ويحدث موارد قابلة للفوترة، مثل خدمات LoadBalancer. استخدم هوية مع أذونات لنشر أعباء العمل على AKS وقراءة موارد العنقود.

سطح مكتب AKS

يتطلب هذا الدرس تثبيت سطح مكتب AKS.

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

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

Azure المطور CLI

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

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

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

سطح مكتب AKS

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

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

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

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

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

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

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

4. تحقق من وجود ذلك aks-store-quickstart.yaml في مجلدك الحالي قبل أن تتابع.

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

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

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

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

4. تحقق من وجود ذلك aks-store-quickstart.yaml في مجلدك الحالي قبل أن تتابع.

Azure المطور CLI

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

شغّل التطبيق

سطح مكتب AKS

نشر وإدارة التطبيق باستخدام سطح مكتب AKS

AKS desktop هو بوابة مطوري تركز على التطبيقات لخدمة خدمة Azure Kubernetes ‏(AKS) تسهل نشر التطبيقات وإدارتها دون الحاجة إلى خبرة عميقة في Kubernetes.

سجل عنقودك في سطح مكتب AKS

1. تأكد من تسجيل الدخول إلى سطح مكتب AKS بنفس الحساب الذي لديه وصول إلى عنقود AKS. بعد تسجيل الدخول، اختر إضافة من اشتراك Azure.
2. أدخل اسم اشتراكك في Azure إذا كان لديك أكثر من اشتراك. (بدلا من ذلك، اختر السهم لفتح القائمة المنسدلة، ثم اختر اشتراكك في Azure.)
3. اختر عنقودك، ثم اختر Register Cluster.

تابع عندما تظهر حالة العنقود كمتصلة في سطح مكتب AKS.

إنشاء مشروع مدار في سطح مكتب AKS

1. في سطح مكتب AKS، اذهب إلى تبويب المشاريع واختر إنشاء Project مدار جديد.

2. قم بتكوين إعدادات المشروع التالية:

   • الأساسيات:
     • اسم المشروع: على سبيل المثال، my-dev-frontend
     • الاشتراك: <your-subscription-name>
     • المجموعة: <your-cluster-name>

   ملحوظة

   عند تعيين اشتراك Azure وعنقود AKS، يتحقق سطح مكتب AKS من دعم المجموعات المطلوبة وميزات الاشتراك.

   • سياسات الشبكات: يمكنك ترك الإعدادات الافتراضية لهذا البدء السريع أو تحديثها حسب الحاجة.

     • لعرض التطبيق علنا، قم بتغيير Ingress إلى Allow all traffic.

   • حصة الحساب: قم بتعيين القيم لتطبيق الاختبار.

   • الوصول: أضف شخصا أو احذف الإدخال بحذف عنصر السطر.

3. تحت المراجعة، تحقق من إعدادات مشروعك، ثم اختر إنشاء مشروع.

   

نشر تطبيق

1. قدم اسم التطبيق، ثم اختر إنشاء تطبيق.

   

2. اختر مصدرا لطلبك. في هذا المثال، اختر Kubernetes YAML>Next.

3. افتح aks-store-quickstart.yaml، انسخ وأص محتواه في المحرر، ثم اختر التالي.

4. راجع الموارد التي تم إنشاؤها، ثم اختر النشروالإغلاق.

5. قد تستغرق الموارد بضع دقائق للنشر. خلال هذه الفترة، قد تظهر Degraded حالة المشروع أثناء توسع العنقود.

6. تحقق من حالة موارد التطبيق باختيار الموارد ثم أعمالالعمل.

   يمكنك إجبار تحديث الشاشة باختيار خيار التنقل> في قائمة النافذة العلوية.

7. اختر موارد عبء العمل الفردية لعرض تفاصيلها وأحداثها.

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

   kubectl apply -f aks-store-quickstart.yaml
   

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

   statefulset.apps/rabbitmq 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
   

   تأكد من أن كبسولات التقديم تعرض Running حالة قبل أن تكمل.

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

   kubectl apply -f aks-store-quickstart.yaml
   

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

   statefulset.apps/rabbitmq 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
   

   تأكد من أن كبسولات التقديم تعرض Running حالة قبل أن تكمل.

Azure المطور CLI

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

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

   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 واجهة التطبيق الأمامية للإنترنت. قد تستغرق هذه العملية بضع دقائق حتى تكتمل.

سطح مكتب AKS

1. احصل على عنوان IP العام من خدمة شبكة> الموارد>:عنوان IP خارجيفي واجهة> المتجر.

2. استكشف التطبيق على سطح مكتب AKS، مثل عرض السجلات والمقاييس. لمزيد من المعلومات، راجع نظرة عامة على سطح مكتب AKS.

سطر الأوامر

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 في المستعرض لزيارة صفحة المتجر.

   

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

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

سطح مكتب AKS

ملحوظة

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

إذا انتهيت، اختر أيقونة الحذف . في رسالة التأكيد، اختر أيضا حذف مساحة الاسم.

سطر الأوامر

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