私有雲的邊緣 4.17.09 版
新功能
請參閱「4.17.09 - Edge for Private Cloud 版本資訊」。
造訪 Apigee 社群
Apigee 社群是一項免費資源,方便您聯絡 Apigee 和其他 Apigee 客戶,並提出問題、提示和其他問題。在社群中張貼問題前,請務必先搜尋現有貼文,確認您的問題是否已有解答。
架構總覽
安裝 Private Cloud 適用的 Apigee Edge 之前,請先熟悉 Edge 模組和軟體元件的整體組織。
適用於私有雲的 Apigee Edge 包含下列模組:
- Apigee Edge Gateway (又稱 API 服務)
- Apigee Edge 數據分析
- Apigee API 裸機
- Apigee Edge 開發人員管道
- Apigee Edge 營利服務 (又稱為「開發人員服務營利」)
注意:Edge for Private Cloud 安裝程式無法安裝 Apigee Edge 開發人員管道。開發人員頻道可透過個別指令碼進行地端部署安裝。如要安裝開發人員管道,請與 Apigee 支援團隊聯絡。
Apigee Edge 閘道
Edge Gateway 是 Apigee Edge 的核心模組,也是管理 API 的主要工具。Gateway UI 提供多項工具,可用於新增及設定 API、設定資源組合,以及管理開發人員和應用程式。Gateway 會從您的後端 API 卸載許多常見的管理疑慮。新增 API 時,您可以套用有關安全性、頻率限制、中介服務、快取和其他控制項的政策。您也可以套用自訂指令碼、呼叫第三方 API 等來自訂 API 的行為。
軟體元件
Edge Gateway 以下列主要元件建構而成:
- Edge Management Server
- Apache ZooKeeper
- Apache Cassandra
- 邊緣路由器
- Edge 訊息處理器
- OpenLDAP
- Edge UI
Edge Gateway 可全部安裝在單一主機上,或發布至多個主機。
Apigee Edge 數據分析
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 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 網路伺服器中的 UI
- ElasticSearch - 分散式全文搜尋引擎。ElasticSearch 可以安裝在與 API BaaS 堆疊相同的節點上,或安裝在本身的節點上。
您可以新增 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 Monetization 服務
「邊緣營利服務」是 Apigee Edge 私有雲適用的全新擴充功能。API 供應商必須利用簡單好上手且靈活的方式透過 API 營利,以便利用這些 API 賺取收益。「營利服務」就能滿足這些條件。 透過營利服務,您可以建立各種費率方案,向開發人員收取套件中隨附的 API 使用費。這項解決方案提供豐富的彈性:您可以建立預付方案、後付方案、固定付費方案、可變動費率方案、「免費增值」方案、專為特定開發人員量身打造的方案,以及涵蓋開發人員群組的計畫等等。
另外,營利服務也包含報表和帳單功能。舉例來說,API 供應商可針對開發人員購買費率方案,而取得 API 套件流量的摘要或詳細報表。您也可以視需要調整這些記錄。您還可以為 API 套件的使用建立帳單文件 (含適用稅金),並向開發人員發布這些文件。
您也可以設定限制,以便控管及監控 API 套件的效能,並據此做出回應。此外,您也可以設定自動通知,讓系統在即將達到或達到這些限制時傳送通知。
注意:核心 Apigee Edge (閘道和數據分析) 是使用營利服務的先決條件。
營利服務功能
Edge 營利服務的主要功能包括:
- 與 API 平台完全整合,讓使用者能進行即時互動
- 從簡單的費用型方案到最複雜的充電/收益分潤方案 (方便建立及修改方案),讓所有商業模式「立即可用」支援
- 請為每筆交易中的數量或「自訂屬性」進行交易評分。 交易可以由 Gateway PLUS 其他系統 (在 Apigee Edge 外部) 的 API 組成
- 透過限制和通知等自動化工具監控效能及管理程序
- 整合開發人員/合作夥伴工作流程和控制選項,以便透過帳單/付款功能管理購買交易
- 全方位為企業使用者和開發人員/合作夥伴提供全方位的服務,不需要昂貴的技術介入
- 已與任何後端銷售、會計和 ERP 系統整合
軟體元件
邊緣營利服務是以下列主要元件為基礎建構而成:
- Edge Management Server
- Edge 訊息處理器
如要進一步瞭解如何透過 Edge UI 開始使用營利服務,請參閱 http://apigee.com/docs/monetization-services/content/get-started-using-monetization-services。
地端部署部署
透過內部部署系統適用的核心 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 產品、應用程式和使用者所需的大多數工作。
安裝 Edge Analytics 的地端部署安裝元件包括:
- Qpid 伺服器會管理數據分析資料的佇列系統,
- Postgres 伺服器會管理 PostgreSQL 數據分析資料庫。
下圖說明 Apigee Edge 元件的互動方式: