カスタム・イメージの管理
この項では、カスタム・イメージに対して実行できる次の操作について説明します:
-
編集および削除
-
別のコンパートメントへの移動
-
テナンシ間で共有
-
次の方法でアップロード、インポートおよびエクスポートします:
-
ローカル・ファイル・システムからObject Storageバケットへのイメージのアップロード
-
オブジェクト・ストレージ・バケットからコンパートメントへのイメージのインポート
-
オブジェクト・ストレージ・バケットへのイメージのエクスポート
-
URLへのイメージのエクスポート
-
URLからのイメージのインポート
-
カスタム・イメージを作成するには、「インスタンスからのイメージの作成」およびBring Your Own Image (BYOI)を参照してください。
イメージ名の更新
カスタム・イメージのみを編集できます。 プラットフォーム・イメージの名前は変更できません。
「コンピュートWeb UI」の使用
-
ダッシュボードで、「コンピュート/イメージの表示」ボタンをクリックします。
-
イメージ・リストの上にあるコンパートメント・ドロップ・ダウン・メニューを使用して、イメージをリストするコンパートメントを選択します。
-
次のいずれかのメソッドを使用して、「イメージの更新」ダイアログを開きます。
-
更新するイメージに対して、アクション・メニューをクリックし、編集オプションをクリックします。
-
更新するイメージの名前をクリックします。 イメージの詳細ページで、コントロール・メニューをクリックし、詳細の編集をクリックします。
-
-
「イメージの更新」ダイアログで、イメージ名を変更します。
イメージ名は一意である必要はありません。
-
Save Changesボタンをクリックします。
OCI CLIの使用
-
コマンドを実行するために必要な情報を収集します:
-
イメージOCID (
oci compute image list
)
-
-
イメージ更新コマンドを実行します。
構文:
$ oci compute image update --image-id ocid1.image.unique_ID --display-name new_name
別のコンパートメントへのイメージの移動
イメージを移動するには、OCI CLIを使用する必要があります。
OCI CLIの使用
-
次の情報を取得します:
-
現在のコンパートメントのOCIDおよび宛先コンパートメントのOCID:
# oci iam compartment list --compartment-id-in-subtree true
-
移動するイメージのOCID:
# oci compute image list --compartment-id current_compartment_OCID
-
-
イメージ変更コンパートメント・コマンドを実行します。
構文:
oci compute image change-compartment \ --compartment-id destination_compartment_OCID \ --image-id image_OCID
イメージの削除
「コンピュートWeb UI」の使用
-
ダッシュボードで、「コンピュート/イメージの表示」ボタンをクリックします。
-
イメージ・リストの上にあるコンパートメント・ドロップ・ダウン・メニューを使用して、イメージをリストするコンパートメントを選択します。
-
削除するカスタム・イメージに対して、アクション・メニューをクリックし、イメージの削除をクリックします。
イメージが削除されます。
OCI CLIの使用
-
コマンドを実行するために必要な情報を収集します:
-
イメージOCID (
oci compute image list
)
-
-
イメージの削除コマンドを実行します。
構文:
oci compute image delete --image-id image_OCID
例:
$ oci compute image delete --image-id ocid1.image.unique_ID Are you sure you want to delete this resource? [y/N]: y { "etag": "bbb9a3df-8f9d-47df-a419-f9d2de912b57", "opc-work-request-id": "ocid1.workrequest.unique_ID" }
オブジェクト・ストレージ・バケットへのイメージのアップロード
Object Storageバケットにイメージを格納する利点は、「オブジェクトのバージョニングの管理」および「事前認証済リクエストの使用」の説明に従って、オブジェクト・バージョニングまたは事前認証済リクエストを実装できることです。
-
「バケットの作成」の説明に従って、オブジェクト・ストレージ・バケットを作成します。
-
ローカル・ファイル・システムからバケットにイメージをアップロードします。 「オブジェクトのアップロード」を参照してください。
-
インスタンスの起動時にイメージを選択できるように、オブジェクト・ストレージ・バケットからコンパートメントにイメージをインポートします。 「オブジェクト・ストレージ・バケットからのイメージのインポート」を参照してください。
オブジェクト・ストレージ・バケットからのイメージのインポート
オブジェクト・ストレージ・バケットからコンパートメントにイメージをインポートできます。
または、「URLからのイメージのインポート」の説明に従って、URLからイメージをインポートできます。
始める前に
Object Storageバケットへの読取りアクセス権があり、使用するイメージがバケットに含まれていることを確認します。 「オブジェクト・ストレージ・バケットの管理」を参照してください。
使用するイメージがバケットに含まれていない場合は、「オブジェクト・ストレージ・バケットへのイメージのアップロード」で説明されている手順を実行します。
「コンピュートWeb UI」の使用
-
「カスタム・イメージ」ページに移動します。
-
ダッシュボードで、「コンピュート/イメージの表示」をクリックします。 イメージ・ページの左側にあるメニューで、カスタム・イメージをクリックします。
-
ナビゲーション・メニューで、Computeをクリックし、Custom Imagesをクリックします。
-
-
「カスタム・イメージ」ページで、イメージのインポート・ボタンをクリックします。
-
「イメージのインポート」ダイアログで、次の情報を入力します:
-
名前: イメージの説明的な名前を入力します。
-
コンパートメントに作成: イメージを配置するコンパートメントを選択します。
-
ソース・タイプ: 「オブジェクト・ストレージ・バケット」からインポート・オプションを選択します。
-
バケット: バケットを選択します。 バケットを見つけるためにコンパートメントを変更する必要がある場合があります。
-
オブジェクト名: リストからイメージ・オブジェクトの名前を選択します。
-
イメージ・タイプ: インポートするイメージのタイプに基づいて、次のいずれかのオプションを選択します。
-
VMDK: 仮想マシン・ディスク・イメージに使用される仮想マシン・ディスク・ファイル形式(
.vmdk
)。 -
QCOW2: 書込み時にQEMUコピーで使用されるディスク・イメージ・ファイル(
.qcow2
)の場合。 -
OCI: QCOW2イメージおよびOCIメタデータを含むOracle Cloud Infrastructureファイル(
.oci
)。
-
-
起動モード: 準仮想化がデフォルトであり、変更できません。
-
タグ付け: オプションで、リソース作成時のタグの追加の説明に従って、このイメージに1つ以上のタグを追加します。 タグは後で適用することもできます。
-
-
ダイアログでイメージのインポート・ボタンをクリックします。
インポートされたイメージは、コンパートメントのカスタム・イメージ・リストにインポート中の状態で表示されます。 操作の進行状況を追跡するには、関連付けられている作業リクエストを表示します。
インポートが正常に完了すると、イメージの状態が使用可能に変わり、「インスタンスの作成」の説明に従ってイメージを使用してインスタンスを起動できます。
OCI CLIの使用
-
コマンドを実行するために必要な情報を収集します:
-
コンパートメントのOCID:
oci iam compartment list --compartment-id-in-subtree true
-
オブジェクト・ストレージ・バケット名:
oci os bucket list -c compartment_OCID
-
バケット内のイメージ・オブジェクトの名前:
oci os object list --bucket-name bucket_name
-
オブジェクト・ストレージ・ネームスペース。 「オブジェクト・ストレージ・ネームスペースの取得」を参照してください。
-
イメージ・タイプ イメージがVMDKまたはQCOW2イメージの場合は、そのタイプを
--source-image-type
オプションの引数として指定する必要があります。--source-image-type
オプションを指定しない場合、イメージはOCIファイルであるとみなされます: QCOW2イメージおよびOCIメタデータ。--source-image-type
が指定されておらず、イメージ・タイプがOCIでない場合、インポートは失敗します。
-
-
オブジェクトからのイメージ・インポート・コマンドを実行します。
構文:
oci compute image import from-object \ --compartment-id compartment_OCID --bucket-name bucket_name \ --name bucket_image_object_name --namespace namespace
--display-name
オプションを指定して、インポートされたイメージにカスタム名を付けることができます。 名前は一意である必要はなく、後で変更できます。 プラットフォーム・イメージ名をカスタム・イメージ名として使用することはできません。重要:
Microsoft Windowsイメージをインポートする場合は、
--operating-system
オプションを指定し、インスタンスの最適なパフォーマンスを確保するために、値に大/小文字を区別しない文字列「Windows」を含めます。--operating-system
オプションを指定し、これがMicrosoft Windowsイメージでない場合は、値に大/小文字を区別しない文字列"Windows"が含まれていないことを確認してください。
URLからのイメージのインポート
イメージ・ファイルのURLを指定することで、イメージをコンパートメントにインポートできます。
または、「オブジェクト・ストレージ・バケットからのイメージのインポート」の説明に従って、Object Storageバケットからイメージをインポートできます。
始める前に
この手順に必要なURLを取得します。 テナンシからURLにアクセスできることを確認します。
「コンピュートWeb UI」の使用
-
ダッシュボードで、「コンピュート/イメージの表示」をクリックします。 イメージ・ページの左側にあるメニューで、カスタム・イメージをクリックします。
-
「カスタム・イメージ」ページで、イメージのインポート・ボタンをクリックします。
-
「イメージのインポート」ダイアログで、次の情報を入力します:
-
名前: イメージの説明的な名前を入力します。
-
コンパートメントに作成: イメージを配置するコンパートメントを選択します。
-
ソース・タイプ: 「オブジェクト・ストレージURL」からインポート・オプションを選択します。
-
オブジェクト・ストレージURL: イメージのURLを入力します。 URLはオブジェクト・ストレージURLである必要はありません。 イメージへのアクセスを提供する任意のURLを指定できます。
-
イメージ・タイプ: インポートするイメージのタイプに基づいて、次のいずれかのオプションを選択します。
-
VMDK: 仮想マシン・ディスク・イメージに使用される仮想マシン・ディスク・ファイル形式(
.vmdk
)。 -
QCOW2: 書込み時にQEMUコピーで使用されるディスク・イメージ・ファイル(
.qcow2
)の場合。 -
OCI: QCOW2イメージおよびOCIメタデータを含むOracle Cloud Infrastructureファイル(
.oci
)。
-
-
起動モード: 準仮想化がデフォルトであり、変更できません。
-
タグ付け: オプションで、リソース作成時のタグの追加の説明に従って、このイメージに1つ以上のタグを追加します。 タグは後で適用することもできます。
-
-
ダイアログでイメージのインポート・ボタンをクリックします。
インポートされたイメージは、コンパートメントのカスタム・イメージ・リストにインポート中の状態で表示されます。 操作の進行状況を追跡するには、関連付けられている作業リクエストを表示します。
インポートが正常に完了すると、イメージの状態が使用可能に変わり、「インスタンスの作成」の説明に従ってイメージを使用してインスタンスを起動できます。
OCI CLIの使用
-
コマンドを実行するために必要な情報を収集します:
-
コンパートメントのOCID:
oci iam compartment list --compartment-id-in-subtree true
-
イメージのURL。 URLはオブジェクト・ストレージURLである必要はありません。 テナンシからアクセスできる任意のURLを使用できます。
-
イメージ・タイプ イメージがVMDKまたはQCOW2イメージの場合は、そのタイプを
--source-image-type
オプションの引数として指定する必要があります。--source-image-type
オプションを指定しない場合、イメージはOCIファイルであるとみなされます: QCOW2イメージおよびOCIメタデータ。--source-image-type
が指定されておらず、イメージ・タイプがOCIでない場合、インポートは失敗します。
-
-
オブジェクトURIからのイメージ・インポート・コマンドを実行します。
構文:
oci compute image import from-object-uri \ --compartment-id compartment_OCID --uri URL_for_image
--display-name
オプションを指定して、インポートされたイメージにカスタム名を付けることができます。 名前は一意である必要はなく、後で変更できます。 プラットフォーム・イメージ名をカスタム・イメージ名として使用することはできません。重要:
Microsoft Windowsイメージをインポートする場合は、
--operating-system
オプションを指定し、インスタンスの最適なパフォーマンスを確保するために、値に大/小文字を区別しない文字列「Windows」を含めます。--operating-system
オプションを指定し、これがMicrosoft Windowsイメージでない場合は、値に大/小文字を区別しない文字列"Windows"が含まれていないことを確認してください。例:
$ oci compute image import from-object-uri \ --compartment-id compartment_OCID \ --uri http://fqdn_or_ip_address/compute_images/uln-pca-Oracle-Linux-8-2022.02.25_0.oci \ --display-name "Oracle Linux 8 2-25-22" { "data": { "agent-features": null, "base-image-id": null, "billable-size-in-gbs": null, "compartment-id": "ocid1.compartment.unique_ID", "create-image-allowed": true, "defined-tags": {}, "display-name": "Oracle Linux 8 2-25-22", "freeform-tags": {}, "id": "ocid1.image.unique_ID", "launch-mode": "PARAVIRTUALIZED", "launch-options": null, "lifecycle-state": "IMPORTING", "listing-type": null, "operating-system": "UNAVAILABLE", "operating-system-version": "UNAVAILABLE", "size-in-mbs": 0, "time-created": "2022-04-19T20:44:35.163119+00:00" }, "etag": "ab0c6265-c671-4ccb-a9b1-279d9437ba87", "opc-work-request-id": "ocid1.workrequest.unique_ID" }
オブジェクト・ストレージ・バケットへのイメージのエクスポート
イメージはObject Storageバケットにエクスポートできます。 バケットへの書込みアクセス権が必要です。
または、「URLへのイメージのエクスポート」の説明に従って、イメージをURLにエクスポートできます。
エクスポートされたイメージは、イメージが作成されたときのブート・ボリュームとメタデータのコピーです。
「コンピュートWeb UI」の使用
-
ダッシュボードで、「コンピュート/イメージの表示」をクリックします。 イメージ・ページの左側にあるメニューで、カスタム・イメージをクリックします。
-
エクスポートするカスタム・イメージの名前をクリックします。 エクスポートするイメージがリストに表示されない場合は、イメージ・リストの上にあるコンパートメント・メニューを使用します。
-
イメージの詳細ページで、「コントロール」メニューをクリックし、「イメージのエクスポート」オプションをクリックします。
-
「カスタム・イメージのエクスポート」ダイアログで、次の情報を入力します:
-
エクスポート先: 「オブジェクト・ストレージ・バケットにエクスポート」オプションを選択します。
-
バケット: バケットを選択します。 必要に応じて、メニューを使用して別のコンパートメントを選択します。
-
オブジェクト名: エクスポートされたイメージの名前を入力します。
-
エクスポート形式: エクスポートするイメージのタイプに基づいて、次のいずれかのオプションを選択します。
-
VMDK: 仮想マシン・ディスク・イメージに使用される仮想マシン・ディスク・ファイル形式(
.vmdk
)。 -
QCOW2: 書込み時にQEMUコピーで使用されるディスク・イメージ・ファイル(
.qcow2
)の場合。 -
OCI: QCOW2イメージおよびOCIメタデータを含むOracle Cloud Infrastructureファイル(
.oci
)。
-
-
-
ダイアログで「エクスポートの作成」ボタンをクリックします。
イメージの状態が「エクスポート中」に変わります。 カスタム・イメージをエクスポートすると、指定したオブジェクト・ストレージのロケーションにデータがコピーされます。 操作の進行状況を追跡するには、関連付けられている作業リクエストを表示します。
イメージのエクスポート中もインスタンスを起動できますが、エクスポートが完了するまでイメージを削除することはできません。
エクスポートが完了すると、イメージの状態は「使用可能」に変更されます。 イメージの状態が「使用可能」に変わっても、指定したオブジェクト・ストレージのロケーションにエクスポートされたイメージが表示されない場合、エクスポートは失敗しています。イメージをエクスポートするステップを再度実行する必要があります。
OCI CLIの使用
-
バケットが使用可能であることを確認します。
「バケットのリスト」および「バケットの作成」を参照してください。
-
コマンドを実行するために必要な情報を収集します:
-
オブジェクト・ストレージ・バケット名 ステップ1を参照してください。
-
イメージOCID (
oci compute image list
) -
オブジェクト・ストレージ・ネームスペース。 「オブジェクト・ストレージ・ネームスペースの取得」を参照してください。
-
エクスポートされたイメージ・ファイルのオブジェクト・ストレージ内の名前。 これは、次の「URLへのエクスポート」プロシージャのURL例の
my-object
と同じパラメータです。 -
エクスポートされたイメージの形式: OCI、QCOW2またはVMDK。 詳細は、前述の「コンピュートWeb UI」プロシージャを参照してください。
イメージ形式がOCIでない場合は、
--export-format
オプションを使用してイメージ形式を指定する必要があります。--export-format
が指定されていない場合、イメージはOCI形式でエクスポートされます。
-
-
image export to objectコマンドを実行します。
構文:
oci compute image export to-object --bucket-name bucketname \ --image-id image_OCID --namespace namespace \ --name exported_image_object_name --export-format VMDK
URLへのイメージのエクスポート
イメージをURLにエクスポートできます。 エクスポート・ロケーションへの書込みアクセス権が必要です。
または、「オブジェクト・ストレージ・バケットへのイメージのエクスポート」の説明に従って、イメージをオブジェクト・ストレージ・バケットにエクスポートできます。
エクスポートされたイメージは、イメージが作成されたときのブート・ボリュームとメタデータのコピーです。
「コンピュートWeb UI」の使用
-
ダッシュボードで、「コンピュート/イメージの表示」をクリックします。 イメージ・ページの左側にあるメニューで、カスタム・イメージをクリックします。
-
エクスポートするカスタム・イメージの名前をクリックします。 エクスポートするイメージがリストに表示されない場合は、イメージ・リストの上にあるコンパートメント・メニューを使用します。
-
イメージの詳細ページで、「コントロール」メニューをクリックし、「イメージのエクスポート」オプションをクリックします。
-
「カスタム・イメージのエクスポート」ダイアログで、次の情報を入力します:
-
エクスポート先: 「オブジェクト・ストレージURLにエクスポート」オプションを選択します。
-
オブジェクト・ストレージURL: イメージをエクスポートするURLを入力します。 URLはオブジェクト・ストレージURLである必要はありません。 イメージへのアクセスを提供する任意のURLを指定できます。
-
エクスポート形式: エクスポートするイメージのタイプに基づいて、次のいずれかのオプションを選択します。
-
VMDK: 仮想マシン・ディスク・イメージに使用される仮想マシン・ディスク・ファイル形式(
.vmdk
)。 -
QCOW2: 書込み時にQEMUコピーで使用されるディスク・イメージ・ファイル(
.qcow2
)の場合。 -
OCI: QCOW2イメージおよびOCIメタデータを含むOracle Cloud Infrastructureファイル(
.oci
)。
-
-
-
ダイアログで「イメージのエクスポート」ボタンをクリックします。
イメージの状態が「エクスポート中」に変わります。 カスタム・イメージをエクスポートすると、指定したオブジェクト・ストレージのロケーションにデータがコピーされます。 操作の進行状況を追跡するには、関連付けられている作業リクエストを表示します。
イメージのエクスポート中もインスタンスを起動できますが、エクスポートが完了するまでイメージを削除することはできません。
エクスポートが完了すると、イメージの状態は「使用可能」に変更されます。 イメージの状態が「使用可能」に変わっても、指定したオブジェクト・ストレージのロケーションにエクスポートされたイメージが表示されない場合、エクスポートは失敗しています。イメージをエクスポートするステップを再度実行する必要があります。
OCI CLIの使用
-
事前認証済リクエストを含むバケットが使用可能であり、リクエストURLがあることを確認します。 参照:
-
コマンドを実行するために必要な情報を収集します:
-
イメージOCID (
oci compute image list
) -
URI ステップ1を参照してください。
-
エクスポートされたイメージの形式: OCI、QCOW2またはVMDK。 詳細は、前述の「コンピュートWeb UI」プロシージャを参照してください。
イメージ形式がOCIでない場合は、
--export-format
オプションを使用してイメージ形式を指定する必要があります。--export-format
が指定されていない場合、イメージはOCI形式でエクスポートされます。
-
-
オブジェクトURIへのイメージ・エクスポート・コマンドを実行します。
構文:
oci compute image export to-object-uri --image-id image_OCID \ --uri URL_to_export_to
例:
oci compute image export to-object-uri \ --image-id ocid1.image.unique_ID \ --uri https://objectstorage.mypca01.example.com/p/MrxLFkKlFkIlNDhvhcZnrjbUAlsoeah/n/mynamespace/b/my-bucket/o/my-object { "data": { "agent-features": null, "base-image-id": null, "compartment-id": "ocid1.tenancy.unique_ID", "create-image-allowed": true, "defined-tags": null, "display-name": "PCA OL8 Image", "freeform-tags": null, "id": "ocid1.image.unique_ID", "launch-mode": "PARAVIRTUALIZED", "launch-options": { "boot-volume-type": "PARAVIRTUALIZED", "firmware": "UEFI_64", "is-consistent-volume-naming-enabled": false, "is-pv-encryption-in-transit-enabled": false, "network-type": "PARAVIRTUALIZED", "remote-data-volume-type": "PARAVIRTUALIZED" }, "lifecycle-state": "EXPORTING", "listing-type": null, "operating-system": "OracleLinux", "operating-system-version": "8", "size-in-mbs": 47694, "time-created": "2022-01-18T16:29:13.114742+00:00" }, "etag": "5d24f645-b446-42f2-a777-112457f0cafe", "opc-work-request-id": "ocid1.workrequest.unique_ID" }
テナンシ間でのカスタム・イメージの共有
イメージのインポートおよびエクスポートを使用して、テナンシ間でカスタム・イメージを共有できるため、各テナンシでイメージを手動で再作成する必要はありません。 テナンシの1つでイメージを作成し、イメージをエクスポートして、追加のテナンシでインポートできるようにします。
高レベルのタスクは次のとおりです:
-
イメージをObject Storageバケットにエクスポートします。 「オブジェクト・ストレージ・バケットへのイメージのエクスポート」を参照してください。
-
バケット内のイメージに対する読取り専用アクセス権を持つ事前認証済リクエストを作成します。 事前認証済リクエストの使用を参照してください。
-
宛先テナンシで、イメージをインポートします。 事前認証済リクエストURLをオブジェクト・ストレージURLとして使用します。 「URLからのイメージのインポート」を参照してください。