Edge for Private Cloud v4.18.05
最新情報
4.18.05 - Edge for Private Cloud リリースノートをご覧ください。
Apigee コミュニティにアクセスする
Apigee コミュニティは、Apigee に関する質問、ヒント、その他の問題について Apigee のスタッフや他の Apigee ユーザーに問い合わせることや、情報交換を行える無料のリソースです。コミュニティに投稿する前に、既存の投稿を検索して同じ質問に対する回答がないかどうかご確認ください。
アーキテクチャの概要
Apigee Edge for Private Cloud をインストールする前に、Edge モジュールとソフトウェア コンポーネントの全体的な構成を理解する必要があります。
Apigee Edge for Private Cloud は、次のモジュールで構成されています。
- Apigee Edge Gateway（別名 API サービス）
- Apigee Edge Analytics
- Apigee Edge Developer Services ポータル
- Apigee Edge Monetization Services（別名 Developer Services Monetization）
次の図は、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 Edge Developer Services ポータル
Apigee Developer Services ポータル（略して「ポータル」）は、コンテンツとコミュニティ管理のためのテンプレート ポータルです。これは、オープンソースの Drupal プロジェクトをベースとしています。デフォルトの設定では、API ドキュメント、フォーラム、ブログを作成および管理できます。組み込みのテスト コンソールを使用すると、ポータル内から API をリアルタイムでテストできます。
ポータルには、コンテンツ管理以外にも、手動/自動ユーザー登録やユーザー コメントの管理など、コミュニティ管理のためのさまざまな機能があります。ロールベース アクセス制御（RBAC）モデルは、ポータルの機能へのアクセスを制御します。たとえば、登録ユーザーにフォーラム投稿の作成やテスト コンソールの使用などを許可するコントロールを有効にできます。
Apigee Edge for Private Cloud のデプロイ スクリプトには、ポータルのデプロイ機能は含まれません。オンプレミスでのポータル デプロイは、オンプレミス固有のインストール スクリプトによってサポートされます。ポータルをインストールして構成する場合は、Apigee Edge サポートにお問い合わせください。
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 管理サーバー
- 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 トラフィックを処理し、リクエストを処理する 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 コンポーネント間のやり取りを示しています。
