在本地调试 GitLab CI Pipeline (WSL搭建GitLab Runner)

为什么本地搭建

有时候我们对公司远端Gitlab Server的主分支（main）没有权限。在调试 CI/CD 时，我们需要编辑 .gitlab-ci.yml，然后提交，再进行合并，才能查看 Pipeline 的执行结果。

GitLab Runner 有时候显示“等待中（Pending）”，这通常是因为资源有限，其他人也有并行的 Pipeline 任务。

在 Windows 上创建 GitLab 环境和 GitLab Runner 并不容易。

由于我们一般不使用 Linux 发行版作为主操作系统，WSL 是一个很好的解决方案。

---

️ 使用 WSL 和本地 GitLab Runner 搭建 GitLab CI/CD

前提条件

需要安装 WSL（例如：Ubuntu 22.04.5 LTS）。

安装所需的软件包：

sudo apt update
sudo apt install -y curl openssh-server ca-certificates tzdata perl
sudo apt install -y postfix

---

安装 GitLab CE

添加 GitLab 仓库

curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash

安装 GitLab CE

sudo EXTERNAL_URL="http://localhost" apt-get install gitlab-ce

启动并配置 GitLab

sudo gitlab-ctl reconfigure
sudo gitlab-ctl start

默认 root 用户的密码保存在：

/etc/gitlab/initial_root_password

可以在以下页面更改密码：

http://localhost/-/user_settings/password/edit

→ 编辑个人资料 → 密码

这让你成为 GitLab 的 root 用户。

对于快速测试来说，不再会遇到权限问题，非常方便。

⚙️ 安装 GitLab Runner

添加 GitLab Runner 仓库

curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh | sudo bash

安装 GitLab Runner

sudo apt-get install gitlab-runner

---

注册 GitLab Runner

1. 打开：CI/CD > Runners > Create a new runner
2. 执行以下命令：

gitlab-runner register --url http://localhost --token <yourToken>

配置已保存至：

/etc/gitlab-runner/config.toml

验证 Runner 是否正常

sudo gitlab-runner verify

查看所有 Runner：

http://localhost/admin/runners

使用 IP 访问 GitLab

查找本机 IP 地址

hostname -I

示例输出：

172.24.208.12

修改 GitLab 配置文件

sudo vi /etc/gitlab/gitlab.rb

将以下行修改为你的 IP 地址：

external_url 'http://172.24.208.12'

重新配置 GitLab

sudo gitlab-ctl reconfigure

---

之后如果Pipeline任务失败可以手动点击 “Retry” 重新运行 Pipeline。