UI を使用したカスタム・イメージのインポート

IBM Cloud Object Storage で使用可能なイメージがある場合、IBM Cloud VPC コンソールを使用してそれを IBM Cloud インフラストラクチャーにインポートできます。

1. 互換性のあるカスタム・イメージが IBM Cloud Object Storage で使用可能なことを確認してください。 イメージを IBM Cloud Object Storage にアップロードするには、バケットの**「オブジェクト」ページで、「アップロード」**をクリックします。 200 MB を超えるイメージをアップロードするときには、Aspera 高速転送プラグインを使用すると良いでしょう。 詳しくは、Linux カスタム・イメージの作成、 Windows カスタム・イメージの作成、ライセンス持ち込み、および IBM Cloud Object Storage へのデータのアップロードを参照してください。
2. IBM Cloud コンソールで、 「メニュー」アイコン >「VPC インフラストラクチャー」>「コンピュート」>「イメージ」 に移動します。
3. 「カスタム・イメージ」 タブで、 「作成」 をクリックします。
4. 表1に記載されている項目を入力し、「 カスタムイメージの作成 」をクリックしてください。

CLI を使用したカスタム・イメージのインポート

互換性のあるカスタム・イメージが IBM Cloud Object Storage で使用可能なことを確認してください。 詳細については、 Linux カスタム・イメージの作成、 Windows カスタム・イメージの作成、 汎用オペレーティング・システム・カスタム・イメージの作成、 ライセンスの持ち込み、 IBM Cloud Object Storage への データのアップロードを 参照してください。 使用許可表現を含めるには、 カスタム画像に使用許可表現を追加するを 参照してください。

イメージが IBM Cloud Object Storage で利用可能な場合、コマンドライン・インターフェース（CLI） を使って IBM Cloud VPC インフラストラクチャにインポートすることができます。

CLI を使用してカスタム・イメージをインポートするには、 ibmcloud is image-create コマンドを使用します。 カスタム画像の名前は、 IMAGE_NAME 変数で指定します。 この名前は、領域内の別のイメージで使用することはできません。また、 ibm- で始まる名前は、システム提供のイメージ用に予約されています。 ソースを指定する必要があります。例えば、 --file オプションに画像ファイルの場所を指定します。 --os-name オプションに、イメージのオペレーティング・システムの名前を指定します。

ibmcloud is image-create IMAGE_NAME [--file IMAGE_FILE_LOCATION] [--os-name OPERATING_SYSTEM_NAME]

以下の例では、 my-ubuntu-16-amd64 という名前のカスタム・イメージを作成します。 イメージ・ソースの場所は cos://us-south/custom-image-vpc-bucket/customImage-0.qcow2 です。 オペレーティング・システムは ubuntu-16-amd64 です。

ibmcloud is image-create my-ubuntu-16-amd64 --file cos://us-south/custom-image-vpc-bucket/customImage-0.qcow2 --os-name ubuntu-16-amd64

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

ibmcloud is image-create IMAGE_NAME [--file IMAGE_FILE_LOCATION] [--os-name OPERATING_SYSTEM_NAME] [--deprecate-at YYYY-MM-DDThh:mm:ss+hh:mm] [--obsolete-at YYYY-MM-DDThh:mm:ss+hh:mm]

ibmcloud is image-create my-ubuntu-16-amd64 --file cos://us-south/custom-image-vpc-bucket/customImage-0.qcow2 --os-name ubuntu-16-amd64 --deprecate-at 2023-03-01T06:11:28+05:30 --obsolete-at 2023-12-31T06:11:28+05:30

API を使用したカスタム・イメージのインポート

互換性のあるカスタム・イメージが IBM Cloud Object Storage で使用可能なことを確認してください。 詳細については、 Linux カスタム・イメージの作成、 Windows カスタム・イメージの作成、 汎用オペレーティング・システム・カスタム・イメージの作成、 ライセンスの持ち込み、 IBM Cloud Object Storage への データのアップロードを 参照してください。 使用許可表現を含めるには、 カスタム画像に使用許可表現を追加するを 参照してください。

IBM Cloud Object Storageで使用可能なイメージがある場合、アプリケーション・プログラミング・インターフェース (API) を使用して、それを IBM Cloud VPC インフラストラクチャーにインポートできます。

API を使用してカスタム・イメージをインポートするには、 イメージの作成 を使用します。

name は、領域内の別のイメージでは使用できません。 ibm- で始まる名前は、システム提供のイメージ用に予約されています。 file.href サブプロパティーにイメージの場所を指定します。 operating_system.name サブプロパティーにイメージ・オペレーティング・システムの名前を指定します。

一般的なオペレーティング・システムのカスタム・イメージはベータ機能であり、評価およびテスト目的で利用できます。 汎用オペレーティング・システムの family は Generic です。 ご使用のオペレーティング・システムをブートして正しく初期化するために必要な、 allow_user_image_creation 値が true のものと user_data_format のものを必ず選択してください。 詳しくは、 ユーザー・データ・フォーマットに関する考慮事項 を参照してください。

以下の例では、 my-image という名前、 cos://us-south/my-bucket/my-image.qcow2 というソース・ロケーション、およびイメージのオペレーティング・システム debian-9-amd64 という名前のカスタム・イメージをインポートします。

curl -X POST "$vpc_api_endpoint/v1/images?version=2023-02-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{
      "name": "my-image",
      "file": {
        "href": "cos://us-south/my-bucket/my-image.qcow2"
      },
      "operating_system": {
        "name": "debian-9-amd64"
      }
    }'

curl -X POST "$vpc_api_endpoint/v1/images?version=2023-02-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{
      "name": "my-image",
      "file": {
        "href": "cos://us-south/my-bucket/my-image.qcow2"
      },
      "operating_system": {
        "name": "debian-9-amd64"
      },
      "deprecation_at": "2023-03-01T06:11:28+05:30",
      "obsolescence_at": "2023-12-31T06:11:28+05:30"
    }'

Terraformを使ってカスタムイメージをインポートする

Terraformを使用するには、Terraform CLIをダウンロードし、 IBM Cloud プロバイダープラグインを設定してください。 詳しくは Terraformを始めるを 参照。

互換性のあるカスタム・イメージが IBM Cloud Object Storage で使用可能なことを確認してください。 詳細については、 Linux カスタム・イメージの作成、 Windows カスタム・イメージの作成、 汎用オペレーティング・システム・カスタム・イメージの作成、 ライセンスの持ち込み、 IBM Cloud Object Storage への データのアップロードを 参照してください。 使用許可表現を含めるには、 カスタム画像に使用許可表現を追加するを 参照してください。

IBM Cloud Object Storage に画像が用意されている場合、Terraform を使用して、その画像を IBM Cloud VPC のインフラストラクチャにインポートすることができます。

Terraformを使ってカスタムイメージをインポートするには、Terraformリソースコマンド ibm _is_imageを使います。

作成するカスタム画像の名前を name の値で指定します。 この名前は、領域内の別のイメージで使用することはできません。また、 ibm- で始まる名前は、システム提供のイメージ用に予約されています。 また、ソースを指定する必要があります。例えば、 href の値と画像ファイルの場所を指定します。 operating_system 、イメージのオペレーティング・システム名を指定します。

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

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

Terraform を使用してカスタム・イメージをインポートする場合、Terraform リソース・コマンド ibm_is_imageを使用して、 IBM Cloud VPC カスタム・イメージのライフサイクル状況変更を同時にスケジュールすることもできます。

name 属性は、領域内の別のイメージでは使用できません。また、 ibm- で始まる名前は、システム提供のイメージ用に予約されています。

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 は協定世界時のタイム・ゾーンです。

したがって、2023 年 9 月 30 日の午後 8 時 (North American Central Standard time zone (CST)) の日付は 2023-09-30T20:00:00-06:00 になります。

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

以下の例では、 example-image という名前、 cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd というソース・ロケーション、およびイメージのオペレーティング・システム ubuntu-16-04-amd64 という名前のカスタム・イメージをインポートします。 このイメージは、 2023-11-28T15:10:00.000Z で非推奨になる予定です。 このイメージは、 2023-11-28T15:10:00.000Z で廃止されるようにスケジュールされています。

• 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"
    deprecated_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"
  }
  

UI を使用したインポート済みカスタム・イメージの検証

カスタム画像をインポートした後、その画像が IBM Cloud VPC にインポートされた際に生成されたチェックサムを確認できます。

イメージをインポートする前にローカルでチェックサムを生成しておけば、2つのチェックサムを比較して、それらが一致していることを確認できます。 チェックサムが一致すれば、イメージが変更されていないことになります。

1. IBM Cloud コンソールで、 「メニュー」アイコン >「VPC インフラストラクチャー」>「コンピュート」>「イメージ」 に移動します。
2. [ カスタム画像 ] タブで、カスタム画像の一覧から、検証したいカスタム画像の名前をクリックします。
3. 画像の詳細サイドパネルで、「 チェックサム ( SHA256 ) 」フィールドを探してください。 次のようなコンテンツが表示されます。 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7.

z/OS Wazi aaS のカスタムイメージのみ: Wazi Image Builder からデプロイされたインポート済みカスタムイメージのチェックサムを検証することはできません。

4. このチェックサム (SHA256) の値を、ローカルでイメージのチェックサムを計算したときに生成された出力と比較します。

   • Linux のコマンド例: sha256sum ubuntu_image.qcow2
   • Mac のコマンド例: shasum -a 256 ubuntu_image.qcow2
   • 次のような出力が表示されます： 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7

5. このイメージを使用して、仮想サーバー・インスタンスまたはベア・メタル・サーバーを作成します。 詳しくは、 仮想サーバー・インスタンスの作成 または VPC での Bare Metal Servers を参照してください。

CLI を使用したインポート済みカスタム・イメージの検証

カスタム画像をインポートした後、その画像が IBM Cloud VPC にインポートされた際に生成されたチェックサムを確認できます。

イメージをインポートする前にローカルでチェックサムを生成しておけば、2つのチェックサムを比較して、それらが一致していることを確認できます。 チェックサムが一致すれば、イメージが変更されていないことになります。

CLI を使用してインポートしたカスタム・イメージを検証するには、 ibmcloud is image コマンドを使用します。

まず、検証するインポート済みカスタム・イメージの詳細を表示します。 IMAGE 変数を使用して、作成するカスタム・イメージの名前または ID を指定します。

ibmcloud is image IMAGE

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

以下の例では、ID が r006-1d1e92e9-6550-4d06-8483-d674310045fd のカスタム・イメージの詳細を表示します。

ibmcloud is image r006-1d1e92e9-6550-4d06-8483-d674310045fd

Getting image r006-1d1e92e9-6550-4d06-8483-d674310045fd under account Rios IMSLess as user gbgrout@ibm.com...
ID                             r006-589548bd-9241-4ad7-a610-1df6ba020793
Name                           my-image-from-volume-cli-1
CRN                            crn:v1:bluemix:public:is:us-south:a/a1234567::image:r006-589548bd-9241-4ad7-a610-1df6ba020793
Status                         available
Operating system               Name             Architecture   Vendor   Version                 Dedicated host only
                               centos-7-amd64   amd64          CentOS   7.x - Minimal Install   false
Source volume                  ID                                          Name
                               r006-6438d80f-4433-4445-be2f-0cca05afff3e   transpose-clubhouse-putt-repent
Created                        2023-03-16T01:11:03+05:30
Deprecation Date               2023-03-01T06:11:28+05:30
Obsolescence Date              2023-12-31T06:11:28+05:30
Visibility                     private
Minimum provisioned size(GB)   250
SHA256 Checksum                774d44ac0d55f2bfe869b995565715e5d9970ec23ce7127b2e2776b2618a9f7c
File size(GB)                  2
Encryption                     none
Resource group                 11caaa983d9c4beb82690daab08717e9
Resource type                  image
Catalog Offering Managed       false

返されたチェックサム（ SHA256 ）の値を、ローカルで画像のチェックサムを計算した際に生成される出力と比較してください。

• Linux のコマンド例: sha256sum ubuntu_image.qcow2
• Mac のコマンド例: shasum -a 256 ubuntu_image.qcow2
• 次のような出力が表示されます： 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7

チェックサム (SHA256) を検証した後、イメージを使用して仮想サーバーを作成します。 CLI を使用した仮想サーバー・インスタンスの作成 を参照してください。

API を使用したインポート済みカスタム・イメージの検証

カスタム画像をインポートした後、その画像が IBM Cloud VPC にインポートされた際に生成されたチェックサムを確認できます。

イメージをインポートする前にローカルでチェックサムを生成しておけば、2つのチェックサムを比較して、それらが一致していることを確認できます。 チェックサムが一致すれば、イメージが変更されていないことになります。

API を使用してカスタム・イメージとして検証するには、 「すべてのイメージをリスト」 を使用します。

$image_id には、検証するカスタム・イメージの ID を指定します。

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

返されたチェックサム（ SHA256 ）の値を、ローカルで画像のチェックサムを計算した際に生成される出力と比較してください。

• Linux のコマンド例: sha256sum ubuntu_image.qcow2
• Mac のコマンド例: shasum -a 256 ubuntu_image.qcow2
• 次のような出力が表示されます： 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7

チェックサム (SHA256) を検証した後、イメージを使用して仮想サーバーを作成します。 API を使用した仮想サーバー・インスタンスの作成 を参照してください。