buser 发表于 2018-1-11 16:16:22

Gitlab-CI持续集成之Runner配置和CI脚本

  

gitlab-runner start -n jiukun_self_runner  

gitlab-runner start -n jiukun_self2_runner  

  其中,-n为安装的服务名称,-d为工作路径,-c为配置文件,-u为执行用户(服务名称和执行用户必须指定,配置文件和工作路径可以使用默认路径)
https://images2017.cnblogs.com/blog/1151510/201709/1151510-20170905184720538-1839052777.png
  其实,当我们执行上述安装命令时,gitlab-ci-multi-runner后台实际是将run命令写入/etc/systemd/system/jiukun_self_runner.service文件,使之成为一个单独的服务:
https://images2017.cnblogs.com/blog/1151510/201709/1151510-20170905184744460-10569724.png
https://images2017.cnblogs.com/blog/1151510/201709/1151510-20170905184752991-577426543.png
  2.使用Shared Runner
  使用share runner需要管理员权限,联系公司gitlab管理员,获取token。然后使用和Special Runner一样的方法注册成功。
  进入任意项目的Runner页面,将看到以下内容:
https://images2017.cnblogs.com/blog/1151510/201709/1151510-20170905184940491-1460158969.png
  这里我重复注册了两次,可以看到Runner无论是名字还是tag都可以重复,但是Runner的token却不相同,实际上区分不同的Runner工人只需要两样东西就是url和token。当然并不建议进行相同命名,不便于管理。
  公司所有的项目默认都可以使用Shared Runner,而不需要重复配置。
  1)好处:对于大多数Runner的配置其实是完全相同的(同样的executor,同样的配置文件和工作路径,同样的依赖环境),如果每个项目都去一个个注册不仅麻烦,而且不方便迁移,这时可以使用shared runner。
  2)不足:如果一个项目的编译所需的exector等其他配置(配置文件有更多可选配置),并且和其他项目需要单独管理,这时最好使用Special Runner,并锁定该Runner为项目本身使用,单独管理。
https://images2017.cnblogs.com/blog/1151510/201709/1151510-20170905185156913-1030083726.png
https://images2017.cnblogs.com/blog/1151510/201709/1151510-20170905185411413-1950863931.png
  五、管理Runner
  1.注册的runner列表
  

gitlab-runner list \--config "/etc/gitlab-runner/config_jiukun_test.toml"  

  2.查看runner连接状态
  

gitlab-runner verify \--config "/etc/gitlab-runner/config_jiukun_test.toml"  

  3.取消注册(移除)
  

gitlab-runner unregistry \--url http://gitlab.xxxxxx.com/ci \  --token 9c1bb50065661ba766023016f6ebf2
  

  不能直接在project的web端进行remove操作,否则这里会执行失败
  4管理gitlab-runner服务
  

gitlab-runner status \  

-n jiukun_self_runner.service  

  不指定服务名,则默认为gitlab
-runner服务  

  
gitlab
-runner stop \  

-n jiukun_self_runner.service  

  
gitlab
-runner restart \  

-n jiukun_self_runner.service  

  
gitlab
-runner uninstall \  

-n jiukun_self_runner.service  

  

执行uninstall会卸载该服务,与之对应的runner将无法通过该服务运行,请确保对应的CI任务已停止。  

  六、集成脚本
  将集成脚本命名为.gitlab-ci.yml或者.gitlab-ci.yaml,放置在对应项目仓库分支的根目录下。
https://images2017.cnblogs.com/blog/1151510/201709/1151510-20170905185644976-1548408292.png
  1.yaml语法
  大小写敏感、使用缩进代表层级、不允许使用Tab缩进,只能使用空格,缩进并无统一限制,但同级关系内要保持对齐即可。#代表注释。
  语言格式里存在减号和冒号这些特殊字符,因此要注意千万别写成中文的字符格式。
  减号对应的是数组,冒号对应的是键值对(对象)。
  2. 关键词
  1)image
  如果使用docker作为Runner的executor,并且没有设置默认的镜像,此处需要设置镜像;不使用可以省略
  2)sevices
  如果使用docker集群服务,可以直接调用服务;不使用可以省略
  3)stages
  定义各个阶段名称,如果省略,CI默认为三个阶段
https://images2017.cnblogs.com/blog/1151510/201709/1151510-20170905185700335-497002067.png
  每个job都必须定义其所属的阶段,如果不定义,默认均属于build阶段;同阶段任务并行对待,上一阶段所有任务执行成功,才会继续执行下一阶段;语句依次执行,如果某一语句执行失败,将返回错误码,并宣告CI失败。
  如果定义stages,则job中的stage必须与之相对应。
  4)before_script
  定义在所有脚本运行之前执行的语句
  5)after_script
  定义在所有脚本运行之后执行的语句
  6)variables
  定义环境变量
https://images2017.cnblogs.com/blog/1151510/201709/1151510-20170905185714585-208991439.png
  7)cache
  定义下个job会使用到的文件或内容
  3. Jobs
  .gitlab-ci.yml脚本内容的主体为一个个job,没有数量限制,每个Job名称可以相同也可以不同(最好不要相同),可以大小写;每个Job内部至少有一个关键词。常用关键词如下
  1)stage
  和脚本全局stages对应(如果全局未定义,可使用默认)
  2)image、services、variables
  同全局关键词
  3)only
  规定该脚本响应分支(项目其他分支不会触发该脚本;如果不定义,会检测所有分支;与之相反的关键词是except)
  4)before_script、after_script
  同全局关键词(注意,如果同时存在,会覆盖全局关键词对应列表内容)
  5)script
  脚本主体,使用方法和在shell内一样,将在对应executor内运行一个shell环境,执行脚本内容。每个Job的shell环境不同(Job结束,该环境自动关闭)。
  6)tags
  指定Runner的标签(通常一个项目有很多Runner,依靠tag区分)
  7)artifacts
  指定Job的产出文件路径,如果该关键词设定,可以直接在pipeline页面下载该文件
  8)when
  默认一个job只有在上一阶段所有job成功才会执行,通过when可以改,通常用来清理环境使用,以免失败后无法清理,有四种可选参数。
  on_success(上一阶段所有Job成功才执行)
  on_failure(上一阶段任意Job失败就执行)
  always(总是执行)
  manual(此阶段由UI界面交互执行)
  备注:以上纯属原创,学习来源为gitlab-runner官方中文文档、gitlab-runner英文文档、gitlab-ci英文文档。如需转载请注明出处,后续继续完善。
页: [1]
查看完整版本: Gitlab-CI持续集成之Runner配置和CI脚本