文档中心

持续交付

镜像构建推送

镜像构建推送至自定义镜像仓库

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

使用限制

可构建镜像大小 ≤ 5 G。

前提条件

已准备待推送的镜像仓库地址、账号、密码。

已准备构建需要的 Dockerfile 文件。

添加任务

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

参数说明

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

任务名称

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

上游任务

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

代码源下载策略

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

下载代码：当前任务需要下载代码源。

不下载代码：当前任务无需使用代码源。

步骤

当前任务包含一个默认预置步骤（镜像构建推送至自定义仓库）。支持根据需要为当前任务添加其他串行步骤。下文介绍该默认预置步骤的参数。

配置项	说明
步骤名称	默认为镜像构建推送至自定义仓库，支持自定义步骤名称。
镜像地址	Docker 镜像待上传的地址，支持 HTTP 和 HTTPS 协议。地址支持固定 Repository，例如：xxx.com/ns/demo:1.0。地址支持使用动态参数，例如：xxx.com/ns/demo:$(DATETIME)。
凭证信息	配置访问自定义仓库的访问凭证。单击右侧的添加，在凭证信息中填写。
访问凭证类型	当前支持服务连接和用户名密码两种类型。服务连接：选择已经通过接入的服务。服务接入的操作参见服务连接。用户名密码：填写自定义仓库的地址、用户名和密码。说明暂不支持拉取需要二次鉴权的私有基础镜像。如果您需要拉取私有基础镜像，建议使用同一仓库实例（Registry Instance）来存储待拉取的基础镜像和最终要推送的镜像。这种场景下，推送和拉取共享相同的账号和密码。
contextpath	docker 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，镜像构建过程中，会重新拉取基础镜像，耗时较长。
压缩方式	选择镜像压缩方式，当前支持 gzip 和 zstd。
失败时跳过	可选配置。开启：当前步骤运行失败直接跳过，当前任务其余步骤可继续执行，流水线也可继续向下运行。关闭：当前步骤失败后，当前任务其余步骤不再执行，流水线将运行失败。

任务输出

展示当前任务输出的所有产物，包含当前任务下所有步骤的产物。无产物时展示为-。产物可用于后续任务的输入。

对于当前默认预置步骤，将输出构建的镜像地址imageOutput_step-xxxx。

高级设置

资源限制：支持设置 CPU 和内存的上限。

磁盘容量限制：支持设置磁盘容量的上限，最大为 100 GiB。

超时时间：设置整个任务的超时时间，任务超时后自动失败。一个任务可以包含多个串行步骤，每个步骤的运行时长总和需要小于任务的超时时间。

Webhook 通知：支持通过 Webhook 和飞书机器人两种方式推送任务维度的消息，帮助您及时掌握任务动态。

失败自动重试：开启后，填写最多支持重试的次数。任务在执行失败时，会按照配置的最大重试次数，进行至多次指定次数的重试。

注意

私有构建资源池中流水线任务，仅 Agent 版本大于等于 v2.34.0 及以上时支持失败自动重试。v2.34.0 以下版本重新添加 Agent 即可升级为最新版本。添加 Agent 的方法参见创建私有资源池中后续操作。

日志及产物

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

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

运行日志：实时展示该任务的运行日志。

任务配置：展示该任务的配置参数，详情可参考前文的参数说明。

产物：运行成功后，镜像构建推送至自定义镜像仓库会输出构建成功的镜像地址。

最近更新时间：2026.01.27 14:25:40

这个页面对您有帮助吗？

有用

无用