私有雲總覽

Edge for Private Cloud 4.19.01 版

新功能

請參閱「4.19.01 - Edge for Private Cloud 版本資訊」。

存取 Apigee 社群

Apigee 社群是免費資源,您可以在這裡與 Apigee 和其他 Apigee 客戶聯絡,提出問題、分享訣竅及討論其他問題。在社群中發文前,請務必先搜尋現有貼文,確認是否已有相同問題的解答。

架構總覽

安裝 Apigee Edge for Private Cloud 前,請先熟悉 Edge 模組和軟體元件的整體架構。

Apigee Edge for Private Cloud 包含下列模組:

  • Apigee Edge Gateway (又稱 API 服務)
  • Apigee Edge Analytics
  • Apigee Edge 開發人員服務入口網站
  • Apigee Edge 營利服務 (又稱開發人員服務營利)

下圖顯示不同模組在 Apigee 中的互動方式:

邊緣模組可連結組織內的不同服務和團隊。舉例來說,Edge Analytics 會將企業使用者與後端服務和 API 團隊連結;Edge Monetization 會將開發人員與 API 團隊連結;應用程式則會透過 Edge Gateway 和 Edge App Services 連結至後端服務和 API 團隊。所有這些服務和團隊都以某種方式相互連結。

Apigee Edge 閘道

Edge Gateway 是 Apigee Edge 的核心模組,也是管理 API 的主要工具。Gateway UI 提供多項工具,可用於新增及設定 API、設定資源套件,以及管理開發人員和應用程式。閘道可減輕後端 API 的許多常見管理負擔。新增 API 時,您可以套用安全性、頻率限制、中介服務、快取和其他控制項的政策。您也可以套用自訂指令碼、呼叫第三方 API 等,自訂 API 的行為。

軟體元件

Edge Gateway 由下列主要元件組成:

  • Edge 管理伺服器
  • Apache ZooKeeper
  • Apache Cassandra
  • 邊緣路由器
  • Edge 訊息處理器
  • OpenLDAP
  • Edge UI

Edge Gateway 的設計可讓這些元件全部安裝在單一主機上,或分散在多部主機上。

Apigee Edge Analytics

Edge Analytics 具備強大的 API 數據分析功能,可查看長期使用趨勢。您可以依據頂尖開發人員和應用程式區隔目標對象、瞭解各 API 方法的使用情形,進而判斷投資方向,以及建立業務層級資訊的自訂報表。

資料通過 Apigee Edge 時,系統會收集幾種預設類型的資訊,包括網址、IP、API 呼叫資訊的使用者 ID、延遲時間和錯誤資料。您可以使用政策新增其他資訊,例如標頭、查詢參數,以及從 XML 或 JSON 擷取的部分要求或回應。

所有資料都會推送至 Edge Analytics,由分析伺服器在背景維護。資料匯總工具可用於編譯各種內建或自訂報表。

軟體元件

Edge Analytics 包含下列項目:

  • Qpid,包含下列
    • Apache Qpid 訊息系統
    • Apigee Qpid 伺服器服務:Apigee 的 Java 服務,用於管理 Apache Qpid
  • Postgres,包含下列項目:
    • PostgreSQL 資料庫
    • Apigee Postgres 伺服器服務:Apigee 提供的 Java 服務,用於管理 PostgreSQL 資料庫

Apigee Edge 開發人員服務入口網站

Apigee 開發人員服務入口網站 (或簡稱「入口網站」) 是用於內容和社群管理的範本入口網站。這項服務是以開放原始碼 Drupal 專案為基礎。預設設定可讓您建立及管理 API 說明文件、論壇和網誌。內建的測試控制台可讓您在入口網站中即時測試 API。

除了內容管理外,入口網站還提供多種社群管理功能,例如手動/自動使用者註冊和管理使用者留言。角色式存取控管 (RBAC) 模型可控管入口網站功能的存取權。舉例來說,您可以啟用控制項,允許已註冊的使用者建立論壇貼文、使用測試控制台等。

Apigee Edge for Private Cloud 部署指令碼不包含入口網站部署作業。地端部署入口網站由專屬安裝指令碼支援。如要安裝及設定入口網站,請與 Apigee Edge 支援團隊聯絡。

Apigee Edge 營利服務

Edge Monetization Services 是 Apigee Edge for Private Cloud 的全新強大擴充功能。身為 API 供應商,您需要一種簡單易用且靈活的方式,透過 API 營利,以便在使用這些 API 時產生收益。營利服務可滿足這些需求。您可以使用營利服務建立各種費率方案,向開發人員收取 API 套裝組合的使用費。這項解決方案提供極大的彈性:您可以建立預付方案、後付方案、固定費用方案、變動費率方案、免費增值方案、專為特定開發人員量身打造的方案、涵蓋多組開發人員的方案等。

此外,營利服務也包含報表和帳單功能。舉例來說,API 供應商可以取得 API 套件流量的摘要或詳細報表,瞭解開發人員購買的費率方案。您也可以視需要調整這些記錄。您也可以建立帳單文件 (包含適用稅金),列出 API 套件的使用情況,並將這些文件發布給開發人員。

您也可以設定限制,協助控管及監控 API 套件的效能,並允許您採取相應措施,以及設定在接近或達到這些限制時自動通知。

營利服務功能

Edge Monetization Services 的主要功能包括:

  • 與 API 平台完全整合,可即時互動
  • 現成支援所有商業模式,從簡單的收費方案到最複雜的收費/收益分潤方案 (輕鬆建立及修改方案)
  • 根據每筆交易的數量或自訂屬性,為交易評分。 交易可由閘道和其他系統 (Apigee Edge 外部) 的 API 組成
  • 自動化工具 (例如限制和通知),用於監控成效及管理程序
  • 整合開發人員/合作夥伴工作流程和控制項,透過帳單/付款管理購買
  • 為企業使用者和開發人員/合作夥伴提供全自助式服務,因此不需要昂貴的技術介入
  • 與任何後端銷售、會計和 ERP 系統整合

Edge 安裝作業的層級,其中管理 UI 和開發人員入口網站做為介面層,所有其他 Edge 元件則提供服務。

軟體元件

Edge Monetization Services 是以以下主要元件為基礎建構而成:

  • Edge 管理伺服器
  • Edge 訊息處理器

如要進一步瞭解如何使用 Edge UI 開始使用營利服務,請參閱「開始使用營利功能」。

地端部署

在地端部署環境安裝 Apigee Edge for Private Cloud 核心 (閘道和 Analytics),可提供必要的基礎架構,代表地端部署用戶端的客戶執行 API 流量。

下列影片介紹 Apigee Edge for Private Cloud 的部署模型:

S26E01:部署模式簡介

S26E04:部署架構

地端部署安裝 Edge Gateway 提供的元件包括 (但不限於):

  • 路由器會處理來自負載平衡器的所有傳入 API 流量、判斷處理要求的 API Proxy 組織和環境、平衡可用訊息處理器的要求,然後調度要求。路由器會終止 HTTP 要求、處理 TLS/SSL 流量,並使用虛擬主機名稱、通訊埠和 URI,將要求導向適當的訊息處理器。
  • 訊息處理器會處理 API 要求。訊息處理器會評估傳入的要求、執行任何 Apigee 政策,並呼叫後端系統和其他系統來擷取資料。收到這些回應後,訊息處理器會設定回應格式,並將回應傳回用戶端。
  • Apache Cassandra 是執行階段資料存放區,用於儲存應用程式設定、分散式配額計數器、API 金鑰,以及在閘道上執行的應用程式 OAuth 權杖。
  • Apache ZooKeeper 包含各種 Apigee 元件的位置和設定資料,並會通知不同伺服器設定變更。
  • OpenLDAP (LDAP):管理系統和組織使用者與角色。
  • 管理伺服器:用於整合上述元件。Management Server 是 Edge Management API 要求的端點。也會與 Edge UI 互動。
  • 使用者介面提供瀏覽器工具,可讓您執行建立、設定及管理 API Proxy、API 產品、應用程式和使用者所需的大部分工作。

地端部署安裝 Edge Analytics 提供的元件包括:

  • Qpid 伺服器會管理數據分析資料的佇列系統。
  • Postgres 伺服器會管理 PostgreSQL 數據分析資料庫。

下圖說明 Apigee Edge 元件如何互動:

Edge 元件互動的核心是管理伺服器,與大多數其他元件連結。部分元件 (例如路由器和訊息處理器) 除了與管理伺服器互動外,也會直接互相互動。Qpid 和 Postgres 等元件具有未直接連線至管理伺服器的次要資料元件。