镜像构建

最近更新时间:2019-09-11 14:33:57

仓库镜像管理提供镜像构建功能。

前提条件

对仓库具有 write 权限的团队用户,才可以新建和编辑镜像的构建功能。

镜像构建页

  1. 登录 Tencent Hub 控制台
  2. 单击左侧导航栏中的【仓库管理】,下拉选择对应的【空间】,选择仓库。
  3. 进入仓库页面,选择【镜像管理】>【镜像构建】。

镜像构建配置

  1. 如果用户需要从 Git 代码仓库来构建容器镜像,首先必须进行源代码授权。目前我们支持 Github 仓库和 Gitlab 仓库授权。 详情请参见 源代码授权指引
  2. 进入构建规则页面,配置相关信息:

Github 构建规则

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

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

  • Dockerfile路径:Dockerfile 在仓库中的相对路径。默认为空,可以不填,表示 Dockerfile 位于项目的根目录下,且文件名必须为 Dockerfile,以大写 D 开头。如果 Dockerfile 位于其它目录,例如位于仓库的 build 目录下,文件名为 Dockerfile,那么 Dockerfile 路径为:build/Dockerfile。

Gitlab 构建规则

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

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

  • Dockerfile路径:Dockerfile 在仓库中的相对路径。默认为空,可以不填,表示 Dockerfile 位于项目的根目录下,且文件名必须为 Dockerfile,以大写 D 开头。如果 Dockerfile 位于其它目录,例如位于仓库的 build 目录下,文件名为 Dockerfile,那么 Dockerfile 路径为:build/Dockerfile。

自动构建

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

立即构建

您可以对该仓库手动立即发起一次构建。

查看构建记录

如果您完成了构建规则的配置,Tencent Hub 会为您生成一个构建镜像的工作流workflow_docker_builder,在工作流子页面下可以看到该工作流。

查看构建页面 >【查看构建记录】,页面将为您跳转并自动定位到该工作流的执行历史页面。

构建日志

构建参数