مشاركة عبر

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

  • مقالة

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

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

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

هام

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

إشعار

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

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

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

    تلميح

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

إضافة مستودع 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> لعرض لقطة لسجل البوابة المستضافة ذاتيًا.

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