gitlab-ci从入门到差点放弃

1.前言

之前一直用jeakins部署,最近了解了一下gitlab-ci,就想尝试一下,中途遇到很多坑。
简单的记录一下,然后谈一谈自己关于部署的一些理解。

2.gitlab-ci

简介

前端CICD我理解的就是代码通过本地各种校验后的不断集成到远程分支,然后触发一列行为(比如安装,打包,测试,部署)。
一般需要两个服务器,
一个是ci服务器,用来跑各种任务(安装,打包,测试,部署等等)
另外一个就是部署服务器,可以是一个nginx,来展示静态资源。
jeakins可以理解为一个ci服务器。
当然 gitlab本身也提供一个ci服务器,那就是gitlab-ci
这期间我遇到了好多坑,快崩溃了。

安装runner的坑

如果是gitlab项目,在setting-cicd中,左侧是私人的runner,右侧是其他人提供的runner
runner可以简单理解为ci服务器上跑的ci服务
但是需要注意的是别人的runner不一定适用你,因为人家的ci服务器上的环境也许是java环境,没装node,没装你需要的一些全局包。所以一般都需要自己做一个符合自己项目的前端通用runner。

第一步:runner服务器选择
首先如果你是个人gitlab项目,那么你可以找随便找一台服务器。但是你是公司的项目,最后找一台公司内网服务器安装,应该外网服务器不一定能访问你公司的自己搭的gitlab。
第二步:安装runner方式选择
安装的话可以参考官网安装,有几种方式.但是对于我来说,由于公司的服务器不能,下载安装包特别慢,慢到崩溃的那种,所以我直接采用先下载安装包,再安装的方式。注意linux x86_64 对应的安装包是amd64,别下错了。

第三步:安装全局依赖包
runner只是在ci服务器中一个服务,本地找不到包还是得从全局找。
所以需要ci服务器安装 git nvm(管理node) nrm (管理npm源) vue-cli-serve 等等一些常用的全局包。

第四步:注册runner
注册很简单,其实就是runner和gitlab建立链接

gitlab-runner register 按提示一步步来就行了,一定得是ci服务器能连的上gitlab才行
token和url在setting-runner里面找完事后就可以发现自定义runner多了一个且可用。

第五步:更改runner权限
肯定得用root权限执行,默认用户runner 公司的服务器不认

sudo gitlab-runner uninstall # 删除gitlab-runner

gitlab-runner install --working-directory /home/gitlab-runner --user root   # 安装并设置--user(设置为root)

sudo service gitlab-runner restart  # 重启gitlab-runner

ps aux|grep gitlab-runner  # 查看当前runner用户

3.跑通部署服务

.gitlab-ci.yml

项目根目录下面添加.gitlab-ci.yml文件,每次提交的时候gitlab根据该文件启动runner。
具体的含义大家自己去搜,我只说几个关键的地方。

  • runner有名字,我的runner叫fyy,tag参数用来执行需要触发的runner
  • stage是阶段,一般有三个阶段(加上单元测试、集成测试之类的代码检测的可以是四个)
  • 每阶段完成,生成的文件会被删除,所以需要cache缓存一下
  • only参数指定只有哪个分支变化才触发runner


一个可用的参考的脚本

stages:
  - install
  - build
  - deploy
cache: # 缓存
  paths:
    - node_modules
    - dist
第一阶段-install:
  tags:
    - fyy
  stage: install
  script:
    - pnpm install
    - echo '依赖安装成功!'
  only:
    - mono-dp

第二阶段-build:
  tags:
    - fyy
  stage: build
  script:
    - pnpm buildTest
    - echo '测试环境代码打包成功!'
  only:
    - mono-dp

第三阶段-deploy:
  tags:
    - fyy
  stage: deploy
  script:  # 具体的部署方式,这里是常规的部署,也可以容器化部署
    - cd dist
    - tar -cf dist.tar --exclude=./dist.tar .
    - 具体的shell脚本(ssh链接,拷贝到指定目录,解压之类的)
  only:
    - mono-dp

npm安装的坑

这个时候基本上可以了,mono-dp push 上去会触发ci操作,在pipeline里面可以看到流程。
我遇到的问题是npm安装的时候会报一些错,这个应该是我pnpm.lock文件有问题引起的。
排查问题可以直接登录远程服务器手动试一试,手动在runner的项目目录里面/home/gitlab-runner/builds/-qUnF6qy/0/webproject/convergencemarketing/npm insatll build排查下,这个时候不要走ci流程了,会很慢。

runner 打包的坑

我遇到的问题是项目有些依赖走的全局包,比如有个包叫chalk,没写进Package里,ci的时候由于Package里没有就不会安装,导致打包错误
解决方案就是排查下,项目不要有依赖全局包的,全部改成本地的
但是vue-cli-serve这种就没办法,只能ci服务器全局去装

4.总结与思考

最后亮一下成功的截图

总体来说和jekins很类似,比较适合团队开发与大型项目开发,流程比较清楚。
但是缺点也是有的,感觉比较慢,我这个项目大概12分钟 这还是有pnpm+缓存。
对于我这种小公司小项目,直接本地打包传上去部署(走自己写的部署服务,或者直接使用上传软件或者自定义plugin)会不会更适合一点(能控制在1分钟)。

你可能感兴趣的