翻译 https://docs.gitlab.com/ce/ci/quick_start/README.
因为对于我们程序员来说,有些词汇,翻译还不如不翻译呢,就中英混合了。
Note:从8.0版本开始,GitLab CI 已经完全集成进GitLab了,默认情况下,所有项目都启用此功能。
GitLab 提供了一个持续集成的服务。只要你在仓库的根目录里添加.gitlab-ci.yml文件,并且配置你的gitlab 项目使用runner,这样,你的每次commit或push都会触发CI pipeline。
.gitlab-ci.yml文件告诉GitLab runner 要做什么,默认情况下,run一个pipeline分为3个阶段:build,test,和deploy(部署),你无需使用所有的阶段,没有任务的阶段就只是被忽略。
如果run成功了,你会在这次commit得到一个nice的绿色对号,这个可以很容易看出这次commit是否跑失败了,而不用去查代码验证。
大部分的工程都用CI来测试,这样开发者就能立即得到反馈,自己是不是写出bug 了。
使用持续交付和持续部署将测试代码自动部署到stage和生产环境的趋势越来越明显。
所以,简单来说,想要一个好用 的CI的必须步骤,总结为:
1,在仓库的根目录里添加一个.gitlab-ci.yml文件
2,配置一个runner
这样做了以后,每次你push到仓库,runner都会自动 的跑个pipeline,这个pipeline显示在这个项目的pipeline页面。
这个向导假设你已经具备以下条件:
- 有个好使的GitLab 实例,版本得在8.0以上,或者你使用GitLab.com托管代码
- 你要使用CI的项目时托管在GitLab上的
我们把问题分解,来致力于解决GitLab CI 这个难题
- 创建.gitlab-ci.yml文件
在创建这个文件之前,我们首先来大体说明下这是个啥 - 什么是.gitlab-ci.yml
你在这个文件里,告诉CI要对你的项目做什么,把这个文件放在你仓库的根目录。
每当你push代码,GitLab都会去查找这个文件,然后让runner根据文件里的内容对这次commit开始工作。
因为.gitlab-ci.yml在仓库中,所以受版本控制,旧的版本依旧好用,叉子可以轻松的利用CI,每个分支可以有自己的pipeline和job,你可以拥有CI 的单一来源的源码(这啥意思....),你可以在博客读到更多关于我们为什么使用CI 博客是https://about.gitlab.com/2015/05/06/why-were-replacing-gitlab-ci-jobs-with-gitlab-ci-dot-yml/ - 创建一个简单的.gitlab-ci.yml文件
Note:.gitlab-ci.yml是个YAML文件,你要格外注意缩进,使用空格,不能使用tab
before_script:
- apt-get update -qq && apt-get install -y -qq sqlite3 libsqlite3-dev nodejs
- ruby -v
- which ruby
- gem install bundler --no-ri --no-rdoc
- bundle install --jobs $(nproc) "${FLAGS[@]}"
rspec:
script:
- bundle exec rspec
rubocop:
script:
- bundle exec rubocop
这是个最简单的配置,适用于大部分的Ruby应用程序。
1,定义两个job rspec和rubocop,名字随意,分别执行不同的命令。
2,在job 开始之前,before_script 里的命令会先执行。
.gitlab-ci.yml文件定义了jobs如何,以及何时应该run,jobs中最重要的是script 关键字所表示的命令,jobs 用来创建runner将要执行的任务。
重要的是每个job彼此独立运行。
如果你想检查你的CI配置文件是否有效,在gitlab 当前项目页面有一个CI lint工具.
想要获得更多的信息,更完整的.gitlab-ci.yml句法,请阅读https://docs.gitlab.com/ce/ci/yaml/README.html
- push .gitlab-ci.yml到仓库
一旦创建完成,你应该把这个文件加到仓库push到gitlab。
git add .gitlab-ci.yml
git commit -m "Add .gitlab-ci.yml"
git push origin master
这时你去pipeline页面,你会看到pipeline在pending。
Note:如果你的gitlab从一个镜像库来下来的,你要去设置一下允许pipeline触发,在 Settings > Repository > Pull from a remote repository > Trigger pipelines for mirror updates.