啟用 HTTP 部署作業

根據預設,Edge 會使用 RPC 部署 API Proxy。雖然大多數人 安裝時,大量的 MP 大型拓撲可能會導致系統在處理大量備份時 的並行呼叫是透過 RPC 進行。Apigee 預計淘汰

因此,Apigee 建議大型部署作業使用 HTTP,而不要使用遠端程序呼叫 (RPC) 可能面臨擴充性、監控、持續整合 和部署等方面的挑戰

除了可能提供更高的可靠性外,啟用 HTTP 部署功能也一併改善了 部署過程中可能擲回的例外狀況內容和格式。

本節說明如何啟用部署的 HTTP。

更新機構

如要啟用 HTTP 部署,請將 PUT 要求傳送至 更新機構屬性 API。在要求的主體中設定下列屬性:

屬性 說明
allow.deployment.over.http 決定 Edge 能否透過 HTTP (除了 RPC) 部署 API Proxy。設為 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/jsonapplication/xml

以下範例會透過 JSON 訊息呼叫 Update organizationProperties API

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"
      } ]
    }
  }'
敬上

如要為所有機構的所有 API Proxy 啟用 HTTP 部署功能,您必須更新每個 機構。

測試更新

如要測試更新是否成功,請觸發 然後查看訊息處理器的記錄檔系統會記錄 部署事件應包含 mode:API

詳情請參閱記錄檔