4.52.00.03 - Edge for Private Cloud 版本資訊

您正在查看 Apigee Edge 說明文件。
前往 Apigee X 說明文件
info

我們在 2023 年 10 月 25 日發布了新版 Apigee Edge for Private Cloud。

注意:我們會持續支援這個版本,直到 2024 年 10 月 25 日為止。

更新程序

如果您是從 Edge for Private Cloud 的先前版本進行更新,本節將說明如何安裝這個版本。如果您需要從舊版更新,請參閱「套用多個修補程式版本」。

更新這個版本會更新下列 RPM 清單中的元件:

  • edge-gateway-4.52.00-0.0.60200.noarch.rpm
  • edge-management-server-4.52.00-0.0.60200.noarch.rpm
  • edge-message-processor-4.52.00-0.0.60200.noarch.rpm
  • edge-postgres-server-4.52.00-0.0.60200.noarch.rpm
  • edge-qpid-server-4.52.00-0.0.60200.noarch.rpm
  • edge-router-4.52.00-0.0.60200.noarch.rpm
  • apigee-sso-4.52.00-0.0.21316.noarch.rpm
  • edge-analytics-4.52.00-0.0.40100.noarch.rpm
  • edge-management-ui-4.52.00-0.0.20029.noarch.rpm
  • edge-ui-4.52.00-0.0.20233.noarch.rpm
  • apigee-service-4.52.00-0.0.1500.noarch.rpm
  • apigee-mirror-4.52.00-0.0.1032.noarch.rpm
  • apigee-tomcat-9.0.82-0.0.939.noarch.rpm
  • apigee-configutil-4.52.00-0.0.624.noarch.rpm

您可以查看目前已安裝的 RPM 版本,瞭解是否需要更新,方法如下:

apigee-all version

如要更新安裝作業,請在 Edge 節點上執行下列程序:

  1. 在所有 Edge 節點上:

    1. 清除 Yum 存放區:
      sudo yum clean all
    2. 將最新的 Edge 4.52.00 bootstrap_4.52.00.sh 檔案下載至 /tmp/bootstrap_4.52.00.sh
      curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
    3. 安裝 Edge 4.52.00 apigee-service 公用程式和依附元件:
      sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord

      其中 uNamepWord 是您從 Apigee 收到的使用者名稱和密碼。如果省略 pWord,系統會提示您輸入。

    4. 使用 source 指令執行 apigee-service.sh 指令碼:
      source /etc/profile.d/apigee-service.sh
  2. 在所有 Edge 節點上,為邊緣程序執行 update.sh 指令碼:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  3. 在所有節點上執行 update.sh 指令碼,以便使用 SSO:
  4. /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  5. 在所有 UI 節點上,為 UI 執行 update.sh 指令碼:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. 如果您使用的是新版 Edge 服務,請執行下列指令:
    /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile

已修正安全性問題

以下是本版本已修正的已知安全性問題清單。為避免發生這些問題,請安裝最新版的 Edge for Private Cloud。
問題 ID 說明
279065506 在 OAuth2 的重新導向網址中,狀態參數的隨機性已改善,以避免跨網站要求偽造 (CSRF) 安全漏洞。
279065586 在標頭中新增內容安全性政策,為網站提供額外一層防護,避免遭受用戶端攻擊。

支援軟體異動

新增支援下列軟體版本:

  • Red Hat Enterprise Linux (Intel 64 位元):8.8 版
  • Oracle Linux (Intel 64 位元):7.9、8.7 和 8.8 版
  • Rocky Linux 8
  • Tomcat 9.0.82

如需支援軟體的完整清單,請參閱「 Edge for Private Cloud 支援的軟體」。

淘汰和停用

此版本沒有新的淘汰或停用項目。

新功能

此版本推出了下列新功能:

設定機構和環境名稱的字元數上限

在這個版本中,您可以在建立新組織或環境時,限制組織和環境名稱的字元數量上限。字元數上限的預設值為 255。如要設定較低的上限,請在各自的屬性檔案中設定下列屬性:

  • 在組織屬性檔案中設定 org.name.max.length
  • 在組織屬性檔案中設定 env.name.max.length

如果將其中任一屬性設為小於 0 或大於 255 的值,系統會分別使用 1 或 255 的最大值。

設定存取權杖的到期日

在這個版本中,您可以將 conf_keymanagement_oauth_access_token_expiry_time_in_millis 屬性設為所需的到期時間 (以毫秒為單位),藉此設定存取權權杖的到期時間。這項功能預設為停用。如要啟用這項功能,請在訊息處理器中將 conf_keymanagement_oauth_access_token_is_apply_limit 設為 true

這項功能可讓 Apigee 管理員更妥善地控管在 Apigee 中建立的存取權權杖到期日。

修正錯誤

本節列出 Private Cloud 在本次發布中修正的錯誤。

問題 ID 說明
290242749

在 DataMasking 中使用 ServiceCallout.response 變數時,追蹤記錄中不會顯示政策。

這個問題現已修正。
260397807

電子郵件範本中的問題,導致多位元字元無法透過電子郵件傳送。

這個問題現已修正。
234544436

在新的 Edge UI 中變更機構時,左側選單會消失。

這個問題現已修正。
293268203

Analytics 依附元件未在管理伺服器節點上自動升級。

這個問題現已修正。
261616264

新增了 Bootstrap 檢查,確保 postgresql 不會在升級程序中移除/刪除。

279065586

在 OAuth2 的重新導向網址中,狀態參數的熵已改善,以便避免跨網站要求偽造 (CSRF) 安全漏洞。

283310836

剖析大型 XML 時顯示的錯誤訊息已改善。

245936798

機構和環境名稱的問題導致 Postgresql 查詢失敗。<code<create< code="" dir="ltr" translate="no"> </code<create<>

我們已修正這個問題,改善了長機構和環境名稱的 postgres 索引名稱衝突處理方式。
293733533

Edge Gateway 元件中的 Spring 第三方程式庫已從 5.3.20 版更新至 5.3.27 版。

294363158

迴歸導致 Edge UI 分析和監控頁面下拉式選單中顯示一些額外的維度。

這個問題現已修正。
297889765

由 apigee-mirror 產生的構件現在具有正確的擁有權。

294989027

改善特定 Stats API 的效能。

已知問題

如需完整的已知問題清單,請參閱「Edge for Private Cloud 的已知問題」。

套用多個修補程式版本

本節說明如何套用多個修補程式版本,以便您從較舊的 Edge for Private Cloud 版本更新至較新的修補程式版本。

每個修補程式版本都包含 Edge for Private Cloud 的特定元件更新,例如 edge-management-server。如要套用多個修補程式版本,您必須更新修補程式版本中包含的每個 Edge 元件,這些元件版本的發布時間晚於您目前安裝的版本。如要找出這些元件,請查看 Edge for Private Cloud 版本資訊,瞭解比目前版本晚發布的所有版本,並檢查這些版本的 RPM 清單。如要查看所有 Edge for Private Cloud 版本資訊的連結,請參閱 Apigee 版本資訊

注意:您只需更新每個元件一次,方法是安裝修補程式版本中所附最新版本的元件 RPM。請按照該版本的版本資訊中的操作說明更新元件。

注意:升級元件會自動安裝元件的最新修補程式版本。如果您想升級至非最新的修補程式版本,就必須使用 Apigee 鏡像,自行維護 Apigee 存放區的 tarball 副本,並將此鏡像用於 Apigee 安裝作業。詳情請參閱「 使用本機 Edge 存放區來維護 Edge 版本」。