导入虚拟磁盘映像

借助 Migrate to Virtual Machines，您可以将虚拟磁盘映像导入 Compute Engine 映像。如果您的本地环境中已有包含所需软件和配置的虚拟磁盘映像，则可以将这些虚拟磁盘映像导入 Compute Engine 并使用生成的映像创建虚拟机实例或永久性磁盘，从而节省时间。

准备工作

  • 在您的项目上启用 VM Migration API。如需详细了解如何启用 VM Migration API，请参阅启用 Migrate to Virtual Machines 服务。
  • 确保 Migrate to Virtual Machines 支持磁盘上的操作系统。如需了解详情，请参阅支持的操作系统。
  • 确保要导入的虚拟磁盘映像文件采用以下格式。
    • 虚拟机磁盘 (VMDK)。
    • 原始文件，压缩为 .tar.gz。tar 文件必须包含名为 disk.raw 的单个文件。

映像导入过程

如需使用 Migrate to Virtual Machines 将虚拟磁盘映像导入 Compute Engine 映像，请按照以下步骤操作：

  1. 准备要导入的虚拟磁盘映像文件
  2. 选择目标项目
  3. 将虚拟磁盘映像导入 Compute Engine

准备要导入的虚拟磁盘文件

如需将虚拟磁盘映像导入 Compute Engine 映像，您必须先准备要导入的虚拟磁盘映像文件。以下部分详细讨论了这些任务。

将虚拟磁盘映像文件添加到 Cloud Storage

如需将虚拟磁盘映像导入 Compute Engine 映像，您必须先将虚拟磁盘映像文件添加到 Cloud Storage。如需了解详情，请参阅从文件系统上传对象。为了获得更好的性能，我们建议您将虚拟磁盘映像文件上传到您要在其中创建映像的同一云区域的存储桶。

授予所需权限

如需将虚拟磁盘映像导入 Compute Engine 映像，请按照下表中的说明授予权限。

角色 所需权限 说明
Storage Object Viewer roles/storage.objectViewer 将此权限授予宿主项目服务账号，以便能够将虚拟磁盘映像导入 Compute Engine 映像。
VM Migration Administrator roles/vmmigration.admin 向宿主项目授予此权限，以便能够创建新的 Migrate to Virtual Machines 来源并执行所有其他迁移操作。
VM Migration Service Account roles/vmmigration.serviceAgent 向目标项目授予此权限，以便在目标项目中创建迁移的虚拟机实例、磁盘和映像。

选择目标项目

如需托管 Compute Engine 映像，您必须创建或选择目标项目。目标项目定义 Compute Engine 映像的目标项目。如需详细了解如何创建或选择目标项目，请参阅添加目标项目。

将虚拟磁盘映像导入 Compute Engine

您可以使用 Google Cloud 控制台、Google Cloud CLI 或 REST API 命令将虚拟磁盘映像导入 Compute Engine。

控制台

如需使用 Google Cloud 控制台将虚拟磁盘映像导入 Compute Engine，请按照以下步骤操作。

  1. 打开 Google Cloud 控制台中的 Migrate to Virtual Machines 页面。

    转到 Migrate to Virtual Machines 页面

  2. 选择映像导入标签页。

  3. 点击创建映像。

  4. 定义映像的特征。下表列出了可以为映像设置的参数。

    版块标题 字段名称 说明
    常规 名称 您要创建的映像的名称。如需详细了解命名规则，请参阅命名惯例。
    映像导入 ID 表示映像导入资源的 ID。将映像导入 Compute Engine 时，Migrate to Virtual Machines 首先会创建映像导入资源。映像导入资源表示映像导入过程。您可以使用映像导入 ID 来获取在映像导入过程中导入的映像的链接。
    来源 Cloud Storage 文件 要从中导入映像的文件。点击浏览查看当前项目中的存储桶列表，然后选择要从中导入映像的文件。
    如果要从其他项目的存储桶导入映像，则必须以 bucket/folder/file 格式输入路径。如需获取存储桶中对象的路径，请参阅查看对象元数据。复制路径时，请确保不会复制 gs:// 前缀。
    请注意，您只能从 .vmdk 和 .tar.gz 文件导入映像。
    区域 您要在其中创建映像的区域。如需查看支持的区域列表，请参阅区域和可用区。
    目标项目 要在其中创建映像的目标项目。如果您尚未添加目标项目，请按照添加目标项目中提供的说明执行此操作。
    系列 （可选）选择映像系列。Compute Engine 提供了映像系列，以帮助您确保自动化系统可以引用最新映像。作为管理员，您可以将一组映像划分为一个映像系列。如需了解详情，请参阅公共映像系列。
    说明 （可选）为映像添加说明。
    跳过操作系统适配 如需跳过操作系统适配，请点击跳过操作系统适配开关以切换到开启位置。
    为了在 Google Cloud 上正常运行，基于导入的映像创建的虚拟机需要更改配置。这些更改称为“操作系统适配”。Migrate to Virtual Machines 在映像导入过程中自动执行操作系统适配。如需了解详情，请参阅调整虚拟机实例，使其能够在 Google Cloud 上运行。
    泛化 若要泛化映像，请点击泛化开关以切换到开启位置。从映像创建实例时，Windows 会向实例添加一些唯一信息。泛化是指移除此信息的过程，以便您可以从同一映像创建多个实例。
    许可 许可类型 Compute Engine 支持为已部署的虚拟机使用随用随付 (PAYG) 许可以及自带许可 (BYOL)。Migrate to Virtual Machines 会根据迁移后的操作系统为迁移后的虚拟机分配默认许可类型，如支持的操作系统中所述。
    如果您的操作系统支持多种许可类型，您可以替换默认许可类型，以明确指定许可类型 PAYG 或 BYOL。
    额外许可 额外许可 使用有效的网址格式，您最多可以向通过导入的映像创建的虚拟机实例添加 10 个额外许可。例如，您可以使用以下网址格式添加额外许可： 
    
https://www.googleapis.com/compute/beta/projects/windows-sql-cloud/global/licenses/sql-server-2012-enterprise
    标签 如需整理项目，您可为资源添加键值对形式的标签。请参阅使用标签整理资源。
    加密 由 Google 管理的加密密钥 如果选择此选项，则可以使用 Google 管理的加密密钥在导入过程中加密您的数据。如需了解详情，请参阅加密静态数据。
    客户管理的加密密钥 选择此选项，可在导入过程中使用客户管理的加密密钥 (CMEK) 来加密数据，以及导入过程创建的映像的数据。如果您对保护数据的密钥有特定的合规性或监管要求，则可以使用 CMEK 来加密和解密数据。这些加密密钥由您创建、管理和拥有。 如需了解详情，请参阅使用 Cloud KMS 密钥保护资源。
    添加 CMEK 时，您必须按照下表中的说明授予权限。
    角色 所需权限 说明
    Cloud VM Migration Service Account roles/vmmigration.serviceAgen 向 Compute Engine 服务账号授予此权限，以加密导入过程中创建的映像的数据。
    Compute Engine Service Agent roles/compute.serviceAgent 向 Migrate to Virtual Machines 服务代理授予此权限，以便在导入过程中加密数据。

  5. 选择创建。

gcloud

如需使用 Google Cloud CLI 将虚拟磁盘映像导入 Compute Engine，请使用以下请求。

gcloud alpha migration vms image-imports create IMAGE_NAME \
--source-file=SOURCE_FILE \
--target-project=projects/HOST_PROJECT_ID/locations/global/targetProjects/TARGET_PROJECT

替换以下内容：

  • HOST_PROJECT_ID：要从中迁移虚拟磁盘映像的宿主项目的名称。
  • REGION_ID：您希望在其中运行映像导入过程的区域。将在最近的多区域中创建此映像。如果要在某个区域中创建映像，请确保将 singleRegionStorage 设置为 true。如需查看支持的区域列表，请参阅区域和可用区。
  • SOURCE_FILE：要从中导入映像的文件。输入 gs://bucket/folder/file 格式的路径。如需获取存储桶中对象的路径，请参阅查看对象元数据。请注意，您只能从 .vmdk 和 .tar.gz 文件导入映像。
  • IMAGE_NAME：您要创建的映像的名称。如需详细了解命名规则，请参阅命名惯例。
  • TARGET_PROJECT：要在其中创建映像的目标项目。如果您尚未添加目标项目，请按照添加目标项目中提供的说明执行此操作。

如需了解详情，请参阅 gcloud alpha migration vms image-imports。

REST

如需使用 REST API 将虚拟磁盘映像导入 Compute Engine，请按以下步骤操作。

  1. 使用以下请求创建映像导入资源。

    POST https://vmmigration.googleapis.com/v1/projects/HOST_PROJECT_ID/locations/REGION_ID/imageImports?imageImportId=IMPORT_NAME
{
"cloudStorageUri": "SOURCE_FILE",
"diskImageTargetDefaults": {
"imageName": "IMAGE_NAME",
"targetProject": "projects/HOST_PROJECT_ID/locations/global/targetProjects/TARGET_PROJECT",
...
}
}

    替换以下内容：

    • HOST_PROJECT_ID：要从中迁移虚拟磁盘映像的宿主项目的名称。
    • REGION_ID：您希望在其中运行映像导入过程的区域。将在最近的多区域中创建此映像。如果要在某个区域中创建映像，请确保将 singleRegionStorage 设置为 true。如需查看支持的区域列表，请参阅区域和可用区。
    • SOURCE_FILE：要从中导入映像的文件。输入 gs://bucket/folder/file 格式的路径。如需获取存储桶中对象的路径，请参阅查看对象元数据。请注意，您只能从 .vmdk 和 .tar.gz 文件导入映像。
    • IMAGE_NAME：您要创建的映像的名称。如需详细了解命名规则，请参阅命名惯例。
    • TARGET_PROJECT：要在其中创建映像的目标项目。如果您尚未添加目标项目，请按照添加目标项目中提供的说明执行此操作。

    在此示例中，IMPORT_NAME 是表示映像导入资源的 ID。将映像导入 Compute Engine 时，Migrate to Virtual Machines 会首先创建映像导入资源。映像导入资源表示映像导入过程。您可以使用 IMPORT_NAME 获取在映像导入过程中导入的映像的链接。

    如需查看映像导入创建请求字段支持的字段的完整列表，请参阅下表。

    字段名称 说明
    cloudStorageUri string
    要从中导入映像的文件的路径。输入 gs://bucket/folder/file 格式的路径。如需获取存储桶内对象的路径，请参阅查看对象元数据。
    请注意，您只能从 .vmdk 和 .tar.gz 文件导入映像。
    diskImageTargetDefaults.targetProject string
    TargetProject 的路径。要在其中创建映像的目标项目。如需了解详情，请参阅目标项目 API 参考文档。例如：
    projects/HOST_PROJECT_ID/locations/global/targetProjects/TARGET_PROJECT
    在示例中，替换以下内容：
    • HOST_PROJECT_ID：要从中迁移虚拟磁盘映像的宿主项目的名称。
    • TARGET_PROJECT：要在其中创建映像的目标项目。
    diskImageTargetDefaults.imageName string
    要创建的映像的名称。如需详细了解命名规则，请参阅资源命名惯例。
    diskImageTargetDefaults.description string
    （可选）映像的说明。
    diskImageTargetDefaults.familyName string
    （可选）选择映像系列。Compute Engine 提供了映像系列，以帮助您确保自动化系统可以引用最新映像。作为管理员，您可以将一组映像划分为一个映像系列。如需了解详情，请参阅公共映像系列。如需了解详情，请参阅公共映像系列。
    diskImageTargetDefaults.labels map (key: string, value: string)
    如需整理项目，请为资源添加键值对形式的标签。请参阅为资源添加标签。
    diskImageTargetDefaults.additionalLicenses string[]
    使用有效的网址格式，您最多可以向通过导入的映像创建的虚拟机实例添加 10 个额外许可。例如，您可以使用以下网址格式添加额外许可： 
    
https://www.googleapis.com/compute/beta/projects/windows-sql-cloud/global/licenses/sql-server-2012-enterprise
    diskImageTargetDefaults.singleRegionStorage boolean
    如果您希望映像 storageLocations 是一个区域，请将此标志设置为 true。如果将此标志设置为 false，则系统会选择最近的多区域。
    diskImageTargetDefaults.dataDiskImageImport boolean
    如果要跳过操作系统适配，请将此标志设置为 true。
    为了在 Google Cloud 上正常运行，基于导入的映像创建的虚拟机需要更改配置。这些更改称为“操作系统适配”。Migrate to Virtual Machines 在映像导入过程中自动执行操作系统适配。如需了解详情，请参阅调整虚拟机实例，使其能够在 Google Cloud 上运行。
    diskImageTargetDefaults.osAdaptationParameters.licenseType string
    您要用于映像的许可类型。Compute Engine 支持为已部署的虚拟机使用随用随付 (PAYG) 许可以及自带许可 (BYOL)。Migrate to Virtual Machines 会根据迁移后的操作系统为迁移后的虚拟机分配默认许可类型，如支持的操作系统中所述。
    如果您的操作系统支持多种许可类型，您可以替换默认许可类型，以明确指定许可类型 PAYG 或 BYOL。
    diskImageTargetDefaults.osAdaptationParameters.generalize boolean
    如果要泛化映像，请将此标志设置为 true。
    从映像创建实例时，Windows 会向实例添加一些唯一信息。泛化是指移除此信息的过程，以便您可以从同一映像创建多个实例。
    diskImageTargetDefaults.encryption string
    您要在导入过程中用于加密数据的 Google 管理的加密密钥。如需了解详情，请参阅加密静态数据。
    encryption string
    选择此选项，可在导入过程中使用客户管理的加密密钥 (CMEK) 来加密数据，以及导入过程创建的映像的数据。如果您对保护数据的密钥有特定的合规性或监管要求，则可以使用 CMEK 来加密和解密数据。这些加密密钥由您创建、管理和拥有。 如需了解详情，请参阅使用 Cloud KMS 密钥保护资源。
    添加 CMEK 时，您必须按照下表中的说明授予权限。
    角色 所需权限 说明
    Cloud VM Migration Service Account roles/vmmigration.serviceAgent 向 Compute Engine 服务账号授予此权限，以加密导入过程中创建的映像的数据。
    Compute Engine Service Agent roles/compute.serviceAgent 向 Migrate to Virtual Machines 服务代理授予此权限，以便在导入过程中加密数据。

    您看到的响应应该与以下示例响应类似。

    {
  "name": "projects/HOST_PROJECT_ID/locations/REGION_ID/operations/OPERATION_ID",
  "metadata": {
    "createTime": "2023-10-31T09:12:26.94928636Z",
    "target": "projects/HOST_PROJECT_ID/locations/us-central1/imageImports/IMPORT_NAME",
    "verb": "create",
    "apiVersion": "v1",
    "@type": "type.googleapis.com/google.cloud.vmmigration.v1.OperationMetadata"
  }
}

  2. 使用以下命令轮询操作，以检查映像导入作业是否已完成。

    GET https://vmmigration.googleapis.com/v1/projects/HOST_PROJECT_ID/locations/REGION_ID/operations/OPERATION_ID

    替换以下内容：

    • HOST_PROJECT_ID：要从中迁移虚拟磁盘映像的宿主项目的名称。
    • REGION_ID：您希望在其中运行映像导入过程的区域。将在最近的多区域中创建此映像。如果要在某个区域中创建映像，请确保将 singleRegionStorage 设置为 true。如需查看支持的区域列表，请参阅区域和可用区。
    • OPERATION_ID：迁移作业的操作 ID。

    您应该会看到类似于以下示例响应的操作完成响应。

      {
    "done": true,
    "name": "projects/HOST_PROJECT_ID/locations/REGION_ID/operations/OPERATION_ID",
    "response": {
      "@type": "type.googleapis.com/google.cloud.vmmigration.v1.ImageImport",
      "name": "projects/<HOST_PROJECT_ID>/locations/us-central1/imageImports/IMPORT_NAME",
      "cloudStorageUri": "SOURCE_FILE",
      "createTime": "2023-10-31T09:04:04.413664947Z",
      "diskImageTargetDefaults": {
        "imageName": "IMAGE_NAME",
        "targetProject": "projects/HOST_PROJECT_ID/locations/global/targetProjects/TARGET_PROJECT"
      },
      "recentImageImportJobs": [
        {
          "name": "projects/HOST_PROJECT_ID/locations/us-central1/imageImports/IMPORT_NAME/imageImportJobs/image-import-job",
          "diskImageTargetDetails": {
           "imageName": "IMAGE_NAME",
           "targetProject": "projects/HOST_PROJECT_ID/locations/global/targetProjects/TARGET_PROJECT"
        },
         "state": "PENDING"
       }
      ]
    },
    "metadata": {
      "createTime": "2023-10-31T09:04:04.416740716Z",
      "endTime": "2023-10-31T09:05:36.79987142Z",
      "target": "projects/HOST_PROJECT_ID/locations/us-central1/imageImports/IMPORT_NAME",
      "verb": "create",
      "apiVersion": "v1",
      "@type": "type.googleapis.com/google.cloud.vmmigration.v1.OperationMetadata"
    }
  }

  3. 使用以下命令监控映像导入作业是否完成。

    GET https://vmmigration.googleapis.com/v1/projects/HOST_PROJECT_ID/locations/REGION_ID/imageImports/IMPORT_NAME/imageImportJobs/image-import-job

    替换以下内容：

    • HOST_PROJECT_ID：要从中迁移虚拟磁盘映像的宿主项目的名称。
    • REGION_ID：您希望在其中运行映像导入过程的区域。将在最近的多区域中创建此映像。如果要在某个区域中创建映像，请确保将 singleRegionStorage 设置为 true。如需查看支持的区域列表，请参阅区域和可用区。
    • IMPORT_NAME：表示映像导入资源的 ID。将映像导入 Compute Engine 时，Migrate to Virtual Machines 会首先创建映像导入资源。映像导入资源表示映像导入过程。您可以使用 IMPORT_NAME 获取在映像导入过程中导入的映像的链接。

    您应该会看到类似于以下示例响应的作业完成响应。

    {
  "createTime":"2023-10-31T09:12:27.053788394Z",
  "createdResources":[
    "https://www.googleapis.com/compute/v1/projects/USER_PROJECT/global/images/IMAGE_NAME"
  ],
  "diskImageTargetDetails": {
    "imageName":"IMAGE_NAME",
    "targetProject":"projects/HOST_PROJECT_ID/locations/global/targetProjects/TARGET_PROJECT"
  },
  "endTime":"2023-10-31T09:16:50.224865783Z",
  "name":"projects/HOST_PROJECT_ID/locations/us-central1/imageImports/IMPORT_NAME/imageImportJobs/image-import-job",
  "state":"SUCCEEDED"
}