4.16.01 - Edge for Private Cloud 版本資訊

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

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

自舊版 Private Cloud 的每季版本 (4.15.07.00) 以來，以下是

• 雲端：15.07.08、 15.07.22、15.08.05、Nginx migration、15.09.02、15.09.30、16.01.20
• 私有雲：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)。自訂的所有其他方面 報表仍可存取。

無法覆寫機構名稱長度 私有雲中

您無法再透過以下設定覆寫 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，或位於 如果其他位置需要使用資源 Compute Engine 有權終止工作

新的虛擬主機規定

邊緣遷移指令碼可處理遷移現有 Netty Router 時所需的大部分工作 移至 Nginx不過，升級時，您也必須確保所有虛擬主機 定義前會包含主機別名，再進行遷移。

請參閱 Apigee ftp 上的 Edge 安裝指南 網站：ftp://ftp.apigee.com/，瞭解如何 為現有的虛擬主機新增主機別名，以執行更多作業。

含有設定的程式碼

在 Edge 4.16.01 版中，您不再使用 /<install-dir>/apigee4/conf 目錄下的 .properties 檔案 來設定 Edge 元件自 4.16.01 起，您仍須使用 .properties 檔案，但其目前位於以下目錄中：

/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 設定指令碼

您在舊版 Edge 中使用的設定指令碼已移除， 取代為：

• 透過 Apigee 公用程式執行的指令，例如 apigee-service、apigee-all Apigee-setup、apiee-provision 或 apigee-migration 公用程式。
  舉例來說，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 舊 Pword -n newPword

查看 Apigee ftp 上的 Apigee Edge 作業指南 網站：ftp://ftp.apigee.com/，進一步瞭解你現在的想法 來執行設定

新增邊緣路由器

這個版本的 Edge for Private Cloud 加入了新的路由器架構， Nginx 路由器。Nginx 路由器會取代舊版 Edge 版本中所使用的 Netty Router 4.16.01.

Nginx 路由器的硬體和通訊埠要求與 Netty 路由器相同，因此沒有 您必須調整現有節點

詳情請參閱「附錄 A：關於 Nginx 路由器」，位於 Edge 安裝 指南內容， 歡迎造訪 Apigee ftp 網站：ftp://ftp.apigee.com/、

已移除 BaaS 負載平衡器

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

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

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

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

已移除 Orgtool

orgtool 可以查詢 為取得機構相關資訊而安裝 Edge。目前我們已移除該工具。個人中心 現在，請使用 Edge UI 或 API 呼叫來取得機構相關資訊。

如何在 4.16.01 中執行工作

下表列出您在 4.15.07.03 中的工作執行方式和目前執行的方式 。詳情請參閱 Apigee ftp 網站提供的邊緣作業指南： ftp://ftp.apigee.com/.

Alpha 版 監控工具和資訊主頁

這個版本是全新監控工具和資訊主頁的 Alpha 版， 邊緣這項工具可協助你瞭解各種元件 (路由器、訊息) 的健康狀態 處理器、ZooKeeper、Cassandra) 以及各種機構和環境適用的 http 錯誤代碼 部署狀態您也可以擷取資訊主頁資料的快照並與其他人共用 用來解決支援事件的 Apigee。

文件 (包括安裝指示) 包含在 Edge 的 ZIP 檔案中 Apigee ftp 網站提供的 4.16.01 文件：ftp://ftp.apigee.com/。

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

Edge 平台

管理 UI 重新樣式 (Cloud 15.09.30)

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

API 服務

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

API Proxy 精靈已經重新設計。點選「+ API Proxy」API Proxy 頁面 新的精靈會引導您完成 API Proxy 建立程序。所有 以及與舊版 API Proxy 精靈相同的設定。(MGMT-1376)

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

隨著全新 API Proxy 精靈重新設計，您現在可以使用 OpenAPI 建立 API Proxy (Swagger) 文件。在 API Proxy 精靈的第一頁中，按一下 [Use] (使用) 選取 反向 Proxy、Node.js 時適用 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 目標端點中，您可以動態設定 SSL/TLS 詳細資料，以便支援靈活彈性 執行階段需求以下範例說明如何在 TargetEndpoint 中設定 SSLInfo 這些值可在執行階段透過 Java 呼叫、JavaScript 政策或 建立「指派訊息」政策使用包含您想要設定值的訊息變數。

<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 設定參考資料
• https://community.apigee.com/articles/21424/dynamic-sslinfo-for-targetendpoint-using-variable.html

(APIRT-1475)。

SAML 宣告政策支援 RSA_SHA256 演算法 (Cloud 16.01.20)

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

驗證上傳憑證 (Cloud 16.01.20)

為防止將過期或無效的憑證上傳至 KeyStore 和信任存放區， Management API 會在上傳時驗證憑證憑證通過驗證 檔案大小不得超過 50KB，且格式為 PEM 或 DER。 也會驗證憑證到期日。覆寫預設的到期時間驗證方式 (不進行驗證 ，請使用以下查詢參數： ?ignoreExpiryValidation=true

如需詳細資訊，請參閱 將 JAR 檔案上傳到 KeyStore，並 將憑證上傳至 Truststore。(SECENG-516) 和 (APIRT-2213)

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

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

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

為提升安全性，Edge 預設會移除 X-Forwarded-For HTTP 要求 可能包含一或多個 IP 位址的標頭。新的預設行為代表用戶端 IP 位址會是最後一個外部 TCP 接收的 IP 位址 握手，而不是可能被偽造來避開存取控制的位址 政策。

如何變更這項預設行為，並允許 X-Forwarded-For 地址存取您的資訊 API Proxy 中，您必須設定 貴機構中的feature.enableMultipleXForwardCheckForACL=true。

具備政策屬性的 JavaScript 存取權 (Cloud 15.07.08)

在 API Proxy 流程中使用 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)

機構管理員可稽核在機構層級執行的操作記錄。 在管理使用者介面中，選取「管理員」>「」機構記錄。如要 相關資訊，請參閱 Audits：API、產品和 機構歷史。(MGMT-2232)

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

機構組織管理員可以將自己從以下機構的機構管理員角色中移除： 依序前往「管理員」管理使用者介面機構使用者和 然後按一下對方名稱旁的「移除」。(MGMT-934)

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

在管理 UI 中上傳大型 API Proxy 套件時，會標示「運作中」動畫 ，表示匯入作業仍在進行中，這樣您無法與 。(MGMT-1285)

快取行為與設定 (Cloud 15.07.22)

如要妥善管理記憶體內快取和使用率，請參閱「記憶體中的元素數量上限」 自 Edge Cloud 15.06.10 版起，環境快取資源的設定已淘汰。於 Edge Cloud 版本 15.07.22，這項設定已從「建立快取」使用者介面的「建立快取」使用者介面中移除。 Apigee Edge 管理 UI 的環境設定部分。

所有快取資源 (包括預設快取) 中顯示的元素總數取決於 分配給快取的記憶體總量根據預設，分配的記憶體總容量 訊息處理器的快取功能佔可用記憶體總量的 40%元素將 只有在快取記憶體不足或元素到期時，系統才會從記憶體內快取中將其移除。 (MGMT-2413、APIRT-1140)

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

API >管理 UI 中的「環境設定」頁面現可讓您新增、編輯 刪除目標伺服器

此外，頁面也經過重新設計，使用者也能建立、新增和 刪除，而不是前往新網頁多個快取屬性，包括「最大值」 記憶體中的元素」已無法在 UI 中使用，因為設定這些屬性已不存在 任何對執行階段快取行為的影響(MGMT-280)

具備訊息記錄至 syslog 的 SSL (Cloud 15.07.22)

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

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

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

管理 UI (Cloud 15.07.22)

Apigee 工程改進了管理程序中的多項小錯誤並提升可用性 第一種是使用無代碼解決方案 AutoML 透過使用者介面建立機器學習模型

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 Management 中建立及管理環境範圍的鍵/值對應 (KVM) 第一種是使用無代碼解決方案 AutoML 透過使用者介面建立機器學習模型環境範圍 KVM 包含鍵/值組合，可讓伺服器中的任何 API Proxy 存取 例如 Test 或 prod在管理 UI 選單中，依序前往「API」> 環境設定 >選取您想要的環境 >鍵/值對應 分頁。詳情請參閱「建立及編輯 環境鍵/值對應關係(MGMT-1393)

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

透過 API Proxy 編輯器新增 PopulateCache 政策時，<TimeoutInSec>元素 ，系統會預先填入 3,600 秒 (1 小時) 的值。先前的預設值 則是 300 秒 (5 分鐘)。(MGMT-2622)

開發人員服務

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

在管理 UI 中查看 API 產品時，與該 API 相關聯的開發人員應用程式 產品。為改善 UI 效能，系統不會在 編輯 API 產品(MGMT-2869)

「開發人員應用程式」頁面中的 Key 欄 (Cloud 15.08.05)

在擁有大量開發人員應用程式 (數千個) 的機構中，顯示「鍵」欄 「開發人員應用程式」頁面 (顯示每個應用程式的金鑰數量) 可能會妨礙顯示效能。目的地： 在這種情況下，螢幕可以提升顯示效能，請與 Apigee 支援團隊聯絡來完成以下設定 機構層級資源：features.appsNoCredentialsEnabled = true。這個 屬性會移除「Key」欄。不過請注意，移除「鍵」欄也會移除 並且提供依用戶端金鑰和密鑰搜尋的功能。(MGMT-2486)

開發人員詳細資料頁面進度旋轉圖示 (Cloud 15.09.30)

在管理 UI 中載入開發人員詳細資料頁面時，頁面中的「應用程式」部分 如果應用程式仍在載入，會顯示進度旋轉圖示。這能強化先前的行為 「應用程式」部分在載入應用程式時顯示空白。(MGMT-2667)。

營利

編輯 API 套件名稱 (Cloud 16.01.20)

在營利生命週期中，您可以隨時更新 API 套件名稱， API 套件內含已發布的費率方案時。(DEVRT-2177)

自訂屬性中允許的小數 (Cloud 16.01.20)

搭配自訂屬性使用價目表Plan, 訊息中的自訂屬性 標頭如果用來當做交易的調節係數，現在可以使用最多 4 的十進位值 。如要進一步瞭解這類方案，請參閱 指定 價目表自訂屬性詳細資料 (DEVRT-2191)。

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

透過 Management API 產生摘要收益報表時，您可以新增「費率方案」姓名 並在「方案 ID」評分時欄加入報表。如要這麼做，請新增「RATEPLAN」在群組中做為 groupBy 屬性 進行 API 呼叫，如建立 報表。(請注意，營利報表 UI 尚未提供這項功能)。於 現有費率方案的名稱和 ID 欄現在位於 連同其他分組資料欄一併顯示。(DEVRT-1740)

Analytics 服務

Total( ) 函式，用於回應時間指標 (Cloud 16.01.20)

在數據分析自訂報表和 API 呼叫中，「總和」現在匯總函式 目標回應時間、總回應時間和 end_point_response_time。例如，在 /stats API (http://docs.apigee.com/management/apis/get/organizations/%7Borg_name%7D/environments/%7Benv_name%7D/stats/%7Bdimension_name%7D-0), 您現在可以使用下列「選取」選項查詢參數：?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 GeoMap 包含「City」美國和加拿大。當您 在地圖上按一下州/省，畫面上就會顯示來電地點的城市清單。 (MGMT-2282)

|(直立線符號) 和 = 字元 (Cloud 15.09.02)

Analytics 自訂報表定義支援 |(直立線) 和 = 符號。在此之前 需使用 %7C 和 %3D 編碼。(MGMT-2504)

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

Analytics 自訂報表提供新的 Proxy 路徑字尾 (proxy_pathsuffix) 維度 以及 API 呼叫Proxy 路徑後置字串是 API Proxy 網址中基本路徑之後的部分 例如為條件式流程建立的路徑(AXAPP-1902)

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

使用會傳回開發人員的 /stats API 進行 Edge Analytics API 呼叫時， 開發人員顯示名稱會與開發人員 ID 一併傳回。先前只有開發人員 ID 。(AXAPP-1759)

修正錯誤

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

私有雲 4.16.01

下表列出自 Edge for Private Cloud 4.16.01 版本以來已修正的錯誤。目的地： 取得這些修正程式，請按照操作說明將 4.16.01 安裝更新到最新版本 每千次觀看收益和支援檔案，如更新 Apigee Edge 4.16.01.x 至最新 4.16.01 版。

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