تفعيل نشر HTTP

يستخدم Edge تلقائيًا RPC لنشر الخوادم الوكيلة لواجهة برمجة التطبيقات. على الرغم من أنّ هذا الوضع يعمل بشكل جيد مع معظم عمليات التثبيت، قد تواجه المخططات الأكبر حجمًا التي تحتوي على العديد من معالجات الرسائل مهلات عند إجراء عدد كبير من المكالمات المتزامنة عبر 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.

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