4.17.05 - Edge for Private Cloud 版本資訊

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

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

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

版本總覽

這個版本包含多項重要功能，可協助您更妥善地控管及保護 API，包括：

• 共用流程支援零停機時間部署。
• 現在支援刪除機構的營利資料。
• 其他新功能說明如下。

在淘汰方面，保管庫已淘汰。

本主題的其餘部分將詳細說明這個版本中的所有新功能、更新和錯誤修正。

淘汰與停用

這個版本淘汰或停用了下列功能。詳情請參閱 Edge 淘汰政策。

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

在這次發布版本之前，您可以前往管理 UI 中的 API Proxy，然後前往「Performance」(效能) 分頁，在 Proxy 的「Performance」(效能) 分頁和「Business Transactions」(業務交易) 資訊主頁中，為圖表式比較建立不同路徑。這項功能現已淘汰，不再提供 UI 存取。如需這項功能的替代方案，請參閱下列 Apigee 社群文章：Alternative to Business Transactions API (Business Transactions API 的替代方案)。(EDGEUI-902)

已淘汰： 開發人員服務入口網站的 buildInfo URL

在舊版入口網站中，如要判斷入口網站版本，請在瀏覽器中開啟下列網址：

http://yourportal.com/buildInfo

這個連結已在 4.17.05 版中移除。如要判斷版本，請在 Drupal 中開啟「Reports」>「Status report」選單項目。入口網站版本會顯示在「Install profile」(安裝設定檔) 列的表格中。

Apigee 安全儲存空間 (保管庫) 即將淘汰

Apigee 安全儲存空間 (又稱「保管庫」) 即將淘汰，並於淘汰與停用頁面顯示的淘汰公告日期後一年停用。保險箱提供鍵/值組合的加密儲存空間，可透過管理 API 建立，並在執行階段使用 apigee-access Node.js 模組中的函式存取。

請改用加密的鍵/值對應 (KVM)，如「使用鍵/值對應」一文所述。加密 KVM 與保險箱一樣安全，且提供更多建立和擷取選項。(MGMT-3848)

新功能與最新消息

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

私有雲

在安裝過程中新增必要的 SMTP 設定參數

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

(EDGEUI-1020)

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

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

• conf_apigee_apigee.feature.apitimeout 會設定 UI 等待後端呼叫傳回的時間 (以秒為單位)，無論 UI 上是否有任何活動。如果呼叫未在該時間內完成，UI 會擲回逾時錯誤。預設值為 180 秒 (3 分鐘)。
• conf_apigee_play.ws.timeout.idle 會設定 UI 等待伺服器活動的時間長度 (以毫秒為單位)。可設為與 conf_apigee_apigee_apitimeout 相同的值，或設為較小的值。將其設為較大的值不會有任何影響。預設值為 180000 毫秒 (3 分鐘)。
• conf_apigee_play.ws.timeout.connection 會設定 UI 等待建立連線的時間長度。可設為與 conf_apigee_apigee_apitimeout 相同的值，或設為較小的值。將其設為較大的值不會有任何影響。預設值為 120000 毫秒 (2 分鐘)。

詳情請參閱「設定 Edge UI 用於 Edge API 管理呼叫的逾時時間」。

(EDGEUI-816)

在路由器中新增訊息處理工具重試逾時

新增逾時設定，讓路由器停止重試對訊息處理器的要求，並傳回錯誤訊息。

詳情請參閱設定路由器，以重試連線至訊息處理器。

(APIRT-2912)

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

現在文件中已納入變更預設系統管理員的說明。

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

(DOS-4895)

新增文件，說明如何區分根使用者和非根使用者的 Edge 安裝工作

新版文件說明如何將 Edge 安裝工作分別指派給根使用者和非根使用者。

詳情請參閱 Edge 安裝總覽。

(DOS-4573)

新增屬性，可為產生的電子郵件中的連結設定主機名稱

Edge 會在特定事件發生時自動傳送電子郵件，例如使用者加入機構時。其中許多電子郵件都含有連結。舉例來說，當新使用者加入機構時，Edge UI 會傳送電子郵件給使用者，內含登入網址，格式如下：

https://domain/login

Edge 會自動判斷網域，通常會為機構選擇正確的網域。 不過，如果 Edge UI 位於負載平衡器後方，自動產生的網域名稱可能不正確。如果是，您可以使用 conf_apigee_apigee.emails.hosturl 屬性，明確設定所產生網址的網域名稱部分。

詳情請參閱設定所產生電子郵件中連結的主機名稱。

(EDGEUI-1044)

設定 Edge 使用者介面為 API Proxy 顯示的基準網址

Edge 使用者介面會根據虛擬主機中的設定，顯示 API Proxy 的網址。虛擬主機對應於 Proxy 的部署位置。這個顯示畫面可以包含虛擬主機的路由器連接埠編號。

在大多數情況下，Edge UI 中顯示的網址是向 Proxy 發出外部要求的正確網址。不過，部分設定顯示的網址有誤。 舉例來說，下列任一設定都可能導致顯示的網址與實際用於向 Proxy 發出外部要求的網址不符：

• 安全資料傳輸層 (SSL) 終止於負載平衡器
• 負載平衡器和 Apigee 路由器之間會進行通訊埠對應
• 設定路徑重寫的負載平衡器

Edge for Private Cloud 4.17.05 以上版本支援虛擬主機上的 <BaseUrl> 屬性，可讓您覆寫 Edge UI 顯示的網址。以下範例顯示具有新 <BaseURL> 屬性的虛擬主機物件。在本範例中，Edge UI 會顯示「http://myCo.com」值：

<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」。

您也可以使用 apigee-provision 公用程式的 VHOST_BASEURL 屬性，在建立機構時設定基本網址。

詳情請參閱「為私有雲設定 API 的 TLS 存取權」。

(EDGEUI-5008)

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

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

詳情請參閱啟用偵錯記錄。

(APIRT-4018)

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

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

這個版本的 Edge 包含 apigee-analytics-collector 公用程式的新安裝說明和指令語法。在這個版本中，您現在可以使用 apigee-service 安裝 apigee-analytics-collector 公用程式 (而非 npm)，並透過 apigee-service 叫用 apigee-analytics-collector 公用程式，而非以獨立指令的形式叫用。

詳情請參閱「將 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)

共用流程零停機時間部署作業

如要部署共用流程，並確保部署期間拒絕的連入流量極少或沒有，現在可以使用零停機時間部署管理 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)

修正錯誤

這個版本修正了下列錯誤。這份清單主要供使用者查看支援單是否已解決。這項功能並非為所有使用者提供詳細資訊。

Private Cloud 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 (營利)