1.1.0 - Apigee Hybrid 執行階段版本資訊

您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info

Google 已於 2020 年 1 月 27 日發布 Apigee Hybrid 執行階段 1.1.0 版。本節說明 1.1.0 版的新功能和變更。

升級中

您無法從 1.0.0 升級至 1.1.0，且新版本不回溯相容於 1.0.0 版。1.1.0 版需要重新安裝。

新功能與改良項目

Apigee Connect (Alpha 版)

Apigee Connect Alpha 可讓 Apigee Hybrid MART 服務連線至管理平面，無須公開 MART 端點。如果您使用 Apigee Connect，則不需要使用主機別名和授權的 DNS 憑證，設定 MART 輸入閘道。詳情請洽詢 Apigee 代表。

基本路徑轉送

您可以透過基本路徑路由設定及管理 Apigee Hybrid 如何將 API Proxy 呼叫路由至特定環境。詳情請參閱「設定基本路徑路由」。

變更內容

混合式執行階段 1.1.0 版已進行下列變更。如前所述，其中部分變更不會造成回溯不相容，因此可與 1.0.0 版搭配使用。

  • apigeectl CLI 現在會在 istio-system 命名空間中安裝 Istio。 這是 Istio 的預設命名空間。這項變更不回溯相容於混合式版本 1.0.0。
  • apigeectl CLI 現在會將 CertManager 安裝到 cert-manager 命名空間。這項變更不回溯相容於混合式版本 1.0.0。
  • 由於不再支援 1.2.x 版，因此使用 Apigee Hybrid 執行階段部署的 Istio 支援版本已遷移至 1.4.2 版。

修正錯誤

Apigee Hybrid 1.0.0 版本資訊中列出的下列問題已修正：

問題 說明
144886537 Apigee hybrid 1.0.0 版不支援基本路徑轉送。 如果設定的覆寫會將流量導向至具有相同 hostAlias 的不同環境，則 Ingress 不會根據路徑將流量導向至環境。
143774187 混合式 UI 會在「應用程式」檢視畫面中顯示「公司」標籤。

已知問題

下表說明這個版本的已知問題：

問題 說明
不適用 您無法在 mart 和 envs 設定的 hostAlias 屬性中使用「*」。最佳做法是為 mart 設定使用特定主機名稱。
不適用 Apigee Connect Alpha 版不支援設定 HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY 變數。
不適用

HTTP 標頭無效錯誤：Istio Ingress 會將所有傳入的目標回應切換至 HTTP2 通訊協定。由於混合式訊息處理器僅支援 HTTP1，因此呼叫 API Proxy 時，可能會看到下列錯誤：

http2 error: Invalid HTTP header field was received: frame type: 1, stream: 1,
   name: [:authority], value: [domain_name]

如果看到這則錯誤訊息，請採取下列任一做法來修正問題：

  • 修改目標服務，在回應中省略 Host 標頭。
  • 如有必要，請在 API Proxy 中使用 AssignMessage 政策移除 Host 標頭。
144584813 如果您建立偵錯工作階段，但工作階段中尚未有任何交易，List Debug Sessions API 就不會將該工作階段納入清單。只有當工作階段包含至少一筆交易時，API 才會在回應中納入該工作階段。
144436206 在「快取效能」檢視畫面中，快取命中率的計算結果不正確。
144321491 Apigee Hybrid 會記錄「Creating missing cache」通知，指出可能導致效能下降。這些訊息是正常現象，可以忽略。
144321144 無法重新載入具有安全虛擬主機的 Proxy。
144286363

env.json 中的偵錯遮罩不會遮蓋回應資料。

下列 API 無法使用 responseJSONPaths 欄位更新 env.json 偵錯遮罩：

PATCH /v1/organizations/org/environments/env/debugmask?replaceRepeatedFields=true
{
  "responseJSONPaths": ["$.maskedDataEnv"]
}

如要解決這個問題，您可以透過 UI 刪除整個追蹤工作階段， 也可以使用追蹤 API 刪除工作階段中的個別交易。
143659917

PopulateCache 政策的到期設定必須設為介於 1 到 30 之間的明確值。例如：

<ExpirySettings>
  <TimeoutInSec>30</TimeoutInSec>
</ExpirySettings>
133192879

摘要：使用 API 或 UI 取得貴機構的部署狀態時，延遲時間非常長。這類延遲可能會導致 HTTP 204 (No Content) 或 HTTP 400 (Bad Request) 回應。

解決方法：重新整理瀏覽器 (或重新傳送要求)。