操作场景

本文介绍通过腾讯云容器服务控制台设置构建规则，实现使用 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 文件路径问题，请前往 镜像构建常见问题。