インスタンスの作成

• コンソール
• CLI
• API

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

     • イメージまたはブート・ボリュームと、イメージまたはブート・ボリュームが配置されているコンパートメント。イメージのリストと詳細の表示およびブート・ボリュームのリストを参照してください。

     • 仮想クラウド・ネットワーク(VCN)とサブネット、およびVCNとサブネットが配置されているコンパートメント。VCNの作成を参照してください。

     • ユーザーがSSHを使用してインスタンスに接続する場合の公開Secure Shell (SSH)キー

  2. Compute Cloud@Customerコンソールのダッシュボードで、次のいずれかを実行して「インスタンスの作成」ダイアログ・ボックスを開きます:

     • 左上隅にある「インスタンスの作成」をクリックします。

     • 「コンピュート」ブロックで、「インスタンス」をクリックします。右側のインスタンス・リストの上部で、「インスタンスの作成」をクリックします。

     • 「コンピュート」ブロックで、「カスタム・イメージ」をクリックします。インスタンスの作成に使用するイメージについて、「アクション」メニュー()をクリックし、「イメージからのインスタンスの作成」をクリックします。イメージ・リストの上部にあるコンパートメントを変更して、目的のイメージを表示する必要がある場合があります。

       「イメージからのインスタンスの作成」オプションを使用すると、イメージ名は「インスタンスの作成」ダイアログ・ボックスですでに入力されており、変更できません。次のステップの「ソース・イメージ」で説明されている情報を入力する必要はありません。

  3. 「インスタンスの作成」ダイアログ・ボックスで、次の情報を入力します:

     • 名前: インスタンスの名前を入力します。インスタンス名には、次のような特性があります。

       • インスタンスの作成後に変更できます。

       • 一意である必要はありません。

       • 英数字とハイフン(-)のみを使用できます。

       • 最大63文字です。

     • コンパートメントに作成:インスタンスを作成するコンパートメントを選択します。

     • フォルト・ドメイン: (オプション)フォルト・ドメインを選択します。デフォルトでは、インスタンスの作成時に、インスタンスに最適なフォルト・ドメインが自動的に選択されます。フォルト・ドメインを指定して、リクエストされたフォルト・ドメインがインスタンスに対応できない場合、インスタンスの起動は失敗します。フォルト・ドメインは、インスタンスの作成後に変更できます。

     • ソース・イメージ:イメージまたはブート・ボリュームを選択します。

       1. 「ソース・タイプ」で、「プラットフォーム・イメージ」、「カスタム・イメージ」または「ブート・ボリューム」を選択します。

       2. 「カスタム・イメージ」または「ブート・ボリューム」を選択した場合は、使用するイメージまたはブート・ボリュームがあるコンパートメントを選択します。

       3. リストからイメージまたはブート・ボリュームを選択します。

          「プラットフォーム・イメージ」を選択した場合、「オペレーティング・システム」、「OSバージョン」および「イメージ・ビルド」(イメージが作成された日付)列を含む表形式リストが表示されます。OSバージョンの右側にあるドロップダウン・メニュー矢印を使用して、別のバージョンを選択できます。たとえば、Oracle Linuxオペレーティング・システムの場合、ドロップダウン・メニューを使用して9、8または7.9を選択できます。

          「カスタム・イメージ」を選択した場合、「名前」、「オペレーティング・システム」および「OSバージョン」列を含む表形式リストが表示されます。列見出しの矢印を使用して、リストを並べ替えることができます。リストをフィルタするには、イメージのリストの上にある「オペレーティング・システム」ドロップダウン・メニューを使用します。

          「ブート・ボリューム」を選択した場合、列「名前」、「サイズ(GB)」および「作成日」(ブート・ボリュームが作成された日付)を含む表形式リストが表示されます。列見出しの矢印を使用して、リストを並べ替えることができます。「ブート・ボリューム」セクション(「シェイプ」セクションの後)で、ブート・ボリューム・サイズをカスタマイズできます。

          リストが長すぎて1つのビューに収まらない場合は、矢印を使用してリストの別のページを表示します。

          以前に使用可能であったが、リストされていないプラットフォーム・イメージを使用するには、CLIを使用してインスタンスを作成し、イメージのOCIDを指定します。

       ソース・イメージは、インスタンスの作成後は変更できません。

     • シェイプ: プラットフォーム・イメージを使用している場合は、目的の用途に適したシェイプを選択します:

       • 汎用ワークロードおよびアプリケーション: VM.PCAStandard.E5を選択します。Flexは、OCPUおよびメモリーの数をシェイプして構成します。

         OCPUおよびメモリーの値については、各値フィールドの内側をクリックして、許容される最小値と最大値を確認します。OCPUおよびメモリー構成は、インスタンスの作成後に変更できます。

       • GPUアクセラレーテッド・ワークロード: VM.GPU.L40S.xシェイプを選択します。ここで、xはGPUの数(1-4)を表します。

         GPUシェイプは柔軟ではありません。OCPUおよびメモリーの値は、選択したGPU数によって異なります。

       サポートされるシェイプの詳細は、コンピュート・シェイプを参照してください。

     • ブート・ボリューム: (オプション)ボックスを選択して、カスタム・ブート・ボリューム・サイズまたはボリューム・パフォーマンス設定を指定します。

       • ブート・ボリューム・サイズ(GB): 選択したイメージのデフォルトのブート・ボリューム・サイズが表示されます。大きいサイズを指定するには、最大16384 GB (16 TB)のギガバイトの整数を入力するか、増分矢印および減分矢印を使用します。デフォルトより小さい値は入力できません。

         カスタム・ブート・ボリューム・サイズを指定する場合、より大きいサイズを使用できるようにパーティションを拡張する必要があります。Oracle Linuxプラットフォーム・イメージには、oci-utilsパッケージが含まれています。そのパッケージのoci-growfsコマンドを使用して、ルート・パーティションを拡張し、ファイル・システムを拡張します。その他のOSまたはカスタムイメージについては、そのOSの手順に従ってください。

       • ブート・ボリューム・パフォーマンス(VPU): 増分および減分の矢印を使用して、バランスのとれたパフォーマンス(10 VPU/GB)と高パフォーマンス(20 VPU/GB)を切り替えます。詳細は、ブロック・ボリューム・パフォーマンス・オプションを参照してください。

         高パフォーマンス・オプションを指定し、高パフォーマンス・プールが存在するが、指定したイメージが高パフォーマンス・プールに存在しない場合(イメージのインポート後に高パフォーマンス・プールが作成された場合)、指定したイメージが容量プールから高パフォーマンス・プールにコピーされます。この操作には、イメージ・サイズ、ネットワーク構成およびロードに応じて20分から30分かかる場合があります。

         このコピー操作は、イメージごとに1回の操作です。このイメージおよび高パフォーマンス・プールを指定してインスタンスを作成する将来のリクエストでは、このイメージ・コピーの遅延は発生しません。

         イメージが200GBを超える場合は、イメージ・コピーからエラー・メッセージが表示されます。プラットフォーム・イメージは200GB以下です。

     • サブネット:サブネットを選択します。

       1. リストからVCNを選択します。VCNが配置されているコンパートメントにコンパートメントを変更する必要がある場合があります。

       2. サブネットの選択

     • パブリックIPアドレス: SSHを使用してインスタンスに接続するには、「パブリックIPの割当て」ボックスを選択して、インスタンスにパブリックIPアドレスを割り当てます。パブリック・サブネットを指定した場合、このボックスはデフォルトで選択されます。このボックスにチェックマークを入れない場合、またはこのボックスのチェックマークを外し、後でパブリックIPアドレスを割り当てる場合は、インスタンスへの一時的パブリックIPアドレスの割当ての手順を参照してください。

     • プライベートIPアドレス: (オプション)サブネットのCIDRから使用可能なプライベートIPアドレスを指定します。デフォルトでは、プライベートIPアドレスが自動的に割り当てられます。

     • ホスト名: (オプション)クラウド・ネットワーク内でDNSを使用している場合は、ホスト名を入力します。ホスト名がサブネット内のすべてのVNICで一意である必要があります。

       デフォルトでは、インスタンス名はホスト名に使用されます。ホスト名は、インスタンスの作成後にOSで構成することもできます。

       これがUNIXインスタンスの場合、ファイル・システムをマウントするためのホスト名を正しく設定する方法の詳細は、マウント・ターゲットの作成およびUNIXベースのインスタンスへのファイル・システムのマウントを参照してください。

     • SSHキー: SSHを使用してインスタンスに接続するには、公開SSHキーを指定します。

       ノート
       
       

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

     • 初期化スクリプト: (オプション)初期化スクリプトを指定します。これは、カスタム・インスタンスの初期化に使用されるデータのファイルです。

     • ネットワーク・セキュリティ・グループ: (オプション)デフォルトでは、新しいインスタンスはNSGにアタッチされません。「ネットワーク・セキュリティ・グループの有効化」というラベルのボックスにチェックマークを入れ、このインスタンスのプライマリVNICを1つ以上のNSGに追加します。

       1. ドロップダウン・リストからNSGを選択します。必要なNSGを見つけるには、コンパートメントの変更が必要になる場合があります。

       2. 別のNSGにアタッチする場合は、「別のNSGの追加」をクリックします。

       3. リストからNSGを削除するには、そのNSGの右側にあるごみ箱をクリックします。最後のNSGまたはすべてのNSGを削除するには、「ネットワーク・セキュリティ・グループの有効化」ボックスの選択を解除します。

       このインスタンスのNSGアタッチメントを後で更新するには、VNICの更新を参照してください。

       NSGの詳細は、ネットワーク・セキュリティ・グループを使用したトラフィックの制御を参照してください。

     • インスタンス・オプション: レガシー・インスタンス・メタデータ・サービス・エンドポイントを無効にするには、ボックスを選択します。デフォルトでは、レガシー(/v1)インスタンス・メタデータ・サービス(IMDS)ルートが有効になっています。/v2エンドポイントを使用するようにアプリケーションをアップグレードした場合は、このボックスにチェックマークを入れて、/v1エンドポイントを無効にします。インスタンス・メタデータ・サービスの詳細は、インスタンス内のインスタンス・メタデータの取得を参照してください。アプリケーションのアップグレードの詳細は、IMDSバージョン2エンドポイントへのアップグレードを参照してください。

     • 可用性構成: (オプション)コンピュート・ノードのメンテナンス時にこのインスタンスを処理する方法を指定します」

       • Oracle Cloudインフラストラクチャに最適な移行オプションを選択させます

         このオプションはデフォルトで選択されており、計算ノードのメンテナンス中にこのインスタンスを処理する最適なオプションをシステムで選択できます。通常、最適なオプションは、正常な計算ノードへのライブ移行です。この設定は変更できません。たとえば、Microsoft Windowsクラスタ内のインスタンスでライブ移行がサポートされていないなど、このインスタンスをライブ移行しない場合は、このインスタンスのライブ移行を防ぐために、PCA_no_lmフリーフォーム・タグをTrueに設定します。

       • インフラストラクチャのメンテナンス後にインスタンスのライフサイクル状態をリストアします

         このオプションはデフォルトで選択されており、ライブ移行などのメンテナンス操作後に実行中のインスタンスを自動的に再起動するように指定します。このボックスにチェックマークが入っていない場合、インスタンスは停止状態でリカバリされます。

     • タグ付け: (オプション)このリソースに1つ以上のタグを追加します。タグは後で適用することもできます。リソースのタグ付けの詳細は、リソース・タグを参照してください。

  4. 「インスタンスの作成」をクリックします。

     成功すると、インスタンスの詳細ページが表示されます。「構成」タブの「シェイプ構成」列には、シェイプ、OCPUの数、ネットワーク帯域幅および合計メモリーが表示されます。「ネットワーキング」タブの「VNIC」列にはVCNおよびサブネットが表示され、「インスタンス・アクセス」列にはプライマリ・プライベートIPアドレスおよび割り当てられたパブリックIPアドレスが表示されます。

     インスタンス起動のステータスを確認するには、「リソース」セクションまでスクロールし、「作業リクエスト」をクリックします。

     リソース制約のためにインスタンスの起動に失敗した場合は、次のような処置を試してください。

     • 別のフォルト・ドメインを指定するか、フォルト・ドメインを指定せずにシステムによる選択を許可します。

     • リソース集中型のシェイプを指定します。

     • 不要になったインスタンスを停止します。

     • 不要になったインスタンスを終了します。

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

• インスタンスを作成するには、oci compute instance launchコマンドと必要なパラメータを使用します。

  oci compute instance launch --availability-domain availability_domain --compartment-id compartment_OCID --shape shape --subnet-id subnet_OCID --source-details file://image_info.json [OPTIONS]

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

  oci compute instance launch -h

  CLIのコマンド、フラグおよびオプションの完全なリストは、コマンドライン・リファレンスを参照してください。

  プロシージャ

  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に正しい値を指定しないと、インスタンスが起動しない可能性があります。firmwareプロパティの値は、instance updateコマンドで更新できません。

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

     {
       "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オプションのfile引数で指定することもできます。詳細は、-hオプションを使用してください。

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

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

• LaunchInstance操作を使用してインスタンスを作成します。

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