创建镜像模板并执行构建任务

前提条件

在首次创建镜像组件或镜像模板时，系统会自动为您创建一个镜像关联服务角色（AliyunServiceRoleForECSImageBuilder），用于授权镜像构建服务访问相关的云资源。当使用RAM用户时，需要手动为其添加镜像构建服务的权限，以便管理镜像构建服务关联角色。主账户默认拥有此权限。具体请参见管理镜像构建服务关联角色。

步骤一：创建镜像模板

1. 登录ECS管理控制台。

2. 在左侧导航栏，选择实例与镜像 > > 镜像构建。

3. 在页面左侧顶部，选择目标资源所在的资源组和地域。

4. 在镜像构建页面的镜像模板页签，单击创建镜像模板。

   说明

   如果您是第一次访问镜像构建服务，将进入镜像构建欢迎页，直接单击创建镜像模板。

5. 完成镜像模板的配置，然后单击确定。

   镜像模板的配置项说明如下表所示。

   • 基本信息

     参数	是否必填	说明
     构建模板名称	是	镜像模板的名称。
     描述	否	镜像模板的描述。
     标签	否	镜像模板的标签，用于统一管理资源。更多信息，请参见标签。

   • 配置源镜像

     参数	是否必填	说明
     源镜像类型	是	设置为镜像或镜像族系。 说明 仅支持使用公共镜像、自定义镜像、共享镜像或者镜像族系作为源镜像，不支持云市场镜像和社区镜像。
     镜像或镜像族	是	设置源镜像。配置项根据源镜像类型的设置有所不同。 源镜像类型为镜像时，第一个下拉列表支持选择自定义镜像、公共镜像、共享镜像，第二个下拉列表选择对应的镜像ID。 源镜像类型为镜像族系时，选择已有的镜像族系。

   • 配置模板内容

     参数	是否必填	说明
     构建模板	否	在构建模板中添加镜像组件来快速创建镜像模板。 说明 通过系统组件创建镜像模板可以提供稳定、可靠的镜像，因此推荐您使用系统组件创建镜像模板。 仅支持控制台添加镜像组件快速创建镜像模板，API不支持该功能。
     是否执行镜像修复	否	您可以开启镜像检测修复，在执行构建任务前系统自动检测并修复构建镜像的一些常见问题，并安装云上镜像的必要组件（例如云助手）。目前支持的检测修复项如下： Linux系统 GUESTOS.CloudInit GUESTOS.Dhcp GUESTOS.Virtio GUESTOS.OnlineResizeFS GUESTOS.Grub GUESTOS.Fstab Windows系统 GUESTOS.Virtio GUESTOS.Update GUESTOS.Hotfix GUESTOS.Server 说明 随着检测修复能力的不断提升，包含的修复项可能会增加。修复项的具体含义，请参见镜像检测概述。 默认值：开启镜像检测修复。 说明 如果关闭镜像检测修复，系统只进行镜像检测，不会修复镜像。
     是否执行镜像测试	否	您可以开启执行镜像测试，在构建任务执行完成后系统自动使用指定的组件对新镜像进行测试，以确保在正式使用前该镜像可以达到预期的使用效果。 重要 测试流程会创建新的中转实例用于测试，中转实例是按量计费的ECS实例，将收取一定的费用。更多信息，请参见按量付费。 默认值：开启镜像测试。
     测试构建模板	是	选择Test类型镜像组件。

   • 配置中转实例

     重要

     通过镜像模板构建镜像时，需要创建多台中转实例辅助构建镜像，中转实例是按量计费的 ECS 实例，将收取一定的费用。更多信息，请参见按量付费。

     参数	是否必填	说明
     虚拟交换机	否	需要配置当前地域下可使用的交换机。 默认值：系统默认创建临时的VPC和交换机，请确保您所在区域的资源配额充足。
     实例规格	否	设置中转实例的实例规格。 默认值：默认按vCPU和内存最小的原则，自动设置实例规格，并受实例规格的库存影响。例如，默认选择ecs.g6.large实例规格，如果库存不足，将选择ecs.g6.xlarge实例规格。
     系统盘大小	否	中转实例的系统盘大小，取值范围为20~500 GiB。 默认值：40 GiB。
     公网带宽/Mbps	否	当您的镜像构建内容中存在需要访问公网的命令（例如下载命令）时，您必须设置一定值的公网带宽。否则，镜像构建任务会失败。 默认值：0，即不具备公网访问能力。
     镜像构建失败是否销毁中转实例	否	您可以根据需求选择是否保留中转实例。 说明 如果您选择保留中转实例，实例将持续计费。当您不再需要中转实例时，请及时手动释放。具体操作，请参见释放实例。 默认值：销毁中转实例。

   • 配置镜像分发

     配置项	是否必填	说明
     目标镜像名称	否	设置构建镜像的名称前缀。最终完整的镜像名称由系统自动拼接名称前缀与构建任务ID（ExecutionId），格式为自定义名称前缀_构建任务ID。 默认值：构建任务ID。
     当前地域	否	默认展示当前模板所在地域。
     目标地域	否	如果需要将构建镜像复制到多个地域，您可以设置目标地域，构建的镜像将会分发至指定的目标地域。目标地域数量限制为0~20个。 默认值：与当前模板所在地域相同。
     共享UID	否	如果需要将构建镜像共享给其他阿里云账号，您可以设置共享UID。设置后，构建镜像将会共享给同地域下指定的阿里云账号。共享UID数量限制为0~20个。 默认值：无。
     创建后立即执行	否	您可以根据需求选择是否立即执行构建镜像任务。如果不立即执行，模板创建完成后您可以手动执行任务，具体操作，请参见步骤二：执行构建任务。 默认值：立即执行，创建模板后立即执行构建任务。

6. （可选）模板创建完成后，您可以查看已创建的镜像模板详情。

   单击镜像模板ID，在镜像模板详情页面查看：

   • 在构建历史页签，可以查看构建任务的历史执行详情。

   • 在查看构建模板页签，可以查看镜像模板的构建内容。

   • 在查看测试模板页签，可以查看测试镜像的内容。

步骤二：执行构建任务

在创建镜像模板过程中，支持勾选立即执行任务，即在创建模板后立即触发一次任务执行。如果您希望后续手动执行任务来构建自定义镜像，可以执行本节操作。

操作步骤

1. 登录ECS管理控制台。

2. 在左侧导航栏，选择实例与镜像 > > 镜像构建。

3. 在页面左侧顶部，选择目标资源所在的资源组和地域。

4. 在镜像构建页面的镜像模板页签，找到需要执行构建任务的镜像模板，然后在操作列单击执行。

   说明

   • 在镜像构建任务执行过程中，如果您需要取消正在执行的任务，可以单击镜像模板ID，在构建历史页签构建任务的操作列单击取消。

   • 根据部署业务以及执行的命令不同，构建完成时间可能不同，请您耐心等待。

   • 构建镜像任务执行成功后，构建任务的状态为成功，并且生成对应的镜像ID。您可以单击镜像ID查看生成的镜像详情。

   • 如果构建任务的状态为失败，可以在执行结果列查看详细的报错信息，以定位并排查问题。

相关文档

• 您也可以通过API接口完成以下操作：

  • CreateImagePipeline - 创建镜像构建模板

  • StartImagePipelineExecution - 通过一个镜像模板执行构建镜像的任务

  • DescribeImagePipelines - 查询一个或多个镜像模板的详细信息

  • DescribeImagePipelineExecutions - 查询一个镜像构建任务的详细信息

  • CancelImagePipelineExecution - 取消一个镜像构建任务

• 按照镜像模板定制的内容执行镜像构建任务后，您可以：

  • 在目标地域查看构建的自定义镜像。

  • 根据业务需要，通过构建的新镜像创建ECS实例或更换ECS实例的操作系统。具体操作，请参见使用自定义镜像创建ECS实例或更换操作系统（更换系统盘）。