Edge for Private Cloud バージョン 4.17.05
新機能
4.17.05 - 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 API BaaS
- Apigee Edge Developer チャンネル
- Apigee Edge Monetization Services（別名 Developer Services Monetization）
注: Edge for Private Cloud インストーラでは、Apigee Edge Developer チャンネルをインストールできません。デベロッパー チャンネルは、個別のスクリプトによるオンプレミスのインストールに使用できます。Developer チャンネルをインストールする場合は、Apigee サポートにお問い合わせください。
Apigee Edge ゲートウェイ
Edge Gateway は Apigee Edge のコア モジュールであり、API を管理するためのメインツールです。Gateway UI には、API の追加と構成、リソースのバンドルの設定、デベロッパーとアプリの管理を行うためのツールが用意されています。Gateway により、管理に関する多くの一般的な懸念がバックエンド API から軽減されます。API を追加する際に、セキュリティ、レート制限、メディエーション、キャッシュなどの制御に関するポリシーを適用できます。また、カスタム スクリプトを適用したり、サードパーティの API を呼び出したりすることで、API の動作をカスタマイズすることもできます。
ソフトウェア コンポーネント
Edge ゲートウェイは、次の主要コンポーネントから構築されています。
- Edge 管理サーバー
- Apache ZooKeeper
- Apache Cassandra
- エッジルーター
- Edge Message Processor
- OpenLDAP
- Edge UI
Edge Gateway は、これらすべてを単一のホストにインストールすることも、複数のホストに分散することもできるように設計されています。
Apigee Edge Analytics
Edge Analytics には、長期的な使用傾向を把握するための強力な API 分析機能が備わっています。上位のデベロッパーやアプリでユーザーを分類したり、API メソッドごとの使用状況を確認して投資対象を把握したり、ビジネスレベルの情報に関するカスタム レポートを作成したりできます。
データが Apigee Edge を通過すると、URL、IP、ユーザー ID（API 呼び出し情報）、レイテンシ、エラーデータなど、いくつかのデフォルト タイプの情報が収集されます。ポリシーを使用すると、ヘッダー、クエリ パラメータ、XML または JSON から抽出したリクエストまたはレスポンスの一部などの情報を追加できます。
すべてのデータは Edge Analytics に push され、分析サーバーによってバックグラウンドで管理されます。データ集計ツールを使用して、さまざまな組み込みレポートやカスタム レポートを作成できます。
ソフトウェア コンポーネント
Edge Analytics は以下で構成されます。
- Qpid。次の要素で構成されています。
- Apache Qpid メッセージング システム
- Apigee Qpid Server サービス - Apache Qpid の管理に使用される Apigee の Java サービス
- Postgres。次のものから構成されます。
- PostgreSQL データベース
- Apigee Postgres Server サービス - PostgreSQL データベースの管理に使用する、Apigee の Java サービス
Apigee API BaaS
API BaaS は完全な Backend as a Service（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 Stack - Tomcat ウェブサーバーにデプロイ
- API BaaS ポータル - Nginx ウェブサーバーにデプロイされた UI
- ElasticSearch - 分散型全文検索エンジン。ElasticSearch は、API BaaS Stack と同じノードまたは専用ノードにインストールできます。
Tomcat サーバーを追加し、ロードバランサを使用してすべてのアクティブ サーバーにウェブ リクエストをルーティングすることで、API BaaS REST API 機能を水平方向にスケーリングできます。
API BaaS の使用を開始する方法について詳しくは、http://apigee.com/docs/content/build-apps-home をご覧ください。
Apigee Edge Developer チャンネル
Edge デベロッパー チャンネルは、コンテンツとコミュニティ管理のためのテンプレート ポータルです。これは、オープンソースの Drupal（http://www.drupal.org）プロジェクトに基づいています。デフォルトの設定では、API ドキュメント、フォーラム、ブログを作成および管理できます。組み込みのテスト コンソールを使用すると、ポータル内から API をリアルタイムでテストできます。
デベロッパー チャンネルには、コンテンツ管理以外にも、手動/自動ユーザー登録、ユーザー コメントの管理など、コミュニティ管理のためのさまざまな機能があります。ロールベース アクセス制御（RBAC）モデルは、デベロッパー チャンネルの機能へのアクセスを制御します。たとえば、登録ユーザーにフォーラム投稿の作成やテスト コンソールの使用などを許可するコントロールを有効にできます。
Apigee Edge for Private Cloud のデプロイ スクリプトには、Developer Channel のデプロイは含まれていません。オンプレミスでのデベロッパー チャンネル デプロイは、独自のインストール スクリプトによってサポートされます。Developer チャンネルをインストールして構成する場合は、Apigee サポートにお問い合わせください。
Apigee Edge Monetization Services
Edge Monetization Services は、Apigee Edge for Private Cloud の強力な拡張機能です。API プロバイダは、API の使用に対して収益を上げられるように、API を収益化するための使いやすく柔軟な方法を必要としています。Monetization Services は、これらの要件を満たします。Monetization Services を使用すると、パッケージにバンドルされた API の使用に対してデベロッパーに課金するさまざまな料金プランを作成できます。このソリューションには、非常に高い柔軟性が備わっています。前払いプラン、後払いプラン、固定料金プラン、変動料金プラン、「フリーミアム」プラン、特定のデベロッパーに合わせたプラン、デベロッパー グループに対応するプランなどを作成できます。
また、Monetization Services には、レポート作成機能と請求機能が含まれています。たとえば、API プロバイダは、デベロッパーが料金プランを購入した API パッケージへのトラフィックの概要レポートや詳細レポートを取得できます。これらのレコードは、必要に応じて調整することもできます。また、API パッケージの使用に対する請求ドキュメント（適用される税金を含む）を作成して、デベロッパーに公開できます。
また、上限を設定して、API パッケージのパフォーマンスを管理およびモニタリングして、それに応じて対応することもできます。また、上限に近づいたか、上限に達したときの自動通知を設定できます。
注: コア Apigee Edge（Gateway と Analytics）は、Monetization Services を使用するための前提条件です。
Monetization Services の機能
Edge Monetization Services の主な機能は次のとおりです。
- API プラットフォームと完全に統合されているため、リアルタイムのやり取りが可能
- シンプルな料金ベースのプランから最も複雑な課金/収益分配プランまで、すぐに使用できるすべてのビジネスモデルをサポートします（プランの作成と変更が簡単）。
- 取引量、または各取引内の「カスタム属性」に基づいて取引を評価します。 トランザクションは Gateway と他のシステム（Apigee Edge の外部）の API で構成できる
- パフォーマンスをモニタリングし、プロセスを管理する、制限や通知などの自動ツール
- デベロッパー / パートナーのワークフローと制御を統合し、請求や支払いを通じて購入を管理できる
- ビジネス ユーザー、デベロッパー/パートナー向けの完全なセルフサービスのため、費用のかかる技術的な介入は不要
- あらゆるバックエンドの販売、会計、ERP システムとの統合
Edge for Private Cloud バージョン 4.16.09
ソフトウェア コンポーネント
Edge Monetization Services は、次の主要コンポーネントの上に構築されています。
- Edge 管理サーバー
- Edge Message Processor
Edge UI を使用して Monetization Services の使用を開始する方法について詳しくは、http://apigee.com/docs/monetization-services/content/get-started-using-monetization-services をご覧ください。
オンプレミス デプロイ
コア Apigee Edge for Private Cloud（Gateway および Analytics）をオンプレミスにインストールすることで、オンプレミス クライアントのお客様の代わりに API トラフィックを実行するために必要なインフラストラクチャが提供されます。
Edge Gateway のオンプレミス環境のインストールでは、次のコンポーネントが提供されます（ただし、これらに限定されません）。
- Router は、ロードバランサから受信したすべての API トラフィックを処理し、リクエストを処理する API プロキシの組織と環境を決定します。また、使用可能な Message Processor でリクエストを分散して、リクエストを送信します。Router は HTTP リクエストを終了し、TLS/SSL トラフィックを処理し、仮想ホスト名、ポート、URI を使用してリクエストを適切な Message Processor にステアリングします。
- Message Processor は API リクエストを処理します。Message Processor は受信リクエストを評価し、Apigee ポリシーを実行して、バックエンド システムやその他のシステムを呼び出してデータを取得します。これらのレスポンスを受信すると、Message Processor はレスポンスをフォーマットし、クライアントに返します。
- Apache Cassandra は、ゲートウェイで実行されているアプリケーションのアプリケーション構成、分散割り当てカウンタ、API キー、OAuth トークンを保存するランタイム データ リポジトリです。
- Apache ZooKeeper には、さまざまな Apigee コンポーネントの場所と構成に関する構成データが格納され、さまざまなサーバーに構成の変更が通知されます。
- OpenLDAP（LDAP）は、システムおよび組織のユーザーとロールを管理します。
- Management Server: これらの要素をまとめて保持します。Management Server は、Edge Management API リクエストのエンドポイントです。また、Edge UI ともやり取りします。
- UI は、API プロキシ、API プロダクト、アプリ、ユーザーの作成、構成、管理に必要なタスクのほとんどを実行できるブラウザベースのツールを提供します。
Edge Analytics のオンプレミス環境では、次のコンポーネントが提供されます。
- Qpid Server は、分析データのキューイング システムを管理します。
- Postgres Server は PostgreSQL 分析データベースを管理します。
次の図は、Apigee Edge コンポーネント間のやり取りを示しています。
