インスタンスの作成

プロシージャ

1. 次のリソースおよび情報を作成または取得します。

   • 使用する可用性ドメインの名前: oci iam availability-domain list

   • インスタンスを作成するコンパートメントのOCID: oci iam compartment list

   • このインスタンスのシェイプの名前。目的の使用に適したシェイプを選択します。

     • 一般的なワークロードおよびアプリケーション:

       VM.PCAStandard.E5.Flex

       次の例に示すように、シェイプ構成も指定する必要があります。ocpusの値を指定する必要があります。memoryInGBsプロパティはオプションです。GBのデフォルト値は、ocpusの数の16倍です。

       --shape-config '{"ocpus": 32, "memoryInGBs": 512}'

     • GPU加速ワークロード:

       VM.GPU.L40S.1 | VM.GPU.L40S.2 | VM.GPU.L40S.4

       GPUシェイプは柔軟ではありません。カスタム構成パラメータはありません。

     コンピュート・シェイプを参照してください。

     シェイプ構成は、インスタンスの作成後に変更できます。

   • このインスタンスにアタッチされているVNICが作成されるサブネットのOCID: oci compute vnic-attachment list

   • --hostname-labelオプションの値を指定する場合は、「コンソール」タブのホスト名の説明を参照してください。

   • 次の値のいずれかを収集して、イメージ・ソース(イメージまたはブート・ボリューム)を指定します。

     • インスタンスのブートに使用されるイメージのOCID:

       oci compute image list

       ノート
       
       

       表示名に「-OKE-」を含むイメージを選択しないでください。-OKE-イメージは、withKubernetesエンジン(OKE)のみ使用できます。

     • インスタンスの起動に使用されるブート・ボリュームのOCID。

       oci compute boot-volume-attachment list

   • SSHを使用してインスタンスに接続するための公開Secure Shell (SSH)キー。

     ノート
     
     

     インスタンスの作成後にこのSSHキーを指定することはできません。

   必須パラメータとオプション・パラメータの完全なリストについては、次のコマンドを使用します。

   $ oci compute instance launch -h

   --display-nameおよび--hostname-labelの値の詳細は、このページの「コンソール」タブの説明を参照してください。

2. --source-detailsオプションの引数を構築します。

   --source-details引数には、JSONファイルまたはコマンドライン文字列を指定できます。次のコマンドを使用して、JSONプロパティおよび値の正しい形式を表示します。

   oci compute instance launch --generate-param-json-input source-details
   

   bootVolumeSizeInGBsの詳細は、「コンソール」タブのブート・ボリューム・サイズに関する項を参照してください。

   bootVolumeVpusPerGBの詳細は、「コンソール」タブの「High Performance」を参照してください。

   ノート
   
   

   このインスタンスを後でlistまたはgetすると、インスタンスの作成後にこのブート・ボリューム・プロパティがインスタンス・オブジェクトに格納されないため、bootVolumeVpusPerGBの値はnullになります。インスタンスの起動後に値を確認するには、bv boot-volume listまたはgetコマンドを使用して、vpus-per-gbの値を確認します。

3. (オプション) --launch-optionsオプションの引数を作成します。

   firmwareプロパティのみを変更できます。デフォルト値はBIOSです。かわりに、UEFI_64を指定することもできます。firmwareに正しい値を指定しないと、インスタンスが起動しない可能性があります。instance updateコマンドでは、firmwareプロパティの値を更新できません。

   次に、デフォルト値を示します。

   {
     "bootVolumeType": "PARAVIRTUALIZED",
     "firmware": "BIOS",
     "isConsistentVolumeNamingEnabled": false,
     "is-pv-encryption-in-transit-enabled": false,
     "networkType": "PARAVIRTUALIZED",
     "remoteDataVolumeType": "PARAVIRTUALIZED"
   }

   firmwareプロパティの値を変更するには、次のオプションを指定します。

   --launch-options file://launch_options.json

   ここで、launch_options.jsonファイルの内容は次のとおりです。

   {
     "bootVolumeType": "PARAVIRTUALIZED",
     "firmware": "UEFI_64",
     "isConsistentVolumeNamingEnabled": false,
     "is-pv-encryption-in-transit-enabled": false,
     "networkType": "PARAVIRTUALIZED",
     "remoteDataVolumeType": "PARAVIRTUALIZED"
   }

4. (オプション) --metadataまたは--extended-metadataオプションの引数を作成します。

   カスタム・ユーザー・データは、--metadataおよび--extended-metadataオプションを使用してインスタンスにアタッチできます。メタデータのキー/値ペアは、JSON形式の文字列/文字列マップです。拡張メタデータは、ネストされたJSONオブジェクトです。拡張メタデータは、ネストされたJSONオブジェクトです。

   メタデータと拡張メタデータの合計サイズは、最大32,000バイトです。

   SSH鍵は、--ssh-authorized-keys-fileオプションのfile引数で指定することもできます。ユーザー・データは、--user-data-fileオプションのファイル引数で指定することもできます。詳細は、-hオプションを使用してください。

   次のステップの例では、認可キー・ファイルには、SSH authorized_keysファイルに必要な形式の1つ以上の公開SSHキーが含まれています。複数のキーを区切るには改行文字を使用します。SSH公開キーは、--metadataオプションまたは--ssh-authorized-keys-fileオプションのファイル引数で、ssh_authorized_keysキーの値として指定できます。詳細は、-hを使用してください。

5. インスタンスの起動コマンドを実行します。

   構文:

   oci compute instance launch --availability-domain availability_domain_name \
   --compartment-id compartment_OCID --shape shape --subnet-id subnet_OCID \
   --source-details file://image_info.json

   例:

   パブリック・サブネットを使用している場合は、パブリックIPアドレスがデフォルトで割り当てられるか、--assign-public-ipオプションの値をtrueに設定できます。後でパブリックIPアドレスを割り当てる必要がある場合は、インスタンスへのエフェメラル・パブリックIPアドレスの割当ての手順を参照してください。

   /v2インスタンス・メタデータ・サービス(IMDS)エンドポイントを使用するようにアプリケーションをアップグレードした場合は、--instance-optionsオプションを使用してareLegacyImdsEndpointsDisabledをtrueに設定します。デフォルトでは、レガシー(/v1)インスタンス・メタデータ・サービス・ルートが有効になっています。インスタンス・メタデータ・サービスの詳細は、インスタンス内からのインスタンス・メタデータの取得を参照してください。

   $ oci compute instance launch --availability-domain AD-1 --compartment-id <compartment_OCID> --display-name ops1 --shape VM.PCAStandard.E5.Flex --subnet-id <subnet_OCID> --source-details '{"bootVolumeSizeInGBs":100,"bootVolumeVpusPerGB":20,"imageId":"<image_OCID>","sourceType":"image"}' --assign-public-ip true --ssh-authorized-keys-file ./.ssh/<ssh_key_file> --instance-options '{"areLegacyImdsEndpointsDisabled": true}'
   {
     "data": {
       "agent-config": null,
       "availability-config": {
         "is-live-migration-preferred": null,
         "recovery-action": "RESTORE_INSTANCE"
       },
       "availability-domain": "AD-1",
       "capacity-reservation-id": null,
       "compartment-id": "ocid1.compartment.unique_ID",
       "dedicated-vm-host-id": null,
       "defined-tags": {},
       "display-name": "ops1",
       "extended-metadata": null,
       "fault-domain": "FAULT-DOMAIN-1",
       "freeform-tags": {},
       "id": "ocid1.instance.unique_ID",
       "image-id": "ocid1.image.unique_ID",
       "instance-options": {
         "are-legacy-imds-endpoints-disabled": true
       },
       "ipxe-script": null,
       "launch-mode": "PARAVIRTUALIZED",
       "launch-options": {
         "boot-volume-type": "PARAVIRTUALIZED",
         "firmware": "BIOS",
         "is-consistent-volume-naming-enabled": false,
         "is-pv-encryption-in-transit-enabled": false,
         "network-type": "PARAVIRTUALIZED",
         "remote-data-volume-type": "PARAVIRTUALIZED"
       },
       "lifecycle-state": "PROVISIONING",
       "metadata": {
         "ssh_authorized_keys": <public_ssh_key>"
       },
       "platform-config": null,
       "preemptible-instance-config": null,
       "region": "region_name",
       "shape": "VM.PCAStandard.E5.Flex",
       "shape-config": {
         "baseline-ocpu-utilization": null,
         "gpu-description": null,
         "gpus": null,
         "local-disk-description": null,
         "local-disks": null,
         "local-disks-total-size-in-gbs": null,
         "max-vnic-attachments": 16,
         "memory-in-gbs": 256.0,
         "networking-bandwidth-in-gbps": 24.6,
         "ocpus": 16.0,
         "processor-description": null
       },
       "source-details": {
         "boot-volume-size-in-gbs": 100,
         "bootVolumeVpusPerGB": 20,
         "image-id": "ocid1.image.unique_ID",
         "kms-key-id": null,
         "source-type": "image"
       },
       "system-tags": null,
       "time-created": "2021-09-22T20:20:04.715304+00:00",
       "time-maintenance-reboot-due": null
     },
     "etag": "92180faa-3660-446c-9559-c12a6e6111f9",
     "opc-work-request-id": "ocid1.workrequest.unique_ID"
   }

   work-requests work-request getコマンドを使用して、インスタンス起動のステータスを監視します。

   $ oci work-requests work-request get --work-request-id ocid1.workrequest.unique_ID

   作業リクエストのステータスが「失敗」で、失敗の理由が指定されていない場合、失敗の原因は一時的なものである可能性があります。失敗の理由が指定されていない場合は、少し待ってからインスタンスの作成を再試行してください。