构建环境 - Pages.Top

构建环境

传统的虚拟机容器，Docker 容器有非常巨大的优势，行业中各个 CI 厂商也在向这方面发展。

拥有 Docker 相关知识和容器开发经验，有助于理解和使用 云原生构建

配置方式

流水线构建环境的配置方式有两种：

指定一个 image

这些镜像是之前由其他人制作出来并且推送到镜像仓库中的。

若为私有镜像，还需配置对应的用户名和密码才能使用。

参考语法pipeline.docker.image

指定一个 Dockerfile

在构建开始时，云原生构建 会先依据一些规则计算镜像版本号，若当前构建节点或远端镜像仓库中存在此版本镜像，则直接使用。否则，云原生构建 会用 Dockerfile 通过 docker build 的方式制作、生成镜像后，再使用它，同时推送到流水线所属仓库的 Docker 制品库，供后续使用。

参考语法pipeline.docker.build

流水线指定的构建环境将作为该流水线下脚本任务的默认构建环境。

另外，脚本任务还可以单独指定 Image 作为该任务的构建环境，此时无法指定 Dockerfile。

参考语法脚本任务。

指定 Image

1
2
3
4
5
6
7
8
9
main:
  push:
    - docker:
        # 通过此参数控制使用的 image
        image: node:22
      stages:
        - stage1
        - stage2
        - stage3

用 pipeline.docker.image 参数指定 Docker Image。其值可以是公网中的官方镜像源或其他可以被访问到的镜像源中的公开镜像。

指定 Dockerfile

1
2
3
4
5
6
7
8
9
main:
  push:
    - docker:
        # 通过此参数控制使用的 Dockerfile
        build: ./image/Dockerfile
      stages:
        - stage1
        - stage2
        - stage3

用 pipeline.docker.build 参数指定 Dockerfile。

缺省镜像

当未指定 image 和 Dockerfile 时，image 会被设置为缺省镜像：cnbcool/default-build-env:latest

1
2
3
4
5
6
7
8
9
main:
  push:
    - stages:
        - stage1
        - stage2
        - stage3
      # 未指定 image 和 Dockerfile 相当于如下声明
      # docker:
      # image: cnbcool/default-build-env:latest

镜像中的 VOLUME

镜像中可能包含VOLUME命令。用插件任务的容器启动时会通过 --volumes-from 参数，将这些 volume 共享给 插件任务。

例如，在 Dockerfile 中准备了文件：

RUN mkdir /cache && echo 'hello world' > /cache/data.txt

VOLUME /cache

在后续的 image-commands 中也可以访问到它。

1
2
3
4
- name: image-commands中访问pipeline volume
  image: alpine
  commands:
    - cat /cache/data.txt

使用案例

NodeJS

当需要使用 NodeJS 的构建环境时，可以直接使用 Docker Hub 之中的官方 NodeJS 镜像。

1
2
3
4
5
6
7
8
9
main:
  push:
    - docker:
        image: node:20
      stages:
        - name: 依赖安装
          script: npm install
        - name: 测试用例检查
          script: npm test

最后更新于 2025/10/12 23:03

流水线语法构建集群