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

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

我們在 2020 年 4 月 3 日推出了 Apigee Hybrid 執行階段 1.2.0 版。

升級中

新功能與更新

這個版本的新功能和更新項目如下。

已新增虛擬主機設定以指定轉送規則

新的 virtualhosts 設定功能解決了基本路徑轉送至多個環境順序的問題。詳情請參閱「 設定虛擬主機」。(150336519)

OASValidation 政策 Beta 版

OASValidation (OpenAPI 規格驗證) 政策 (Beta 版) 可讓您依據 OpenAPI 3.0 規範 (JSON 或 YAML) 驗證傳入的要求或回應訊息。詳情請參閱「OASValidation 政策 (Beta 版)」一文。(144949685)

WebSocket 支援的 Beta 版

Apigee Hybrid 支援 WebSocket 連線。API Proxy 用戶端現在可以要求將通訊協定從 HTTP 升級為 WebSocket。詳情請參閱使用 WebSocket (Beta 版)

從 Kubernetes 密鑰存取政策密鑰值

您可以利用新功能,透過 Proxy 流程變數存取 Kubernetes 密鑰中儲存的值。詳情請參閱「將資料儲存於 Kubernetes 密鑰」一文。(133377603)

Apigee Operator (AO) 元素取代 ADAC 和 ADAH

Apigee 操作者 (AO) 建立及更新部署及維護 AD 所需的低階 Kubernetes 和 Istio 資源。舉例來說,控制器會執行訊息處理器的版本。此外,先驗證 ApigeeDeployment 設定,再將設定保留在 Kubernetes 叢集中。AO 取代 Apigee 部署作業 Admissionhook (ADAH) 和 Apigee 部署控制器 (ADC)。請參閱 ao 設定屬性參考資料。(151250559)

替換並淘汰某些叢集和專案設定屬性

新增了兩項設定屬性:k8sClustergcp。這些屬性已取代以下已淘汰的屬性:k8sClusterNamegcpRegiongcpProjectID。詳情請參閱設定屬性參考資料。(146299599)

在 Kubernetes 上為 Cassandra 提供永久磁碟區擴充功能

我們新增了一項程序,擴大 apigee-cassandra 使用的永久磁碟區來滿足儲存空間需求,因此不需要新增更多節點來增加儲存空間。請參閱擴充 Cassandra 永久磁碟區。(138167919)

支援憑證、加密金鑰和 SA 的其他來源

已新增設定屬性,讓您以更靈活的方式指定 TLS 憑證、加密金鑰和服務帳戶金鑰。以下列出新屬性:

  • kmsEncryptionPath
  • kmsEncryptionSecret.key
  • kmsEncryptionSecret.name
  • cassandra.backup.serviceAccountSecretRef
  • cassandra.restore.serviceAccountSecretRef
  • envs[].cacheEncryptionPath
  • envs[].cacheEncryptionSecret.key
  • envs[].cacheEncryptionSecret.name
  • envs[].kmsEncryptionPath
  • envs[].kmsEncryptionSecret.key
  • envs[].kmsEncryptionSecret.name
  • envs[].serviceAccountSecretRefs.synchronizer
  • envs[].serviceAccountSecretRefs.udca
  • envs[].sslSecret
  • logger.serviceAccountSecretRef
  • mart.serviceAccountSecretRef
  • mart.sslSecret
  • metrics.serviceAccountSecretRef
  • synchronizer.serviceAccountSecretRef
  • udca.serviceAccountSecretRef

詳情請參閱設定屬性參考資料。(145303466)

讓客戶先對資料進行模糊處理,再將資料傳送至數據分析

我們新增了一項功能,可讓您先模糊處理特定分析資料,再傳送至管理層。詳情請參閱 模糊處理使用者資料,以便進行數據分析。(142578910)

展開 Statefulset 的永久磁碟區

新增一項功能,讓您可擴大 apigee-cassandra 所使用的永久磁碟區,滿足儲存需求,而不增加更多運算能力。詳情請參閱「擴充 Statefulset 的永久磁碟區」。(138167919)

GKE、Anthos 和 AKS 支援的最低版本皆已升級

Apigee Hybrid 現已支援 GKE 1.14.x、Anthos 1.2 和 AKS 1.14.x。(149578101)

支援北行連線的 TLS 1.3

透過兩項新的設定屬性,您可以設定輸入作業的 TLS 版本下限和上限:ingress.minTLSProtocolVersionmaxTLSProtocolVersion。可能的值為 1.0、1.1、1.2 和 1.3。詳情請參閱設定屬性參考資料。(117580780)

支援混合式執行階段的轉送 Proxy 設定

部署至環境的 API Proxy 現已支援 HTTP 轉送 Proxy。 詳情請參閱「設定轉送 Proxy」。(148970527)

支援每個環境的多個主機別名

已新增新的設定屬性 envs[].hostAliases。這項屬性可讓您為環境新增多個主機別名。請使用此元素,而不要使用已淘汰的 hostAlias。詳情請參閱「為環境新增多個主機別名」。(150738495)

允許資源集範本

<PropertySetRef> 將新的元素 <PropertySetRef> 新增至 <AssignMessage> 政策的 <AssignVariable> 元素。<PropertySetRef> 可讓您動態建立屬性集名稱/金鑰組。 這項功能僅適用於部署至 Apigee Hybrid 的 API Proxy。請參閱「AssignVariable」一節。(148612340)

修正錯誤

本次更新修正了下列錯誤。這份清單主要是用來確認支援單是否已經解決,無法向所有使用者提供詳細資訊。

問題 ID 元件名稱 說明
147958049 執行階段 執行階段啟動序列的時間問題已解決,有時會導致同步程式無法正確啟動。
149867244 K8S 平台 apigee-cps-setup Pod 在多區域設定失敗
150187652 / 149117839 執行階段 無法在環境名稱中使用連字號。
149220463 MP Pod 先前部署的 Proxy 需要重新部署。
144321144 執行階段 無法重新載入含有安全虛擬主機的 Proxy。
147685310 執行階段 初始化期間 GCP 權杖擷取失敗,導致同步工具初始化失敗。
151115900 執行階段 因此 HybridMART 並未進行定期內部探測,導致出現誤判結果。

已知問題

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

問題 說明
不適用

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 才會將工作階段納入回應。
143659917

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

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

摘要:使用 API 或 UI 取得機構的部署狀態時,會發生延遲時間極高的情形。這段延遲時間可能會產生 HTTP 204 (No Content)HTTP 400 (Bad Request) 回應。

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