gitlab-ci从入门到差点放弃
1.前言
之前一直用jeakins部署,最近了解了一下gitlab-ci,就想尝试一下,中途遇到很多坑。
简单的记录一下,然后谈一谈自己关于部署的一些理解。
2.gitlab-ci
简介
【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-runnergitlab-runner install --working-directory /home/gitlab-runner --user root# 安装并设置--user(设置为root)sudo service gitlab-runner restart# 重启gitlab-runnerps 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分钟)。
推荐阅读
- [Android][HOOK] Firda 入门实战
- 成都APP软件EXE开发(EXCEL VBA的基本知识和入门引导V2)
- Python爬虫|爬虫-从入门到入狱(level1)
- Python爬虫|爬虫从入门到入狱(5)——多线程爬虫与常见搜索算法
- 投稿|从AI数羊到“相牛”:人工智能应用如何低门槛化?
- Jupyter Notebook入门指南
- 投稿|从偶像代表到一朝散场,虚拟女团塌房记
- 流程帮App风险评估
- Python中的推荐系统(入门教程)
- R入门教程(管道)