組織、環境、仮想ホストの作成

Edge for Private Cloud v. 4.16.05

組織の作成、 環境と仮想ホストを同時に使用できます。

Apigee Edge で API プロキシを作成する前に、少なくとも 1 つの組織を作成し、 内部 IP アドレスを使用して通信できます

通常、組織と環境は一緒に作成されます。プロセスを簡素化するために、 apigee-provision ユーティリティを使用してプロビジョニングされます。 このコマンドは、Edge Management Server のコマンドラインから呼び出します。

> /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

構成ファイルには次のものが含まれます。

APIGEE_ADMINPW=adminPword     # If omitted, you are prompted for it.
NEW_USER="y"
USER_NAME=orgAdmin@myCo.com
FIRST_NAME=foo
LAST_NAME=bar
USER_PWD="userPwrod"
ORG_NAME=example  # lowercase only, no spaces, underscores, or periods.
ENV_NAME=prod
VHOST_PORT=9001
VHOST_NAME=default
VHOST_ALIAS="$IP1: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. 
# AXGROUP=axgroup-001 # Default value is axgroup-001

このコマンドは次の処理を行います。

  • 組織を作成する
    注: 組織を作成した後にその名前を変更することはできません。
  • 組織を Pod に関連付ける（デフォルトでは「gateway」に関連付け） チーム
  • 指定したユーザーを組織管理者として追加します。ユーザーが存在しない場合は、ユーザーを 1 です。
  • 1 つ以上の環境を作成する
  • 環境ごとに 1 つ以上の仮想ホストを作成する
  • 環境をすべての Message Processor に関連付ける
  • アナリティクスを有効にする

サイレント構成ファイルの詳細については、Google Compute Engine の できます。

デフォルトでは、組織名と環境名の最大長は 20 文字です。 apigee-provision を使用する場合 ユーティリティですEdge API を直接使用して組織を作成する場合や、 できます。

組織を作成する

create-org コマンドを使用して組織を作成します。

> /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-provision create-org -f configFile

このスクリプトは組織を作成しますが、環境の追加や構成は行いません。 組織が API 呼び出しを処理するために必要な仮想ホスト。

構成ファイルには、組織名と組織管理者のメールアドレスが含まれています。「 name 属性に使用できる文字は、a-z0-9\-$% のみです。スペースは使用しないでください。 ピリオドまたは大文字を名前に使用できない場合:

APIGEE_ADMINPW=adminPword    # If omitted, you are prompted for it.
ORG_NAME=example  # lowercase only, no spaces, underscores, or periods.
ORG_ADMIN=orgAdmin@myCo.com

このコマンドは次の処理を行います。

  • 組織を作成する
  • 組織をポッドに関連付けます。デフォルトでは、ポッドを「ゲートウェイ」に関連付けます。 チーム
  • 指定したユーザーを組織管理者として追加します。このユーザーはすでに存在している必要があります。それ以外の場合、スクリプトは エラーが発生します。
で確認できます。 
<Error>
    <Code>organizations.OrganizationAlreadyExists</Code>
    <Message>Organization : test already exists</Message>
    <Contexts/>
</Error>

以下を使用して組織を作成する API 呼び出し

または、次の API 呼び出しを使用して組織を作成することもできます。最初の呼び出しでは、 組織:

curl -H "Content-Type:application/xml<" -u sys>A<dminEmail:a>dminPasswd \
-X PO<ST ht>tp://ms-ip:8080/v1/organizati<ons \
-d 'Organ<ization >name="org>-name" type="paid"/'

次の呼び出しで、組織を Pod に関連付けます。

curl -H "Content-Type:application/x-www-form-urlencoded&q<uot; \
-u sys>A<dminEmail:a>dminPasswd -X POST< \
ht>tp://ms-ip:8080/v1/orga<nization>s/org-name/pods \
-d "&;region=defaultpod=gateway"

この呼び出しを複数回行うと、組織を複数の 構成されます。

最後の呼び出しでは、既存のユーザーを組織の組織管理者として追加します。

curl -H "Content-Type:application/xml<" -u sys>A<dminEmail:a>dminPasswd \
-X POST< \
ht>tp://ms-ip:8080/v1/orga<nization>s/org-n<ame/users/>user-email/userrol<es/ \><
-d 'RolesRole na><me=&qu>ot;orgadmin"//Roles'

ユーザーが存在しない場合は、前述の手順に沿って次の呼び出しを使用してユーザーを作成できます。 ユーザーを追加しています。

環境の作成

add-env コマンドを使用して 既存の組織に環境を作成するには:

> /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-provision add-env -f configFile

この構成ファイルには、環境と仮想環境を作成するために必要な情報が含まれています。 host:

APIGEE_ADMINPW=adminPword    # If omitted, you are prompted for it.
ORG_NAME=example  # lowercase only, no spaces, underscores, or periods.
ENV_NAME=prod
VHOST_PORT=9001
VHOST_NAME=default
VHOST_ALIAS="$IP1: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. 
# AXGROUP=axgroup-001 # Default value is axgroup-001

コマンド:

  • 環境を作成する
  • 環境に単一の仮想ホストを作成する
  • 環境に関連付けられた Pod 内のすべての Message Processor に環境を関連付けます。 その環境を含む組織です。
  • 分析を有効にする
    注: 組織内の 1 つの環境に対して Analytics を有効にする場合は、 分析を組織内のすべての環境で有効にできます。

以下を使用して環境を作成する API 呼び出し

または、次の API 呼び出しを使用して環境を作成することもできます。最初の呼び出し 環境を作成します。

curl -H "Content-Type:application/xml<" -u sys>A<dminEmail:a>dminPasswd \
-X PO<ST ht>tp://ms-ip:8080/v1/orga<nization>s/org-name/environmen<ts \
-d  'Envi<ronment >na>me="env-name"/'

次の呼び出しで、環境を Message Processor に関連付けます。この呼び出しは、各ユーザーに対する 環境に関連付ける Message Processor:

curl -H "Content-Type:application/x-www-form-urlencoded&q<uot; \
-u sys>A<dminEmail:a>dminPasswd -X POST< \
ht>tp://ms-ip:8080/v1/orga<nization>s/org-name/env<ironment>s/env-name/servers \
-d &&quot;<acti>on=adduuid=uuid"

「&lt;uuid&gt;」はどこにあるかは Message Processor の UUID。UUID は、次のコマンドで取得できます。

> curl http://<mp-ip>:8082/v1/servers/self

「&lt;mp-ip&gt;」の部分は Message Processor の IP アドレス。

次の API 呼び出しでは、特定の環境でアナリティクスを有効にします。コンテナ イメージの すべてのデータセンターの Pod 内の Qpid サーバーと Postgres サーバー。その後、アナリティクスのオンボーディングが 固有の組織と環境に対する権限が含まれます。

> /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-provision enable-ax -f configFile

この構成ファイルには以下が含まれます。

ORG_NAME=orgName  # lowercase only, no spaces, underscores, or periods.
ENV_NAME=envName
 
curl -H "Content-Type:application/json<" -u sys>A<dminEmail:a>dminPasswd 
-X PO<ST ht>tp://ms-ip:8080/v1/orga<nization>s/org-name/env<ironment>s/env-name/analytics/admin -d "@sample.json"

sample.json に以下の内容が含まれる。 アナリティクスのオンボーディングに エントリが追加されましたJSON ファイルを取得するには、Apigee サポートにお問い合わせください。

仮想ホストを作成する

組織内の既存の環境に仮想ホストを作成できます。多くの場合、 複数の仮想ホストをサポートします。たとえば、1 つの仮想ホストで HTTP 同じ環境内の別の仮想ホストでは暗号化された HTTPS ポートを 構成されます。

次の API 呼び出しを使用して、追加の仮想ホストを作成するか、または VM 用の仮想ホストを作成します。 仮想ホストのない環境の場合:

curl -H "Content-Type:application/xml<" -u sys>A<dminEmail:a>dminPasswd \
-X POST< \
ht>tp://ms-ip:8080/v1/orga<nization>s/org-name/env<ironment>s/env-name/virtualho<sts \
-d 'VirtualHost >name=&q<uot;default>" \
<    HostA>liases \
      HostAl<iasmyorg-t>est.apig<ee.net/HostA>lias \ <
    /HostA>liases <\
  >  I<nterf>aces/< \
    Port4>43/Port \
  /VirtualHost'

安全な仮想ホストの作成など、仮想ホストの作成方法の詳細を HTTPS で TLS/SSL を使用するホストについては、http://apigee.com/docs/api-services/content/creating-virtual-host をご覧ください。