vue搭配gitlab-ci自动化部署

目的：为了解决频繁发布开发环境版本问题

gitlab-CI概念

官方文档

gitlab 8.0集成了gitlab-CI

CI(Continuous integration) 持续集成

频繁地将代码集成到主干

• 目的：产品快速迭代，同时保持高质量
• 措施：代码提交到主干之前，执行自动化测试，失败则集成失败

环境准备

1. yml脚本文件
2. gitlab上获取项目token
3. 服务器上注册gitlab-runner

自动化部署实现

1. 在项目根目录中添加一个.gitlab-ci.yml文件 (CI管理项目状态)

.gitlab-ci.yml

git项目的根目录里的文件，记录一系列规则和执行规则
可以在gitlab上使用CI Lint验证上面yml文件的正确行。CI Lint在 CI/CD里面。

####提示
1.以下脚本设置的是master分支被合并时执行（设置为平常用来发版本的分支即可）
2.版本自动化部署到nginx下
3.执行yml脚本的runner名字设置的vue-runner1,即对应tags

stages: # Stages 表示构建阶段，这里有两个阶段 install, deploy
- install
- deploy

cache:
  key: ${CI_BUILD_REF_NAME}
  paths:
    - node_modules/
    
install-staging:dep: # Jobs 表示构建工作，表示某个 Stage 里面执行的工作。
  stage: install
  tags:
    - vue-runner1 #runner执行器的名字,与注册runner时填写的tags保持一致
  only: # 定义了只有在被merge到了master分支上 才会执行部署脚本。
  - master
  script:
  - echo "=====start install======"
  - yarn install  #安装依赖
  - echo "=====end install======"
  artifacts:  # 将这个job生成的依赖传递给下一个job。需要设置dependencies
    expire_in: 60 mins   # artifacets 的过期时间，因为这些数据都是直接保存在 Gitlab 机器上的，过于久远的资源就可以删除掉了
    paths:  # 需要被传递给下一个job的目录。
    - node_modules/
    
deploy-staging:dep:
  stage: deploy
  tags:
    - vue-runner1
  only:
  - master
  script:
  - echo "=====start build======"
  - yarn build  # 将项目打包
  - echo "=====end build======"
  - echo "=====start deploy======"
  - sudo cp -rf ./dist/  /usr/share/nginx/html/
  - echo "=====end deploy!!!!!!======"

2. 安装gitlab-runner (执行构建任务)

gitlab-runner

脚本执行者，.gitlab-ci.yml中的scripts由runner运行。有的脚本是测试，有的是部署
runner可以是虚拟机，docker容器等，需要保证runner可以连接gitlab服务器

流程

push

gitlab

gitlab-ci

gitlab-runner测试

gitlab-runner部署

gitlab-runnerxx

push 代码到gitlab上时，gitlab将变动通知给gitlab-CI，gitlab-CI会找到该工程下的gitlab-runner 并通知该runner执行相应脚本

linux下安装runner

curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh | sudo bash 添加官方库
yum install gitlab-runner #安装最新版本

注册

gitlab-runner register
//注册时要输入的内容
url(gitlab服务器地址)
token(项目token) gitlab中按项目>Setting>CI/CD>Runners settings可查找token
executor(执行器，有shell,docker)等 本文选的是shell
tags(用来匹配jobs和执行任务设备(runner) 和yml脚本里的tags保持一致)

启动

gitlab-runner start

停止

gitlab-runner stop

重启

gitlab-runner restart

查看状态

gitlab-runner status

问题

安装在哪里

• 一般安装在与gitlab所在不同的服务器上，可以注册在部署开发环境项目的服务器上

token可以多个项目共享吗？

• 可以为项目特定的token 也可以设置多个项目共享一个token

gitlab-runner遇到的问题

1. job执行失败

在.gitlab-ci.yml的 tags字段里也必须明确指明这些 tags。

2. gitlab runner 权限不够

vim /etc/sudoers 
gitlab-runner ALL=(root) NOPASSWD: ALL  
#加上NOPASSWD: ALL，执行命令时不用再输入passwd for gitlab-runner

3. 执行yml脚本里命令提示yarn 安装失败node-sass
   根目录下创建.yarnrc

registry "https://registry.npm.taobao.org"
sass_binary_site "https://npm.taobao.org/mirrors/node-sass/"

4. gitlab12.7之后自动开启auto devops

导致每次push项目都会执行job

• 可在管理员角色下取消 Default to Auto DevOps pipeline for all projects 的选中状态，然后点击 Save changes 即可。

5. runner注册失败

ERROR: Registering runner... failed                 runner=zoiK2SqN status=401 Unauthorized
PANIC: Failed to register this runner. Perhaps you are having network problems 
原因是：gitlab版本和gitlab-runner不兼容，已知的gitlab版本低于9.x的gitlab runner只能用v1.11.1