4.19.01 Edge for Private Cloud 版本資訊

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

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

版本摘要

下表摘要列出這個版本的異動內容:

新功能

此版本包含以下新功能:

○ Edge UI 正式發布版 (GA)
○ Edge UI 中的營利 (正式發布版) 功能推出
apigee-monit 新增自我修復和監控服務
○ Edge UI 具備新的傳輸層安全標準 (TLS) 設定屬性
○ 您現在可以在 Edge UI 中建立、編輯及刪除虛擬主機
○ OpenAPI v3. Linux (現已支援 OpenAPI v3)。

如要進一步瞭解這些新功能,請參閱新功能

包含的版本

自舊版的 Private Cloud 功能版本以來,這個版本已推出並包含下列版本:

○ Edge:
   18.06.08
   18.06.06
   18.05.21
   18.05.10
   18.05.09
   18.04.23.00
○ Portal:
   18.11.28.00
   18.10.17.00
   18.10.09.00
   18.07.16.00
退休
淘汰項目 不再支援適用於私有雲 4.17.09 的 Apigee Edge (已淘汰)。

詳情請參閱 Apigee 淘汰、淘汰事宜和 CPS 異動

修正錯誤

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

○ Zookeeper 因備份指令碼而停止 (122694069)
已新增「無機構」到達網頁 (120993451 錯誤) ○ 新增「無機構」到達網頁 (120993451)
○刪除自訂報表 (120681592)
○ VMkeeper (使用備份指令碼) 未正確設定 75 至 45 號 ○






如要進一步瞭解這些修正方法,請參閱「錯誤修正」。

已知問題

此版本包含以下已知問題:

○ Metadata 檔案格式 (apigee-sso 安裝 (135616498)
apigee-monit 不支援 Node Linux 1 (122370980) 的 Cassandra 額外 7 設定 。 未支援 更新 3 號 / 含有 Cassandra 7 8 多項 未支援 Node-2
未支援 Node-2 的 Cassandra 設定 7 則用於處理無效檔案 (121095148)







HEAD

如要進一步瞭解這些已知問題 (包括解決方法),請參閱已知問題

升級路徑

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

從 4.18.05 開始 直接從 4.18.05 版升級 → 4.19.01 版
自 4.18.01 起 直接從 4.18.01 版升級 → 4.19.01 版
2017 年 4 月 17 日 直接從 4.17.09 升級 → 4.19.01
自 4.17.05 起 請從 4.17.05 → 4.18.01 升級,然後再從 4.18.01 → 4.19.01 升級
自 4.17.01 起 請從 4.17.01 → 4.18.01 升級,然後再從 4.18.01 → 4.19.01 升級
自 4.16.09 起 請從 4.16.09 → 4.18.01 升級,然後再從 4.18.01 → 4.19.01 升級
自 4.16.05 起 請從 4.16.05 → 4.18.01 升級,然後再從 4.18.01 → 4.19.01 升級
自 4.16.01 起 請從 4.16.01 → 4.18.01 升級,然後再從 4.18.01 → 4.19.01 升級
4.15.0x 起 請從 4.15.0x → 4.16.01 升級,然後再從 4.16.01 → 4.18.01 升級,接著從 4.18.01 → 4.19.01 升級

新功能

本節列出此版本的新功能。此外,這個版本也包含 Edge UI、邊緣管理和入口網站版本列於「包含的版本」中的所有功能。

除了下列強化功能外,這個版本還包含多項可用性、效能、安全性和穩定性方面的強化措施。

Edge UI 正式發布版 (正式發布版)

Apigee Edge UI 是我們最新的管理 UI 服務。這項功能先前是 Beta 版。有了 Apigee Edge for Private Cloud v4.19.01,Edge UI 是一般版本的一部分。

如要使用 Edge UI,您必須啟用 SAML,然後在自身節點上安裝 Edge UI。

詳情請參閱私有雲的 Edge UI

Edge UI 中的營利功能正式發布 (正式發布版)

新版 Edge 服務使用者介面中的「營利」Google Analytics (分析) 版本現已推出。

您現在可以透過 New Edge 體驗 UI 管理 Apigee Edge 私有雲的所有營利工作,包括:

在這項公告中,營利變化報表已正式淘汰。 查看 Apigee 淘汰項目

apigee-monit 提供自我修復和監控服務

Apigee Edge 私有雲現在包含 apigee-monit,這是以開放原始碼 monit 公用程式為基礎的工具。apigee-monit 會定期輪詢 Edge 服務。如果服務無法使用,apigee-monit 會嘗試重新啟動。

如要瞭解如何安裝、設定及使用 apigee-monit,請參閱使用 apigee-monit 進行自我修復

全新 TLS 設定屬性

Edge UI 支援新的 TLS 設定屬性,可用來設定下列項目:

  • 預設 TLS 通訊協定
  • 支援的 TLS 通訊協定清單
  • 支援的 TLS 演算法
  • 支援的 TLS 加密方式

詳情請參閱設定選用的 TLS 屬性相關說明。

建立、編輯及刪除 Edge UI 中的虛擬主機

我們進一步擴充自助式功能,讓您可以在瀏覽器中建立、編輯及刪除虛擬主機 (僅限 Edge UI)。

詳情請參閱「使用瀏覽器建立虛擬主機」一文。

已新增 OpenAPI v3 支援

這個版本已新增透過 OpenAPI 第 3 版建立 Proxy 的支援 (僅限 Edge UI)。

支援的軟體

此版本支援以下軟體變更:

已新增支援 不再支援

這個版本支援下列平台:

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

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

  • RHEL/CentOS/Oracle 7.3 版
  • RHEL/CentOS 6.8 版
  • Oracle Linux 6.7

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

修正錯誤

本節列出在這個版本中修正的 Private Cloud 錯誤。此外,這個版本也修正了 Edge UI、邊緣管理和入口網站版本中顯示的所有錯誤,如「包含的版本」所示。

問題 ID 說明
122694069

備份指令碼並未阻止 Zookeeper

再次修正前,備份指令碼並未停止 Zookeeper 程序。
120993451

「未新增任何機構」到達網頁

如果開發人員登入的帳戶沒有相關聯的機構,就不會再傳送至不存在的頁面。已為這些使用者新增到達網頁。
120682369

刪除自訂報表

使用者無法在 New Edge 服務中刪除自訂報表。
120681592

新版 Edge 服務中的「Geomap」分頁

當使用者前往 New Edge 服務中的「Geomap」分頁時,New Edge 體驗會擲回錯誤。
120624977

Zookeeper JVM 選項

無法透過程式碼搭配 Zookeeper 使用程式碼來設定 JVM 選項。
80187407

工具提示發生未定義的錯誤

如果圖表只有一個時間序列,工具提示便會擲回未定義的錯誤。
79949124

透過 OpenAPI 建立反向 Proxy

建立 Proxy 時,「Use OpenAPI」按鈕無法運作。
77515655

重設密碼無法傳送連結

使用者在要求重設密碼的連結時,沒有收到相關電子郵件。
72799769

重設密碼連結的標頭有誤

即使使用者將 trustxforwarded 屬性設為 true,產生的要求標頭也不會使用 HTTPS。
69550284

使用 WSDL 建立 API Proxy

使用 WSDL 時無法產生 API Proxy。

已知問題

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

問題 ID 說明
135616498

apigee-sso 安裝的中繼資料檔案格式

安裝 apigee-sso 並使用 metadata.xml 檔案 (而非網址) 時,如果 metadata.xml 檔案結尾不含新的一行 (CRLF),則 metadata.xml 檔案並不會完全讀取。

解決方法:

如要解決這個問題,您可以採取下列其中一種做法:

  • 在 metadata.xml 檔案結尾加上 CRLF

  • 使用以網址為基礎的中繼資料位置
122370980

Amazon Linux 1 不支援 apigee-monit

解決方法:

無。
121095148

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

解決方法:

第二次執行備份作業,應會備份正確的檔案組合。

115278838

工作階段符記未失效

使用者點擊 Apigee Edge 登出按鈕時,伺服器上的工作階段符記不會失效。

解決方法:

透過 SAML 使用 New Edge 服務。

113342838

啟用 JMX 驗證時 Cassandra 作業無法運作

解決方法:

每次叫用 nodetool 指令時,新增使用者名稱和密碼。

79993247

向 Node.js 發出的 HEAD 要求停止運作

傳送至 Node.js 目標的 HEAD 要求可能會停止運作,導致連線待處理。

解決方法:

如要解決這個問題,請定義 HEAD 要求的處理常式,以便明確傳回空白回應。

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

結果是,管理伺服器可能無法啟動,因為其嘗試同時連線至 dc-1 和 dc-2 中的 Cassandra 節點。如果 Cassandra 節點停止運作,就會發生 DataAccessExceptions。這也可能會造成 API 流量中斷,因為訊息處理器在嘗試擷取 KVM 時會回報 DataAccessExceptions

請注意,預期狀態是管理伺服器不會跨區域連線至資料儲存庫元件。

解決方法

解決方法是在無法使用的資料中心內取消註冊下列 Cassandra 節點類型,然後在 Cassandra 節點再次提供時重新註冊這些類型:

  • kms-datastore
  • dc-datastore
  • keyvaluemap-datastore

如何取消註冊及重新註冊這些 Cassandra 節點類型:

  1. 使用下列 curl 指令取得 Cassandra 節點的 UUID:
    curl -u ADMIN_EMAIL:ADMIN_PW \
      "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
      &type=CASSANDRA_NODE_TYPE"

    地點:

    • ADMIN_EMAILADMIN_PW 是 Apigee 帳戶的憑證。
    • MS_IPMS_PORT 是管理伺服器的 IP 位址和通訊埠編號。
    • REGION 是管理伺服器所在的資料中心名稱。
    • GATEWAY_POD 是 Pod 名稱,預設為「閘道」。但您可能已經將其重新命名為其他名稱,因此請檢查實作方式。
    • CASSANDRA_NODE_TYPEkms-datastoredc-datastorekeyvaluemap-datastore 其中之一。

    例如:

    curl -u nickdanger@google.com:myP@$$w0rD
      "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

    回應會使用以下格式:

    {
      "internalIP" : "POD_IP_ADDRESS",
      "isUp" : [true|false],
      "pod" : "GATEWAY_POD",
      "reachable" : [true|false],
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
        "uUID" : "POD_UUID"
    }

    例如:

    {
      "internalIP" : "192.168.1.11",
      "isUp" : false,
      "pod" : "gateway",
      "reachable" : false,
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : "dc-datastore",
      "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
    }

    請記下回應中 uUID 欄位的值。您將使用這些項目取消註冊節點。

  2. 針對各種 Cassandra 節點類型,重複執行步驟 1:kms-datastoredc-datastorekeyvaluemap-datastore。請務必記下傳回的 UUID。
  3. 使用下列指令取消註冊節點:
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

    其中 UUID 是前一個指令回應中傳回的 UUID。

  4. 為您在步驟 1 和 2 中收集到的每個 UUID 重複步驟 3。
  5. 使用下列指令重新註冊節點:
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
      "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
      Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
      region=REGION&pod=GATEWAY_POD" -H \
      'content-type: application/x-www-form-urlencoded' -X POST

請注意,這些作業會從 Zookeeper 註冊及取消註冊節點,不會對 Cassandra 叢集造成任何影響。如要進一步瞭解這些指令,請參閱更新資料儲存庫註冊

68722102

MessageLogging 政策,在記錄訊息中加入額外資訊

MessageLogging 政策的 FormatMessage 元素可控管記錄訊息的格式。若為 FormatMessage=false,記錄的訊息不應包含任何 Apigee 產生的資訊。不過,即使您設定 FormatMessage=false,記錄訊息仍會包含以下資訊:

  • 優先順序分數
  • 時間戳記

解決方法:

無。
65737520

無法重設系統管理員密碼

無法重設含有特殊字元的管理伺服器的系統管理員密碼。

解決方法:

在資料檔案中定義密碼,然後您會透過 Management API 傳遞至 /users 端點。詳情請參閱重設系統管理員密碼

後續步驟

如要開始使用 Edge for Private Cloud 4.19.01,請點選下列連結:

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