一、预期目标
通过 gitlab-ci 实现前端项目自动化构建和部署。
1.0 暂时采用 shell 方式处理构建、部署等操作，不使用 docker 。
注意：对 gitlab 版本有要求。
二、具体步骤 & 踩坑
第一步：安装 runner
gitlab 官网文档 - 安装 runner
因为我的服务器是 centos 没有 rpm , 所以通过二进制文件进行安装。
如果网络不好，二进制下载时间比较耗时。
如果是 Debian、Red Hat 可以采用 package 形式安装
1.1 选择合适版本的进行下载
- 查看服务器系统信息：
lsb_release -a - 查看内核信息
uname -a，我的是 x86-64
注意以下命令中的 --output 参数，表示 gitlab-runner 被下载到哪里。
# Linux x86-64
sudo curl -L --output /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-amd64
# Linux x86
sudo curl -L --output /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-386
# Linux arm
sudo curl -L --output /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-arm
# Linux arm64
sudo curl -L --output /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-arm64
1.2 给 /usr/local/bin/gitlab-runner 开通权限
sudo chmod +x /usr/local/bin/gitlab-runner
1.3 在 linux 中创建一个专门用于执行 gitlab-runner 的账户
名字替换成自己需要的即可
# --comment 是注释 gitlab-runner 是用户名
sudo useradd --comment 'GitLab Runner' --create-home gitlab-runner --shell /bin/bash
1.4 安装并指定用户名和工作目录
sudo gitlab-runner install --user=gitlab-runner --working-directory=/home/gitlab-runner
sudo gitlab-runner start
问题一：
gitlab-runner 下载之后，运行 gitlab-runner 命令，提示找不到命令。解决方案：找不到命令--软连接
第二步：注册 runner
执行命令： sudo gitlab-runner register, 接下来会问一些问题
- gitlab 地址
- token
- runner 的描述
- runner 的tags ：类似于标识符，后续可通过此指定 runner
- 选择执行器：选择熟悉的即可，无奈我只会 shell
打开你的 gitlab 地址，需要使用 gitlab-ci 的项目。
复制 gitlab 地址和 token
成功后的结果：
第三步：编写 .gitlab-ci.yml 进行测试
在这一步只进行最简单的测试，目标：推送到 master 分支后，服务器上新建一个目录。
job1:
script:
- mkdir ci
tags:
- 这里写刚才注册的runner 的 tags
特别说明：针对上述这种如果一个job没有指定stage，那么这个任务会分配到 test stage。
对 runners 的说明
右侧的 Shared Runners ，如果这里有，那说明你们公司内部有人分享了 runners，但是这里我不清楚哪些 runner 是做什么的，所以我直接禁用了。
注意：如果没有禁用Shared Runners ，并且 .gitlab-ci.yml 中没有指定 runner ，那么如果 Shared Runners 中刚好有满足条件的 runners ,就会执行了。这可能不是期望的。
追加补充
gitlab-runner 需要 服务器上安装了 git ，因为runner 执行过程中有一步是从服务器 clone 代码。
服务器上执行 runner 的用户，需要权限，否则某些操作会因为没有权限而执行失败。
参考
gitlab-ci实现前端自动化部署
一个例子学会使用 gitlab runner 实现自动部署 附踩坑记录