4.17.05 - Edge for Private Cloud 版本資訊

查看 Apigee Edge 說明文件。
前往 Apigee X說明文件。 資訊

自舊版 Private Cloud 功能版本以來，下列版本已 ，且收錄在這次功能版本中：

請參閱「關於版本」 編號，瞭解如何判斷特定雲端版本是否 包含在您的 Edge for Private Cloud 版本中

版本總覽

這個版本包含許多重要功能，可協助您進一步控管及保護 API，包含：

• 共用流程支援零停機部署。
• 系統現在支援刪除機構的營利資料。
• 其他新功能如下所述。

在淘汰之前，保管箱已淘汰。

本主題的其餘部分包含所有新功能、更新和錯誤修正的詳細資訊 特定授權。

淘汰和淘汰項目

這個版本已淘汰或淘汰了下列功能。詳情請參閱邊緣淘汰政策。

已淘汰：新增 API Proxy「效能」分頁中的路徑

在這個版本之前，您可以前往管理 UI 中的 API Proxy，前往 「效能」分頁，並建立不同路徑，以便透過 Proxy 的 「成效」分頁，以及「商業交易」資訊主頁。這項功能已淘汰，不會再 這些元素。如需瞭解這項功能的替代方案，請參閱下列 Apigee 社群貼文：https://community.apigee.com/articles/23936/alternative-to-business-transactions-api.html。 (EDGEUI-902)

退休人員： 開發人員服務入口網站的 buildInfo 網址

在舊版入口網站中，判斷您曾開啟以下項目的入口網站版本 瀏覽器中的網址：

http://yourportal.com/buildInfo

這個連結已在 4.17.05 版中移除。若要判斷版本，請開啟報表 > Drupal 中的狀態報告選單項目。入口網站版本會顯示在資料列的資料表中 命名為 Install profile (安裝設定檔)。

Apigee 淘汰 安全商店 (保管箱)

Apigee 安全 商店 (也稱為「保管箱」)將於以下一年後淘汰： 請前往 GCP 控制台 淘汰項目， 淘汰頁面保管箱 (提供鍵/值組合的加密儲存空間) 建立的保管箱 透過 Management API，在執行階段使用 Apigee-access 中的函式存取 Node.js 模組。

請改用已加密的金鑰值對應 (KVM)，如 使用鍵/值對應關係。 加密 KVM 跟保管箱一樣安全，提供了更多的建立與建立選項 和擷取。(MGMT-3848)

新功能與最新資訊

這個版本新增的功能和強化項目如下。除了下列資源外 這個版本也包含多項可用性、效能、安全性和穩定性 強化功能

私有雲

新增必要的 SMTP 設定參數以進行安裝

您現在必須在 找到 Edge 安裝設定檔這個參數會指定電子郵件地址 Edge 傳送自動電子郵件 (例如使用者要求重設密碼時使用)。詳情請見 在裝置上安裝 Edge 元件 節點。

(EDGEUI-1020)

現在可以設定 Edge UI 用於 Edge API 管理呼叫的逾時時間

您現在可以指定 Edge UI 使用的 API 逾時持續時間，以控制 UI 的逾時時間 等待 API 管理呼叫傳回。下列屬性可定義逾時：

• conf_apigee_apigee.feature.apitimeout 組合 這是指 UI 等待後端呼叫傳回的時間 (以秒為單位) 上面有活動。如果未在這段時間內完成呼叫，UI 會擲回逾時錯誤。 預設值為 180 秒 (3 分鐘)。
• conf_apigee_play.ws.timeout.idle 決定了 也就是 UI 對伺服器上活動等待的時間 (以毫秒為單位)。可設為相同的值 例如 conf_apigee_apigee_apitimeout 或 改為較小值將值設為較大的值不會有任何效果。預設值為 180,000。 毫秒 (3 分鐘)。
• conf_apigee_play.ws.timeout.connection 組合 也就是 UI 等待連線建立的時間。可設為相同的值 例如 conf_apigee_apigee_apitimeout 或 改為較小值將值設為較大的值不會有任何效果。預設值為 120,000。 毫秒 (2 分鐘)。

請參閱設定逾時 Edge UI 進行 Edge API 管理呼叫所用的資源。

(EDGEUI-816)

為路由器新增訊息處理器重試逾時

新增逾時設定，以便路由器停止重新向訊息處理器發出的要求，並傳回 錯誤訊息。

如需說明，請參閱設定 重新嘗試連線至訊息處理器的路由器。

(APIRT-2912)。

新增變更預設系統管理員的程序

現已提供變更預設系統管理員的說明文件。

詳情請參閱管理 使用者、角色和權限等等。

(DOS-4895)。

新增說明文件，說明如何區隔根使用者和非超級使用者之間的 Edge 安裝工作

新的說明文件會詳細介紹如何將 Edge 安裝工作區隔開來，包括根實體和 非超級使用者

請參閱 Edge 安裝 總覽瞭解更多資訊。

(DOS-4573)。

新增了屬性，以便設定所產生電子郵件中的連結主機名稱

Edge 會自動根據特定事件傳送電子郵件，例如使用者新增至 Google 日曆的 機構。其中許多電子郵件都包含連結。舉例來說，如果將新使用者加入 機構，Edge UI 會透過電子郵件將含有登入網址的電子郵件傳送給使用者：

https://domain/login

網域是由 Edge 自動決定，通常為機構正確無誤。 不過，如果 Edge UI 落後於負載平衡器後方， 產生的網域名稱不正確。若是如此，您可以使用 conf_apigee_apigee.emails.hosturl 屬性： 明確設定所產生的網址的網域名稱部分。

如需說明，請參閱設定 系統所產生電子郵件中連結的主機名稱。

(EDGEUI-1044)

為 API Proxy 設定 Edge UI 顯示的基本網址

Edge UI 會根據虛擬主機的設定顯示 API Proxy 的網址 與部署 Proxy 的部署位置相對應這個顯示器可能包含路由器通訊埠編號 虛擬主機

在大多數情況下，Edge UI 中顯示的網址是將外部的正確網址 向 Proxy 發出要求不過，部分設定顯示的網址並不正確。 比方說，下列任一設定都會導致系統不顯示顯示網址 對應至用來向 Proxy 提出外部要求的實際網址：

• 在負載平衡器上進行 SSL 終止
• 負載平衡器與 Apigee 路由器之間進行通訊埠對應
• 已設定路徑重寫功能的負載平衡器

Edge for Private Cloud 4.17.05 以上版本支援名為「虛擬主機」的屬性 <BaseUrl>，也就是 覆寫 Edge UI 顯示的網址。以下範例顯示含有 新的 <BaseURL> 屬性。在這個範例中，值「http://myCo.com」會出現於 Edge UI 中：

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>DNS_name_or_IP:9005</HostAlias> 
   </HostAliases> 
   <BaseUrl>http://myCo.com</BaseUrl>     
   <Interfaces/>
   <Port>9005</Port> 
</VirtualHost>

如未設定 <BaseUrl>， 預設值，則 Edge UI 轉譯的預設網址會顯示為：「http://DNS_name_or_IP:9005/」， 實際的主機別名設定則是「http://myCo.com」。

您也可以在建立機構時，使用 VHOST_BASEURL 屬性，將 apigee-provision 公用程式

請參閱設定 TLS 使用私有雲的 API 存取權。

(EDGEUI-5008)

新增啟用偵錯記錄功能的說明文件

新增說明文件，說明如何啟用/停用 Edge 的偵錯記錄功能 元件。

請參閱啟用偵錯記錄功能 瞭解詳情。

(APIRT-4018)。

Apigee-analytics-collector 公用程式的全新安裝程式和指令語法

所有 Edge for Private Cloud 客戶都必須向 Apigee 提交 API 相關統計資料 使用 apigee-analytics-collector 指令列 Beta 版的 Proxy 流量 公用程式這個公用程式會將 API 呼叫量報表傳回 Apigee。

這個 Edge 版本包含 apigee-analytics-collector 公用程式在這個版本中，您現在使用 apigee-service 安裝 也就是 apigee-analytics-collector 公用程式 而不是 npm，以及叫用 apigee-analytics-collector 公用程式 改為使用 apigee-service 獨立的指令

詳情請參閱 Uploading API 傳送至 Apigee - Beta 版的流量資料。

開發人員服務入口網站更新後，新增預設安裝目錄 新安裝 4.17.01 的 Nginx/Postgres 百分比

更新使用 Nginx/Postgres (根目錄) 的新 4.17.01 安裝之後 從：

/opt/apigee/apigee-drupal

收件者：

/opt/apigee/apigee-drupal/wwwroot

API 服務

嚴格的實體輸入驗證

已針對 Apigee Edge 機構的所有實體強制執行更嚴格的輸入驗證。 允許的字元通常包括字母 (所有案例)、數字和底線。

受影響的實體包括：

• 機構組織
• 環境
• API Proxy
• API Proxy 修訂版本
• API Proxy 中的政策名稱
• 偵錯追蹤記錄遮罩設定 ID
• 資源名稱 (Java 呼叫、xsl、所有資源)
• KeyStore
• CRLstores
• 資源參考資料
• 目標伺服器

(MGMT-3840)

共用流程無須停機部署

當您要部署共用流程，並確保幾乎或沒有任何連入流量會遭到拒絕 您現在可以使用零停機時間 Deployment Management API這項程序會 幾乎是使用 Management API 進行 API Proxy 的免停機時間部署。只有 管理 API 資源

下列呼叫會部署 URI 中指定的共用流程修訂版本，然後取消部署 先前部署的修訂版本 (override=true 查詢參數支援)：

curl -X POST -H "Content-type:application/x-www-form-urlencoded" \
https://api.enterprise.apigee.com/v1/o/{org_name}/environments/{env-name}/sharedflows/{shared_flow_name}/revisions/{revision_number}/deployments?"override=true" \
-u email:password

(MGMT-3485)

營利

刪除機構的營利資料

在下列情況下，建議您刪除貴機構的營利資料：

• 刪除機構。在這種情況下，你必須先刪除營利資料 就可以刪除機構
• 從要重複使用的測試機構清除營利資料。在本 在這種情況下，您必須在刪除營利資料後，同步處理 Apigee Edge 資料。

如需更多資訊，請參閱刪除營利資料 機構。(DEVRT-2581)

新增可為機構啟用營利功能的 API

您現在可以使用 API 為機構啟用營利功能。

請參閱啟用 營利

(DEVRT-2383)

修正錯誤

這個版本修正了下列錯誤。這份清單主要適用對象 來解決他們的支援單問題它無法針對 所有使用者。

私有雲 4.17.05

Cloud 17.04.12 (UI)

Cloud 17.04.05 (UI)

Cloud 17.03.29 (UI)

Cloud 17.03.15.01 (UI)

Cloud 17.03.15 (UI)

Cloud 17.03.13.02 (營利)

Cloud 17.03.13.01 (營利)

Cloud 17.03.13 (API 管理)

Cloud 17.03.1 (UI)

Cloud 17.02.15 (UI)

Cloud 17.02.13 (API 執行階段)

Cloud 17.02.13 (API 管理)

Cloud 17.01.18 (UI)

Cloud 17.01.16 (API 管理)

Cloud 17.01.16 (營利)