گسترش HTTP را فعال کنید

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

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

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

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

سازمان خود را به روز کنید

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

اموال توضیحات
allow.deployment.over.http تعیین می کند که آیا Edge می تواند پراکسی های API را از طریق 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 API را با بدنه پیام 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 در همه پراکسی‌های API در همه سازمان‌هایتان، باید هر سازمان را همانطور که در بالا توضیح داده شد به‌روزرسانی کنید.

آپدیت را تست کنید

برای آزمایش موفقیت آمیز بودن به روز رسانی، یک رویداد استقرار در یک پراکسی API در سازمان به روز شده را راه اندازی کنید و سپس به فایل های گزارش پردازشگر پیام نگاه کنید. ورودی گزارش برای رویدادهای استقرار باید حاوی mode:API باشد.

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