查看 Apigee Edge 說明文件。
前往
Apigee X說明文件。 資訊
本節說明適用於 Private Cloud 功能版本的 Edge 4.18.05 版,
版本摘要
下表摘要說明這個功能版本的異動內容:
新功能 | ○ JWT 政策現已正式發布 (GA) ○ RedHat Enterprise Linux 6.9 現已支援 ○ 現已支援 Oracle Linux 6.9 ○ CentOS 6.9 現已支援 ○ 全新 Edge 體驗安裝設定變更 ○ 現在可以在虛擬主機層級設定路由器重試選項 |
|||
包含的版本 |
|
|||
退休 | ○ API BaaS ○ 監控資訊主頁 (Beta 版) |
|||
淘汰項目 | ○ Apigee 安全儲存庫 (保管箱) 已由 KVM 取代 ○ 在 API Proxy「效能」分頁中新增路徑 ○ 開發人員服務入口網站的 SMTPSSL 屬性 |
|||
修正錯誤 | ○ 防止使用者的電子郵件地址遭到變更 (65550638) ○ jackson-databind (69711616) 中的安全漏洞 ○ 訊息處理器中的記憶體流失 (71612599) |
|||
已知問題 | 此版本包含以下已知問題: ○ 訊息處理器備份未備份正確的檔案 (121095148)○ 對 Node.js 發出的 HEAD 要求會停止運作 (79993247)○ 顯示「透過 Open API 建立反向 Proxy」選項 (79949124) ○ 無法解析主機名稱 (79757554) ○ 多資料中心設定中的 DataAccessExceptions (76087166) ○ 停止 apigee-postgresql (72379834) 時,會顯示權限錯誤訊息 ○ MessageLogging 政策,包括記錄訊息中的額外資訊 (68722102) 如要進一步瞭解這些已知問題 (包括解決方法),請參閱 已知問題。 |
|||
以下各節將詳細說明這些主題。
升級路徑
下表列出這個功能版本的升級路徑:
4.18.01 起 | 直接從 4.18.01 版本升級 → 4.18.05 |
4.17.09 起 | 直接從 4.17.09 → 4.18.05 升級 |
4.17.05 起 | 直接從 4.17.05 → 4.18.05 升級 |
4.17.01 起 | 從 4.17.01 → 4.18.01 升級, 再從 4.18.01 升級 → 4.18.05 |
4.16.09 起 | 從 4.16.09 → 4.18.01 升級, 再從 4.18.01 升級 → 4.18.05 |
4.16.05 起 | 從 4.16.05 → 4.18.01 升級, 再從 4.18.01 升級 → 4.18.05 |
4.16.01 起 | 從 4.16.01 → 4.18.01 升級, 再從 4.18.01 升級 → 4.18.05 |
4.15.0 倍 | 從 4.15.0x → 4.16.01 升級 然後從 4.16.01 → 4.18.01 升級,再從 4.18.01 → 4.18.05 升級 |
新功能
本節說明這個功能版本的新功能。除了這些功能 此版本包含 Edge UI、Edge 管理和 Portal 版本中列出的所有功能 包含的版本。
除了下列強化功能以外,這個版本還包含多個可用性。 效能、安全性和穩定性
JWT 政策
下列 JWT 政策 將不再處於 Beta 版測試階段;現已正式發布:
支援的軟體
這個 Feature Release 對支援的軟體進行了下列變更:
- 現已支援 Red Hat Enterprise Linux (RHEL) 6.9
- 現已支援 Oracle Linux 6.9
- 現已支援 CentOS 6.9
- 不再支援 RHEL/CentOS/Oracle Linux 7.2
若需更多資訊,請參閲 支援的軟體和支援版本。
新版 Edge 服務安裝設定變更
4.18.05 版的「New Edge」體驗包含的設定檔變更: 4.18.01 版。如需新屬性的說明,請參閱 安裝 與 Edge 4.18.01 的設定變更
現可在虛擬主機層級設定路由器重試選項
您現在可以為路由器與訊息處理器開啟的通訊設定重試選項 虛擬主機相較於先前的選項 只能在路由器層級設定
若需更多資訊,請參閲 虛擬 主機設定屬性。
新增數據分析維度並變更為「x_forwarded_for_ip
」維度
Edge 設定 x_forwarded_for_ip
維度的方式
有異動過去,如果 X-Forwarded-For
標頭中有多個 IP 位址,
x_forwarded_for_ip
維度只包含列出的最後 IP 位址。
客戶通常會使用「x_forwarded_for_ip
」維度來判斷 IP 位址的
傳送 API 要求至 Edge 的用戶端
在這個版本中,x_forwarded_for_ip
維度現在包含完整清單
第一個 IP 位址位於 X-Forwarded-For
標頭中
警告:X-Forwarded-For
標頭可能遭到存取遭拒的 IP 假冒。
的最後一個位址則例外,也就是上次外部 TCP 交握所接收的 IP 位址邊緣。
如要判斷向 Edge 發出 API 要求的原始用戶端 IP 位址,
這個版本在 Edge Analytics 中加入一個新維度:ax_resolved_client_ip
。
您現在可以在自訂報表或ax_resolved_client_ip
篩選條件來找出發出 API 要求的用戶端 IP 位址。
請參閱 Analytics 指標、維度和篩選器參考資料
進一步瞭解「ax_resolved_client_ip
」維度
這項變更也會影響 AccessControl 政策處理 X-Forwarded-For
標頭的方式。
在這個版本中,Edge 會將 X-Forwarded-For
HTTP 標頭自動填入
從「最後一個」外部 TCP 握手 (例如用戶端 IP 或路由器) 接收的單一 IP 位址。
在先前版本中,Edge 會將 X-Forwarded-For
HTTP 標頭設為
從第一個外部 TCP 交握 (例如用戶端 IP 或路由器) 接收的單一 IP 位址。
詳情請參閱
關於 X-Forwarded-For HTTP 標頭。
包含的版本
自舊版 Private Cloud 功能版本以來,Google 曾出現下列版本 ,且隨附於此功能版本中:
Edge UI | 邊緣管理/執行階段 | 傳送門 |
---|---|---|
18.04.04 18.03.02 18.02.14 17.11.06 |
18.04.06 18.04.04 18.03.02* 18.02.02 18.01.05 |
18.04.25.01 18.04.25.00 18.04.23.00 18.03.28.00 18.03.05.00 18.02.15.00 18.01.31.00 17.12.20.00 |
* 錯誤修正 74622499 未包含在 Private Cloud 4.18.05 版本中。 |
點選上方連結,即可查看錯誤修復以及那些版本的新功能 。
退休
本節說明這個功能版本已淘汰的功能。
API BaaS
API BaaS 已淘汰,若需更多資訊,請參閲 Apigee 淘汰、淘汰和 CPS 異動。
Monitoring 資訊主頁 (Beta 版)
Monitoring 資訊主頁 (Beta 版) 已淘汰,日後不再提供相關支援。因此, 下列元件不再是安裝的一部分:
apigee-influxdb
apigee-telegraf
apigee-grafana
如要繼續取得路由器、訊息處理器和節點指標,Apigee 建議您 使用 JMX 將 Edge for Private Cloud 資料與您自己的監控工具整合。如要 請參閱這篇文章,瞭解要監控的項目。 監控方式。
如果將現有的安裝檔升級至 4.18.05 版,請解除安裝 Monitoring 儀表板。Apigee 不保證能繼續正常運作。
淘汰項目
這個功能版本已淘汰下列功能。
若需更多資訊,請參閲 Apigee 淘汰、淘汰和 CPS 異動。
Apigee 安全存放區 (保管箱)
Apigee 安全存放區 (也稱為「保管箱」)並將於下列日期淘汰: 2018 年 9 月。
請改用已加密的金鑰值對應 (KVM),如 使用鍵/值對應關係。 加密 KVM 跟保管箱一樣安全,提供了更多的建立與建立選項 和擷取。
在 API Proxy「效能」分頁中新增路徑
在這個版本之前,您可以前往管理 UI 中的 API Proxy,前往 「成效」分頁,然後為 Proxy 的「成效」分頁和「商家交易」中。 儀表板中指定這項設定。
這項功能已淘汰,不會再 這些元素。如要瞭解這項功能的替代方案,請參閱 Business Transactions API 替代方案。
開發人員服務入口網站的 SMTPSSL 屬性
如要設定連至入口網站的 SMTP 伺服器所使用的通訊協定,您現在應使用
SMTP_PROTOCOL
屬性,而非 SMTPSSL
屬性。有效值
的 SMTP_PROTOCOL
為「standard」、「ssl」和「tls」。
若需更多資訊,請參閲 安裝「開發人員服務」入口網站。
修正錯誤
本節列出在這個功能版本中修正的私有雲錯誤。此外, 包含下列錯誤,此功能版本修正了 Edge UI、Edge 中的所有錯誤 「包含的版本」中顯示的管理和入口網站版本。
問題 ID | 說明 |
---|---|
71612599 |
訊息處理器的記憶體流失 記憶體流失問題已修正。當 Qpidd 為訊息處理程式時 已停止。 |
69711616 |
jackson-databind 中的安全漏洞 jackson-databind 程式庫已更新至 2.7.9.1 版, 反序列化程序。 |
65550638 |
防止使用者的電子郵件地址遭到變更 您無法在傳送至此位置的郵件酬載中,變更使用者的電子郵件地址 Management APIManagement API 現在也不允許在要求主體中使用 XML。 |
已知問題
下表列出此功能版本中的已知問題:
問題 ID | 說明 |
---|---|
121095148 |
訊息處理器備份未備份正確的檔案 解決方法: 再次執行備份作業,系統應會備份正確的檔案集。 |
79993247 |
對 Node.js 目標發出的 對 Node.js 目標發出的 HEAD 要求可能會停止運作,導致連線處於待處理狀態。 解決方法: 如要解決這個問題,請定義 |
79949124 |
顯示「透過 Open API 建立反向 Proxy」的選項 Proxy 精靈目前會顯示透過 Open API 建立新 Proxy 的選項。這對私有雲的 Edge 無法執行此操作。 解決方法: 無。 |
79757554 |
無法解析主機名稱 安裝或升級 Private Cloud 適用的 Edge 後,主機名稱可能無法解析為位址。 解決方法: 如要解決這個問題,請重新啟動 Edge UI 元件: /opt/apigee/apigee-service/bin/apigee-service edge-ui restart |
76087166 |
多個資料中心設定中的 DataAccessException 在多項資料中心設定中,如果其中一個資料儲存庫無法使用,您可能會看到 下列錯誤: DataAccessException: Error while accessing datastore; Please retry later 結果是管理伺服器嘗試連線至 Cassandra 時,可能並未啟動
分別位於 dc-1 和 dc-2 的節點上如果 Cassandra 節點是 請注意,預期的狀態是「管理伺服器」無法連線至資料儲存庫元件 以及跨區域 解決方法 解決方法是將下列 Cassandra 節點類型取消註冊在無法使用的資料中心 等到 Cassandra 節點恢復可用後,再重新註冊這些節點:
如要取消註冊並重新註冊這些 Cassandra 節點類型:
請注意,這些作業會註冊及取消註冊 Zookeeper 節點,且沒有任何 對 Cassandra 叢集的影響如要進一步瞭解這些指令,請參閱 更新資料儲存庫註冊。 |
72379834 |
停止 apigee-postgresql 時會顯示權限錯誤訊息 使用 解決方法: 無 |
68722102 |
MessageLogging 政策,包括記錄訊息中的額外資訊 MessageLogging 政策的
解決方法: 無。 |
下一步
如要開始使用 Edge for Private Cloud 4.18.05,請點選下列連結: