組織をオンボーディングするには、オンボーディング構成ファイルを作成して渡す必要があります。
setup-org
コマンドに追加します。これらの各ステップについては、
できます。
Management API を使用して組織のオンボーディングを行う方法については、以下をご覧ください。 組織の作成、 環境、仮想ホスト。
オンボーディング構成ファイルを作成する
このセクションでは、Google Cloud で組織をオンボーディングするためのサンプル構成ファイルを示します。
setup-org
。
次の例をコピーし、ご自身の組織に合わせて編集してください。
IP1=192.168.1.1 # Specify the IP or DNS name of the Management Server. MSIP="$IP1" # Specify the Edge sys admin credentials. ADMIN_EMAIL="admin@email.com" APIGEE_ADMINPW=admin_password # If omitted, you are prompted for it. # Specify organization name. ORG_NAME=myorg # lowercase only, no spaces, underscores, or periods. # Specify the organization administrator user. # Either specify an existing user, or specify the information # necessary to create a new user. # Do not use the sys admin as the organization administrator. # # Create a new user for the organization administrator. NEW_USER="y" # New user information if NEW_USER="y". USER_NAME=new@user.com FIRST_NAME=new LAST_NAME=user # Org admin password must be at least 8 characters long and contain one uppercase # letter, one lowercase letter, and one digit or special character USER_PWD="newUserPword" ORG_ADMIN=new@user.com # # Or, specify an existing user as the organization admin, # omit USER_NAME, FIRST_NAME, LAST_NAME, USER_PWD. # NEW_USER="n" # ORG_ADMIN=existing@user.com # Specify environment name. ENV_NAME=prod # lowercase only # Specify virtual host information. VHOST_PORT=9001 VHOST_NAME=default # If you have a DNS entry for the virtual host. VHOST_ALIAS=myorg-test.apigee.net # If you do not have a DNS entry for the virtual host, # specify the IP and port of each router as a space-separated list: # VHOST_ALIAS="firstRouterIP:9001 secondRouterIP:9001" # Optionally configure TLS/SSL for virtual host. # VHOST_SSL=y # Set to "y" to enable TLS/SSL on the virtual host. # KEYSTORE_JAR= # JAR file containing the cert and private key. # KEYSTORE_NAME= # Name of the keystore. # KEYSTORE_ALIAS= # The key alias. # KEY_PASSWORD= # The key password, if it has one. # Specify the analytics group. # AXGROUP=axgroup-001 # Default name is axgroup-001.
注:
VHOST_ALIAS
の場合: 仮想ホストへのアクセスに使用する DNS レコードがすでにある場合は、 エイリアスとポート(省略可能)です(例: myapi.example.com)。まだ DNS がない場合 Router の IP アドレスを使用できます。
仮想ホストの構成方法の詳細については、 仮想ホストを作成するをご覧ください。
- TLS/SSL 構成については、キーストアと トラストストアと構成 「Private Cloud の API への TLS アクセス」をご覧ください。 その他の側面について説明します。
- 仮想ホストの構成の詳細については、外部 IP アドレスへの TLS アクセスの構成 プライベート クラウド用の API をご覧ください。
- 同じ名前の組織を 2 つ作成することはできません。その場合、2 番目の作成で 失敗します。
setup-org を実行する
オンボーディング構成ファイルを作成したら、setup-org
に渡します。
スクリプトを使用してオンボーディング プロセスを実行します。このスクリプトは Management Server で実行する必要があります。
あります。
組織をオンボーディングする際に、setup-org
スクリプトは次の処理を行います。
- 新しい組織を作成する。
- 環境を作成する。
- 環境の仮想ホストを作成します。
- 指定したユーザーを組織管理者として設定します。次のことに注意してください。
<ph type="x-smartling-placeholder">
- </ph>
- 既存のユーザーを使用することも、組織管理者用に新しいユーザーを作成することもできます。
- 組織管理者は、システム管理者と同じにすることはできません。
- 組織を「ゲートウェイ」に関連付ける作成します。(これはデフォルトであり、 changed.)
- 環境をすべての Message Processor に関連付けます。
- 分析を可能にする。
setup-org
を実行するには:
- Management Server ノードに
apigee-provision
をインストールします。/opt/apigee/apigee-service/bin/apigee-service apigee-provision install
- Management Server ノードで
setup-org
スクリプトを実行し、 オンボーディング構成を作成する ファイル:/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
構成ファイルは「apigee」から読み取り可能である必要があります。できます。
- 組織のオンボーディングが正常に完了したことを確認します。これを行う方法の 1 つは、
UI に組み込むには、ブラウザで次の URL をリクエストします。
http://IP_address:9000/login
ここで、IP_address は Edge をインストールしたサーバーの IP アドレスです。 UI です。
その他の確認手順については、オンボーディングの確認をご覧ください。
- 最初のプロキシを作成します。
オンボーディングを確認する
オンボーディングが完了したら、以下のコマンドを発行してシステムのステータスを確認します。
Management Server ノードに対する curl
コマンド:
- 次のコマンドを実行して、Management Server でユーザーと組織のステータスを確認します。
コマンド:
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/org_name/deployments
- 次のコマンドを実行して、分析を確認します。
curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus
- ノード 2 で次のコマンドを実行して、PostgreSQL データベースのステータスを確認します。
(インストール トポロジをご覧ください)。
psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee
コマンド プロンプトで次のコマンドを入力して、分析テーブルを表示します。 組織:
\d analytics."org_name.env_name.fact"
psql を終了するには、次のコマンドを使用します。
\q
- ウェブブラウザを使用して Apigee Edge UI にアクセスします。なお、
管理コンソールの URL に表示されます。
- 任意のブラウザを起動し、Edge UI の URL を入力します。画面は、
ここで、IP アドレスはノード 1 用です(
インストール トポロジ)
接続先のノードに
代替構成用の UI をインストールしました。
http://192.168.56.111:9000/login
9000 は UI で使用されるポート番号です。
Edge UI をホストするサーバー上でブラウザを直接起動する場合は、 次の形式の URL を使用できます。
http://localhost:9000/login
- コンソールのログインページで、Apigee システム管理者のユーザー名/パスワードを指定します。
- 任意のブラウザを起動し、Edge UI の URL を入力します。画面は、
ここで、IP アドレスはノード 1 用です(
インストール トポロジ)
接続先のノードに
代替構成用の UI をインストールしました。
- 新しい Apigee ユーザー アカウントを登録し、新しいユーザー認証情報を使用してログインします。
[ログイン] ボタンをクリックします。
ブラウザが
http://192.168.56.111:9000/platform/#/org_name/
にリダイレクトする すると、作成した組織を設定できるダッシュボードが開きます( (例: Apigee 管理者認証情報を使用する場合)
最初のプロキシを作成する
新しい組織をオンボーディングし、オンボーディング プロセスが 最初のプロキシを作成できます。詳細については、初めての API プロキシの構築をご覧ください。
他にも役に立つリソースがあります。