私有雲 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 元件如何互動: