نشر البوابة المستضافة ذاتيا إلى 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 في الموقع أو في السحابة لأحمال العمل الإنتاجية.
- إنشاء مثيل Azure API Management.
- توفير مورد بوابة في مثيل إدارة واجهة برمجة التطبيقات
- تثبيت Helm v3.
إضافة مستودع Helm
إضافة Azure API Management كمستودع جديد لـ Helm.
helm repo add azure-apim-gateway https://azure.github.io/api-management-self-hosted-gateway/helm-charts/
تحديث المستودع لإحضار أحدث مخططات Helm البيانية.
helm repo update
تحقق من تكوين 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
حدد البواباتمن ضمنالنشر والبنية التحتية.
حدد مورد البوابة المستضافة ذاتيًا الذي تنوي نشره.
حدد Deployment.
تم إنشاء رمز مميز جديد في مربع نص Token تلقائيًا من أجلك باستخدام القيم الافتراضية لكل من Expiry وSecret Key. اضبط أحدهما أو كليهما إذا رغبت في ذلك، وحدد Generate لإنشاء رمز مميز جديد.
لاحظ الرمز المميز وعنوان URL للتهيئة
تثبيت البوابة المستضافة ذاتياً باستخدام مخطط 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
نفذ الأمر . يوجه الأمر نظام مجموعة Kubernetes لديك إلى:
- تنزيل صورة البوابة المستضافة ذاتياً من Microsoft Container Registry وتشغيلها كحاوية.
- تكوين الحاوية لعرض منفذي HTTP (8080) وHTTPS (8081).
هام
افتراضياً، تستخدم العبّارة خدمة ClusterIP ولا يتم عرضها إلا داخل المجموعة. يمكنك تغيير هذا عن طريق تحديد نوع خدمة Kubernetes أثناء التثبيت.
على سبيل المثال، يمكنك كشفه من خلال موازن تحميل عن طريق إضافة
--set service.type=LoadBalancer
تشغيل الأمر التالي للتحقق من تشغيل جراب البوابة. سيكون اسم جرابك مختلفًا.
kubectl get pods NAME READY STATUS RESTARTS AGE azure-api-management-gateway-59f5fb94c-s9stz 1/1 Running 0 1m
تشغيل الأمر التالي للتحقق من تشغيل خدمة البوابة. سيكون اسم الخدمة وعناوين 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
ارجع إلى مدخل Azure وتأكد من أن عقدة المدخل التي نشرتها تبلغ عن حالة سليمة.
تلميح
استخدم الأمر kubectl logs <gateway-pod-name>
لعرض لقطة لسجل البوابة المستضافة ذاتيًا.
الخطوات التالية
- التعرف على المزيد بشأن البوابة المستضافة ذاتياً، راجع نظرة عامة على البوابة المستضافة ذاتياً في Azure APIM.
- تعرف على المزيد حول إرشادات تشغيل البوابة المستضافة ذاتيا على Kubernetes في الإنتاج.
- تعرف على كيفية نشر البوابة المستضافة ذاتيًا لإدارة واجهة برمجة التطبيقات إلى مجموعات Kubernetes الممكّنة بواسطة Azure Arc.
- تعرف على المزيد بشأن قدرات المراقبة لبوابات إدارة واجهات برمجة التطبيقات في Azure.
الملاحظات
https://aka.ms/ContentUserFeedback.
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجعإرسال الملاحظات وعرضها المتعلقة بـ