نشر البوابة المستضافة ذاتيًا لإدارة واجهة برمجة التطبيقاتAzure API إلى Docker

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

توفر هذه المقالة خطوات نشر مكوّن البوابة المستضافة ذاتيًا لإدارة Azure API إلى بيئة Docker.

إشعار

استضافة بوابة ذاتية الاستضافة في Docker هي الأنسب لحالات التقييم واستخدام التطوير. يوصى بـ Kubernetes للاستخدام في الإنتاج. تعرف على كيفية التوزيع باستخدام Helm أو استخدام ملف YAML للتوزيع لمعرفة كيفية توزيع البوابة المستضافة ذاتياً إلى Kubernetes.

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

• إتمام التشغيل السريع التالي: إنشاء مثيل في Azure APIM
• إنشاء بيئة Docker. Docker لسطح المكتبهو خيار جيد لأغراض التطوير والتقييم. راجعوثائق Docker للحصول على معلومات حول كافة إصدارات Docker وميزاتها والوثائق الشاملة على Docker نفسه.
• توفير مورد بوابة في مثيل إدارة واجهة برمجة التطبيقات الخاصة بك

إشعار

يتم حزم البوابة ذاتية الاستضافة كحاوية Docker المستندة إلى Linux x86-64.

نشر البوابة المستضافة ذاتيًا إلى Docker

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

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

3. حدد Deployment.

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

5. تأكد من تحديد Docker ضمن نصوص النشر.

6. حدد رابط ملف env.conf المجاورللبيئة لتنزيل الملف.

7. حدد رمزالنسخالموجود في أقصى الطرف الأيمن من مربع نص التشغيللنسخ أمر Docker إلى الحافظة.

8. الصق الأمر في نافذة الوحدة الطرفية (أو الأمر). اضبط تعيينات المنفذ واسم الحاوية حسب الحاجة. لاحظ أن الأمر يفترض أن ملف البيئة الذي تم تنزيله موجود في الدليل الحالي.

   docker run -d -p 80:8080 -p 443:8081 --name <gateway-name> --env-file env.conf mcr.microsoft.com/azure-api-management/gateway:<tag>
   

9. نفذ الأمر . يوجه الأمر بيئة Docker لديك إلى تشغيل الحاوية باستخدام صورة حاوية منMicrosoft Container Registry، وتعيين حاوية HTTP (8080) ومنافذ HTTP (8081) إلى منافذ 80 و443 على المضيف.

10. تشغيل الأمر أدناه للتحقق مما إذا كانت حاوية البوابة قيد التشغيل:

    docker ps
    CONTAINER ID        IMAGE                                                 COMMAND                  CREATED             STATUS              PORTS                                         NAMES
    895ef0ecf13b        mcr.microsoft.com/azure-api-management/gateway:latest   "/bin/sh -c 'dotnet …"   5 seconds ago       Up 3 seconds        0.0.0.0:80->8080/tcp, 0.0.0.0:443->8081/tcp   my-gateway
    

11. العودة إلى مدخل Azure، انقر علىنظرة عامةوتأكد من أن حاوية البوابة المستضافة ذاتيا التي قمت بنشرها للتو تبلغ عن حالة سليمة.

    

تلميح

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

استخدم docker container logs --help الأمر لتشاهد كافة خيارات عرض السجل.

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

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