- A+
简单介绍一下如何使用 GitLab-CI 来自动创建 Docker 镜像, 并上传到仓库.
想法
用 GitLab 来管理 Dockerfile 是一件很显然的事情了. 在每次更改 Dockerfile 之后, 都要手动 build 然后 push 到 registry, 有点烦. 正好这两天自己开了个 registry. 那就采用一种自动的方法来帮助我们做这种机械重复的工作.
首先我想到的是使用 webhook 的响应 结合docker api 来调用 docker build 和 push. 我试验了一下觉得比较麻烦.
后来想到可以使用了 GitLab CI, 并且自 GitLab 8.x 开始已经集成了 GitLab CI Server. 所以也不用额外部署 CI Server 了. 我们要做的工作就是部署一下 GitLab CI runner. 然后在 Dockerfile 的项目里配置一下 .gitlab-ci.yml告诉 GitLab CI runner 如何做就行了.
安装 Docker
在你想用来 build image 的机器上, 显然需要先装好 Docker. 参见 Docker官方文档.
安装 GitLab CI Runner
在用来 build 的机器上我们需要安装 GitLab CI Runner. 官方项目里面提供了很多安装说明. 可以直接找你对应的需要. 这里我就说一下我怎么直接在 Ubuntu 14.04 LTS 上安装的.(对应的官方文档)
|
1 2 |
curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-ci-multi-runner/script.deb.sh | sudo bash sudo apt-get install gitlab-ci-multi-runner |
然后注册 runner:
|
1 |
sudo gitlab-ci-multi-runner register |
当中会让你填写一些信息. 例如你的 gitlab-ci coordinator 的地址和注册这个 runner 的 token, 这两个在你 GitLab 中可以找到. 具体的内容我忘记截图了. 关于 executor 的话, 我这里使用的是 shell, 因为我将 runner 直接运行在物理机的系统上, 想其能够直接使用 docker.
注册好后, 我们可以看 runner 的配置文件, 类似如下:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
# /etc/gitlab-runner/config.toml concurrent = 1 [[runners]] url = "http://gitlab.com/ci" token = "******************" name = "image builder" executor = "shell" [runners.ssh] [runners.docker] image = "" privileged = false [runners.parallels] base_name = "" |
关于这些参数可以在官方文档中找到. 注册好的 runner 在 GitLab 中如下图所示.
实际显示情况可能和上图有不同, 因为我已经将这个 runner 设置为 specific runner 了. 关于 runner 的说明可以参考 官方文档 configuring runner.
使用 GitLab runner 来 build docker image 的相关说明, 可以参考 官方文档 using docker build. 主要需要注意的是, 为了要让 runner 可以调用 docker 命令, 需要把 gitlab-runner 这个用户加入 docker 所在组.
|
1 |
sudo usermod -aG docker gitlab-runner |
配置项目
可以参考官方文档 Configuring project. 我这里直接贴出我用的配置了.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
stages: - build_image - push_image before_script: - docker info build_image: stage: build_image script: - docker build -t myregistry/aplusplus/ubuntu:14.04 . push_image: stage: push_image script: - docker push myregistry/aplusplus/ubuntu:14.04 |
简单地说, stages 定义了你要做几步(stage) 以及他们之间的顺序. 默认每个 stage 都是在之前所有 stage 成功执行后才会执行. 每个 stage 可以包含多个任务(job), 例如上面的 build_image 和 push_image. 这里只定义了一个. 当每个 stage 有多个 jobs 时, 每个 jobs 会并行执行.
当你每次修改项目并 push 到 gitlab 后, runner 就会开始执行你配置的任务了. 如下图
