UI を使用したカスタム・イメージの管理

IBM Cloud コンソールを使用してイメージを管理できます。

1. IBM Cloud コンソールで、ナビゲーションメニュー アイコン インフラストラクチャ コンピュート > イメージに進みます。
2. 「カスタム・イメージ」 タブで、特定のイメージの「アクション」アイコン をクリックし、使用可能なオプションから選択します。 暗号化されているカスタム・イメージには、イメージ名の後に鍵のアイコンが付いています。 以下のアクションから 選択できます。

CLI を使用したカスタム・イメージのリスト表示

コマンド・ライン・インターフェース (CLI) を使用して、リージョン内のすべての IBM Cloud VPC カスタム・イメージをリストできます。

CLI を使用してすべてのカスタム・イメージをリストするには、 ibmcloud is images コマンドを使用します。 カスタム・イメージは、それらが作成されたアカウント専用であるため、 --visibility オプションは private です。

ibmcloud is images --visibility private

詳細については、VPC CLIリファレンスページのibmcloud is imagesを 参照してください。

APIを使用してすべての画像を一覧表示する

アプリケーション・プログラミング・インターフェース (API) を使用して、領域内のすべての IBM Cloud VPC イメージをリストできます。

API を使用してすべてのイメージをリストするには、 「すべてのイメージをリスト(List all images)」 を使用します。 カスタム・イメージは、それらが作成されたアカウント専用であるため、 visibility プロパティーを private に設定して、カスタム・イメージのみを取得できます。

curl -X GET \
”$vpc_api_endpoint/v1/images?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"

Terraform を使用したすべてのイメージのリスト表示

Terraform を使用して、地域内のすべての IBM Cloud VPC イメージをリストできます。

Terraform を使用してすべてのイメージをリストするには、Terraform データ・ソース・コマンド ibm_is_imagesを使用します。 カスタム・イメージは、それらが作成されたアカウント専用であるため、 visibility 属性を private に設定して、カスタム・イメージのみを取得できます。

data "ibm_is_images" "images" {
  visibility = "public"
}

UIを使用してカスタム画像の詳細を表示する

カスタム・イメージの以下の詳細を表示できます。

• 割り当てられたリソース・グループ
• チェックサム
• 作成日
• CRN
• 非推奨の日付 (設定されている場合)
• 暗号化タイプ
• Location
• 名前と ID
• 廃止日 (設定されている場合)
• オペレーティング・システムおよびバージョン
• サイズ
• ソース・タイプ

カスタム・イメージの名前の編集、検索可能性のためのタグの追加、および固有のクラウド・リソース名 (CRN) の表示とコピーを行うことができます。 イメージの SHA256 チェックサム値にアクセスできます。

カスタム・イメージの詳細を表示するには、以下の手順を実行します。

1. IBM Cloud コンソールで、ナビゲーションメニュー アイコン インフラストラクチャ コンピュート > イメージに進みます。
2. カスタム画像タブで、カスタム画像の名前をクリックすると、その画像の詳細が表示されます。
3. 画像の詳細ページでは、画像名の編集、チェックサムのコピー、タグの追加、画像のCRNのコピーができます。
4. イメージの詳細ページのアクションメニューから、カスタムイメージから仮想サーバーインスタンスを作成したり、イメージを削除したりすることができます。 可能なアクションの完全なリストについては、 UI を使用したカスタム・イメージの管理 を参照してください。

CLI を使用したカスタム・イメージの詳細の表示

コマンド・ライン・インターフェース (CLI) を使用して、カスタム・イメージの詳細 (名前と ID、オペレーティング・システムとバージョン、暗号化状況、非推奨または廃止の日付、割り当てられたリソース・グループなど) を表示できます。

CLIを使用してカスタム・イメージの詳細を表示するには ibmcloud is image コマンドを使います。 IMAGE 変数を使用して、カスタム・イメージの名前または ID を指定します。

ibmcloud is image IMAGE

詳細については、VPC CLIリファレンスページのibmcloud is imageを 参照してください。

API を使用したカスタム・イメージの詳細の取得

アプリケーション・プログラミング・インターフェース (API) を使用して、カスタム・イメージの詳細 (名前と ID、オペレーティング・システムとバージョン、暗号化状況、非推奨または廃止の日付、割り当てられたリソース・グループなど) を表示できます。

API を使用して特定のカスタム・イメージの詳細を取得するには、 イメージの取得 を使用します。 $image_id 変数には、取得するカスタム・イメージの ID を指定します。

curl -X GET \
”$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"

Terraform を使用したカスタム・イメージの詳細の取得

Terraform を使用して、カスタム・イメージの詳細 (名前と ID、オペレーティング・システムとバージョン、暗号化状況、非推奨または廃止の日付、割り当てられたリソース・グループなど) を表示できます。

Terraform を使用してイメージの詳細を表示するには、Terraform データ・ソース・コマンド ibm_is_imagesを使用します。 name 変数には、取得するカスタム・イメージの名前を指定します。

data "ibm_is_images" "image_name" {
}

UI を使用したプライベート・カタログへのカスタム・イメージの共有

既存の IBM Cloud VPC カスタム・イメージを既存のプライベート・カタログと共有できます。 プライベート・カタログがまだない場合は、 VPC の仮想サーバー・イメージのオンボード を参照してください。

「イメージをプライベート・カタログに共有」 アクションは、以下のイメージでは使用できません。

• 画像はすでにプライベート・カタログで共有されている。 プライベート・カタログ内のイメージは、1 つのプライベート・カタログ内の 1 つの製品オファリング内の 1 つのバージョンにのみ存在できます。 イメージを別のバージョンで共有するには、その前に、そのイメージが最初に含まれているバージョンからイメージを削除する必要があります。
• イメージは暗号化されています。
• イメージは x86 イメージではありません。

プライベート・カタログでカスタム・イメージを共有するには、以下の手順を実行します。

1. IBM Cloud コンソールで、ナビゲーションメニュー アイコン インフラストラクチャ コンピュート > イメージに進みます。
2. 「カスタム・イメージ」 タブで、「アクション」アイコン をクリックし、 「カタログに共有」 を選択します。
3. 「イメージをプライベート・カタログに共有」 ページで、使用可能なプライベート・カタログのリストから 「プライベート・カタログ」 を選択します。
4. 「ソフトウェア・バージョン」 にバージョン番号を入力します。
5. 「カタログ・オファリングの作成」 をクリックして、イメージをプライベート・カタログに共有します。
6. イメージが作成されたら、 「イメージの検証」 をクリックします。

このプロセスでは、カスタムイメージをプライベートカタログのみに共有します。 検証プロセスは、プライベート・カタログ内で行われます。 「イメージの検証 (Validate image)」 をクリックすると、新規ページが表示されます。この画面から、 「ステップ 3: VPC の仮想サーバー・イメージのオンボーディング(Step 3: Validate the virtual server image in Onboarding a virtual server image for VPC)」 から開始して、検証プロセスを完了できます。

CLI を使用したプライベート・カタログへのカスタム・イメージの共有

IBM Cloud VPC からUIを使用して、プライベートカタログにのみカスタムイメージを共有することができます。 CLI を使用してプライベートカタログにオンボードする方法の詳細については、「 アカウントへのソフトウェアのオンボード」 を参照してください。

API を使用したプライベート・カタログへのカスタム・イメージの共有

IBM Cloud VPC からUIを使用して、プライベートカタログにのみカスタムイメージを共有することができます。 APIを使用してプライベートカタログにオンボードする方法の詳細については 、「アカウントへのソフトウェアのオンボード」 を参照してください。

Terraform を使用したプライベート・カタログへのカスタム・イメージの共有

IBM Cloud VPC からUIを使用して、プライベートカタログにのみカスタムイメージを共有することができます。 Terraform を使用してプライベートカタログにオンボードする方法の詳細については、「 アカウントへのソフトウェアのオンボード」 を参照してください。

コンソールでカスタムイメージライフサイクルのステータス変更をスケジュールする

単一のイメージ・ライフサイクル・ステータス変更をスケジュールすることも、イメージのライフサイクル全体のステータス変更をスケジュールすることもできます。 即時ステータス変更は、将来のステータス変更をスケジュールしていない場合にのみ実行できます。

単一のステータス変更をスケジュールするには、以下の手順を実行します。

イメージの単一のステータス変更をスケジュールできます。

1. IBM Cloud コンソールで、ナビゲーションメニュー アイコン インフラストラクチャ コンピュート > イメージに進みます。
2. 「カスタム・イメージ」 タブで、特定のイメージの「アクション」アイコン をクリックし、使用可能なオプションから選択します。
3. 「ライフサイクルのスケジュール」 を選択します。
4. 「イメージ状況」 で、イメージの状況変更を選択します。
5. 「非推奨の詳細」 で、ステータスを 「即時」 に変更するか、 「将来の日付をスケジュールする」 に変更するかを選択します。
6. 「将来の日付をスケジュールする」 を選択した場合は、以下を入力する必要があります。
   • 「カレンダー日付別 (By calendar date)」 または 「日数別 (By number of days)」 を選択します。
     • 「カレンダー日付別」 を選択した場合は、日時情報を入力します。 これは、ステータスの変更が行われる日時です。
     • 「日数別」 を選択した場合は、状況が変更されるまでに経過する日数を入力します。
7. 保存 をクリックします。

イメージのライフサイクル全体をスケジュールするには、以下のステップを実行します。

イメージの完全なライフサイクルをスケジュールできます。 イメージは、最初に非推奨になり、次に定義したスケジュールに従って廃止に変更されます。 ライフサイクルの変更をスケジュールするには、以下の手順を使用します。

1. IBM Cloud コンソールで、ナビゲーションメニュー アイコン インフラストラクチャ コンピュート > イメージに進みます。

2. 「カスタム・イメージ」 タブで、特定のイメージの「アクション」アイコン をクリックし、使用可能なオプションから選択します。

3. 「ライフサイクルのスケジュール」 を選択します。

4. ライフサイクル全体をスケジュールするを選択します。

   • 「カレンダー日付別」 を選択した場合は、ステータス変更を行う日時を入力します。
   • 「日数別」 を選択した場合は、ステータスが変更されるまでの経過日数を入力します。

   廃番の日付は非推奨の日付より後でなければなりません。

5. **「スケジュール」**をクリックします。

CLI を使用したカスタム・イメージのライフサイクル状況の変更

コマンド・ライン・インターフェース (CLI) を使用して、 IBM Cloud VPC カスタム・イメージのライフサイクル状況を変更できます。 ibmcloud is image-deprecate または ibmcloud is image-obsolete コマンドを使用して、状況を即時に変更できます。 ibmcloud is image-update コマンドを使用して、これらの状況変更を将来の日時にスケジュールすることもできます。 IMAGE 変数を使用して、カスタム・イメージの名前または ID を指定します。

即時状況変更を行うには、以下のいずれかの例を使用します。

即時ステータス変更は、将来のステータス変更がスケジュールされていない場合にのみ実行できます。 スケジュールされた状況変更を削除するには、 CLI を使用したスケジュールされたカスタム・イメージ・ライフサイクル状況変更の削除 を参照してください。 スケジュールされたステータス変更を削除した後、即時ステータス変更を行うことができます。

• イメージのライフサイクル状況を deprecate に変更します。

  ibmcloud is image-deprecate IMAGE
  

• イメージのライフサイクル状況を obsolete に変更します。

  ibmcloud is image-obsolete IMAGE
  

ステータス変更をスケジュールするには、以下の例を使用します。

deprecate-at または obsolete-at オプションには、ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm) の日時形式で日付を指定します。

• YYYY は 4 桁の年です。
• MM は 2 桁の月です。
• DD は 2 桁の日です。
• T は日付と時刻の情報を区切ります。
• hh は 2 桁の時間です。
• mm は 2 桁の分です。
• +hh:mm または -hh:mm は UTC タイム・ゾーンです。

したがって、北米中央標準時ゾーン (CST) で 2023 年 9 月 30 日の午後 8 時に行われる日付は、 2023-09-30T20:00:00-06:00 になります。

日時をスケジュールする際に、現在の日時を使用することはできません。 例えば、6 月 12 日の午前 8:00 の場合、スケジュールされた日時は 6 月 12 日の午前 8:00 より後でなければなりません。 deprecate-at と obsolete-at の両方の日付を定義する場合、 obsolete-at の日付は deprecate-at の日付より後でなければなりません。

ibmcloud is image-update IMAGE [--deprecate-at YYYY-MM-DDThh:mm:ss+hh:mm] [--obsolete-at YYYY-MM-DDThh:mm:ss+hh:mm]

deprecate-at および obsolete-at の日時項目を変更する場合は、これらのコマンドを再度実行できます。 前の日付と時刻は新しい日付と時刻に置き換えられます。

CLI を使用して、以前にスケジュールされたカスタム・イメージのライフサイクル状況変更を削除する

--reset-deprecate-at オプションまたは --reset-obsolete-at オプションを使用して、スケジュールされたステータス変更を削除できます。 これらのオプションのいずれかを ibmcloud is image-update コマンドで使用すると、日時がイメージから削除されます。 イメージは、その状況変更用にスケジュールされなくなります。

ibmcloud is image-update IMAGE [--reset-deprecate-at] [--reset-obsolete-at]

--reset-deprecate-at オプションと --reset-obsolete-at オプションの両方を使用すると、イメージ状況は availableに戻ります。

API を使用したカスタム・イメージ・ライフサイクル状況の変更

アプリケーション・プログラミング・インターフェース (API) を使用して、 IBM Cloud VPC カスタム・イメージのライフサイクル状況を変更できます。 即時ステータス変更を行うことも、後でステータス変更が行われるようにスケジュールすることもできます。

即時状況変更を行うには、以下のいずれかの例を使用します。 $image_id 変数には、状況変更のカスタム・イメージの ID を指定します。

即時ステータス変更は、将来のステータス変更がスケジュールされていない場合にのみ実行できます。 スケジュール済みステータス変更を削除するには、 API を使用したスケジュール済みカスタム・イメージ・ライフサイクル・ステータス変更の削除 を参照してください。 スケジュールされたステータス変更を削除した後、即時ステータス変更を行うことができます。

• イメージのライフサイクル状況を deprecated に変更します。

  curl -X POST "$vpc_api_endpoint/v1/images/$image_id/deprecate?version=2023-02-21&generation=2" -H “Authorization: Bearer $iam_token”
  

• イメージのライフサイクル状況を obsolete に変更します。

  curl -X POST "$vpc_api_endpoint/v1/images/$image_id/obsolete?version=2023-12-21&generation=2" -H “Authorization: Bearer $iam_token”
  

ステータス変更をスケジュールするには、以下のいずれかの例を使用します。

deprecation_at プロパティーまたは obsolescence_at プロパティーには、ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm) の日時形式で日付を指定します。

• YYYY は 4 桁の年です。
• MM は 2 桁の月です。
• DD は 2 桁の日です。
• T は日付と時刻の情報を区切ります。
• hh は 2 桁の時間です。
• mm は 2 桁の分です。
• +hh:mm または -hh:mm は UTC タイム・ゾーンです。

したがって、北米中央標準時ゾーン (CST) で 2023 年 9 月 30 日の午後 8 時に行われる日付は、 2023-09-30T20:00:00-06:00 になります。

日時をスケジュールする際に、現在の日時を使用することはできません。 例えば、6 月 12 日の午前 8:00 の場合、スケジュールされた日時は 6 月 12 日の午前 8:00 より後でなければなりません。 deprecation_at と obsolescence_at の両方の日時を定義する場合、 obsolescence_at の日付は deprecation_at の日時より後でなければなりません。

• deprecated へのステータス変更をスケジュールします。

  curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{
   "deprecation_at": "2023-03-01T06:11:28+05:30" }'
  

• obsolete へのステータス変更をスケジュールします。

  curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{
   “obsolescence_at": "2023-12-31T06:11:28+05:30" }'
  

  deprecation_at および obsolescence_at の日時項目を変更する場合は、これらのコマンドを再度実行できます。 前の日付と時刻は新しい日付と時刻に置き換えられます。

API を使用して、以前にスケジュールされたカスタム・イメージのライフサイクル状況を削除する

deprecation_at または obsolescence_at を nullに更新して、スケジュールされた状況変更を削除するための PATCH /images 要求を行います。 このプロパティーを変更すると、イメージから日時が削除され、イメージはそのステータス変更にスケジュールされなくなります。

• イメージを deprecated から availableに変更するには、 deprecation_at プロパティーを nullに変更します。

  curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{ "deprecation_at": null }'
  

• イメージを obsolete から前の状態に変更するには、 obsolescence_at を nullに変更します。 イメージに以前に null for deprecation_at以外の値が含まれていた場合、このプロパティーの変更により obsolete 状態が削除され、 deprecatedに戻されます。 前の状態が availableの場合 (イメージが available から obsoleteに直接移動されたことを意味します)、このプロパティーの変更は obsolete から availableに戻ります。

  curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{ “obsolescence_at": null }'
  

• deprecation_at プロパティーまたは obsolescence_at プロパティーの両方が availableに設定されているイメージを変更するには、 deprecation_at プロパティーまたは obsolescence_at プロパティーの両方を更新する必要があります。

  curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{ "deprecation_at": null, “obsolescence_at": null }'
  

Terraformを使用してカスタムイメージのライフサイクルステータスを変更する

Terraform を使用して即座にステータスを変更するには、 ibm_is_image_deprecate または ibm_is_image_obsolete リソースコマンドを使用します。次の例のいずれかを使用します。 name 変数には、状況変更のカスタム・イメージの名前を指定します。

即時ステータス変更は、将来のステータス変更がスケジュールされていない場合にのみ実行できます。 スケジュールされた状況変更を削除するには、 Terraform を使用したスケジュールされたカスタム・イメージのライフサイクル状況変更の削除 を参照してください。 スケジュールされたステータス変更を削除した後、即時ステータス変更を行うことができます。

• イメージのライフサイクル状況を deprecated に変更します。

  resource "ibm_is_image" "example" {
    name               = "example-image"
    href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
    operating_system   = "ubuntu-16-04-amd64"
    encrypted_data_key = "eJxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx0="
    encryption_key     = "crn:v1:bluemix:public:kms:us-south:a/6xxxxxxxxxxxxxxx:xxxxxxx-xxxx-xxxx-xxxxxxx:key:dxxxxxx-fxxx-4xxx-9xxx-7xxxxxxxx"
  }
  resource "ibm_is_image_deprecate" "example" {
    image               = ibm_is_image.example.id
  }
  

• イメージのライフサイクル状況を obsolete に変更します。

  resource "ibm_is_image" "example" {
    name               = "example-image"
    href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
    operating_system   = "ubuntu-16-04-amd64"
    encrypted_data_key = "eJxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx0="
    encryption_key     = "crn:v1:bluemix:public:kms:us-south:a/6xxxxxxxxxxxxxxx:xxxxxxx-xxxx-xxxx-xxxxxxx:key:dxxxxxx-fxxx-4xxx-9xxx-7xxxxxxxx"
  }
  resource "ibm_is_image_obsolete" "example" {
    image               = ibm_is_image.example.id
  }
  

ステータス変更をスケジュールするには、以下のいずれかの例を使用します。

deprecation_at 属性または obsolescence_at 属性には、ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm) の日時形式で日付を指定します。

• YYYY は4桁の西暦
• MM は2桁の月
• DD は2桁の曜日
• T は日付と時刻の情報を区切ります。
• hh 2桁の時間です
• mm は2桁の分
• +hh:mm または は協定世界時時間帯です。 -hh:mm

したがって、北米中央標準時ゾーン (CST) で 2023 年 9 月 30 日の午後 8 時に行われる日付は、 2023-09-30T20:00:00-06:00 になります。

日時を指定する際、現在の日時を使用することはできません。 例えば、6 月 12 日の午前 8:00 の場合、スケジュールされた日時は 6 月 12 日の午前 8:00 より後でなければなりません。 deprecation_at と obsolescence_at の両方の日時を定義する場合、 obsolescence_at の日付は deprecation_at の日時より後でなければなりません。

• deprecated へのステータス変更をスケジュールします。

  resource "ibm_is_image" "example" {
    name               = "example-image"
    href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
    operating_system   = "ubuntu-16-04-amd64"
    deprecation_at     = "2023-11-28T15:10:00.000Z"
  }
  

• obsolete へのステータス変更をスケジュールします。

  resource "ibm_is_image" "example" {
    name               = "example-image"
    href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
    operating_system   = "ubuntu-16-04-amd64"
    obsolescence_at    = "2023-11-28T15:10:00.000Z"
  }
  

  deprecation_at および obsolescence_at の日時項目を変更する場合は、これらのコマンドを再度実行できます。 前の日付と時刻は新しい日付と時刻に置き換えられます。

Terraformを使用して、以前にスケジュールされたカスタムイメージのライフサイクルステータスを削除する

スケジュールされた状況変更を削除するには、 deprecation_at 属性または obsolescence_at 属性を null に更新します。 この属性変更により、イメージから日時が削除され、イメージはその状況変更に対してスケジュールされなくなります。

• イメージを deprecated から available に変更するには、 deprecation_at プロパティーを null に変更します。

  resource "ibm_is_image" "example" {
    name               = "example-image"
    href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
    operating_system   = "ubuntu-16-04-amd64"
    deprecation_at       = null
  }
  

• イメージを obsolete から前の状態に変更するには、 obsolescence_at を null に変更します。 イメージに以前に null for deprecation_at 以外の値が含まれていた場合、この属性の変更により、 obsolete 状態が削除され、 deprecated に戻されます。 前の状態が available の場合 (イメージが available から obsolete に直接移動されたことを意味します)、この属性の変更は obsolete から available に戻ります。

  resource "ibm_is_image" "example" {
    name               = "example-image"
    href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
    operating_system   = "ubuntu-16-04-amd64"
    obsolescence_at    = null
  }
  

• deprecation_at プロパティーまたは obsolescence_at プロパティーの両方が available に設定されているイメージを変更するには、 deprecation_at 属性または obsolescence_at 属性の両方を更新する必要があります。

  resource "ibm_is_image" "example" {
    name               = "example-image"
    href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
    operating_system   = "ubuntu-16-04-amd64"
    deprecation_at     = null
    obsolescence_at    = null
  }