組織のオンボーディング

Edge for Private Cloud v. 4.17.05

setup-org コマンドを使用して オンボーディングプロセスを実施しますこのコマンドは Management Server ノードで実行する必要があります。

オンボーディング プロセスの一環として、スクリプトは次のことを行います。

• 組織を作成する。
• 指定したユーザーを組織管理者として設定します。
  • このユーザーは、システム管理者ユーザーとは異なる必要があります。つまり、sys Admin を使用して 付与します。
  • 組織管理者の既存のユーザーを指定することも、次のようにスクリプトを構成することもできます。 新しいユーザーを作成します
• 組織をポッドに関連付けます。デフォルトでは、ポッドを「ゲートウェイ」に関連付けます。 作成します。
• 環境を作成してください。
• 環境の仮想ホストを作成します。
• 環境をすべての Message Processor に関連付ける。
• 分析を可能にする。

オンボーディング用の構成ファイル

setup-org コマンドに構成ファイルを渡します。setup-org コマンドを呼び出し、-f オプションを指定する。 サイレント構成ファイルのパスを含めます。

> /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

サイレント インストールの唯一の要件は、構成ファイルにアクセスできる必要があります。 「apigee」によって読み取られできます。

サイレント構成ファイルの例を以下に示します。必要に応じて編集してください。 要件:

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=adminPassword     # 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
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

# 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 構成については、キーストアと トラストストアとサービス アカウントに対する TLS アクセスの構成 の API を確認する」を参照してください。 詳しく学びました。
• 仮想ホストの構成の詳細については、外部 IP アドレスへの TLS アクセスの構成 プライベート クラウド用の API をご覧ください。

オンボーディングの手順

1. apigee-provision をインストールする Management Server ノード:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
2. Management Server ノードで次のコマンドを実行します。
   > /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
   
   構成ファイルにアクセスできる必要がある 「apigee」によって読み取られできます。

オンボーディングの確認

オンボーディングが完了したら、次の CURL を発行してシステムのステータスを確認します。 Management Server ノードでこれらのコマンドを実行できます。

1. 次のコマンドを発行して、Management Server でユーザーと組織のステータスを確認します。 CURL コマンド:
   &gt;curl -u <adminEmail>:<管理者のパス>http://localhost:8080/v1/users
   &gt;curl -u <adminEmail>:<管理者パスワード>http://localhost:8080/v1/organizations
   &gt;curl -u <adminEmail>:<管理者パスワード> http://localhost:8080/v1/organizations/&lt;orgname&gt;/deployments
2. 分析を有効にした場合は、次のコマンドを使用します。
   &gt;curl -u <adminEmail>:<管理者のパス> http://localhost:8080/v1/organizations/&lt;orgname&gt;/environments/&lt;envname&gt;/provisioning/axstatus
3. PostgreSQL データベースのステータスを確認するには、 マシン 2 で psql を起動します。
   &gt;psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee
   
   コマンド プロンプトで次のコマンドを入力して、分析テーブルを表示します。 組織:
   apigee=# : \d analytics."<orgname>.prod.fact"
   
   psql を終了するには、次のコマンドを使用します。
   apigee=# \q
4. ウェブブラウザを使用して Apigee Edge ユーザー インターフェースにアクセスします。なお、 管理コンソール URL を入力します。
   1. 任意のブラウザを起動し、Edge UI の URL を入力します。画面は、 IP アドレスは、マシン 1 またはインストールしたマシンのものです。 代替構成の UI:
      http://192.168.56.111:9000/login
      
      9000 は UI で使用されるポート番号です。Google Chat で直接ブラウザを起動する場合、 サーバーの場合は、次の形式の URL を使用できます。
      http://localhost:9000/login
      
      注: ポート 9000 が開いていることを確認してください。
   2. コンソールのログインページで、Apigee システム管理者のユーザー名/パスワードを指定します。
      注: これは、すでに設定されているグローバル システム管理者パスワードです。 初期化されます。また、次の方法もあります。
5. 新しい Apigee ユーザー アカウントを登録し、新しいユーザー認証情報を使用してログインします。
   1. [ログイン] をクリックすると、ブラウザが
      にリダイレクトされます。 http://192.168.56.111:9000/platform/#/<orgname>/
      
      ダッシュボードが開きます。このダッシュボードでは、以前に作成した組織を （例: Apigee 管理者認証情報を使用してログインしている場合）
   2. Edge を初めて使用する場合は、最初の API プロキシを作成できます。詳しくは 最初の API プロキシの構築をご覧ください。
      
      サンプルリストや疑似ターゲットなどのサンプルに関するセクションもご覧ください。 Mock Target API で独自の API 構築テストに使用できる RESTful API。