构建虚拟机映像

本页面可帮助您为您的产品创建公共机器映像，以便在 Compute Engine 上运行。

映像包含引导加载程序、操作系统以及启动实例所需的根文件系统。您可以使用产品的一组应用和服务来配置映像。客户使用该映像在云端启动虚拟机 (VM) 实例。

我们建议您先在开发项目中创建映像，然后在 Google 合作伙伴工程师验证映像后将其移到公共项目中。

注意：如果您要自动执行构建虚拟机映像的过程，请考虑使用开源工具 Imagebuilder，它可以减少在更新软件时创建新映像所需的时间。

准备工作

1. 下载 Google Cloud SDK。

创建基础产品虚拟机

如需为 Cloud Marketplace 创建自定义机器类型，您需要执行以下操作： 请完成以下步骤（如以下部分所述）：

• 使用其中一个 Google 支持的基础公共映像创建虚拟机，并安装特定于应用的软件包和配置。

  您可以选择使用 Arm 处理器或 x86 的映像 处理器。您还可以添加多张图片， 一个虚拟机产品中。如需详细了解 CPU 平台， 以及支持它们的机器类型，请参阅 CPU 平台：

• 如果您打算为客户提供支持，请安装脚本以检索应用用户凭据。

创建许可的虚拟机映像

1. 使用 gcloud 设置 Google Cloud CLI 的默认值：

   gcloud config set project <project_id>
   gcloud config set compute/zone <zone>

2. 创建一个用于安装软件的主实例，之后再执行 转换为映像，以便在 Cloud Marketplace 上使用。如需了解有关创建实例的更多信息，请参阅创建和启动实例。

   gcloud compute instances create ${INSTANCE} --scopes
   https://www.googleapis.com/auth/cloud-platform 

3. 安装和自定义您的软件。包括所需的所有启动脚本，例如用于创建授权凭据的启动脚本。

   如需使用安全的随机密码创建授权凭据，请按照下一部分中创建授权凭据中的步骤操作。

   注意 ：如果您的应用具有 则您的应用必须 通过服务器脚本自定义 从实例元数据中读取用户登录凭据，并设置 在部署过程中添加用户名和密码。

   创建并自定义主实例后，请准备创建虚拟机映像所需的磁盘。

4. 清理磁盘。直接从您的虚拟机创建虚拟机映像也会将用户目录和 SSH 密钥转移到客户的虚拟机中，因此，在创建虚拟机映像时，您必须清理输入磁盘。

   要清理磁盘，请执行以下操作：

   1. 在 Compute Engine 虚拟机实例菜单中，单击要清除的实例的名称，然后单击编辑。

   2. 向下滚动并清除在删除实例时也删除启动磁盘 复选框，然后点击保存。您将使用该磁盘来创建映像。

   3. 在删除虚拟机的同时保留磁盘。系统会提示您确认删除。不要选择同时也删除启动磁盘。

   4. 接下来，您需要创建一个新的虚拟机实例。展开管理， disk、networking、SSH keys 选项。

   5. 在磁盘下，将先前实例中的磁盘作为附加数据磁盘挂载。确保为选择选择 删除实例。

      您现在可以通过 SSH 登录到实例并移除在软件安装过程中创建的任何主目录或其他临时文件。 您必须先装载数据磁盘，然后才能访问它。如需详细了解如何装载磁盘，请参阅添加永久性磁盘或调整其大小。

   6. 完成后，在将实例关停并删除的同时保留更新的数据磁盘。现在，您可以通过完成以下步骤来创建虚拟机映像。

5. 使用以下命令在 Producer Portal 中获取虚拟机产品的许可名称 步骤：

   1. 在 Google Cloud 控制台中打开 Producer Portal：

      https://console.cloud.google.com/producer-portal?project=YOUR_PROJECT_ID
      

      将 YOUR_PROJECT_ID 替换为您的开发项目或公开项目的 ID。我们建议您先创建 然后将其公开 。

   2. 点击产品名称。

   3. 前往部署软件包部分。在虚拟机许可下，请注意 名称。您将在后续步骤中使用该许可名称 您的映像

6. 通过运行以下命令创建许可映像 gcloud 命令：

   注意：此命令需要几分钟的时间才能运行。

   gcloud compute images create CREATE_IMAGE_NAME \
    --project PUBLIC_PROJECT_NAME \
    --source-disk projects/DEV_PROJECT_NAME/zones/SOURCE_DISK_ZONE/disks/SOURCE_DISK_NAME \
    --licenses LICENSE_NAME \
    --description ADD_DESCRIPTION

   替换以下内容：

   • CREATE_IMAGE_NAME：映像名称和 CPU 其支持的架构，格式为 who-vmOS-image-architecture-date，将 architecture 替换为 Arm 或 x86_64，具体取决于映像的 CPU 架构 支持。每次为产品更新映像时，都必须使用一个新的唯一名称。

   • PUBLIC_PROJECT_NAME：您的公共项目的 ID 使用 Cloud Marketplace您必须已被授予 Compute Storage Admin 角色 (roles/compute.storageAdmin)。

   • LICENSE_NAME：您在上一步记下的虚拟机产品的许可名称。

   • DEV_PROJECT_NAME：您要创建的项目的 ID 为 Cloud Marketplace 的开发和测试而创建的。您必须拥有此项目的 Compute Image User 角色 (roles/compute.imageUser)。

   • SOURCE_DISK_ZONE：来源磁盘的可用区。

   • SOURCE_DISK_NAME：来源磁盘的名称。

   • ADD_DESCRIPTION：待创建映像的可选文本说明。

公开映像

注意 ：如果您打算仅支持基于 Terraform 的部署，或者计划 使用 Marketplace 拥有的映像； 则可以跳过此部分。

对于不使用 Marketplace 自有映像的非 Terraform 产品，您必须 公开您的映像，以便客户可以将其部署到 Compute Engine 实例如需公开映像，请使用 Google Cloud 控制台或 Google Cloud CLI：

控制台

1. 在公共项目的 Compute Engine 下，转到“映像”页面。

   转到“映像”页面

2. 选择您的映像，如下所示：

   

3. 如果右上角没有显示信息面板，请点击显示信息面板。

4. 在信息面板的添加成员字段中，输入 allAuthenticatedUsers，然后从选择角色菜单中选择 Compute Image User。

   

5. 点击添加以公开映像。

命令行

在 Cloud Shell 中或本地机器上使用以下 gcloud 命令：

gcloud compute images add-iam-policy-binding IMAGE_NAME --member=allAuthenticatedUsers --role=roles/compute.imageUser

创建授权凭据

如果您的产品是使用基本防火墙规则对单个虚拟机实例进行简单部署，则当您直接配置部署包时，可以自动添加安全的随机密码。

如果您打算使用开源 mpdev 工具创建部署包（建议大部分情况都这样做），然后您可以使用 mpdev 自动添加多个安全的随机密码。

如需了解创建授权凭据的步骤，请参阅 创建部署包。

在部署产品后，获取您在 Google Cloud 控制台中 请在虚拟机实例中使用以下命令：

curl -H "Metadata-Flavor: Google" \
http://metadata/computeMetadata/v1/instance/attributes/PASSWORD_NAME

测试虚拟机映像

使用您新建的映像创建虚拟机实例，并验证功能。

此外，要验证许可 ID，请通过 SSH 登录实例并验证是否附加了有效许可证：

curl -s -H "Metadata-Flavor: Google" http://metadata.google.internal/computeMetadata/v1/instance/licenses/?recursive=true

验证是否已安装 Python 2.6 或更高版本：

python -V

验证是否已安装以下软件包：

gcloud --version
ssh -V
ps aux | grep sshd
curl -V
ps aux | grep dhcp

检查以确保除了您自己的用户目录之外，实例上没有安装其他用户目录，并且除了您自己的用户目录和凭据之外，没有其他任何的用户目录和凭据。

注意：当 Google 更新基本公共映像时，您需要每月重新构建和重新发布一次映像。