镜像构建推送至镜像仓库服务

持续交付提供对各语言的通用镜像构建能力，用户可通过 镜像构建推送至镜像仓库服务 对源代码进行编译，构建容器镜像，并推送至火山引擎镜像仓库。

使用限制

• 可构建镜像大小 ≤ 5 G。
• Maven 编译构建建议使用国内的镜像代理，原生代理因网络问题易拉取失败。

前提条件

• 已开通火山引擎镜像仓库服务。

• 若推送至标准版实例，请确认已创建标准版实例。具体操作请参见 购买标准版实例。

• 已在镜像仓库创建目标命名空间，具体操作请参见 创建命名空间。

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

添加任务

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

参数说明

镜像构建推送至镜像仓库服务由编译构建和镜像打包推送至镜像仓库服务两个预置步骤组成。

• 编译构建
  

  配置项	说明
  步骤名称	默认为编译构建，支持自定义步骤名称。
  语言	选择编译构建使用的语言。 目前支持 Go、Java Maven、Java Gradle、Python、Node.js。
  版本	选择编译构建使用的语言版本，不同语言提供不同的预置版本。
  编译命令	输入编译命令。命令框中为默认的编译命令，需根据实际业务自行调整。

• 镜像打包推送至镜像仓库服务
  

  配置项	说明
  步骤名称	默认为镜像打包推送至镜像仓库服务，支持自定义步骤名称。
  地域	选择要推送的镜像仓库所在的地域。 目前支持的地域请参见 镜像仓库开服地域。 说明 由于网络影响，使用公共资源池推送至柔佛地域可能需要较长时间。建议更换为私有资源池推送柔佛任务。
  仓库实例	选择要推送的目标仓库实例。支持推送至体验版实例和标准版实例。 说明 火山引擎镜像仓库的基础版实例已更名为体验版实例。为保证服务兼容性，老用户仍可选择 cr-basic 基础版实例，这种情况下，您的镜像实际将被推送至体验版实例的同名仓库。
  命名空间	选择要推送的目标命名空间。 支持使用自定义环境变量 ${变量名}动态设置命名空间。 注意 命名空间必须已存在，否则将推送失败，报错 401 Unauthorized。
  OCI制品仓库	选择要推送的目标 OCI 制品仓库。 支持输入自定义环境变量 ${变量名}动态设置 OCI 制品仓库。如果 OCI 制品仓库不存在，系统将自动创建。
  镜像版本	自定义镜像版本号。 支持输入固定值，如 v1.0。 支持使用自定义环境变量 ${变量名}动态设置版本号。 支持使用系统预置环境变量时间戳 ${DATETIME}实现版本号动态变化。 上述三类支持组合使用，如 test-${变量名}、${变量名}_${DATETIME}。
  contextpath	docker build 命令执行上下文路径。填写相对于代码根目录的路径，默认为.。
  多框架构建	如果您希望构建 linux/arm64 架构的镜像，或者希望同时构建 linux/arm64 和 linux/amd64 两种架构的镜像，请勾选多框架构建功能的启用框。 启用多框架构建功能后，需要进一步勾选具体希望构建的镜像架构。当前支持构建 linux/arm64 和 linux/amd64 两种架构的镜像。 不启用多框架构建功能，则默认构建 linux/amd64 架构的镜像。
  Dockerfile	输入待构建的 Dockerfile 文件。如果您选择构建多架构镜像，需要分别输入每种架构的 Dockerfile 文件。 Dockerfile 支持以下配置两种方式。 文件路径：填写 Dockerfile 文件相对于代码库根目录所在路径，默认为./Dockerfile。 自定义文件：在命令框中输入 Dockerfile 文件内容。
  产出物	该步骤的产出物为镜像，默认名称为 DockerOutput，支持自定义命名。 产出物可用于后续部署任务。
  忽略证书有效性	勾选后，当前步骤中的所有内容不再校验 HTTPS 证书有效性。例如：推送/拉取镜像的仓库地址不再校验 HTTPS 证书有效性。 注意 该配置主要适用于仓库使用自签证书不受信的情形。忽略证书有效性涉及安全风险，一般情况下不建议勾选。

日志及产物

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

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