مشاركة عبر

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

  • مقالة

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

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

هام

سينتهي دعم الإصدار 0 من البوابة المستضافة ذاتيا ل Azure API Management وصور حاوية الإصدار 1 في 1 أكتوبر 2023، جنبا إلى جنب مع واجهة برمجة تطبيقات التكوين المقابلة لها الإصدار 1. استخدم دليل الترحيل الخاص بنا لاستخدام البوابة المستضافة ذاتيا v2.0.0 أو أعلى مع Configuration API v2. تعرف على المزيد في وثائق الإهمال الخاصة بنا

إشعار

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

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

النشر إلى 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 لمجموعة كاملة من خيارات الأمر، مثل كيفية عرض سجلات لحزمة معينة أو حاوية.

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