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

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

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

ユーザー、組織、環境のステータスを検査する

Management Server は、Edge Private Cloud のオンプレミス環境で他のすべてのコンポーネントを結び付けるうえで重要な役割を果たします。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 ステータスが表示されるはずです。そうでない場合は、次の手順に従います。

/opt/apigee/var/log/apigee/management-server にある Management Server のログを調べて、エラーが出力されていないか確認します。
Management Server を呼び出して、正常に機能しているかどうか検査します。
ELB から Management Server を削除した後、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 ヘッダーと使用可能なホストエイリアスのリストとを比較します。仮想ホストを介してリクエストを発行する場合は、仮想ホストのホストエイリアスに一致するドメイン名を指定するか、Router の IP アドレスと、ホストエイリアスを含む Host ヘッダーを指定します。

たとえば、myapis.apigee.net というエイリアスを持つ仮想ホストをポート 9001 に作成した場合、その仮想ホストを介した 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 ヘッダーでホストエイリアスを渡します。
注: curl コマンド、大部分のブラウザ、その他多くのユーティリティでは、ドメインを含む Host ヘッダーがリクエストの一部として自動的に追加されるので、実際には次の形式の curl コマンドを使用できます。
```
curl http://routerIP:9001/proxy-base-path/resource-path
```

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

DNS エントリがない場合の 1 つの方法は、ホストエイリアスを、Router の IP アドレスと仮想ホストのポートを組み合わせた routerIP:port の形式で設定することです。例:

192.168.1.31:9001

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

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

この方法は Edge UI で適切に機能するので、推奨されるオプションです。

複数の Router がある場合は Router ごとにホストエイリアスを 1 つずつ追加します。その際、各 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