نشر البوابة المستضافة ذاتيا إلى Kubernetes باستخدام Helm

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

Helm أداة تعبئة مفتوحة المصدر تساعدك على تثبيت دورة حياة تطبيقات Kubernetes وإدارتها. يسمح لك بإدارة مخططات Kubernetes، وهي عبارة عن حزم من موارد Kubernetes المهيأة مسبقاً.

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

إشعار

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

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

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

  تلميح

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

• إنشاء مثيل Azure API Management.
• توفير مورد بوابة في مثيل إدارة واجهة برمجة التطبيقات
• تثبيت Helm v3.

إضافة مستودع Helm

1. إضافة Azure API Management كمستودع جديد لـ Helm.

   helm repo add azure-apim-gateway https://azure.github.io/api-management-self-hosted-gateway/helm-charts/
   

2. تحديث المستودع لإحضار أحدث مخططات Helm البيانية.

   helm repo update
   

3. تحقق من تكوين Helm الخاص بك عن طريق سرد جميع المخططات المتاحة.

   $ helm search repo azure-apim-gateway
   NAME                                            CHART VERSION   APP VERSION     DESCRIPTION
   azure-apim-gateway/azure-api-management-gateway 1.0.0           2.0.0           A Helm chart to deploy an Azure API Management ...
   

توزيع البوابة ذاتية الاستضافة إلى Kubernetes

1. حدد البواباتمن ضمنالنشر والبنية التحتية.

2. حدد مورد البوابة المستضافة ذاتيًا الذي تنوي نشره.

3. حدد Deployment.

4. تم إنشاء رمز مميز جديد في مربع نص Token تلقائيًا من أجلك باستخدام القيم الافتراضية لكل من Expiry وSecret Key. اضبط أحدهما أو كليهما إذا رغبت في ذلك، وحدد Generate لإنشاء رمز مميز جديد.

5. لاحظ الرمز المميز وعنوان URL للتهيئة

6. تثبيت البوابة المستضافة ذاتياً باستخدام مخطط Helm

   helm install azure-api-management-gateway \
                --set gateway.configuration.uri='<your configuration url>' \
                --set gateway.auth.key='<your token>' \
                azure-apim-gateway/azure-api-management-gateway
   

7. نفذ الأمر . يوجه الأمر نظام مجموعة Kubernetes لديك إلى:

   • تنزيل صورة البوابة المستضافة ذاتياً من Microsoft Container Registry وتشغيلها كحاوية.
   • تكوين الحاوية لعرض منفذي HTTP (8080) وHTTPS (8081).

   هام

   افتراضياً، تستخدم العبّارة خدمة ClusterIP ولا يتم عرضها إلا داخل المجموعة. يمكنك تغيير هذا عن طريق تحديد نوع خدمة Kubernetes أثناء التثبيت.

   على سبيل المثال، يمكنك كشفه من خلال موازن تحميل عن طريق إضافة --set service.type=LoadBalancer

8. تشغيل الأمر التالي للتحقق من تشغيل جراب البوابة. سيكون اسم جرابك مختلفًا.

   kubectl get pods
   NAME                                           READY     STATUS    RESTARTS   AGE
   azure-api-management-gateway-59f5fb94c-s9stz   1/1       Running   0          1m
   

9. تشغيل الأمر التالي للتحقق من تشغيل خدمة البوابة. سيكون اسم الخدمة وعناوين IP مختلفين.

   kubectl get services
   NAME                           TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)               AGE
   azure-api-management-gateway   ClusterIP   10.0.229.55     <none>        8080/TCP,8081/TCP     1m
   

10. ارجع إلى مدخل Azure وتأكد من أن عقدة المدخل التي نشرتها تبلغ عن حالة سليمة.

تلميح

استخدم الأمر kubectl logs <gateway-pod-name> لعرض لقطة لسجل البوابة المستضافة ذاتيًا.

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

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