4.16.05 - Edge for Private Cloud 版本資訊

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

我們已於 2016 年 5 月 31 日 (星期二) 發布新版 Apigee Edge Private Cloud。

自上一個 Edge for 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 密碼。 如需完整清單，請參閱「Default Disabled Cipher Suites」一節：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 版更新的新程序 - 這個版本會以 update.sh 公用程式取代 apigee-migrate 公用程式，將安裝版本從 4.16.01 更新至 4.16.05。請參閱「將 Apigee Edge 4.16.01 更新至 4.16.05」。
  • Bootstrap
    • 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」。

管理

以下是私有雲管理和設定的新功能。

  • 安裝驗證 - 用於測試 Edge Private Cloud 安裝作業的 apigee-validate 公用程式，現在可從管理伺服器執行。先前，指令碼必須在訊息處理工具上執行。請參閱「測試安裝」。
  • 區域名稱 - 區域可以是任何名稱。在先前的版本中，名稱的格式為「dc-#」，其中 # 是整數值。
  • 閘道 Pod - 閘道 Pod 可以使用任何名稱。在先前的版本中，Pod 必須命名為「gateway」。
  • 以指令碼為基礎的管理 - 您可以使用新的 apigee-adminapi.sh 指令列公用程式，執行與呼叫 Edge 管理 API 相同的 Edge 設定工作。請參閱「使用 apigee-adminapi.sh 公用程式」。
  • 虛擬主機 SSL 無聲設定 - 建立機構或環境時，您現在可以傳遞屬性，在虛擬主機上設定 SSL。請參閱「加入機構」。

API 服務

以下是 Edge API 服務的新功能，這些功能已在產品的先前雲端版本中提供。

syslog 訊息記錄的固定長度前置字串 (Cloud 16.03.30)

訊息記錄政策在 Syslog 設定中新增了 <FormatMessage> 元素。設定 <FormatMessage>true</FormatMessage> 後，Syslog 訊息會以固定數量的字元開頭，方便您篩除 Apigee 插入的資料。詳情請參閱「訊息記錄政策」。(APIRT-1398)

API Proxy Base Path 中的萬用字元 (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)。新增或更新 TargetEndpoint 時，Proxy 編輯器 UI 也會提供這些選項。

服務呼叫政策也提供 Proxy 鏈結。

詳情請參閱「鏈結多個 API Proxy」。新的 LocalTargetConnection 元素也會列在 XML 架構中，網址為：https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd。 (MGMT-3049、MGMT-3050)

修正錯誤

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

Edge for Private Cloud 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」，管理 API 呼叫就會失敗
MGMT-3214 JavaCallouts 期間可能會發生類別衝突，導致客戶的 Java 程式碼失敗
MGMT-3185 將機構管理員新增至機構時發生錯誤
EDGEUI-127 使用新的 Proxy 編輯器時，權限不足
EDGEUI-119 使用者介面工作階段逾時問題
CORESERV-671 看到「No rings configured; Cannot initialize cps service」錯誤
AXAPP-2345 非 CPS 客戶無法列出 AX 自訂報表
AXAPP-2302 每日 Apigee Analytics 摘要在開發人員採用率下方顯示零
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 使用者介面顯示「clientAuthEnabled」參數的 SSL 虛擬主機設定不正確
DEVRT-2344 單日報表定義不會在 UI 中載入交易

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 (名稱服務快取精靈)，可能會發現訊息處理器會進行兩次 DNS 查詢：一次是 IPv4，另一次是 IPv6。

如要停用 IPv6 的 DNS 查詢，請按照下列步驟操作：

  1. 在每個訊息處理器節點上，編輯 /etc/nscd.conf。
  2. 設定下列屬性：

    enable-cache hosts no
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 精靈的 Apigee Edge 主機上，Satellite Server 6 中使用的 Katello 代理程式無法正常安裝。

「指派訊息」、「Java Callout」和「引發錯誤」政策中的 JSON 酬載

您可以使用 Assign Message、Java Callout 和 Raise 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
上一頁
4.16.05.01
下一頁
4 月 16 日