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

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

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

إشعار

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

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

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

إشعار

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

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

1. حدد البوابات المستضافة ذاتيا ضمن النشر + البنية الأساسية.

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

3. حدد نشر الإعدادات>.

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 Artifact Registry، ولتعيين منافذ HTTP (8080) وHTTPS (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. ارجع إلى مدخل Microsoft Azure، وحدد نظرة عامة، وتأكد من أن حاوية البوابة المستضافة ذاتيا التي قمت بنشرها للتو تبلغ عن حالة سليمة.

    

تلميح

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

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

المحتوى ذو الصلة

• لمعرفة المزيد حول البوابة المستضافة ذاتيا، راجع نظرة عامة على البوابة المستضافة ذاتيا.
• قم بتكوين اسم مجال مخصص لبوابة مستضافة ذاتيا.