gitlab-ci 尝试

一、预期目标

通过 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 的项目。

查看项目 CI/CD 相关信息

复制 gitlab 地址和 token

获取 地址和 token

成功后的结果：

runners

第三步：编写 .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 实现自动部署 附踩坑记录