一、预期目标
通过 gitlab-ci
实现前端项目自动化构建和部署。
1.0
暂时采用 shell
方式处理构建、部署等操作,不使用 docker
。
注意:对 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 的用户,需要权限,否则某些操作会因为没有权限而执行失败。