构建规则设置

Recent Pages

构建规则设置

最后更新时间：2024-10-22 16:06:01

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