インスタンス・プールを作成する

Compute Cloud@Customerでは、同じリージョン内のインスタンスのインスタンス・プールを作成できます。

プール・オブジェクトに対してリセットまたは削除などの操作を実行すると、プールのメンバーであるすべてのインスタンスに対してその操作が実行されます。プールのメンバーである個々のインスタンスでこれらの操作を実行しても、他のメンバー・インスタンスには影響しません。

インスタンス・プールを作成するには、インスタンス構成および配置構成が必要です。プール更新でプールに追加されるインスタンスは、異なるインスタンスおよび配置構成で作成できます。

プール内のインスタンスの場合、インスタンス構成内のdisplayNameプロパティの値は無視されます。プール内のインスタンスの名前はinst-aaaaa-pool_nameで、aaaaaは5文字のランダム英数字です。

配置構成

インスタンス構成に加えて、プールの作成には配置構成が必要です。配置構成で指定された値は、インスタンス構成で指定された値をオーバーライドします。

配置構成では、フォルト・ドメイン、プライマリ・サブネットおよびセカンダリVNICサブネットを指定できます。

フォルト・ドメイン

インスタンス構成または配置構成でフォルト・ドメインを指定しない場合、プール・インスタンスに最適なフォルト・ドメインが自動的に選択されます。1つのフォルト・ドメインのみを指定した場合、すべてのインスタンスは、そのフォルト・ドメインにのみ配置されます。複数のフォルト・ドメインを指定すると、プール・インスタンスはそれらのフォルト・ドメインに均等に配置されるため、プールの高可用性が向上します。1つのフォルト・ドメインで追加のインスタンスに対応できない場合、インスタンスの作成は停止します。あるフォルト・ドメインに、別のフォルト・ドメインよりも多くのインスタンスは配置されません。

一部のインスタンスがリソース制約のために起動できない場合、それらのインスタンスはプロビジョニング状態のままになり、プールはスケーリング状態のままになります。sizeインスタンスの起動後、プールは「実行中」状態に遷移できます。プールが「スケーリング中」状態の間は、「実行中」状態のプール・インスタンスを使用できます。

次に、リソース制約のためにプール・インスタンスの起動に失敗した場合に実行できるアクションの例を示します。

プールを更新し、「インスタンス数」またはsize値を減らします。
プールを更新し、コンソールまたは新しいインスタンスまたは配置構成でフォルト・ドメイン仕様を変更します。
プールを更新して、より少ないリソースを必要とするインスタンスを作成する新しいインスタンス構成を指定します。
リソース制約のため、プール・インスタンスの起動に失敗している同じフォルト・ドメイン内のプールのメンバーではないインスタンスを停止します。
リソース制約のためにプール・インスタンスの起動に失敗している同じフォルト・ドメイン内のプールのメンバーではないインスタンスを削除します。

前提条件

インスタンス・プールを作成する前に、インスタンス構成が必要です。インスタンス構成は、インスタンスを作成する際に使用する設定を定義するテンプレートになります。インスタンス構成の作業を参照してください。

名前とタグに機密情報を入力しないでください。

1. 「Compute Cloud@Customerコンソール」ナビゲーション・メニューで、「コンピュート」、「インスタンス構成」の順に選択します。
2. ページの上部で、プールの作成に使用するインスタンス構成を含むコンパートメントを選択します。
3. このプール内のインスタンスに使用するインスタンス構成を選択します。
4. 「リソース」で、「アタッチされたインスタンス・プール」を選択します。
5. ページの上部で、他のコンパートメントを選択して、他のコンパートメントのプールをリストします。
  「インスタンス・プールの作成」を選択します。
6. 「インスタンス・プールをinstance_configuration_nameにアタッチ」ダイアログ・ボックスで、次の情報を入力します。
  
  名前: インスタンス・プールの名前を入力します。この名前は一意である必要はありません。この名前は、作成されたインスタンスの名前で使用されます。プールの名前を指定しない場合、インスタンス・プールのデフォルト名はinstancepoolYYYYMMDDhhmmssで、YYYYMMDDhhmmssは作成日時です。
  
  コンパートメントに作成: このインスタンス・プール定義のコンパートメントを選択しますプール内のインスタンスは、インスタンス構成で指定されたコンパートメントに作成されます。
  
  インスタンス数: このインスタンス・プールに作成するインスタンスの数を指定します。
  
  プール配置: このインスタンス・プール内のインスタンスのフォルト・ドメイン、VCNおよびサブネットを選択します。VCNおよびサブネットを選択する別のコンパートメントを選択できます。このセクションの最初にある配置構成とフォルトドメインの説明を参照してください。
  
  ロード・バランサ: 「ロード・バランサのアタッチ」ボックスを選択して、このプールのロード・バランシングを指定します。ロード・バランシングの詳細は、サービスとしてのロード・バランサを参照してください。次の情報を入力します:
  
  このプールにアタッチするロード・バランサを選択します。
  
  これらのプール・インスタンスを追加するバックエンド・セットを選択します。
  
  ロード・バランサがトラフィックの転送先となるインスタンスのポート番号を入力します。
  
  インスタンスをバックエンド・セットに追加するときに使用するVNICを選択します。プライベートIPアドレスが使用されます。
  
  別のロード・バランサをアタッチするには、「ロード・バランサの追加」を選択します。インスタンス・プールの作成後にロード・バランサをアタッチするには、インスタンス・プール・ロード・バランサ・アタッチメントの管理を参照してください。
  
  タグ付け: (オプション)このリソースに1つ以上のタグを追加します。タグは後で適用することもできます。リソースのタグ付けの詳細は、リソース作成時のタグの追加(OCIのIAM)を参照してください。
7. 「インスタンス・プールの作成」を選択します。
  
  新しいプールの詳細ページが表示されます。リクエストされたインスタンスは、作成時に「リソース」セクションの「アタッチされたインスタンス」表にリストされます。新しいインスタンスの名前はinst-aaaaa-pool_nameで、aaaaaは5文字のランダム英数字です。プールの名前を変更し、新しいインスタンスをプールに追加した場合、新しいインスタンスは新しい名前になります。
  
  「リソース」ボックスで「作業リクエスト」を選択して、インスタンス・プール作成のステータスを確認します。
インスタンス・プールを作成するには、oci compute-management instance-pool createコマンドおよび必要なパラメータを使用します。
oci compute-management instance-pool create --compartment-id <compartment_OCID> --instance-configuration-id <instance-configuration_OCID> --placement-configurations <placement_configurations.json> [OPTIONS]
CLIコマンド、フラグおよびオプションの完全なリストは、コマンドライン・リファレンスを参照してください。
プロシージャ

次の情報を取得してください。

インスタンス・プール定義を作成するコンパートメントのOCID: oci iam compartment list

プール内のインスタンスは、インスタンス構成で指定されたコンパートメントに作成されることに注意してください。

使用するインスタンス構成のOCID: oci compute-management instance-configuration list

インスタンス・プールのサイズです。これは、インスタンス・プールのコンピュート・インスタンスの数です。

このプールのロード・バランシングが必要な場合は、次の情報を取得します。

このプールにアタッチするロード・バランサのOCIDおよびこれらのプール・インスタンスを追加するバックエンド・セットの名前: oci lb load-balancer list

バックエンド・セットの作成時に使用するポート値。

ロード・バランサに関連付けるVNIC。値は、PrimaryVnic、またはインスタンス・プールに関連付けられたインスタンス構成上のセカンダリVNICのいずれかの表示名です。

--placement-configurationsオプションの引数を構築します。

このセクションの最初にある配置構成とフォルトドメインの説明を参照してください。

配置構成引数の内容を表示するには、次のコマンドを使用します。

$ oci compute-management instance-pool create --generate-param-json-input placement-configurations

このプールのロード・バランシングが必要な場合は、--load-balancersオプションの引数を作成します。

ロード・バランサ引数の内容を表示するには、次のコマンドを使用します。

$ oci compute-management instance-pool create --generate-param-json-input load-balancers

インスタンス・プールの作成後にロード・バランサをアタッチするには、インスタンス・プール・ロード・バランサ・アタッチメントの管理を参照してください。

インスタンス・プールのcreateコマンドを実行します。

構文:

oci compute-management instance-pool create -c compartment_OCID --instance-configuration-id instance_configuration_OCID --placement-configurations file://placement_configuration.json --size number_of_instances

例:

$ oci compute-management instance-pool create --compartment-id ocid1.compartment.unique_ID --display-name support-pool --instance-configuration-id ocid1.instanceConfiguration.unique_ID --placement-configurations file://./placement_configurations.json --load-balancers file://./load_balancers.json --size 10

--display-nameオプションの値は、プールの名前です。プール名は一意である必要はありません。--display-nameオプションの値を指定しない場合、インスタンス・プールのデフォルト名はinstancepoolYYYYMMDDhhmmssで、YYYYMMDDhhmmssは作成日時です。

プール名はインスタンスの名前で使用されます。プール内のインスタンスの名前はinst-aaaaa-pool_nameで、aaaaaは5文字のランダム英数字です。プールの名前を変更してから、新しいインスタンスをプールに追加すると、新しいインスタンスには新しい名前が付きます。

このコマンドの出力は、instance-pool getコマンドの出力と同じです。プール内のインスタンスのリストは表示されません。

このプールに属するインスタンスをリストするには、次のコマンドを使用します。

$ oci compute-management instance-pool list-instances -c <compartment_OCID> --instance-pool-id <instance_pool_OCID>

各インスタンスの出力は、instance getコマンドの出力と比較して省略されています。

次のコマンドは、指定したインスタンスのみについて同じ省略形の出力を表示します。

$ oci compute-management instance-pool-instance get --instance-id ocid1.instance.unique_ID \ --instance-pool-id ocid1.instancePool.unique_ID
CreateInstancePool操作を使用して、インスタンス・プールを作成します。

APIの使用およびリクエストの署名の詳細は、REST APIおよびセキュリティ資格証明を参照してください。SDKについては、ソフトウェア開発キットとコマンドライン・インタフェースを参照してください。

Oracle Cloud Infrastructureドキュメント

インスタンス・プールを作成する

前提条件