4.16.01 - Edge for Private Cloud 版本資訊

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

我們在 2016 年 3 月 24 日 (星期四) 發布了新版 Apigee Edge for Private Cloud。

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

• Cloud：15.07.08, 15.07.22、15.08.05、Nginx 遷移、15.09.02、15.09.30、16.01.20
• Private Cloud：4.15.07.01、4.15.07.03

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

淘汰項目

私有雲 4.15.07.03

curl http:// <qpid_IP>:8083/v1/servers/self/queues

Analytics：多份報表的自訂報表資訊主頁檢視畫面 (Cloud 15.09.30)

提供最多四份自訂報表檢視畫面的特定自訂報表資訊主頁功能即將淘汰，並會在日後推出的版本中移除。(MGMT-2673)。自訂報表的其他功能仍可正常使用。

無法在 Private Cloud 中覆寫機構名稱長度

您無法再透過設定以下項目，覆寫 20 個半形字元的機構名稱長度：

• APIGEE_ORG_NAME_LENGTH=25

• APIGEE_ENV_NAME_LENGTH=25

新功能和強化項目

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

私有雲

新增支援 RedHat、CentOS 和 Oracle 6.7 - 7.2

這個版本新增支援 RedHat Enterprise Linux、CentOS 和 Oracle Linux 6.7 至 7.2 版。

如需完整的系統需求清單，請參閱「支援的軟體和版本」。

以 RPM 為基礎的安裝方式

這個版本的 Edge 使用 RPM 型安裝機制，大幅簡化安裝和遷移程序。

新的基本目錄

Edge 4.16.01 版的目錄結構已變更。在舊版 Edge 中，您將 Edge 安裝到基本目錄：

/<install-dir>/apigee4

install-dir 可以位於任何位置，預設為 /opt。例如：

/opt/apigee4

如果是 4.16.01 版，您必須將 Edge 安裝至下列目錄：

/opt/apigee

另請注意，apigee4 目錄已變更為 apigee。

資料目錄的位置不會受到影響。可能位於 /opt/apigee 下方，也可能位於其他位置。

新的虛擬主機規定

Edge 遷移指令碼會處理將現有 Netty 路由器遷移至 Nginx 的大部分工作。不過，在升級過程中，您也必須確保所有虛擬主機定義都包含主機別名，才能進行遷移。

如要進一步瞭解如何為現有虛擬主機新增主機別名，請參閱 Apigee FTP 網站上的 Edge 安裝指南 ：ftp://ftp.apigee.com/。

使用設定程式碼

在 Edge 4.16.01 版中，您不再使用 /<install-dir>/apigee4/conf 目錄下的 .properties 檔案設定 Edge 元件。自 4.16.01 版起，您仍可使用 .properties 檔案設定 Edge 元件，但這些檔案現在位於下列目錄中：

/opt/apigee/customer/application

針對節點上安裝的每個 Edge 元件，該目錄中都會有一個 .properties 檔案。如要設定元件，請編輯對應的 .properties 檔案，變更現有屬性的值，或新增屬性和值。如果檔案不存在，您可以建立該檔案。

與舊版 Edge 不同，Edge 4.16.01 的 .properties 檔案不會包含元件的所有屬性。這個版本的一項變更，是 .properties 檔案只會包含預設屬性值的覆寫項目。

這種架構的優點是，在遷移至較新版本的 Edge 時，Edge 安裝程式絕不會覆寫 /opt/apigee/customer/application 中的檔案。這樣一來，Edge 就不會意外覆寫您的設定。

在遷移作業中，Edge 安裝程式會檢查現有的 .properties 檔案，並將變更複製到 /opt/apigee/token 目錄的預設屬性值。因此，遷移後您應該不需要進行任何編輯。

詳情請參閱 Apigee ftp 網站上的 Apigee Edge 作業指南： ftp://ftp.apigee.com/。

邊緣設定指令碼已取代

先前 Edge 版本中使用的設定指令碼已移除，並替換為下列其中一項：

• 透過 Apigee 公用程式執行的指令，例如 apigee-service、apigee-all、apigee-setup、apiee-provision 或 apigee-migrate 公用程式。
  舉例來說，all-start.sh 和 all-stop.sh 指令碼已由下列指令取代：
  > /opt/apigee/apigee-service/bin/apigee-all start
  > /opt/apigee/apigee-service/bin/apigee-all stop
• 直接在 Edge 元件上執行的指令。舉例來說，在先前的版本中，您使用 chpasswd-openldap.sh 指令碼變更 OpenLDAP 密碼。該指令碼已由下列指令取代，您可以在 apigee-openldap 元件上執行該指令：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-password -o oldPword -n newPword

如要進一步瞭解如何透過指令執行設定，請參閱 Apigee ftp 網站 (ftp://ftp.apigee.com/) 上的 Apigee Edge 作業指南。

新邊緣路由器

這個版本的 Edge for Private Cloud 包含以 Nginx Router 為基礎的新路由器架構。Nginx 路由器會取代 4.16.01 之前的 Edge 版本所用的 Netty 路由器。

Nginx 路由器與 Netty 路由器的硬體和連接埠需求相同，因此不需要變更現有節點。

詳情請參閱 Edge《安裝指南 》的附錄 A：關於 Nginx 路由器，該指南位於 Apigee FTP 網站：ftp://ftp.apigee.com/，

已移除 BaaS 負載平衡器

API BaaS 入口網站已移除內部負載平衡器。現在，您必須在 API BaaS 入口網站和三個 API BaaS Stack 節點之間，使用自己的負載平衡器。

除了負載平衡器，您也可以使用循環配置資源 DNS。在這個情境中，您會建立 DNS 項目，其中包含對應至 BaaS 堆疊 IP 位址的多筆 A 記錄。在 DNS 查詢期間，DNS 伺服器會自動以循環方式傳回 A 記錄值。

新文件：說明如何新增 Cassandra 和 ZooKeeper 節點，以及如何將資料中心新增至現有資料中心

Apigee FTP 網站上的文件 ZIP 檔案現在包含「Scaling Edge for Private Cloud」，說明如何新增 Cassandra 和 ZooKeeper 節點，以及如何將資料中心新增至現有資料中心。

已移除 Orgtool

orgtool 可以查詢 Edge 安裝作業，取得機構的相關資訊。該工具現已移除。您現在可以使用 Edge UI 或 API 呼叫，取得機構資訊。

如何在 4.16.01 版中執行工作

下表列出您在 4.15.07.03 中執行的工作，以及在 4.16.01 中執行的工作。詳情請參閱 Apigee FTP 網站上的 Edge 作業指南： ftp://ftp.apigee.com/。

監控工具和資訊主頁的 Alpha 版

這個版本包含 Edge 的新監控工具和資訊主頁 Alpha 版。這項工具可協助您瞭解部署作業中各種元件 (路由器、訊息處理器、ZooKeeper、Cassandra) 的健康狀態，以及各種機構和環境的 HTTP 錯誤代碼。您也可以擷取資訊主頁資料的快照，並與 Apigee 分享，協助解決支援事件。

說明文件 (包括安裝操作說明) 隨附於 Edge 4.16.01 說明文件的 ZIP 檔案中，可從 Apigee FTP 網站下載：ftp://ftp.apigee.com/。

不過，您必須先完成文件 ZIP 檔案中的 Apigee 評估協議，然後透過電子郵件將協議傳送至 orders@apigee.com，才能安裝及使用資訊主頁。

Edge Platform

管理使用者介面重新設計 (Cloud 15.09.30)

管理 UI 中的多個頁面已更新外觀和風格。(MGMT-2627)

API 服務

重新設計 API Proxy 精靈 (Cloud 16.01.20)

API Proxy 精靈已重新設計。在管理 UI 的「API Proxies」頁面中點選「+ API Proxy」時，新的精靈會引導您完成 API Proxy 建立程序。您可以使用與舊版 API Proxy 精靈相同的設定。(MGMT-1376)

使用 OpenAPI (Swagger) 文件建立 API Proxy (Cloud 16.01.20)

在全新設計的 API Proxy 精靈中，您現在可以從 OpenAPI (Swagger) 文件建立 API Proxy。在 API Proxy 精靈的第一頁，選取「Reverse Proxy」、「Node.js App」或「No Target」時，請點選「Use OpenAPI」。在顯示的欄位中，輸入 OpenAPI 文件的網址。詳情請參閱「建構簡單的 API Proxy」。 (MGMT-1376)

支援 SOAP Proxy 的 WSDL 1.2 (Cloud 16.01.20)

Apigee Edge 支援 WSDL 1.2，可建立 API Proxy 來呼叫 SOAP 服務。(MGMT-2835)

TargetEndpoint 設定中的 SSLInfo 變數 (Cloud 16.01.20)

在 API Proxy 的 TargetEndpoint 中，您可以動態設定 SSL/TLS 詳細資料，以支援彈性的執行階段需求。在下列範例中，我們說明如何在 TargetEndpoint 設定中設定 SSLInfo，值則可由 Java Callout、JavaScript 政策或 Assign Message 政策在執行階段提供。使用包含要設定值的訊息變數。

<TargetEndpoint>
...
  <SSLInfo>
    <Enabled>{myvars.ssl.enabled}</Enabled>
    <ClientAuthEnabled>{myvars.ssl.client.auth.enabled}</ClientAuthEnabled>
    <KeyStore>{myvars.ssl.keystore}</KeyStore>
    <KeyAlias>{myvars.ssl.keyAlias}</KeyAlias>
    <TrustStore>{myvars.ssl.trustStore}</TrustStore>
  </SSLInfo>
...
</TargetEndpoint>

如要瞭解這項功能，請參閱下列文件：

• API Proxy 設定參考資料
• 使用變數參照的 TargetEndpoint 動態 SSLInfo

(APIRT-1475)

支援 SAML 聲明政策的 RSA_SHA256 演算法 (Cloud 16.01.20)

SAML 聲明政策現在除了 RSA_SHA1 之外，也支援 RSA_SHA256 演算法。 (APIRT-1779)

驗證上傳的憑證 (Cloud 16.01.20)

為避免將過期或無效的憑證上傳至金鑰儲存區和信任儲存區，管理 API 會在上傳時驗證憑證。系統會驗證憑證，確保檔案大小不超過 50 KB，且格式為 PEM 或 DER。系統也會驗證憑證是否過期。如要覆寫預設的到期日驗證 (上傳時不驗證憑證到期日)，請使用下列查詢參數： ?ignoreExpiryValidation=true

詳情請參閱「 將 JAR 檔案上傳至金鑰儲存區」和「 將憑證上傳至信任儲存區」。(SECENG-516) 和 (APIRT-2213)

Node.js 記錄頁面自動輪詢 (Cloud 16.01.20)

在 Proxy 編輯器中查看 Node.js 記錄時，系統會定期自動重新整理 Node.js 記錄頁面，列出可用的新記錄。按一下「停止自動重新整理」，即可關閉自動重新整理功能。(MGMT-1692)

X-Forwarded-For HTTP 標頭 (Cloud 15.09.30)

為提高安全性，Edge 預設會移除可能含有一或多個 IP 位址的 X-Forwarded-For HTTP 要求標頭。這項新預設行為表示 Edge 收到的用戶端 IP 位址，會是從上次外部 TCP 交握收到的 IP 位址，而不是可能遭偽造以規避存取控制政策的位址。

如要變更這項預設行為，並允許 X-Forwarded-For 位址連線至 API Proxy，您必須在貴機構中設定 feature.enableMultipleXForwardCheckForACL=true 屬性。

透過 JavaScript 存取政策屬性 (Cloud 15.07.08)

在 API 代理流程中使用 JavaScript 時，您可以存取 JavaScript 政策中定義的屬性。如果您想在 JavaScript 程式碼中使用知名變數，這個做法就特別實用。舉例來說，假設您的 JavaScript 政策包含下列屬性定義：

<Properties>
    <Property name='source'>response.content</Property>
</Properties>

在 JavaScript 中，您可以參照「source」屬性存取訊息回覆，如下所示：
var source = properties.get('source'); // returns: response.content
或
var source = properties.source
或
var source = properties['source']

詳情請參閱「JavaScript 政策」。(APIRT-1460)

機構層級稽核 (Cloud 15.07.08)

機構管理員可以稽核機構層級的動作記錄。 在管理使用者介面中，依序選取「管理」>「機構記錄」。詳情請參閱「稽核：API、產品和機構記錄」。(MGMT-2232)

機構管理員自行移除角色 (Cloud 15.07.08)

組織管理員可以前往管理 UI，依序點選「管理」>「機構組織使用者」，然後按一下自己名稱旁邊的「移除」，從組織管理員角色中移除自己。(MGMT-934)

API Proxy 套件匯入進度指標 (Cloud 15.07.08)

在管理 UI 中上傳大型 API Proxy 套件時，系統會顯示「正在作業」動畫，表示匯入作業仍在進行中，因此您無法與管理 UI 互動，直到匯入完成為止。(MGMT-1285)

快取行為和設定 (Cloud 15.07.22)

為提升記憶體內快取管理和使用率，自 Edge 雲端版本 15.06.10 起，環境快取資源的「記憶體中的元素上限」設定已遭淘汰。在 Edge Cloud 15.07.22 版中，這項設定已從 Apigee Edge 管理 UI 的「環境設定」部分中移除。

所有快取資源 (包括預設快取) 中的元素總數取決於分配給快取的總記憶體。根據預設，特定訊息處理器上分配給記憶體內快取的記憶體總量，是可用記憶體總量的 40%。只有在快取記憶體不足或元素過期時，系統才會從記憶體內快取中逐出元素。(MGMT-2413、APIRT-1140)

管理 UI 中的目標伺服器設定 (Cloud 15.07.22)

管理 UI 中的「APIs」>「Environment Configuration」頁面現在可供您新增、編輯及刪除目標伺服器。

此外，我們也重新設計了這個頁面，讓您不必前往新頁面，就能直接建立、新增及刪除快取。使用者介面不再提供多項快取屬性，包括「記憶體中的元素上限」，因為設定這些屬性已不會對執行階段快取行為造成任何影響。(MGMT-280)

SSL，並將訊息記錄至系統記錄檔 (Cloud 15.07.22)

訊息記錄政策支援透過 SSL/TLS 將系統記錄傳送給第三方記錄管理供應商。在政策設定中，將下列項目做為父項元素的直接子項：

<SSLInfo>
    <Enabled>true</Enabled>
</SSLInfo>

詳情請參閱「訊息記錄政策」。 (APIRT-942)

管理 UI (Cloud 15.07.22)

Apigee 工程團隊在管理 UI 中修正多項小錯誤，並提升可用性。

Trace 中的 cURL (Cloud 15.09.02)

追蹤向目標伺服器發出要求的 API Proxy 呼叫時，您可以將目標伺服器的要求視為 cURL 指令。在「交易地圖」圖表中選取「要求已傳送至目標伺服器」階段，然後按一下「階段詳細資料」窗格中「要求已傳送至目標伺服器」欄的「顯示 Curl」按鈕。(MGMT-2589)

資料遮蓋特殊字元 (Cloud 15.09.02)

使用資料遮蓋功能遮蓋 JSON 酬載中的機密資料時，現在可以遮蓋 $、* 和 { 等特殊字元。(APIRT-1727)

管理 UI 中的鍵/值對應 (Cloud 15.09.30)

您現在可以在 Edge 管理 UI 中，建立及管理環境範圍的鍵/值對應 (KVM)。環境範圍 KVM 包含環境 (例如測試或正式環境) 中任何 API Proxy 皆可存取的鍵/值組合。在管理 UI 選單中，依序前往「APIs」>「Environment Configuration」> 選取所需環境 >「Key Value Maps」分頁標籤。詳情請參閱「建立及編輯環境鍵值對應」。(MGMT-1393)

管理 UI 中的 PopulateCache 政策預設到期時間 (Cloud 15.09.30)

使用 API Proxy 編輯器新增 PopulateCache 政策時，快取到期的 <TimeoutInSec> 元素會預先填入 3600 秒 (1 小時) 的值。先前的預設值為 300 秒 (5 分鐘)。(MGMT-2622)

開發人員服務

API 產品頁面成效，未列出任何開發人員應用程式 (Cloud 16.01.20)

在管理使用者介面中查看 API 產品時，系統會列出與該產品相關聯的開發人員應用程式。為提升使用者介面效能，編輯 API 產品時不會顯示開發人員應用程式清單。(MGMT-2869)

「開發人員應用程式」頁面的主要資料欄 (Cloud 15.08.05)

如果機構有大量 (數千個) 開發人員應用程式，在「開發人員應用程式」頁面顯示「金鑰」欄 (顯示每個應用程式的金鑰數量) 可能會影響顯示效能。如要改善這種情況下的顯示效能，請與 Apigee 支援團隊聯絡，設定下列機構層級屬性：features.appsNoCredentialsEnabled = true。這項屬性會移除「鍵」欄。但請注意，移除「金鑰」欄後，您就無法再依據消費者金鑰和密鑰進行搜尋。(MGMT-2486)

「開發人員詳細資料」頁面的進度微調器 (Cloud 15.09.30)

在管理使用者介面中載入「開發人員詳細資料」頁面時，如果應用程式仍在載入中，頁面的「應用程式」部分會顯示進度微調器。這項改善措施可解決先前應用程式載入時，「應用程式」部分會顯示空白的問題。(MGMT-2667)

營利

編輯 API 套件名稱 (Cloud 16.01.20)

您可以在營利生命週期的任何時間點更新 API 套件名稱，即使 API 套件包含已發布的費率方案也沒問題。(DEVRT-2177)

自訂屬性可使用小數 (Cloud 16.01.20)

使用「Rate Card with Custom Attribute」方案時，訊息標頭中做為交易乘數的自訂屬性，現在最多可有四位小數。如要進一步瞭解這類方案，請參閱「指定費率卡自訂屬性詳細資料」(DEVRT-2191)。

摘要報表中的房價方案名稱和 ID (Cloud 15.09.02)

使用 Management API 產生收益摘要報表時，您可以在報表中新增「費率方案」名稱和費率「方案 ID」資料欄。如要這麼做，請在 API 呼叫中新增「RATEPLAN」做為 groupBy 屬性，如「建立報表」一文所述。(請注意，這項功能尚未在營利報表使用者介面中推出)。在詳細報表中，現有的費率方案名稱和 ID 欄現在位於報表前端，與其他分組欄並列。(DEVRT-1740)

數據分析服務

回應時間指標的 sum( ) 函式 (Cloud 16.01.20)

在 Analytics 自訂報表和 API 呼叫中，現在可對目標回應時間、總回應時間和 end_point_response_time 使用「sum」匯總函式。舉例來說，在 /stats API (http://docs.apigee.com/management/apis/get/organizations/%7Borg_name%7D/environments/%7Benv_name%7D/stats/%7Bdimension_name%7D-0) 中，您現在可以使用下列「select」查詢參數：?select=sum(total_response_time)。(AXAPP-2006)

延遲時間分析報表：API Proxy 名稱排序 (Cloud 16.01.20)

在延遲分析報表 UI 中 (僅限 Apigee Edge 企業方案)，API Proxy 會依字母順序顯示在「Proxy」下拉式清單中。(MGMT-2858)

資訊主頁上顯示的開發人員應用程式名稱 (Cloud 16.01.20)

在管理 UI 資訊主頁中，「開發人員應用程式」長條圖會依顯示名稱 (而非內部名稱) 列出開發人員應用程式。(MGMT-2853)

自訂報表新增日期/時間小工具 (Cloud 16.01.20)

管理使用者介面中自訂報表頁面的日期/時間挑選器小工具已獲得改良。 (MGMT-2881)

在 GeoMap 上依城市深入分析 (Cloud 15.07.22)

美國和加拿大的 Analytics 地理地圖包含「城市」的向下鑽取功能。在地圖上點選州或省份後，系統會顯示通話來源城市清單。(MGMT-2282)

分析自訂報表中的 | (管道) 和 = 字元 (Cloud 15.09.02)

Analytics 自訂報表定義支援使用 | (管道) 和 = 符號。在此之前，這些符號必須使用 %7C 和 %3D 編碼。(MGMT-2504)

Proxy 路徑後置字串維度 (Cloud 15.09.30)

分析自訂報表和 API 呼叫中，現在提供新的 Proxy 路徑尾碼 (proxy_pathsuffix) 維度。Proxy 路徑尾碼是 API Proxy 網址中，位於基本路徑之後的部分，例如為條件流程建立的路徑。(AXAPP-1902)

報表顯示開發人員 ID，而非顯示名稱 (Cloud 15.09.30)

使用 /stats API 呼叫 Edge 數據分析 API 時，系統會傳回開發人員 ID 和開發人員顯示名稱。先前只會傳回開發人員 ID。(AXAPP-1759)

修正錯誤

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

Private Cloud 4.16.01

下表列出 Edge for Private Cloud 4.16.01 版發布後修正的錯誤。如要取得這些修正檔，請按照「將 Apigee Edge 4.16.01.x 更新至最新 4.16.01 版本」一文中的操作說明，將 4.16.01 安裝項目更新至最新的 RPM 和支援檔案。

Cloud 16.01.20

Cloud 15.07.08

Cloud 15.07.22

Cloud 15.08.05

Cloud 15.09.02

Cloud 15.09.30

私有雲 4.15.07.03

私有雲 4.15.07.01

已知問題

這個版本有下列已知問題。

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart