توزيع بوابة مستضافة ذاتياً لـ مع YAML Kubernetes

ينطبق على: المطور | قسط

توضح هذه المقالة خطوات نشر مكون البوابة ذاتية الاستضافة في Azure API Management إلى مجموعة Kubernetes.

إشعار

يمكنك أيضًا نشر البوابة المستضافة ذاتيًا إلى نظام مجموعة Kubernetes الممكن بواسطة Azure Arc كملحق نظام مجموعة.

المتطلبات الأساسية

• أكمل التشغيل السريع التالي:إنشاء مثيل لـ Azure API Management.

• إنشاء مجموعة Kubernetes، أو الوصول إلى مجموعة موجودة.

  تلميح

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

• قم بتوفير مورد بوابة مستضافة ذاتيًا في مثيل API Management لديك.

النشر إلى Kubernetes

تلميح

تنشر الخطوات التالية البوابة المستضافة ذاتيا إلى Kubernetes وتمكن المصادقة إلى مثيل APIM باستخدام رمز مميز للوصول إلى البوابة (مفتاح المصادقة). يمكنك أيضا نشر البوابة المستضافة ذاتيا إلى Kubernetes وتمكين المصادقة إلى مثيل APIM باستخدام معرف Microsoft Entra.

1. حدد Gateways ضمن Deployment and infrastructure.
2. حدد مورد البوابة ذاتية الاستضافة التي تريد نشرها.
3. حدد Deployment.
4. تم إنشاء رمز مميز للوصول في مربع نص الرمز المميز تلقائيا نيابة عنك، استنادا إلى قيم المفتاح الافتراضي انتهاء الصلاحيةوالسرية . إذا لزم الأمر، اختر قيمًا في أي من عناصر التحكم أو كليهما لإنشاء رمز مميز جديد.
5. حدد علامة التبويب Kubernetes ضمن Deployment scripts.
6. حدد رابط ملف <gateway-name>.yml وقم بتنزيل ملف YAML.
7. حدد أيقونة copy في الركن السفلي الأيمن من مربع Deploy النص لحفظ الأوامر kubectl إلى الحافظة.
8. عند استخدام Azure Kubernetes Service (AKS)، قم بتشغيل az aks get-credentials --resource-group <resource-group-name> --name <resource-name> --admin في جلسة طرفية جديدة.
9. قم بتشغيل الأوامر لإنشاء العناصر Kubernetes الضرورية في مساحة الاسم الافتراضية وبدء حزم البوابة المستضافة ذاتيًا من صورة الحاوية التي تم تحميلها من سجل Microsoft الإصطناعي.
   • تنشئ الخطوة الأولى سر Kubernetes الذي يحتوي على رمز الوصول الذي تم إنشاؤه في الخطوة 4. بعد ذلك، يقوم بإنشاء نشر Kubernetes للبوابة المستضافة ذاتيا، والتي تستخدم ConfigMap مع تكوين البوابة.

تأكد من تشغيل البوابة

1. قم بتشغيل الأمر التالي للتحقق من نجاح النشر. قد يستغرق الأمر بعض الوقت لإنشاء جميع الكائنات وتهيئة القرون.

   kubectl get deployments
   

   يجب أن يعود

   NAME             READY   UP-TO-DATE   AVAILABLE   AGE
   <gateway-name>   1/1     1            1           18s
   

2. قم بتشغيل الأمر التالي للتحقق مما إذا تم إنشاء الخدمات بنجاح. ستكون عناوين IP للخدمة والمنافذ مختلفة.

   kubectl get services
   

   يجب أن يعود

   NAME                                TYPE           CLUSTER-IP      EXTERNAL-IP   PORT(S)                      AGE
   <gateway-name>-live-traffic         ClusterIP      None            <none>        4290/UDP,4291/UDP   9m1s
   <gateway-name>-instance-discovery   LoadBalancer   10.99.236.168   <pending>     80:31620/TCP,443:30456/TCP   9m1s
   

3. قم بالعودة إلى مدخل Microsoft Azure وتحديد Overview.

4. تأكد من أن Status تعرض علامة اختيار خضراء، متبوعة بعدد العقدة الذي يطابق عدد النسخ المتماثلة المحدد في ملف YAML. تعني هذه الحالة أن جرابات البوابة المستضافة ذاتيا المنشورة تتواصل بنجاح مع خدمة APIM ويكون لها "رسالة كشف أخطاء الاتصال" العادية.

تلميح

• قم بتشغيل الأمر kubectl logs deployment/<gateway-name> لعرض سجلات من حزمة محددة عشوائيًا إذا كان هناك أكثر من واحدة.
• قم بتشغيل kubectl logs -h لمجموعة كاملة من خيارات الأمر، مثل كيفية عرض سجلات لحزمة معينة أو حاوية.

المحتوى ذو الصلة

• لمعرفة المزيد حول البوابة ذاتية الاستضافة، راجع نظرة عامة على البوابة ذاتية الاستضافة.
• تعرف على كيفية نشر البوابة المستضافة ذاتيًا لإدارة واجهة برمجة التطبيقات إلى مجموعات Kubernetes الممكّنة بواسطة Azure Arc.
• تعرف على المزيد حول إرشادات تشغيل البوابة المستضافة ذاتيا على Kubernetes في الإنتاج.