Windows VPS海外搭建GitLab Runner指南

简单来说，持续集成就像一个自动小助手，能替开发者完成代码检查、打包等重复工作。GitLab Runner则是这个小助手的“执行体”，负责按指令完成具体任务。本文将手把手教你用Windows VPS海外服务器搭建这样的持续集成代理。

准备工作：基础工具与环境

搭建前需准备三样核心工具：首先是Windows VPS海外服务器，相当于承载所有操作的“数字空间”；其次是GitLab账号及对应项目，用于存储代码和管理任务；最后要确保服务器已安装PowerShell——这是后续执行命令的“操作窗口”。若服务器未预装，可通过Windows应用商店或官网下载最新版本。

安装GitLab Runner：下载与部署

第一步，访问GitLab Runner官方网站，将Windows版本的安装包下载至Windows VPS海外服务器。下载完成后，打开PowerShell，使用`Move-Item`命令将安装包移动到指定目录（如`C:\GitLab-Runner`），这一步类似为工具选择“专属工具箱”。
接着在PowerShell中执行安装命令：`.\gitlab-runner-windows-amd64.exe install`。等待安装完成后，可通过`.\gitlab-runner-windows-amd64.exe status`命令检查服务状态，显示“Running”即表示安装成功。

注册GitLab Runner：绑定项目

安装完成后需让Runner与具体项目绑定。登录GitLab账号进入目标项目，依次点击“设置-CI/CD-Runners”，找到“注册令牌”（Registration Token）——这是Runner接入项目的“通行证”。
回到PowerShell，执行注册命令：`.\gitlab-runner-windows-amd64.exe register`，根据提示输入项目URL、注册令牌，设置Runner名称（如“Windows-Builder”）及标签（如“windows,ci”）。最后选择执行器（推荐“shell”），完成后Runner会显示在项目的Runner列表中。

配置GitLab Runner：定制工作规则

配置文件决定了Runner的工作细节。在`C:\GitLab-Runner\config.toml`中可调整并发任务数（`concurrent`）、代码拉取路径（`builds_dir`）等参数。例如，若项目需要同时处理3个任务，可将`concurrent`设为3；若希望代码存储在D盘，可修改`builds_dir = "D:\builds"`。
配置完成后需重启服务使设置生效，命令为：`.\gitlab-runner-windows-amd64.exe restart`。

测试GitLab Runner：验证运行效果

最后通过实际任务验证搭建结果。在GitLab项目根目录添加`.gitlab-ci.yml`文件，内容示例：
```yaml
stages:
- test
test_job:
stage: test
script:
- echo "Running test..."
- dir
```
将代码推送至GitLab后，项目页面的“CI/CD-流水线”中会显示新生成的任务。若状态为“成功”，且日志中出现“Running test...”，则说明Runner已正常工作。

通过以上步骤，你已用Windows VPS海外服务器搭建起专属的GitLab Runner持续集成代理。这个自动小助手将持续为你处理重复任务，让开发流程更高效、更省心。