نشر بوابة مستضافة ذاتيا لإدارة واجهة برمجة تطبيقات Azure إلى خدمة Azure Kubernetes
ينطبق على: المطور | قسط
توفر هذه المقالة خطوات نشر مكوّن البوابة المستضافة ذاتيًا لإدارة Azure API في خدمة Azure Kubernetes. لنشر البوابة ذاتية الاستضافة إلى مجموعة Kubernetes، راجع مقالة الكيفية للنشر باستخدام ملف YAML للنشر أو باستخدام Helm.
إشعار
يمكنك أيضًا نشر البوابة المستضافة ذاتيًا إلى نظام مجموعة Kubernetes الممكن بواسطة Azure Arc كملحق نظام مجموعة.
المتطلبات الأساسية
- إنشاء مثيل إدارة Azure API
- أنشئ نظام مجموعة Azure Kubernetes باستخدام Azure CLI أو باستخدام Azure PowerShell أو باستخدام مدخل Microsoft Azure.
- توفير مورد بوابة في مثيل إدارة واجهة برمجة التطبيقات
نشر البوابة المستضافة ذاتيًا إلى AKS
حدد البواباتمن ضمنالنشر والبنية التحتية.
حدد مورد البوابة المستضافة ذاتيًا الذي تنوي نشره.
حدد Deployment.
تم إنشاء رمز مميز جديد في مربع نص Token تلقائيًا من أجلك باستخدام القيم الافتراضية لكل من Expiry وSecret Key. اضبط أحدهما أو كليهما إذا رغبت في ذلك، وحدد Generate لإنشاء رمز مميز جديد.
تأكد من تحديد Kubernetes ضمن Deployment scripts.
حدد ارتباط ملف <gateway-name>.yml بجوار Deployment لتنزيل الملف.
اضبط
config.service.endpoint
، وتعيينات المنافذ واسم الحاوية في ملف .yml حسب الحاجة.بناءً على السيناريو لديك، قد تحتاج إلى تغيير service type.
- القيمة الافتراضية هي
LoadBalancer
؛ ألا وهي موازنة التحميل الخارجية. - يمكنك استخدام موازنة التحميل الداخلية؛ لتقييد الوصول إلى البوابة المستضافة ذاتيًا للمستخدمين الداخليين فقط.
- تستخدم العينة أدناه
NodePort
.
- القيمة الافتراضية هي
حدد رمز copy الموجود في الطرف الأيمن من مربع نص Deploy؛ لحفظ أمر
kubectl
إلى الحافظة.الصق الأمر في نافذة الوحدة الطرفية (أو الأمر). يتوقع الأمر أن يكون ملف البيئة الذي تم تنزيله موجودًا في الدليل الحالي.
kubectl apply -f <gateway-name>.yaml
نفذ الأمر . يوجه الأمر نظام مجموعة AKS لديك إلى:
- تشغيل الحاوية باستخدام صورة البوابة المستضافة ذاتيًا التي تم تنزيلها من Microsoft Container Registry.
- تكوين الحاوية لعرض منفذي HTTP (8080) وHTTPS (443).
تشغيل الأمر أدناه للتحقق من تشغيل جراب البوابة. سيكون اسم جرابك مختلفًا.
kubectl get pods NAME READY STATUS RESTARTS AGE contoso-apim-gateway-59f5fb94c-s9stz 1/1 Running 0 1m
تشغيل الأمر أدناه للتحقق من تشغيل خدمة البوابة. سيكون اسم الخدمة وعناوين IP مختلفين.
kubectl get services NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE contosogateway NodePort 10.110.230.87 <none> 80:32504/TCP,443:30043/TCP 1m
ارجع إلى مدخل Azure وتأكد من أن عقدة المدخل التي نشرتها تبلغ عن حالة سليمة.
تلميح
استخدم الأمر kubectl logs <gateway-pod-name>
لعرض لقطة لسجل البوابة المستضافة ذاتيًا.
الخطوات التالية
- لمعرفة المزيد بشأن البوابة المستضافة ذاتيًا، راجع نظرة عامة على البوابة المستضافة ذاتيًا في Azure API Management.
- تعرف على كيفية نشر البوابة المستضافة ذاتيًا لإدارة واجهة برمجة التطبيقات إلى مجموعات Kubernetes الممكّنة بواسطة Azure Arc.
- تعرف على المزيد بشأن قدرات المراقبة لبوابات إدارة واجهات برمجة التطبيقات في Azure.
- تعرف على المزيد حول إرشادات تشغيل البوابة ذاتية الاستضافة على Kubernetes في الإنتاج.
- تعرف على المزيد بشأن خدمة Azure Kubernetes.