Edge for Private Cloud v4.19.01
新機能
4.19.01 - Edge for Private Cloud リリースノートをご覧ください。
Apigee コミュニティの利用
Apigee コミュニティは、Apigee だけでなく他の Apigee ユーザーにも質問、ヒント、その他の問題について問い合わせることができる無料のリソースです。コミュニティに投稿する前に、既存の投稿を検索して、同じ質問に対する回答がないかどうか確認してください。
アーキテクチャの概要
Apigee Edge for Private Cloud をインストールする前に、Edge のモジュールとソフトウェア コンポーネントの全体的な構成を十分に理解してください。
Apigee Edge for Private は、次のモジュールで構成されています。
- Apigee Edge Gateway（別名 API Services）
- Apigee Edge Analytics
- Apigee Edge Developer Services ポータル
- Apigee Edge Monetization Services（別名 Developer Services Monetization）
次の図に、Apigee 内でさまざまなモジュールが相互にやり取りする仕組みを示します。
次の動画で、Apigee Edge の On Premises バージョンと Cloud バージョンを比較しています。
Apigee Edge Gateway
Edge Gateway は Apigee Edge のコアモジュールであり、API を管理するメインのツールです。Gateway UI には API を追加して構成するためのツール、リソースのバンドルを設定するためのツール、デベロッパーとアプリを管理するためのツールが用意されています。Gateway によって、管理に関する多くの一般的な考慮事項がバックエンド API で不要になります。API を追加する際に、セキュリティ、レート制限、メディエーション、キャッシングやその他の制御に関するポリシーを適用できます。さらに、カスタム スクリプトを適用したり、サードパーティ API を呼び出したりするなどして、API の動作をカスタマイズすることも可能です。
ソフトウェア コンポーネント
Edge Gateway は、次の主要なコンポーネントで構成されています。
- Edge Management Server
- Apache ZooKeeper
- Apache Cassandra
- Edge Router
- 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 では、データが分析サーバーによってバックグラウンドで管理されます。データ集計ツールを使用して、各種の組み込みレポートやカスタム レポートを作成できます。
ソフトウェア コンポーネント
Edge Analytics は次のコンポーネントで構成されています。
- Qpid。次のコンポーネントで構成されています。
- Apache Qpid メッセージング システム
- Apigee Qpid Server サービス（Apache Qpid を管理するために使用する Apigee の Java サービス）
- Postgres。次のコンポーネントで構成されています。
- PostgreSQL データベース
- Apigee Postgres Server サービス（PostgreSQL データベースを管理するために使用する Apigee の Java サービス）
Apigee Edge Developer Services ポータル
Apigee Developer Services ポータル（略して「ポータル」）は、コンテンツおよびコミュニティを管理するテンプレート ポータルです。そのベースとなっているのはオープンソースの Drupal プロジェクトです。デフォルトの設定で、API ドキュメント、フォーラム、ブログの作成と管理を行うことができます。組み込みのテスト コンソールを使用して、ポータル内からリアルタイムで API をテストできます。
ポータルにはコンテンツ管理のほかに、手動 / 自動ユーザー登録、ユーザー コメントのモデレートをはじめとする各種のコミュニティ管理機能もあります。ポータル上の機能へのアクセスは、ロールベースのアクセス制御（RBAC）モデルで制御されます。たとえば、登録済みユーザーにフォーラム投稿の作成、テスト コンソールの使用などを許可するアクセス制御を有効にできます。
Apigee Edge for Private Cloud のデプロイ スクリプトでは、ポータルはデプロイされません。オンプレミスでのポータル デプロイは、オンプレミス固有のインストール スクリプトによってサポートされます。ポータルをインストールして構成する場合は、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 パッケージのパフォーマンスを管理およびモニタリングして状況に応じて対応できるよう、制限を設定することもできます。さらに、設定した制限に近づきつつある場合、または制限に達した場合の自動通知を設定することもできます。
Monetization Services の機能
Edge Monetization Services の主要な機能は、次のとおりです。
- API プラットフォームに完全に統合されます。つまり、処理はリアルタイムです。
- 単純な有料プランから、とりわけ複雑な課金 / 収益分配プランまで、あらゆるビジネスモデルを柔軟にサポートします（簡単にプランを作成、変更できます）。
- トランザクションごとのボリュームまたはカスタム属性に基づいてトランザクションを評価します。トランザクションで Gateway だけでなく他のシステム（Apigee Edge 外部のシステム）の API が使用されていても対応できます。
- パフォーマンスをモニタリングしてプロセスを管理するための制限や通知などのツールが自動化されています。
- デベロッパー / パートナーのワークフローと制御が統合されるため、課金 / 決済を通じて購入を管理できます。
- ビジネス ユーザーとデベロッパー / パートナー向けの完全なセルフサービスのため、費用のかかる技術を導入する必要はありません。
- バックエンドのあらゆる販売、会計、ERP システムに統合できます。
ソフトウェア コンポーネント
Edge Monetization Services は、次の主要なコンポーネントをベースとしています。
- Edge Management Server
- Edge Message Processor
Edge UI を使用して Monetization Services の使用を開始する方法について詳しくは、収益化の使用開始をご覧ください。
オンプレミスのデプロイ
オンプレミスにインストールされた Apigee Edge for Private Cloud のコア（Gateway および Analytics）は、オンプレミス クライアントのユーザーに代わって API トラフィックを実行するために必要なインフラストラクチャを提供します。
次の動画で、Apigee Edge for Private Cloud のデプロイモデルを紹介しています。
S26E01: デプロイモデルの紹介
S26E04: デプロイ アーキテクチャ
Edge Gateway のオンプレミス インストールによって、次のコンポーネントが提供されます（ただし、これらに限りません）。
- Router。ロードバランサからの受信 API トラフィックのすべてを処理するコンポーネントです。Router はリクエストを処理する 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。以上のコンポーネントを 1 つにまとめるコンポーネントです。Management Server は Edge Management API リクエストのエンドポイントであり、Edge UI とやり取りします。
- UI。API プロキシ、API プロダクト、アプリ、ユーザーを作成、構成、管理するために必要なタスクのほとんどを実行できる、ブラウザベースのツールを提供します。
Edge Analytics のオンプレミス インストールによって、次のコンポーネントが提供されます。
- Qpid Server。分析データのキューイング システムを管理します。
- Postgres Server。PostgreSQL 分析データベースを管理します。
次の図に、Apigee Edge コンポーネントが相互にやり取りする仕組みを示します。
メンテナンスと費用
次の動画で、Apigee Edge On Premises（すなわち、Apigee Edge for Private Cloud）にかかる費用、および Apigee Edge for Cloud の代わりに Apigee Edge On Premises の利用を決定する前に、よくご検討する必要がある内容について説明しています。