您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件。 資訊
我們在 2016 年 5 月 31 日星期二發布了新版 Apigee Edge for Private Cloud。
自舊版的 Private Cloud 功能版本 (4.16.01) 以來,已推出下列版本,這個功能版本包含這些內容:
請參閱「關於版本編號」,瞭解如何確認您的 Edge for Private Cloud 版本是否包含特定雲端版本。
新功能和強化項目
這個版本包含的新功能和強化項目。除了下列強化項目外,這個版本也強化了可用性、效能、安全性和穩定性。
如需更多詳細資料和操作說明,請參閱 Edge for Private Cloud 說明文件。
安裝與作業指南已改為在線上
您現在可以在 4.18.01 版中存取 Edge for Private Cloud 安裝和作業指南。
軟體更新
版本包含下列軟體更新:
- Java JDK 1.8:為了使用最新的 Java 功能,此版本與 Java 1.8 相容。您的環境中須使用 Oracle JDK 1.8 或 OpenJDK 8。
在 Java 8 更新中,Oracle JDK 1.8 中不再提供部分傳輸層安全標準 (TLS) 加密。如需完整清單,請參閱「預設停用的加密套件」一節:http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html。 - Cassandra 2.1.13 - 從 Cassandra 2.0.15 更新。
安裝、升級、復原
以下是安裝、升級和相關指令碼的變更清單。如需使用說明,請參閱 Edge for Private Cloud 說明文件。
- 從 4.16.01 更新的新程序 - 這個版本會將
apigee-migrate
公用程式替換為update.sh
公用程式,以便將安裝作業從 4.16.01 更新至 4.16.05。請參閱將 Apigee Edge 4.16.01 更新至 4.16.05 版。 -
啟動
bootstrap.sh
(4.16.01 版) 現在是 4.16.05 中的bootstrap_4.16.05.sh
。- 您不再需要指定
uname:pword
,即可下載bootstrap_4.16.05.sh
。
- 復原:如要將更新復原至 4.16.05,您需要解除安裝元件的 4.16.05 版本,並重新安裝先前的版本。已移除先前的
rollback.sh
公用程式。請參閱 4.16.05 復原程序。 setup.sh
和update.sh
可將記錄檔寫入/tmp
:根據預設,setup.sh
和update.sh
公用程式會將記錄資訊寫入/opt/apigee/var/log/apigee-setup
。如果執行公用程式的使用者無法存取該目錄,系統會將記錄寫入/tmp
目錄。如果使用者無法存取/tmp
,公用程式就會失敗。- API BaaS 更新程序 - 在 4.16.01 版本中,您必須重新安裝 API BaaS 才能進行遷移。新的
update.sh
公用程式支援更新現有的 API BaaS。請參閱將 Apigee Edge 4.16.01 更新至 4.16.05 版。
管理
以下是 Private Cloud 管理與設定的新功能。
- 安裝驗證 - 用來測試 Edge Private Cloud 安裝項目的
apigee-validate
公用程式現在可從管理伺服器執行。先前必須在訊息處理器上執行指令碼。請參閱「測試安裝」。 - 區域名稱:區域可以是任何名稱。在先前的版本中,名稱的格式為「dc-#」,其中 # 是整數值。
- 閘道 Pod:閘道 Pod 可以使用任何名稱。在先前的版本中,Pod 必須命名為「gateway」。
- 指令碼式管理:新的
apigee-adminapi.sh
指令列公用程式可讓您呼叫 Edge Management API,執行相同的 Edge 設定工作。請參閱使用 apigee-adminapi.sh 公用程式。 - 虛擬主機 SSL 無訊息設定 - 現在建立機構或環境時,您可以傳遞屬性,在虛擬主機上設定 SSL。請參閱「為機構加入」。
API 服務
以下是 Edge API 服務的新功能。這些功能已在先前的雲端版本中提供。
固定的系統記錄檔訊息記錄功能長度前置字串 (Cloud 16.03.30)
訊息記錄政策在 Syslog 設定中加入新的 <FormatMessage>
元素。設定 <FormatMessage>true</FormatMessage>
之後,系統記錄檔訊息的開頭會以固定的字元數開頭,讓您篩除已插入 Apigee 的資料。詳情請參閱訊息記錄政策。(APIRT-1398)
API Proxy 基本路徑中的萬用字元 (Cloud 16.03.09 UI)
管理 UI 支援在 API Proxy 基本路徑中使用一或多個 /*/
萬用字元。舉例來說,/team/*/members
的基本路徑可讓用戶端使用 https://[host]/team/blue/members
或 https://[host]/team/green/members
呼叫 Proxy,而您不必建立新的 Proxy 來支援新團隊。請注意,不允許使用 /**/
。(MGMT-3154)
API Proxy 鏈結 (Cloud 16.03.02、Cloud 16.03.09 UI)
Edge 支援本機 API Proxy 鏈結,可讓一個 API Proxy 呼叫部署在 Edge 機構中的另一個 API Proxy,而且不會增加網路負擔。先前,API Proxy 鏈結需要到另一個 API Proxy 進行 http(s) 呼叫,而該 Proxy 會透過負載平衡器、路由器和訊息處理器轉送要求。
API Proxy 的 TargetEndpoint 有新的 LocalTargetConnection
元素,可讓您指定 API Proxy 名稱、API Proxy 中的特定 ProxyEndpoint 名稱,或僅當本機 API Proxy 資源的基本路徑 (例如 /v1/myresource)。當您新增或更新目標端點時,Proxy 編輯器 UI 也會提供這些選項。
服務呼叫政策也提供 Proxy 鏈結。
詳情請參閱將 API Proxy 鏈結在一起。這裡的 XML 結構定義中也會顯示新的 LocalTargetConnection
元素:https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd。(MGMT-3049, MGMT-3050)
修正錯誤
本次更新修正了下列錯誤。這份清單主要是用來確認支援單是否已經解決,無法向所有使用者提供詳細資訊。
私有雲 4.16.05 邊緣
問題 ID | 說明 |
---|---|
PRC-770 | 16.01 安裝程式無法在 axgroup 中註冊 Postgres 待命伺服器 |
PRC-758 | 具備使用者角色的使用者可編輯自訂報表 |
PRC-883 | 在具備主要待命設定的 Postgres 伺服器上更新失敗 |
Cloud 16.03.30
問題 ID | 說明 |
---|---|
SECENG-584 | 驗證檢查中憑證鏈中憑證之間的換行符號,會導致實際工作環境中的部分憑證發生問題 |
MGMT-3217 | 如果 KVMap 名稱結尾是「keys」,Management API 呼叫就會失敗 |
MGMT-3214 | 在 Java 呼叫期間,導致客戶的 Java 程式碼失敗,可能會發生類別衝突 |
MGMT-3185 | 為機構新增機構管理員時發生錯誤 |
EDGEUI-127 | 使用新的 Proxy 編輯器取得權限不足 |
EDGEUI-119 | 使用者介面工作階段逾時問題 |
CORESERV-671 | 系統顯示「未設定環;無法初始化 cps 服務」錯誤訊息 |
AXAPP-2345 | 針對非單次轉換出價客戶顯示 AX 自訂報表時發生問題 |
AXAPP-2302 | 每日 Apigee 數據分析摘要顯示,開發人員採用率為零 |
APIRT-2750 | 特定機構單位的流量失敗次數偏高 |
APIRT-2516 | JavaScript 呼叫的執行階段錯誤指定了錯誤的行數 |
APIRT-2508 | 在保管箱回呼中呼叫快速監聽時發生錯誤 |
APIRT-2336 | Node.js 的 Gzip 問題 |
APIRT-1975 | 遮罩設定不適用於 message.content |
Cloud 16.03.16 UI
問題 ID | 說明 |
---|---|
MGMT-3142 | 錯誤分析資訊主頁未載入圖表 (已更新修正) |
Cloud 16.03.09 UI
問題 ID | 說明 |
---|---|
MGMT-3158 | 透過 API 設定個別 Proxy 上的 RBAC 時,UI 權限不足 |
MGMT-3142 | 錯誤分析資訊主頁未載入圖表 |
MGMT-3118 | UI 的「clientAuthEnabled」參數顯示錯誤的 SSL 虛擬主機設定 |
DEVRT-2344 | 單日報表定義未在使用者介面中載入交易 |
Cloud 16.03.02
問題 ID | 說明 |
---|---|
MGMT-3083 | Node.js 記錄的自動重新整理功能過於詳細 |
DEVRT-2275 | 自訂屬性費率方案只會顯示 5 項屬性,不會顯示 10 項屬性 |
DEVRT-1275 | 「費率方案」下拉式選單中未顯示所有開發人員 |
DEVRT-1074 | 餘額為零的預付開發人員在套用抵免額時擲回 NullpointerException |
Cloud 16.02.17
問題 ID | 說明 |
---|---|
MGMT-3083 | Node.js 記錄的自動重新整理功能過於詳細 |
MGMT-3077 | UI 是從使用預設命名空間的 WSDL 產生無效的 Proxy 組合 |
MGMT-1642 | 自訂使用者角色缺少開發人員應用程式的「取得」權限 |
已知問題
這個版本有下列已知問題。
問題 ID | 說明 |
---|---|
APIRT-2978 |
路由器無法啟動 Nginx,或路由器無法啟動 如果 Edge Router 無法啟動 Nginx,或是完全無法啟動 (如 /opt/apigee/var/log/edge-router/logs/system.log 檔案所示),請刪除 /opt/nginx/conf.d 目錄中的所有檔案,然後重新啟動路由器: > rm -f /opt/nginx/conf.d/* > /opt/apigee/apigee-service/bin/apigee-service edge-router restart |
APIRT-3364 |
郵件處理器會對 IPv4 和 IPv6 進行 DNS 查詢 如果您安裝並啟用 NSCD (名稱服務快取 Daemon),可能會發現訊息處理方會進行兩項 DNS 查詢:分別針對 IPv4 和 IPv6。 如何停用 IPv6 的 DNS 查詢:
|
PRC-1118 |
執行「apigee-service apigee-postgresql pg-data-purge」指令時發生錯誤 如果您執行「apigee-service apigee-postgresql pg-data-purge」指令,並看到錯誤訊息: 錯誤:必須是關係擁有者 編輯 /opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge,並將下列屬性設為「apigee」: POSTGRES_USER=apigee |
DOC-1687 | 由於已知的套件依附元件衝突,在搭載 Qpid Daemon 的 Apigee Edge 主機上,無法使用衛星伺服器 6 的 Katello 代理程式正確安裝。 |
指派訊息、Java 呼叫和擴充錯誤政策中的 JSON 酬載
Assign Message、Java callout 和 rise Fault 政策可讓您使用 <Set><Payload>
元素產生訊息內容。在這些訊息中,您可以加入變數,其值會在執行階段自動填入。舉例來說,如果您想從 HTTP 標頭輸出日期,可以在訊息中插入 {message.header.date}
。
如果訊息格式是 JSON,看起來會像這樣:
{"The date is: " : "{message.header.date}"}
不過,您可以看到格式錯誤的 JSON。如要解決這個問題,有以下兩種做法:
- 使用反斜線逸出左大括號:
\{"The date is: " : "{message.header.date}"}
- 在酬載元素設定中,使用
variablePrefix
和variableSuffix
屬性表示 JSON 酬載中的變數。例如:
<Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>
在下一個 Edge for Private Cloud 功能版本中,您可以將大括號用於 JSON 訊息中的變數,沒有任何問題。(APIRT-1160)
路由器無法啟動 Nginx,或是路由器無法啟動
如果 Edge Router 無法啟動 Nginx,或是完全無法啟動 (如 /opt/apigee/var/log/edge-router/logs/system.log 檔案所示),請刪除 /opt/nginx/conf.d 目錄中的所有檔案,然後重新啟動路由器:
> rm -f /opt/nginx/conf.d/* > /opt/apigee/apigee-service/bin/apigee-service edge-router restart