用户指南

构建规则设置

最近更新时间:2019-11-04 11:14:05

操作场景

本文介绍通过腾讯云容器服务控制台设置构建规则,实现使用 Git 仓库自动构建容器镜像。

前提条件

操作步骤

  1. 选择左侧导航栏中的【镜像仓库】>【我的镜像】,进入“我的镜像”页面。
  2. 在“我的镜像”页面,单击镜像所在行右侧【构建配置】。如下图所示:
  3. 进入构建规则页面,参考以下步骤配置相关信息。

Github 构建规则

根据以下信息设置 Github 构建规则,并单击【完成】。如下图所示:

  • 代码源: 选择 Github。
  • Organization:选择您的 Organization,通常为您的 Github 账户,如果您属于多个组织,那么挑选其中一个。
  • Repository:选择您需要构建容器镜像的仓库。
  • 触发方式:复选模式,支持当 push 代码到某个分支或者新的 Tag 时,自动触发容器镜像构建。也可不选择触发方式,在镜像构建页面通过 手动构建 的方式构建镜像。
  • 版本命名规则:即容器镜像 Tag 命名规则,镜像 Tag 名支持格式化。
    • 分支/标签:可以包含分支名 / 仓库 Tag 名。
    • 更新时间:镜像构建时间。
    • commit号:分支 / Tag 最近的 commit 号。
      注意:

      如果在某个分支或者 Tag 上进行自动构建,且版本命名规则包含了分支 / 标签,那么分支或者 Tag 名不能包含特殊字符,例如不能包含 /$ 等特殊字符,可以包含大小写字符,下划线(_),连接符(-)。

  • 覆盖镜像版本:构建后将同时生成该版本名的镜像,并覆盖已有同名镜像。
  • Dockerfile路径:Dockerfile 在仓库中的相对路径。默认为空,可以不填,表示 Dockerfile 位于项目的根目录下,且文件名必须为 Dockerfile,以大写 D 开头。如果 Dockerfile 位于其它目录,例如位于仓库的 build 目录下,文件名为 Dockerfile,那么 Dockerfile 路径为 build/Dockerfile
  • 构建目录:构建时的工作目录,Dockerfile 指令将在该目录下执行。
  • 构建参数:镜像构建时传入的参数,可用于设置环境变量。

Gitlab 构建规则

根据以下提示设置 Gitlab 构建规则,并单击【完成】。如下图所示:

  • 代码源:选择 Gitlab。
  • Group:选择一个 Gitlab 的Group。
  • Repository:选择您需要构建容器镜像的仓库。
  • 触发方式:复选模式,支持当 push 代码到某个分支或者新的 Tag 时,自动触发容器镜像构建。也可不选择触发方式,在镜像构建页面通过 手动构建 的方式构建镜像。
  • 版本命名规则:即容器镜像 ** Tag 命名规则**,镜像 Tag 名支持格式化。
    • 分支/标签:可以包含分支名 / 仓库 Tag 名。
    • 更新时间:镜像构建时间。
    • commit号:分支 / Tag 最近的 commit 号。
      注意:

      如果在某个分支或者 Tag 上进行自动构建,且版本命名规则包含了分支 / 标签,那么分支或者 Tag 名不能包含特殊字符,例如不能包含 /$ 等特殊字符,可以包含大小写字符,下划线(_),连接符(-)。

  • 覆盖镜像版本:构建后将同时生成该版本名的镜像,并覆盖已有同名镜像。
  • Dockerfile路径:Dockerfile 在仓库中的相对路径。默认为空,可以不填,表示 Dockerfile 位于项目的根目录下,且文件名必须为 Dockerfile,以大写 D 开头。如果 Dockerfile 位于其它目录,例如位于仓库的 build 目录下,文件名为 Dockerfile,那么 Dockerfile 路径为 build/Dockerfile
  • 构建目录:构建时的工作目录,Dockerfile 指令将在该目录下执行。
  • 构建参数:镜像构建时传入的参数,可用于设置环境变量。

自动构建

如果您完成了构建规则的配置,并且触发方式选择了添加新 Tag 时触发或者提交代码到分支时触发,那么当您提交一个新的分支或者 push 代码到指定仓库时,会自动触发容器镜像的构建。整个构建过程在腾讯云的容器平台上进行,在构建完成后,会按照您定义的版本命名规则生成新的镜像,并上传到腾讯云容器镜像仓库。

常见问题

更多关于源码构建 Dockerfile 文件路径问题,请前往 镜像构建常见问题

目录