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

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

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

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

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

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

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

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

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

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

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