تفعيل نشر HTTP

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

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

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

يوضّح هذا القسم كيفية تفعيل بروتوكول HTTP للنشر.

تعديل مؤسستك

لتفعيل عملية النشر عبر بروتوكول HTTP، أرسِل طلبًا من النوع PUT إلى واجهة برمجة التطبيقات Update organization properties API. اضبط السمات التالية في نص الطلب:

الموقع	الوصف
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.

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