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

詳細については 、ibmcloud is image-create in the VPC CLI reference pageを参照してください。

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 リソース・コマンド 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

詳細については 、ibmcloud is imagein the VPC CLI リファレンスページをご覧ください。

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

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

Getting image r134-1d1e92e9-6550-4d06-8483-d674310045fd under account Rios IMSLess as user gbgrout@ibm.com...

ID                             r134-589548bd-9241-4ad7-a610-1df6ba020793
Name                           my-image-from-volume-cli-1
CRN                            crn:v1:staging:public:is:us-south:a/efe5afc483594adaa8325e2b4d1290df::image:r134-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
                               r134-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
Owner type                     user
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 を使用した仮想サーバー・インスタンスの作成 を参照してください。