You need to enable JavaScript to run this app.
导航
镜像构建推送至自定义镜像仓库
最近更新时间:2024.11.07 19:19:14首次发布时间:2023.10.23 11:22:00

持续交付预置 镜像构建推送至自定义镜像仓库 任务,支持通过 Dockerfile 构建容器镜像,并推送至自定义的镜像仓库(自建镜像仓库或第三方云厂商镜像仓库)。本文为您介绍该预置任务的使用说明。

使用限制

可构建镜像大小 ≤ 5 G。

前提条件

  • 已准备待推送的镜像仓库地址、账号、密码。
  • 已准备构建需要的 Dockerfile 文件。

添加任务

创建或编辑流水线时,在 流程编排 页签,单击 添加任务,弹出 添加任务 抽屉。任务模板选择 镜像构建推送至自定义镜像仓库

参数说明

下文为您介绍该预置任务的参数。

  • 任务名称
    默认为镜像构建推送至自定义镜像仓库,支持自定义任务名称。

  • 上游任务
    展示当前任务的上游串行任务名称。无上游任务时展示为-

  • 代码源下载策略
    根据当前任务是否需要使用代码源,选择代码源下载策略。

    • 下载代码:当前任务需要下载代码源。
    • 不下载代码:当前任务无需使用代码源。
  • 步骤
    当前任务包含一个默认预置步骤(镜像构建推送至自定义仓库)。支持根据需要为当前任务添加其他串行步骤。下文介绍该默认预置步骤的参数。

配置项说明
步骤名称默认为镜像构建推送至自定义仓库,支持自定义步骤名称。

镜像地址

Docker 镜像待上传的地址,支持 HTTP 和 HTTPS 协议。

  • 地址支持固定 Repository,例如:xxx.com/ns/demo:1.0

  • 地址支持使用动态参数,例如:xxx.com/ns/demo:$(DATETIME)

用户名输入目标镜像仓库登录账号。

密码

输入目标镜像仓库登录密码。

说明

暂不支持拉取需要二次鉴权的私有基础镜像。如果您需要拉取私有基础镜像,建议使用同一仓库实例(Registry Instance)来存储待拉取的基础镜像和最终要推送的镜像。这种场景下,推送和拉取共享同一套账密。

contextpathdocker build 命令执行上下文路径。填写相对于代码根目录的路径,默认为.

Dockerfile

指定待构建的 Dockerfile 文件。Dockerfile 支持以下配置两种方式。

  • 文件路径:填写 Dockerfile 文件相对于代码库根目录所在路径。

  • 自定义文件:在命令框中输入 Dockerfile 文件内容。

如果您选择构建多架构镜像,需要分别指定每种架构的 Dockerfile。

  • 多架构构建:可选配置。是否开启多架构构建。
    • 关闭:则默认构建 linux/amd64 架构的镜像。

    • 开启:需要进一步勾选具体希望构建的镜像架构。当前支持构建 linux/arm64 和 linux/amd64 两种架构的镜像。

构建参数

使用 docker build 命令构建镜像的过程中,支持指定相关构建参数,定制镜像的构建过程。
场景示例:

  • 使用--target <stage名称>,指定镜像构建的阶段。例如--target hello
  • 使用--build-arg <参数名>=<值>,替换 Dockerfile 中的 ARG 值。例如--build-arg VERSION=1.21.3

说明

  • 支持 docker build 常见参数。
  • 支持按需指定多条构建参数。
  • 指定多条构建参数时,推荐每条构建参数写一行。
  • 构建参数的值支持引用流水线变量。

忽略证书有效性

可选配置。勾选后,当前步骤中的所有内容不再校验 HTTPS 证书有效性。例如:推送/拉取镜像的仓库地址不再校验 HTTPS 证书有效性。

注意

该配置主要适用于仓库使用自签证书不受信的情形。忽略证书有效性涉及安全风险,一般情况下不建议勾选。

开启缓存

默认开启缓存,用于加速镜像构建,解决基础镜像拉取耗时长的问题。

  • 开启缓存:首次镜像构建完成后,系统会生成基础镜像的缓存。后续镜像构建过程中,无需重复拉取相同的基础镜像,可有效缩减镜像构建耗时。
  • 关闭缓存:系统会在构建命令中追加--no-cache,镜像构建过程中,会重新拉取基础镜像,耗时较长。

失败时跳过

可选配置。

  • 开启:当前步骤运行失败直接跳过,当前任务其余步骤可继续执行,流水线也可继续向下运行。

  • 关闭:当前步骤失败后,当前任务其余步骤不再执行,流水线将运行失败。

  • 任务输出
    展示当前任务输出的所有产物,包含当前任务下所有步骤的产物。无产物时展示为-。产物可用于后续任务的输入。
    对于当前默认预置步骤,将输出构建的镜像地址imageOutput_step-xxxx

  • 高级设置

    • 超时时间:设置整个任务的超时时间,任务超时后自动失败。一个任务可以包含多个串行步骤,每个步骤的超时时间受限于任务的超时时间。
    • Webhook 通知:支持通过 Webhook 和飞书机器人两种方式推送任务维度的消息,帮助您及时掌握任务动态。

日志及产物

下文为您介绍该预置任务运行完成后,流水线展示的详情信息。

在当前流水线的运行详情页面,单击镜像构建推送至自定义镜像仓库卡片的标题,查看运行日志、产物及任务配置信息。
alt

  • 运行日志:实时展示该任务的运行日志。
  • 任务配置:展示该任务的配置参数,详情可参考前文的参数说明。
  • 产物:运行成功后,镜像构建推送至自定义镜像仓库会输出构建成功的镜像地址。