تفعيل نشر HTTP

بشكل تلقائي، يستخدم Edge RPC لنشر الخوادم الوكيلة لواجهة برمجة التطبيقات. وبينما يعمل هذا الوضع بشكل جيد للغاية مع معظم عمليات التثبيت، قد تواجه المخططات ذات الحجم الأكبر التي تتضمن العديد من وحدات MP مهلة عند إجراء عدد كبير من المكالمات المتزامنة عبر استدعاء إجراء عن بُعد (RPC). تخطط Apigee لإيقاف هذا التنفيذ في المستقبل.

نتيجةً لذلك، تنصح Apigee باستخدام بروتوكول HTTP بدلاً من RPC للنشر.

بالإضافة إلى إمكانية توفير المزيد من الموثوقية، يعمل تفعيل نشر HTTP أيضًا على تحسين المحتوى وتنسيق الاستثناءات التي قد يتم طرحها أثناء عملية النشر.

يصف هذا القسم كيفية تفعيل HTTP للنشر.

تعديل بيانات مؤسستك

لتفعيل نشر HTTP، أرسِل طلب PUT إلى تحديث خصائص المؤسسة. اضبط السمات التالية في نص الطلب:

الموقع	الوصف
allow.deployment.over.http	يحدد ما إذا كان بإمكان Edge نشر الخوادم الوكيلة لواجهة برمجة التطبيقات عبر HTTP (بالإضافة إلى استدعاء إجراء عن بُعد (RPC)). اضبط السمة على true للسماح بنشر بروتوكول HTTP، وإلا سيتم استخدام false. والقيمة التلقائية هي false. لتفعيل عمليات نشر HTTP، يجب ضبط هذه السمة على true.
use.http.for.configuration	تُحدِّد الطريقة المطلوب استخدامها لأحداث الضبط. القيم المتاحة: never: تستخدم جميع أحداث الضبط استدعاء إجراء عن بُعد (RPC). وهذا هو الخيار التلقائي. retry: تستخدم جميع أحداث الضبط استدعاء إجراء عن بُعد (RPC) أولاً، وإذا تعذَّر تنفيذ حدث من خلال استدعاء إجراء عن بُعد (RPC)، سيحاول Edge استخدام HTTP. وقد يؤدي هذا إلى حدوث تأخيرات إذا كان يجب استخدام HTTP. always: تستخدم جميع أحداث الإعداد بروتوكول HTTP. لتفعيل عمليات نشر HTTP، تنصح Apigee بضبط هذه السمة على always.

وبالإضافة إلى ضبط هاتَين السمتَين في نص الرسالة، عليك ضبط العنوان Content-Type على application/json أو application/xml.

يستدعي المثال التالي تحديث سمات المؤسسة مع نص رسالة JSON.

curl -u admin_email:admin_password
  "http://management_server_IP:8080/v1/organizations/org_name"
  -X POST -H "Content-Type: application/json" -d
  '{
    "properties" : {
      "property" : [
      {
        "name" : "allow.deployment.over.http",
        "value" : "true"
      },
      {
        "name" : "use.http.for.configuration",
        "value" : "always"
      } ]
    }
  }'

لتفعيل نشر HTTP على جميع الخوادم الوكيلة لواجهة برمجة التطبيقات في جميع مؤسساتك، عليك تعديل بيانات كل مؤسسة كما هو موضَّح أعلاه.

اختبار التحديث

لاختبار نجاح التحديث، شغّل حدث نشر على خادم وكيل لواجهة برمجة التطبيقات في المؤسسة المحدثة، ثم راجع ملفات السجل لمعالج الرسائل. يجب أن يحتوي إدخال السجل لأحداث النشر على mode:API.

لمزيد من المعلومات، يمكنك الاطّلاع على ملفات السجلّ.