توزيع بوابة APIM Azure على Azure Arc(إصدار أولي)

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

مع التكامل بين Azure API Management وAzure Arc على Kubernetes، يمكنك نشر مكون بوابة APIM كملحق في مجموعة Kubernetes التي تدعم Azure Arc.

يؤدي نشر بوابة APIM على مجموعة Kubernetes الممكنة في Azure Arc إلى توسيع دعم APIM للبيئات المختلطة ومتعددة السحابات. تمكين التوزيع باستخدام ملحق نظام مجموعة لجعل إدارة وتطبيق النهج على مجموعة تمكين Azure Arc تجربة متناسقة.

هام

بوابة إدارة واجهة برمجة التطبيقات المستضافة ذاتيًا على Azure Arc حاليًا في المعاينة. أثناء المعاينة، يتوفر ملحق بوابة APIM في المناطق التالية:

• آسيا (شرق وجنوب شرق)
• أستراليا (وسط، وسط 2، شرق وجنوب شرق)
• البرازيل (جنوب وجنوب شرق)
• كندا (وسط وشرق)
• أوروبا (الشمال والغرب)
• فرنسا (وسط وجنوب)
• ألمانيا (شمال وغرب وسط)
• الهند (وسط وجنوب وغرب وجيو الوسطى وجيو الغربية)
• اليابان (شرق وغرب)
• كوريا (وسط وجنوب)
• النرويج (شرق وغرب)
• جنوب أفريقيا (الشمال والغرب)
• السويد (وسط)
• سويسرا (الشمال والغرب)
• الإمارات العربية المتحدة (الإمارات العربية المتحدة - الوسط والشمال)
• المملكة المتحدة (المملكة المتحدة - الجنوب)
• الولايات المتحدة (الولايات المتحدة - وسط، وسط EUAP، شرق، شرق 2، شرق 2 EUAP، شمال وسط، جنوب وسط، وسط غرب، غرب، غرب 2، غرب 3)

إشعار

يمكنك أيضا نشر البوابة المستضافة ذاتيا مباشرة إلى Kubernetes.

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

• الاتصال مجموعة Kubernetes الخاصة بك داخل منطقة Azure Arc المدعومة.

• k8s-extension تثبيت ملحق Azure CLI:

  az extension add --name k8s-extension
  

  إذا قمت بتثبيت الوحدة النمطية k8s-extension بالفعل، فقم بتحديث إلى أحدث إصدار:

  az extension update --name k8s-extension
  

• إنشاء مثيل Azure API Management.

• توفير مورد بوابة في مثيل Azure API Management.

توزيع ملحق بوابة APIM باستخدام Azure CLI

1. في مدخل Azure، انتقل إلى مثيل API Management.

2. حدد Gateways من قائمة التنقل الجانبية.

3. حدد مورد البوابة المخصصة، وقم بفتحها من القائمة.

4. في مورد البوابة المتوفرة، انقر فوق Deployment من قائمة التنقل الجانبية.

5. دون قيم عنوان URL للرمز المميز والتكوين للخطوة التالية.

6. في Azure CLI، انشر ملحق البوابة باستخدام az k8s-extension create الأمر . token املأ القيم وconfiguration URL.

   • يستخدم المثال التالي تكوين الملحق service.type='LoadBalancer' . راجع المزيد من تكوينات الملحقات المتوفرة.

   az k8s-extension create --cluster-type connectedClusters --cluster-name <cluster-name> \
       --resource-group <rg-name> --name <extension-name> --extension-type Microsoft.ApiManagement.Gateway \
       --scope namespace --target-namespace <namespace> \
       --configuration-settings gateway.configuration.uri='<Configuration URL>' \
       --config-protected-settings gateway.auth.token='<token>' \
       --configuration-settings service.type='LoadBalancer' --release-train preview
   

   تلميح

   -protected- العلامة ل gateway.auth.token اختيارية، ولكن يوصى بها.

7. تحقق من حالة التوزيع باستخدام الأمر CLI التالي:

   az k8s-extension show --cluster-type connectedClusters --cluster-name <cluster-name> --resource-group <rg-name> --name <extension-name>
   

8. انتقل مرة أخرى إلى قائمة البوابات للتحقق من أن حالة البوابة تعرض علامة اختيار خضراء مع عدد العقد. تعني هذه الحالة حواسب البوابات المستضافة ذاتيًا التي تم توزيعها:

   • يتم بنجاح الاتصال مع APIM.
   • لديك "رسالة كشف أخطاء الاتصال" منتظمة.

وزع ملحق بوابة APIM باستخدام مدخل Microsoft Azure

1. في مدخل Microsoft Azure، انتقل إلى نظام المجموعة المتصل Azure Arc.

2. في القائمة اليسرى، حدد Extensions>+ Add>API Management gateway (preview).

3. حدد إنشاء.

4. في نافذة Install API Management gateway ، قم بتكوين ملحق البوابة:

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

   

5. في علامة التبويب Monitoring ، قم بتمكين المراقبة اختياريا لتحميل طلبات تتبع المقاييس إلى البوابة والواجهة الخلفية. إذا تم تمكينه، فحدد مساحة عمل Log Analytics موجودة.

6. حدد Review + install ثم Install.

اطلع على المزيد من تكوينات الملحقات المتاحة

يوفر ملحق البوابة المستضاف ذاتيا ل Azure Arc العديد من إعدادات التكوين لتخصيص الملحق للبيئة الخاصة بك. يسرد هذا القسم إعدادات النشر المطلوبة والإعدادات الاختيارية للتكامل مع Log Analytics. للحصول على قائمة كاملة بالإعدادات، راجع مرجع ملحق البوابة المستضافة ذاتيا.

الإعدادات المطلوبة

تكوينات الملحق التالية مطلوبة.

الإعدادات	‏‏الوصف
gateway.configuration.uri	نقطة نهاية التكوين في خدمة APIM للبوابة المستضافة ذاتيا.
gateway.auth.token	رمز البوابة المميز (مفتاح المصادقة) للمصادقة على خدمة APIM. يبدأ عادة ب GatewayKey.
service.type	تكوين خدمة Kubernetes للبوابة: LoadBalancerأو NodePortأو .ClusterIP

إعدادات تحليلات السجلات

لتمكين مراقبة البوابة المستضافة ذاتيًا، قم بتكوين إعدادات تحليلات السجل التالية:

الإعدادات	‏‏الوصف
monitoring.customResourceId	معرف Azure Resource Manager لمثيل APIM.
monitoring.workspaceId	معرّف مساحة العمل لتحليلات السجل.
monitoring.ingestionKey	البيانات السرية مع مفتاح الإدخال من تحليلات السجل.

إشعار

إذا لم تقم بتمكين تحليلات السجل:

1. اطلع على التشغيل السريع إنشاء مساحة عمل Log Analytics.
2. تعرف على مكان العثور على إعدادات عامل Log Analytics.

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

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