私有雲總覽

私有雲 4.18.01 版本

新功能

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

存取 Apigee 社群

Apigee 社群是免費的資源,您可以透過這個管道針對 Apigee 和其他 Apigee 客戶提出問題、提示和其他問題。張貼社群前,請務必先搜尋現有的貼文,查看問題是否已有解答。

架構總覽

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

私有雲 Apigee Edge 包含以下模組:

  • Apigee Edge Gateway (又稱 API 服務)
  • Apigee Edge 數據分析
  • Apigee API 級別
  • Apigee Edge 開發人員管道
  • Apigee Edge 營利服務 (又稱「開發人員服務營利服務」)

注意:邊緣私有雲安裝程式無法安裝 Apigee Edge 開發人員頻道。開發人員版可透過獨立的指令碼安裝在內部。如要安裝開發人員版本,請與 Apigee Edge 支援團隊聯絡。

Apigee Edge 閘道

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

軟體元件

Edge Gateway 是透過下列主要元件建構而成:

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

Edge Gateway 經過精心設計,因此可以安裝在單一主機上,或分散到多個主機上。

Apigee Edge 數據分析

Edge Analytics (分析) 提供強大的 API 數據分析功能,方便您掌握長期的使用趨勢。您可以依熱門開發人員和應用程式區隔目標對象、瞭解 API 方法的使用情況,以及製作業務層級資訊的自訂報表。

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

系統會將所有資料推送至 Edge Analytics (分析),並在分析伺服器在背景維護。資料匯總工具可用來編譯各種內建或自訂報表。

軟體元件

Edge Analytics (分析) 包含下列功能:

  • Qpid 包含以下項目:
    • Apache Qpid 訊息系統
    • Apigee Qpid Server 服務 - 透過 Apigee 用來管理 Apache Qpid 的 Java 服務
  • Postgres,當中包含下列項目:
    • PostgreSQL 資料庫
    • Apigee Postgres 伺服器服務 - 透過 Apigee 用來管理 PostgreSQL 資料庫的 Java 服務

Apigee API 級別

API BaaS 是完整的後端式服務 (BaaS),可讓行動和網頁應用程式安裝在 Edge 之外的附加項目。API BaaS 可讓應用程式開發人員使用彈性的資料儲存區和重要功能,例如社交圖表、地理位置、使用者管理、推播通知、效能監控等。API BaaS 透過 iOS、Android、JavaScript 等的 SDK 提供這些功能,讓應用程式開發人員專注於打造豐富功能和使用者體驗,真正區分不同的用戶端應用程式,不必費時實作核心後端服務和基礎架構。

API BaaS 功能

Apigee 說明文件網站提供更多有關 API BaaS 功能的資訊。請參閱 http://apigee.com/docs/app-services/content/app-services-features

下圖說明 API BaaS 元件如何互動。

軟體元件

API BaaS 是以下列主要元件建構而成:

  • API BaaS 堆疊 - 部署於 Tomcat 網路伺服器
  • API BaaS 入口網站 - 部署在 Nginx 網路伺服器中
  • ElasticSearch - 分散式文字搜尋引擎。ElasticSearch 可以安裝在 API BaaS Stack 所在的節點上,或安裝在自己的節點上。

您可以新增 Tomcat 伺服器,並使用負載平衡器將網路要求轉送至所有使用中的伺服器,藉此大規模調整 API BaaS REST API 功能。

如要進一步瞭解如何開始使用 API BaaS,請參閱 http://apigee.com/docs/content/build-apps-home

Apigee Edge 開發人員管道

Edge Developer Channel 是內容和社群管理功能的範本入口網站。這個程式碼是以開放原始碼 Drupal (http://www.drupal.org) 專案為基礎。預設設定可讓您建立及管理 API 說明文件、論壇和網誌。內建測試主控台可讓您在入口網站中即時測試 API。

除了內容管理外,開發人員頻道還具備各種社群管理功能,例如手動/自動註冊使用者內容,以及管理使用者留言。角色型存取權控管 (RBAC) 模型可控制開發人員頻道功能的存取權。舉例來說,您可以啟用控制項,讓已註冊的使用者能夠建立論壇文章、使用測試控制台等。

Apigee Edge 私有部署部署指令碼不含開發人員版本部署。地端部署管道支援自家的安裝指令碼。 如要安裝及設定開發人員管道,請與 Apigee 支援團隊聯絡。

Apigee Edge 營利服務

Edge Monetize Services 是適用於私有雲的 Apigee Edge 這項全新擴充功能。API 供應商必須提供簡單好上手且富有彈性的方法透過 API 營利,以便透過這些 API 賺取收益。營利服務可以滿足這些要求。您可以透過營利服務制定各種費率方案,讓開發人員使用您的 API 組合套件。該解決方案提供大幅的彈性:您可以建立預付方案、後付方案、固定方案、可變費率方案、「免費增值方案」方案,以及專為特定開發人員設計的方案,以及涵蓋開發人員群組的方案等等。

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

另外,您也可以設定限制,以便監控及監控 API 套件效能,並視情況做出回應。此外,您也可以設定自動通知,當這些限制即將達到或達到上限時。

注意:您必須先使用核心 Apigee Edge (閘道和數據分析) 才能使用營利服務。

營利服務功能

邊緣營利服務的主要特色包括:

  • 與 API 平台完全整合,提供即時互動功能
  • 支援各種商業模式,包括簡易的付費方案、最複雜的收費/收益分享方案 (輕易建立及修改方案)
  • 為每筆交易中的數量或「自訂屬性」進行交易評分。 交易可能是由 Gateway PLUS 其他系統 (由 Apigee Edge 外部) 的 API 組成
  • 監控限制及管理程序等自動化工具
  • 整合式開發人員/合作夥伴工作流程和控制項,透過帳單/付款功能管理購買交易
  • 為商業使用者和開發人員/合作夥伴提供全方位服務,因此無需高昂介入
  • 整合任何後端銷售、會計和 ERP 系統

軟體元件

邊緣營利服務是以下列主要元件為基礎:

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

如要進一步瞭解如何透過 Edge UI 開始使用營利服務,請參閱 http://apigee.com/docs/monetization-services/content/get-started-using-monetization-services

地端部署部署

地端部署 Private Apigee Edge 核心 Apigee Edge (閘道和數據分析) 會提供基礎架構,以便代表地端部署用戶端的客戶執行 API 流量。

透過 Edge Gateway 安裝的元件包括 (但不限於):

  • 路由器會處理來自負載平衡器的所有傳入 API 流量、決定要處理要求的 API Proxy 的機構與環境、平衡可用訊息處理程式的要求,以及分派要求。路由器會終止 HTTP 要求、處理傳輸層安全標準 (TLS)/安全資料傳輸層 (SSL) 流量,並使用虛擬主機名稱、通訊埠和 URI 將要求轉送至適當的訊息處理器。
  • 訊息處理器處理 API 要求。訊息處理工具會評估傳入要求、執行任何 Apigee 政策,並呼叫後端系統和其他資料擷取資料。收到這些回應後,「訊息處理工具」會格式化回應,並將回應傳回用戶端。
  • Apache Cassandra 是一種執行階段資料存放區,可儲存應用程式在閘道中執行的應用程式設定、分散式配額計數器、API 金鑰和 OAuth 權杖。
  • Apache ZooKeeper 包含各種 Apigee 元件的位置和設定資料,並會通知不同的設定變更伺服器。
  • OpenLDAP (LDAP),以管理系統和機構使用者和角色。
  • 管理伺服器請將這些元件放在一起。管理伺服器是 Edge Management API 要求的端點。也與 Edge UI 互動。
  • UI 提供以瀏覽器為基礎的工具,可讓您執行建立、設定及管理 API Proxy、API 產品、應用程式和使用者所需的大多數工作。

地端部署 Analytics (分析) 提供的元件包括:

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

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