准备工作

在导入引导映像之前，请确认您已满足以下先决条件：

• 将您的启动映像文件上传到 IBM Cloud Object Storage 存储桶中。 支持的文件格式包括 .ova、.ova.gz、.tar、.tar.gz 以及 .tgz。 如需了解更多信息，请参阅 “创建一些存储桶来存储您的数据”。

• 为您的 COS 实例生成基于哈希的消息认证码 (HMAC) 凭证。 如需了解更多信息，请参阅《 使用 HMAC 凭据 》。

• 创建或使用现有的 Power Virtual Server 工作区。

使用 Power Virtual Server 用户界面导入启动映像

若要通过 Power Virtual Server 用户界面导入启动映像，请执行以下步骤：

1. 请使用您的 IBM 账号登录 IBM Cloud 产品目录。

2. 在搜索框中输入 Power Virtual Server，然后点击 Power Virtual Server 磁贴。

3. 在导航面板中点击“工作区”。 系统将显示“工作区”页面，其中列出了现有工作区。

4. 请选择要导入启动镜像的工作区。 将显示所选工作区的“虚拟服务器实例”页面。

5. 在导航面板中单击“启动映像”，然后单击“导入映像”。 此时将显示“导入启动映像”面板。

6. 在“导入引导映像”面板中，请在 “源”部分完成以下步骤：

   1. 从“映像操作系统”下拉列表中选择映像操作系统。

      如果您选择 SAP HANA 或 SAP NetWeaver 映像操作系统，则必须勾选“自我认证”复选框。

   2. 从 “区域” 下拉列表中，选择包含您的 COS 存储桶的区域。

   3. 在 “图像文件名”字段中输入图像的文件名。 图像文件名中不得包含空格。

      支持的文件名扩展名包括：.ova、.ova.gz、.tar、.tar.gz 和 .tgz。 您可以使用 gzip 来压缩图片文件。 例如：Aix_7200-03-02-1846_cldrdy_112018.ova.gz。

   4. 在 “存储桶名称”字段中输入您的存储桶名称。 如果您的图像文件存储在存储桶中的某个子文件夹内，请使用 bucketName/optional/folders 这种格式指定完整路径。

      要查看您的存储桶名称，请转到 “导航菜单” >“资源列表”>“存储”，然后单击您的 Cloud Object Storage 实例名称。 您的存储桶已列在 “存储桶”选项卡中。

   5. 从您的 COS 服务凭据中复制“access_key_id”值，并将其粘贴到 HMAC 访问密钥字段中。

      要查找服务凭据，请转至 “导航菜单” >“资源列表”>“存储”，点击您的 Cloud Object Storage 实例名称，然后转至“服务凭据”>“查看凭据”。

   6. 从您的 COS 服务凭据中复制“secret_access_key”值，并将其粘贴到 HMAC 密钥字段中。

   7. 将 “使用校验和文件验证导入”设置为“开启”，以根据校验和文件验证导入的文件。 您必须将校验和文件和启动映像文件存储在同一个 COS 存储桶中。

      在将引导映像文件导出到 IBM Cloud Object Storage 存储桶时，您可以生成校验和文件。 校验和文件的名称基于引导映像文件的名称，并使用 .sha256 文件扩展名。

      如果您创建了自己的启动映像，可以生成一个校验和文件，并将其与启动映像存储在同一个存储桶中。 您可以通过运行 shasum -a 256 <filename> 或 sha256sum <filename> 命令来生成校验和文件。

      有关生成校验和文件的更多信息，请参阅《 使用 Power Virtual Server 用户界面捕获并导出 VM 》。

      将导入文件与校验和文件进行验证可能会延长导入时间。

7. 单击下一步。

8. 在 “目的地”部分输入以下信息：

   1. 在 “自定义映像名称”字段中，为导入的启动映像输入一个名称。

   2. 可选：在 “用户标签”字段中，输入标签以对该启动映像进行整理或分类。

      用户标签对该账户中的所有用户都是可见的。 请勿在标签名称中包含敏感数据。

   3. 在 “层级”字段中，请选择以下存储类型选项之一：

      • 第 0 层（25 IOPs/ GiB ）
      • 第1层（10 IOPs / GiB ）
      • 第3层（3个IOPs / GiB ）
      • 固定IOP（5000 IOP）

      VSI 无法同时使用一级和三级存储类型。 如需了解更多信息，请参阅“存储层级”。

   4. 在 “存储池”字段中，选择一个存储池选项。

      Power Virtual Server 根据您选择的选项（ “自动选择”、“亲和性”或“反亲和性” ），将一个或多个自定义图像存储卷放置到存储池中。 使用此映像部署的任何 VSI 的启动卷，都会创建在同一个存储池中。 有关存储卷的更多信息，请参阅 “添加和管理存储卷”。

      提供以下存储池选项：

      • 自动选择：自动在容量充足的存储池中创建存储卷。

      • 亲和性：根据您账户中的现有 VSI 或存储卷，确定启动卷所属的存储池。Power Virtual Server 将自定义映像存储卷存储在与该亲和性对象所在相同的存储池中。 如果亲和性对象是 VSI，则“Power Virtual Server”将根据 VSI 的启动卷来确定存储池。

      • 反亲和性：指定一个或多个需要排除的存储池。在放置启动卷时，Power Virtual Server 不会考虑这些被排除的存储池。 将要排除的存储池是根据您账户中现有的 VSI 或存储卷来确定的。 选择此选项后，Power Virtual Server 在创建自定义映像存储卷时，会排除包含反亲和性对象的存储池。 如果您将 VSI 用作反亲和性对象，Power Virtual Server 将根据每个 VSI 的启动卷来排除存储池。

9. 点击“导入图片”。

   大型启动镜像的导入可能需要更长时间。 您可能需要等待一段时间才能收到确认消息。

新的启动镜像已列在 “启动镜像”页面上。

使用 Power Virtual Server 命令行界面导入启动镜像

要导入启动映像，请运行 ibmcloud pi image import 命令。 要验证导入是否完成，请运行 ibmcloud pi image list 命令。

--import-details 如果您使用的是“自带许可证”（BYOL）版的 SAP HANA 或 SAP NetWeaver 镜像，请在 ibmcloud pi image import 命令中，以将该映像标识为 SAP 认证映像。

使用 Power Virtual Server API导入启动映像

若要通过 API 从 IBM Cloud Object Storage 导入启动映像，请使用 “创建 cos-image 导入任务” 方法，并在请求正文中包含以下必填属性：imageName、imageFilename 以及 bucketName。 对于私有存储桶，您必须指定 accessKey 和 secretKey，它们是您 COS 实例的 HMAC 访问密钥和密钥。 如需了解更多信息，请参阅 “使用 HMAC 凭据”。

curl -X POST \
  https://us-east.power-iaas.cloud.ibm.com/pcloud/v1/cloud-instances/$CLOUD_INSTANCE_ID/cos-images \
  -H "Authorization: Bearer $TOKEN" \
  -H "CRN: $CRN" \
  -H "Content-Type: application/json" \
  -d '{
    "imageName": "my-image-name",
    "imageFilename": "my-os-image-file.ova.gz",
    "bucketName": "my-cos-bucket-name",
    "region": "us-east",
    "accessKey": "my-cos-access-key",
    "secretKey": "my-cos-secret-key",
    "storageType": "tier3"
  }'

如果您使用的是“自带许可证”（BYOL）版本的 SAP HANA 或 SAP NetWeaver 镜像，请在请求正文中包含 importDetails 对象，以标识该镜像已通过 SAP 认证：

"importDetails": {
   "licenseType": "byol",
   "product": "Hana",
   "vendor": "SAP"
}

查看启动映像导入结果

启动引导映像导入后 ，“引导映像”页面上的 “状态”列将显示导入进度。 要查看详细信息，请单击 “查看详细信息”以打开“正在执行的作业状态”对话框。 该对话框显示以下信息：

• 作业标识
• 操作类型
• 输入资源
• 创建时间
• 已完成步骤

若要通过 CLI 查看启动映像导入任务的详细信息，请使用 ibmcloud pi image import-show 命令。

若要通过 API 查看引导映像导入任务的详细信息，请使用 “获取最近一次 cos-image 导入任务的详细信息”方法。

从 Cloud Object Storage

若要在导入启动镜像后将其下载，请按照以下步骤操作：

1. 在 IBM Cloud 仪表盘中，转到“资源列表”，然后单击您的 Cloud Object Storage 实例。

2. 在您存储启动镜像的存储桶中，单击该启动镜像文件。

3. 单击 “下载对象”。

有关 Cloud Object Storage CLI 命令的更多信息，请参阅“下载对象”。

相关信息

有关导出自定义启动映像的信息，请参阅“导出启动映像”。

有关捕获和导出虚拟服务器实例的信息，请参阅“捕获和导出虚拟服务器实例”。