Getting started with GitLab CI/

2018-07-13 本文已影响0人宋乐怡

翻译 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.

Getting started with GitLab CI/

猜你喜欢

热点阅读