创建机器映像

使用机器映像可以存储 Compute Engine 上运行的虚拟机实例的多个磁盘的所有配置、元数据、权限和数据。用于创建机器映像的虚拟机实例称为“来源虚拟机实例”。

如需了解何时以及如何使用机器映像，请参阅机器映像。

本文档介绍了通过来源虚拟机实例创建机器映像的步骤。

准备工作

• 如果您尚未设置身份验证，请进行设置。身份验证是通过其进行身份验证以访问 Google Cloud 服务和 API 的过程。如需从本地开发环境运行代码或示例，您可以通过选择以下选项之一向 Compute Engine 进行身份验证：
  

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  1. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

  REST

  如需在本地开发环境中使用本页面上的 REST API 示例，请使用您提供给 gcloud CLI 的凭据。

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  如需了解详情，请参阅 Google Cloud 身份验证文档中的使用 REST 时进行身份验证。

局限和限制

• 每 60 分钟最多可以创建特定实例的机器映像 6 次。
• 您可以使用 Cloud Key Management Service (Cloud KMS) 或 CSEK（客户提供的加密密钥）来保护机器映像。加密密钥用于保护磁盘的内容。不过，元数据不受保护。
• 如果您使用 CSEK 来保护机器映像，则在生成机器映像期间，系统会存储所有磁盘数据的完整副本。在其他所有情况下，磁盘数据会存储在差分副本中。

• 您无法通过符合以下条件的来源虚拟机创建机器映像：

  • 挂接的磁盘超过 200 TB。
  • 没有挂接任何磁盘。
  • 挂接了任何 Hyperdisk 卷。
  • 使用 C3D、H3、A3 或 Z3 机器类型

机器映像不支持的实例和磁盘属性

通过虚拟机实例创建机器映像或通过机器映像创建虚拟机实例时，系统不会保留或恢复以下实例和磁盘属性：

• disks.architecture
• disks.description
• disks.labels
• disks.locked
• disks.multiWriter
• disks.onUpdateAction
• disks.provisionedIops
• disks.shieldedInstanceInitialState
• disks.sourceImage
• disks.sourceImageEncryptionKey
• disks.sourceInstantSnapshot
• disks.sourceSnapshot
• disks.sourceSnapshotEncryptionKey
• privateIpv6GoogleAccess
• resourceManagerTags
• resourcePolicies
• secure_tag
• shieldedInstanceConfig

通过虚拟机创建机器映像

您可以使用Google Cloud 控制台、Google Cloud CLI 或 REST 创建机器映像。

如需创建机器映像，您需要以下信息：

• 您要创建的机器映像的名称。
• 来源虚拟机实例的名称。
• 来源虚拟机实例所在的可用区。
• 可选的说明。
• 可选的 storageLocation。 如果您没有指定位置，则默认存储位置为来源虚拟机实例的多区域 Cloud Storage 位置。
• 可选的加密密钥。您可以选择 Google-owned and Google-managed encryption key、Cloud Key Management Service (Cloud KMS) 密钥或客户提供的加密密钥 (CSEK)。如果未指定加密密钥，则系统会使用 Google-owned and Google-managed encryption key对机器映像进行加密。

• 如果您想使用机器映像进行实例克隆和快照，请先移除实例特有的操作系统和应用信息，然后再通过实例生成机器映像。例如，对于 Windows 虚拟机实例，请使用 GCESysprep 为复制准备系统。

gcloud compute machine-images create MACHINE_IMAGE_NAME \
    --source-instance=SOURCE_VM_NAME

gcloud compute machine-images create my-machine-image  \
    --source-instance=my-instance

Created [https://www.googleapis.com/compute/v1/projects/project-12345/global/machineImages/my-machine-image].
NAME               STATUS
my-machine-image   READY

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/machineImages

{
  "name": "MACHINE_IMAGE_NAME",
  "sourceInstance": "SOURCE_INSTANCE_URL"
}

后续步骤

• 详细了解机器映像
• 通过机器映像创建虚拟机实例