組織と環境のメンテナンス

このセクションでは、Apigee Edge for Private Cloud のインストールにおける Apigee 組織、環境、仮想ホストの作成、管理、削除など、さまざまな管理オペレーションについて説明します。

組織、環境、仮想ホストの概要については、プラネット、リージョン、ポッド、組織、環境、仮想ホストについてをご覧ください。

ユーザー、組織、環境のステータスの確認

Management Server は、Edge プライベート クラウドのオンプレミス インストールで他のすべてのコンポーネントをまとめる重要な役割を果たします。Management Server でユーザー、組織、デプロイのステータスを確認するには、次の curl コマンドを実行します。

curl -u adminEmail:admin_passwd http://localhost:8080/v1/users
curl -u adminEmail:admin_passwd http://localhost:8080/v1/organizations
curl -u adminEmail;:admin_passwd http://localhost:8080/v1/organizations/orgname/deployments

すべての呼び出しに対して 200 HTTP ステータスが表示されます。これらの方法で解決しない場合は、次の手順を行います。

1. /opt/apigee/var/log/apigee/management-server の Management Server ログでエラーを確認します。
2. Management Server に対して呼び出しを行い、正常に機能しているかどうかを確認します。
3. ELB からサーバーを削除し、Management Server を再起動します。

   /opt/apigee/bin/apigee-service management-server restart

構成ファイルの使用について

以下のコマンドは、構成ファイルを入力として受け取ります。たとえば、setup-org コマンドに構成ファイルを渡して、環境や仮想ホストなど、組織のすべてのプロパティを定義します。

完全な構成ファイルと、構成ファイルで設定できるプロパティの詳細については、組織をオンボーディングするをご覧ください。

仮想ホストの設定について

Edge の仮想ホストは、API プロキシが公開されるドメインと Edge Router ポートを定義します。さらに、拡張機能により、アプリが API プロキシへのアクセスに使用する URL も定義されます。仮想ホストは、API プロキシへのアクセスに HTTP プロトコルを使用するか、暗号化された HTTPS プロトコルを使用するかも定義します。

以下に示すスクリプトと API 呼び出しを使用して、仮想ホストを作成します。仮想ホストを作成するときに、次の情報を指定する必要があります。

• API プロキシで参照するために使用する仮想ホストの名前。
• 仮想ホストの Router のポート。通常、これらのポートは 9001 から始まり、新しい仮想ホストごとに 1 ずつ増加します。
• 仮想ホストのホスト エイリアス。通常は仮想ホストの DNS 名です。

  Edge Router は、リクエストを処理する API プロキシを特定する際に、受信リクエストの Host ヘッダーをホスト エイリアスのリストと比較します。仮想ホストを介してリクエストを行う場合は、仮想ホストのホスト エイリアスに一致するドメイン名を指定するか、ルーターの IP アドレスとホスト エイリアスを含む Host ヘッダーを指定します。

たとえば、ポート 9001 にホスト エイリアス myapis.apigee.net を持つ仮想ホストを作成した場合、その仮想ホストを介して API に curl リクエストを実行するには、次のいずれかの形式を使用します。

• myapis.apigee.net の DNS エントリがある場合:

  curl http://myapis.apigee.net:9001/proxy-base-path/resource-path

• myapis.apigee.net の DNS エントリがない場合:

  curl http://routerIP:9001/proxy-base-path/resource-path -H 'Host: myapis.apigee.net'

  2 番目の形式では、Router の IP アドレスを指定し、Host ヘッダーでホスト エイリアスを渡します。

仮想ホストの DNS エントリがない場合のオプション

DNS エントリがない場合の 1 つのオプションは、ホスト エイリアスに routerIP:port の形式で Router の IP アドレスと仮想ホストのポートを設定することです。次に例を示します。

192.168.1.31:9001

次に、以下の形式で curl コマンドを作成します。

curl http://routerIP:9001/proxy-base-path/resource-path

このオプションは Edge UI と連携するため、推奨されます。

複数の Router がある場合は、Router ごとにホスト エイリアスを追加し、各 Router の IP アドレスと仮想ホストのポートを指定します。

または、ホスト エイリアスを temp.hostalias.com などの値に設定することもできます。この場合、すべてのリクエストで Host ヘッダーを渡す必要があります。

curl -v http://routerIP:9001/proxy-base-path/resource-path -H 'Host: temp.hostalias.com'

または、ホスト エイリアスを /etc/hosts ファイルに追加します。たとえば、/etc/hosts に次の行を追加します。

192.168.1.31   temp.hostalias.com

次に、DNS エントリがあるかのようにリクエストを送信します。

curl -v http://myapis.apigee.net:9001/proxy-base-path/resource-path