文档

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

更新时间:

当您使用镜像模板定制镜像内容时,可以配置跨地域、跨账号分发镜像。镜像模板创建完成后,系统会按照镜像模板配置的内容生成构建任务,任务执行过程中也会自动检测镜像模板中各配置项是否存在异常。本文介绍如何通过ECS控制台创建镜像模板并按照定制的模板内容手动执行镜像构建任务。

创建镜像模板

注意事项

在操作前,请您了解以下注意事项:

  • 仅支持创建您自定义的镜像模板。

  • 仅支持Linux系统的公共镜像、自定义镜像、共享镜像或者镜像族系作为源镜像。

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

操作步骤

  1. 登录ECS管理控制台

  2. 在左侧导航栏,选择部署与弹性 > icon1 > 镜像构建

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

  4. 镜像构建页面,单击创建镜像模板

    如果您第一次访问镜像构建服务,将进入镜像构建欢迎页,您需要先单击立即体验进入镜像构建页面。

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

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

    • 基本信息区域

      配置项

      说明

      构建模板名称

      必填。镜像模板的名称。

      描述

      镜像模板的描述。

      标签

      镜像模板的标签,用于统一管理资源。更多信息,请参见标签概述

    • 配置源镜像区域

      配置项

      说明

      通过Dockerfile导入模板

      构建模板命令兼容Dockerfile的部分命令,因此您也可以直接通过Dockerfile导入已编辑好的模板内容。

      重要

      但是导入Dockerfile内容会覆盖您通过ECS控制台已配置的源镜像类型镜像构建模板信息,请谨慎操作。

      源镜像类型

      支持设置镜像镜像族系

      镜像镜像族

      必填。配置项根据源镜像类型的设置有所不同。

      说明

      目前仅支持选择Linux系统的镜像。

      • 源镜像类型镜像时,第一个下拉列表支持选择自定义镜像公共镜像共享镜像。第二个下拉列表选择对应的镜像ID或镜像版本。

      • 源镜像类型镜像族系时,选择已有的镜像族系或者输入新的镜像族系

      构建模板

      单击新增命令,然后设置命令与内容。设置完成后可以单击预览模板查看模板内容。

      说明
      • 命令内容大小不能超过16 KB,命令设置的上限为127个。

      • 命令支持选择自定义组件系统组件,对应的内容为组件ID。通过系统组件创建镜像模板可以提供稳定、可靠的镜像,推荐您使用系统组件创建镜像模板。

      • 支持的命令详情,请参见镜像构建服务(ImageBuilder)指令集

    • 配置中转实例区域

      配置项

      说明

      虚拟交换机

      需要配置当前地域下可使用的交换机。不设置值时,系统将默认创建临时的VPC和交换机,请确保您地域下的资源配额充足。

      实例规格

      设置中转实例的实例规格。不设置值时,默认按vCPU和内存最小的原则,自动设置实例规格,并受实例规格的库存影响。例如,默认选择ecs.g6.large实例规格,如果库存不足,将选择ecs.g6.xlarge实例规格。

      系统盘大小

      中转实例的系统盘大小。取值范围为20~500 GiB,默认值为40 GiB。

      公网带宽/Mbps

      公网带宽默认值为0,即不具备公网访问能力。当您的镜像构建内容中存在需要访问公网的命令(例如下载命令)时,您必须设置一定值的公网带宽。否则,镜像构建任务会失败。

      镜像构建失败是否销毁中转实例

      您可以根据需求选择是否保留中转实例。

      说明

      如果您选择保留中转实例,实例将持续计费。当您不再需要中转实例时,请及时手动释放。具体操作,请参见释放实例

    • 配置镜像分发区域

      配置项

      说明

      目标镜像名称

      目标镜像名称前缀。最终完整的镜像名称由系统自动拼接名称前缀与构建任务ID(ExecutionId),格式为自定义名称前缀_构建任务ID

      当前地域

      系统展示ECS控制台当前所在地域。

      目标地域

      如果需要将构建的镜像复制到多个地域,您可以设置目标地域,构建的镜像将会分发至指定的目标地域。分发地域数量限制为0~20个。也可以不设置目标地域。

      共享UID

      如果需要将构建的镜像共享给其他阿里云账号,您可以设置共享UID。设置后,构建的镜像将会共享给同地域下指定的阿里云账号。共享UID数量限制为0~20个。您也可以选择不设置共享UID。

      创建后立即执行

      您可以根据需求选择是否立即执行构建镜像任务。如果不立即执行,您可以手动执行任务,具体操作,请参见执行构建任务

    创建成功后,您可以在镜像构建页面查看已创建的镜像模板。

执行构建任务

在创建镜像模板的过程中,如果未启动立即执行任务,您需要手动执行任务来构建镜像任务。

注意事项

在操作前,请您了解以下注意事项:

  • 同一个镜像模板,同一时间只能执行一个构建任务。

  • 取消构建镜像任务可以同时执行多次,并且取消构建镜像任务和构建镜像任务之间互不干扰。

操作步骤

  1. 登录ECS管理控制台

  2. 在左侧导航栏,选择部署与弹性 > icon1 > 镜像构建

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

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

    说明

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

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

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

相关文档

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

  • 本页导读 (1)