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

您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件。 資訊

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 版。如果覆寫設定是將流量轉送至具有相同主機別名的不同環境，輸入就不會按照路徑轉送至環境。
143774187 混合型使用者介面會在「應用程式」檢視畫面中顯示「公司」標籤。

已知問題

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

問題 說明
不適用 「*」無法用於 hostAlias 屬性的 mart 和 envs 設定。最佳做法是使用特定的主機名稱進行 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 政策移除主機標頭。
144584813 如果您建立偵錯工作階段，但工作階段中沒有任何交易，List Debug Sessions API 就不會將該工作階段列入這份清單。只有在工作階段至少包含一筆交易時，API 才會將工作階段納入回應。
144436206 在「Cache Performance」檢視畫面中，快取命中率的計算方式不正確。
144321491 Apigee Hybrid 記錄檔「正在建立缺少快取」通知，指出效能可能會降低。這是正常顯示的訊息，系統會忽略這些訊息。
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) 回應。

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