4.50.00 Edge for Private Cloud 版本資訊

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

本節說明 Edge for Private Cloud 功能發布的 4.50.00 版。

版本摘要

下表彙整了這個版本中的變更:

新功能

這個版本包含下列新功能:

○ API Proxy 現在提供 TLS 連線資訊
○ Zookeeper 升級
○ Drupal 8 入口網站現已推出,Drupal 7 則已終止支援

如要進一步瞭解各項新功能,請參閱新功能

回溯相容性 這個版本的 Apigee Edge Private Cloud 導入了下列影響回溯相容性的問題:
     
  • 由於修正了問題 132443137 (如公開雲端 19.03.01 版發行說明所述),訊息處理器現在會忽略開頭為 X-Apigee-* 的標頭。因此,您必須重構使用 X-Apigee-* 標頭的任何程式碼,並將這些標頭替換為支援的標頭。
  • Cassandra 記錄檔的名稱已變更。現在:

    /opt/apigee/var/log/apigee-cassandra/system.log
包含的發布內容

自上一個 Edge for Private Cloud 功能版本發布以來,已推出下列版本,並納入這個版本:

○ Edge:
   20.04.06 (執行階段、API 管理、營利管理)
   20.03.27 (使用者介面)
   20.03.16 (Edge Analytics)
   20.03.11 (使用者介面)
   20.02.27 (API 監控)
   20.02.24 (使用者介面)
   20.02.03 (API 監控)
   20.01.29 (使用者介面)
   20.01.22 (使用者介面)
   20.01.06 (API 管理/執行階段)
○ Edge (續):
   20.01.06 (UI)
   19.11.13 (API 安全性報告)
   19.10.01 (UI)
   19.09.26 (Edge UI/入口網站)
   19.08.27 (UI)
   19.08.15 (API 安全性報告)
   19.07.29 (UI)
○ Portal:
   20.05.27.00
   20.04.13.00
   20.03.20.00
   19.12.20.00
   19.11.21.00
   19.09.25.00
淘汰
淘汰項目

4.50.00 版發布後:

  • 4.18.05:Apigee Edge for Private Cloud 4.18.05 版現已淘汰。

這個版本淘汰的功能包括:

  • 支援 Node.js Proxy 和 Secure Vault
  • 支援 OAuth v1 政策
  • 支援並行速率限制政策
  • 支援 Istio 適用的 Apigee 轉接器
  • 支援 Teams 搶先體驗功能

如要進一步瞭解淘汰項目 (包括移除時間表),請參閱「Apigee 淘汰和停用項目」。

修正錯誤

這個版本修正了下列錯誤:

○ 如果金鑰儲存區設定了類似的名稱或別名,訊息處理器就無法載入環境。(154428338)
○ 安裝修補程式時發生 QPid 依附元件衝突 (152574421)
○ 快取記憶體限制器未遵守 L1 快取大小上限 (151449163)
○ 備份指令碼失敗 (150710952)
○ QPid 伺服器傳送額外的記錄訊息 (148231209)
○ Postgresql 備份未儲存 SSO 資訊 (147458330)
○ apigee-nginx 版本未升級。(146872858)
○ 不再顯示「試用新版 UI」訊息 (145419621)
○ Apigee SmartDocs API 安全漏洞 (145340106)
○ Postgres 備份指令碼失敗 (145254693)
○ 各種安全性修正 (142150706)
○ 路由器至訊息處理器逾時率偏高 (138107618)
○ SSO 設定指令碼失敗 (135616498)
○ JMX 通訊埠 (132044907)
○ 由於競爭狀況,導致執行階段流量間歇性出現 404 錯誤 (130653816)
○ 升級期間 OpenLDAP 損毀 (120799182)
○ 多個資料中心設定中的 DataAccessException (76087166)
○ MessageLogging 政策中設為 false 的 FormatMessage 無效 (68722102)

如要進一步瞭解各項修正,請參閱「錯誤修正」。

已知問題

這個版本有下列已知問題:

○ JWT 驗證失敗 (159788170)
○ Mint 評分伺服器記憶體洩漏 (137865184)
○ Amazon Linux 1 不支援 apigee-monit (122370980)
○ Message Processor 備份未備份正確的檔案集 (121095148)
○ 升級後快取未命中率提高 (160109014)
○ 針對主體空白且 Content-Encoding: gzip 的 GET 要求,HTTP 408 回應。(159858015)

如要進一步瞭解各項已知問題 (包括解決方法),請參閱「已知問題」。

升級路徑

下表列出這個版本的升級路徑:

從 4.19.01 或 4.19.06 版升級 直接從 4.19.01/4.19.06 升級至 4.50.00
4.18.05 版起 直接從 4.18.05 升級至 4.50.00

新功能

本節列出這個版本的新功能。此外,這個版本也包含「Included Releases」中列出的 Edge UI、Edge Management 和 Portal 版本的所有功能。

除了下列強化功能外,這個版本也包含多項可用性、效能、安全性及穩定性強化功能。

API Proxy 現在提供 TLS 連線資訊

透過支援 TLS 的虛擬主機向 API Proxy 提出要求時,Edge 可以擷取 TLS 連線的相關資訊。API Proxy 現在可以透過流程變數存取該資訊,執行額外分析和驗證。詳情請參閱「評估 API Proxy 中的傳輸層安全標準 (TLS) 連線資訊」。

Zookeeper 升級

這個版本包含 Zookeeper 3.4.14。

Drupal 8 入口網站的可用性,以及 Drupal 7 的終止支援

Drupal 8 已取代 Drupal 7,成為 Apigee 建議的 Private Cloud 開發人員入口網站。 由於 Drupal 7 本身將於 2021 年 11 月終止長期支援,因此自 2021 年 11 月起,我們將不再支援 Drupal 7 的 Apigee 模組。雖然 Drupal 7 的安裝/升級指令碼仍可使用,但我們建議您不要再使用,因為後續版本將會移除這些指令碼。

如要瞭解與 Apigee 整合的 Drupal 8 模組,請參閱: 使用 Drupal 8 建構入口網站

支援的軟體

這個版本對支援的軟體進行了下列變更:

支援新增 停止支援

這個版本新增了下列平台支援:

  • Red Hat Enterprise Linux (RHEL) 7.8
  • CentOS 7.8
  • Oracle Linux 7.8

這個版本不再支援下列平台:

  • Red Hat Enterprise Linux (RHEL) 6.10
  • CentOS 6.10
  • Oracle Linux 6.9

如需支援平台的完整清單,請參閱「支援的軟體和支援的版本」。

修正錯誤

本節列出本次發布版本修正的 Private Cloud 錯誤。此外,這個版本也包含「隨附版本」中顯示的 Edge UI、Edge Management 和入口網站版本的所有錯誤修正項目。

問題 ID 說明
154428338

如果金鑰儲存區設定了類似的名稱或別名,訊息處理器就無法載入環境。

我們修正了載入命名慣例相似的金鑰儲存區時,發生的 regex 查閱衝突。這導致訊息處理器無法載入與金鑰儲存區相關聯的環境,或是在查詢期間傳回多個衝突的金鑰儲存區時,無法啟動。
152574421

安裝修補程式時發生 QPid 依附元件衝突

現在已安裝正確版本的 QPid。
151449163

快取記憶體限制器未遵守 L1 快取大小上限

快取記憶體限制器現在會遵守 L1 快取大小上限。
150710952

備份指令碼失敗

備份程序已根據更新後的備份指令碼更新。
148231209

QPid 伺服器傳送額外的記錄訊息

QPid 伺服器不會再傳送額外的記錄訊息。
147458330

Postgresql 備份未儲存 SSO 資訊

Postgresql 備份現在會儲存 SSO 資訊。
146872858

apigee-nginx 版本未升級。

apigee-nginx 版本現已正確升級。
145419621

不再顯示「試試新版使用者介面」訊息

UI 不再顯示「試試新版使用者介面」訊息。
145340106

Apigee SmartDocs API 安全漏洞

更新 Apigee SmartDocs Proxy,解決安全漏洞。如需更多資訊和必要步驟,請參閱 SmartDocs 安裝程序。
145254693

Postgres 備份指令碼失敗

Postgres 備份指令碼現在可正常運作。
142150706

修正多項安全性問題

修正安全性問題,包括 #111390246。
138107618

路由器到訊息處理器逾時的比例過高

這項問題已解決。
135616498

單一登入 (SSO) 設定指令碼失敗

修正使用檔案架構網址導致單一登入設定指令碼失敗的問題。
132044907

JMX 連接埠

JMX 連接埠不應對外開放,僅供內部伺服器使用。
130653816

因競爭狀況導致執行階段流量發生間歇性 404 錯誤

修正 MP 啟動期間的競爭條件,避免部分 Proxy 無法正確部署。
120799182

升級期間 OpenLDAP 損毀

這項問題已解決。
76087166

多個資料中心設定中的 DataAccessException

在多個資料中心設定中,如果其中一個資料存放區無法使用,您就不會再看到 DataAccessException 錯誤。
68722102

在 MessageLogging 政策中將 FormatMessage 設為 false 無效

您現在可以在 MessageLogging 政策中將 FormatMessage 設為 false。

已知問題

下表列出這個版本的已知問題:

問題 ID 說明
159788170

JWT 驗證失敗

如果 RSA 金鑰小於 2048 位元,JWT 驗證就會失敗。

解決方法:

確認金鑰長度為 2048 位元以上。
137865184

Mint 評分伺服器記憶體流失

在 mxgroup 中註冊新的 Qpid 執行個體時,佇列會建構但沒有消費者,導致佇列深度不斷增加,直到用盡所有可用資源為止。

解決方法:

無。
122370980

apigee-monit Amazon Linux 1 不支援

解決方法:

無。
121095148

訊息處理器備份未備份正確的檔案集

解決方法:

再次執行備份,這次應該就能備份正確的檔案集。

160109014

升級後快取未命中率提高

升級至 4.50.00 版後,Proxy 的快取失誤率可能會提高。這些遺漏的訊息可能伴隨 MP 記錄中增加的錯誤訊息,類似於:

InvalidClassException when fetching cps cache entry from second level - com.apigee.jsonparser.LinkedJSONObject; local class incompatible: stream classdesc serialVersionUID = -8575741446425131573, local class serialVersionUID = 752634431212433936. Considering it as cache miss.

解決方法:

無,快取命中率預計會隨著時間趨於穩定。

159858015

針對主體空白且 Content-Encoding: gzip 的 GET 要求,傳回 HTTP 408 回應。

當 API 用戶端使用 Content-Encoding: gzip 標頭和空白要求內容發出 GET 要求時,會收到 408 超時回應。

解決方法:

以空白主體發出 GET 要求時,請省略 Content-Encoding 標頭。

下一步

如要開始使用 Edge for Private Cloud 4.50.00,請參閱下列連結:

新安裝人數:
新安裝服務總覽
現有安裝數:
升級路徑