インスタンス・グループを使用したインスタンスの一括プロビジョン

IBM Cloudコマンドラインインタフェースを使用してインスタンスグループを作成すると、同時に多数の仮想サーバーインスタンスをプロビジョニングできます。

開始前に

  1. IBM Cloud® CLI 環境 と IBM Cloud VPC のセットアップが完了していることを確認してください。
  2. インスタンス・グループ・リソースを作成するために必要な IBM Cloud Identity and Access Management (IAM) 権限が付与されていることを確認します。 詳細については、VPC インフラストラクチャ サービスの IAM アクセスの管理。
  3. グループ内の同じようなインスタンスのプロビジョニングに使用されるインスタンス詳細で、インスタンス・テンプレート を作成したことを確認してください。

インスタンス・グループの作成

インスタンス・テンプレートを作成したら、インスタンス・グループの作成に進みます。 インスタンス・グループを作成するときには、メンバーシップ数として 0 から 1000 までを指定できます。 このメンバーシップ数によって、インスタンス・グループでプロビジョンされるインスタンスの数が決まります。

ロード・バランサーを含めてインスタンス・グループのインスタンス間に着信要求を分散させる場合は、インスタンス・グループを作成する前に、ロード・バランサーを作成しておく必要があります。 詳しくは、アプリケーション・ロード・バランサーについてを参照してください。 ロード・バランサーをインスタンス・グループに関連付ける場合は、メンバーシップ数が 50 に制限されます。

ibmcloud is instance-group-create を実行する前に、以下の情報を収集してください。

必要なインスタンスグループの詳細
インスタンス・グループの詳細 説明
インスタンス・テンプレート 使用するインスタンス・テンプレートの ID。 ibmcloud is instance-templates コマンドを使用してテンプレートをリスト表示できます。
Subnets Comma-separated IDs of subnets that you want to use from the ibmcloud is subnets command.
メンバーシップ数 インスタンス・グループ内でプロビジョンするインスタンスの数。

これらの値を集めたら、それを使って instance-group-create コマンドを実行する。 さらに、インスタンス・グループの名前を指定する必要があります。

ibmcloud is instance-group-create INSTANCE_GROUP_NAME --instance-template INSTANCE_TEMPLATE --subnets SUBNETS [--membership-count MEMBERSHIP_COUNT] [--lb LB --lb-pool LB_POOL --application-port APPLICATION_PORT] [--vpc VPC] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

例えば、インスタンス・テンプレートIDが_0738-c3809e5b-8d48-4629-b258-33d5b14fa84f_で、メンバーが_100_人の_my-instance-group_というインスタンス・グループを作成する場合、instance-group-create コマンドは以下のサンプルのようになります。

ibmcloud is instance-group-create my-instance-group --instance-template 0738-c3809e5b-8d48-4629-b258-33d5b14fa84f --subnets 0076-2249dabc-8c71-4a54-bxy7-953701ca3999,0767-173bn4aa-060b-47e7-am45-b3395a593897 --membership-count 100

ここで、

  • INSTANCE_GROUP_NAME は my-instance-group
  • INSTANCE_TEMPLATE は 0738-c3809e5b-8d48-4629-b258-33d5b14fa84f
  • SUBNETS は 0076-2249dabc-8c71-4a54-bxy7-953701ca3999 および 0767-173bn4aa-060b-47e7-am45-b3395a593897
  • MEMBERSHIP_COUNT is 100

この例では、コマンド・レスポンスは以下のようになる。

ID                  r006-4f7d0010-33f5-40bf-9f21-ab5bee04fd71
Name                my-instance-group
Status              healthy
Instances           100
Instance Template   0738-c3809e5b-8d48-4629-b258-33d5b14fa84f
Subnets             Name       Subnet ID
                    subnet-1   0076-2249dabc-8c71-4a54-bxy7-953701ca3999
                    subnet-2   0767-173bn4aa-060b-47e7-am45-b3395a593897

Resource group      ID                                 Name
                    11caaa983d9c4beb82690daab08717e9   Default

ibmcloud is instance-group-create コマンドの他の例については、VPC の CLI リファレンスを参照してください。

さらに詳しい情報が必要な場合は、 ibmcloud is instance-group-create --help を実行すると、インスタンス・グループの作成に関するヘルプが表示されます。

次のステップ

必要なインスタンス数を指定してインスタンス・グループを作成したら、以下のコマンドを使用して、インスタンス・グループとそのグループのインスタンス・メンバーシップを管理できます。

インスタンスグループを管理するためのCLIコマンド
インスタンス・グループのコマンド 説明
ibmcloud is instance-group-update インスタンス・グループを更新します。
ibmcloud is instance-group-delete インスタンス・グループを削除します。
ibmcloud is instance-group-membership インスタンス・グループのメンバーの詳細を表示します。
ibmcloud is instance-group-membership-delete インスタンス・グループのメンバーシップを削除します。
ibmcloud is instance-group-memberships インスタンス・グループのすべてのメンバーをリスト表示します。
ibmcloud is instance-group-memberships-delete インスタンス・グループのすべてのメンバーシップを削除します。

オプションで、インスタンス・グループにオートスケール・ポリシーを設定して、グループの仮想サーバー・インスタンスを動的に追加/削除することができます。 詳しくは、オートスケールのためのインスタンス・グループの作成 を参照してください。