使用 UI 导入定制图像

如果 IBM Cloud Object Storage 中有可用映像，那么可以使用 IBM Cloud VPC 控制台将其导入到 IBM Cloud 基础架构。

1. 确保兼容的定制映像在 IBM Cloud Object Storage 中可用。 要将图像上载到 IBM Cloud Object Storage，请在存储区的“对象”页面上，单击 上载。 可以使用 Aspera 高速传输插件来上传大于 200 MB 的映像。 有关更多信息，请参阅 创建 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 子属性。

通用操作系统定制映像是可用于评估和测试目的的 Beta 功能。 通用操作系统具有 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 是四位数的年份
• MM 是两位数的月份
• DD 是两位数的日期
• T 分隔日期和时间信息
• hh 是两位数的小时
• mm 是两位数的分钟数
• +hh:mm 或 -hh:mm 是全球标准时区

因此，北美中央标准时区 (CST) 2023 年 9 月 30 日晚上 8:00 的日期将为 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时为该映像生成的校验和。

如果在导入映像之前在本地生成校验和，那么可以比较这两个校验和以确保它们完全相同。 匹配的校验和指示图像未改变。

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时为该映像生成的校验和。

如果在导入映像之前在本地生成校验和，那么可以比较这两个校验和以确保它们完全相同。 匹配的校验和指示图像未改变。

要使用 CLI 验证导入的定制映像，请使用 ibmcloud is image 命令。

首先，查看要验证的已导入定制映像的详细信息。 指定要使用 IMAGE 变量创建的定制映像的名称或标识。

ibmcloud is image IMAGE

有关更多信息，请参阅 VPC CLI 参考页面中的 ibmcloud is image。

以下示例查看标识为 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时为该映像生成的校验和。

如果在导入映像之前在本地生成校验和，那么可以比较这两个校验和以确保它们完全相同。 匹配的校验和指示图像未改变。

要使用 API 作为定制映像进行验证，请使用 列出所有映像。

对于 $image_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 创建虚拟服务器实例。