فعال کردن استقرار HTTP

به‌طور پیش‌فرض، Edge از RPC برای استقرار پراکسی‌های API استفاده می‌کند. اگرچه این حالت برای اکثر نصب‌ها بسیار خوب کار می‌کند، اما توپولوژی‌های بزرگ‌تر با تعداد زیادی MP ممکن است هنگام برقراری تعداد زیادی تماس هم‌زمان ازطریق RPC با وقفه زمانی مواجه شوند. Apigee قصد دارد این پیاده‌سازی را در آینده منسوخ کند.

درنتیجه، Apigee توصیه می‌کند که برای استقرارهای بزرگ‌تر، به‌جای RPC از HTTP برای استقرار استفاده شود.

علاوه‌بر اینکه فعال کردن استقرار HTTP به‌طور بالقوه قابلیت اطمینان بیشتری را فراهم می‌کند، محتوا و قالب استثناهایی را که ممکن است درطول فرایند استقرار ایجاد شود نیز بهبود می‌بخشد.

این بخش نحوه فعال کردن HTTP برای استقرار را شرح می‌دهد.

به‌روزرسانی سازمان

برای فعال کردن استقرار HTTP، درخواست PUT را به میانای برنامه‌سازی کاربردی به‌روزرسانی ویژگی‌های سازمان ارسال کنید. ویژگی‌های زیر را در بدنه درخواست تنظیم کنید:

دارایی شرح
allow.deployment.over.http تعیین می‌کند که آیا Edge می‌تواند پراکسی‌های میانای برنامه‌سازی کاربردی را ازطریق HTTP (علاوه‌بر RPC) مستقر کند یا نه. برای مجاز کردن استقرار HTTP، روی true تنظیم کنید؛ درغیراین‌صورت، 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 تنظیم کنید.

نمونه زیر میانای برنامه‌سازی کاربردی Update organization properties را با بدنه پیام 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 باشد.

برای اطلاعات بیشتر، به فایل‌های گزارش مراجعه کنید.