1. 安装 gitlab-runner.exe
powershell
# Run PowerShell: https://docs.microsoft.com/en-us/powershell/scripting/windows-powershell/starting-windows-powershell?view=powershell-7#with-administrative-privileges-run-as-administrator
# 1. 创建目录,例如: C:\GitLab-Runner
New-Item -Path "$env:userprofile\run\gitlab_runner" -ItemType Directory
# 2. 切换到该目录
cd "$env:userprofile\run\gitlab_runner"
# 3. 下载二进制文件
Invoke-WebRequest -Uri "https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-windows-amd64.exe" -OutFile "gitlab-runner.exe"
# 4. 注册完成后,安装并启动服务
.\gitlab-runner.exe install
.\gitlab-runner.exe start
2. 注册 Runner
powershell
.\gitlab-runner.exe register --url http://gitlab.ioptic.cn --token glrt-wsDxw0qyWj0v57guV705r286MQpwOmEKdDozCnU6Mw8.01.17147tm3v
2.1 指定 Runner 使用的 Shell
指定 gitlab runner 运行的 shell 为 pwsh(需要手动修改配置文件):
powershell
[[runners]]
name = "windows_msvc"
url = "http://gitlab.ioptic.cn"
executor = "shell"
shell = "pwsh"
3. 使用指定账户运行
3.1 如果希望 Runner 使用 vi 账户?
GitLab Runner 支持指定 Windows 服务账户。
powershell
.\gitlab-runner.exe stop
.\gitlab-runner.exe uninstall
.\gitlab-runner.exe install `
--user ".\vi" `
--password "你的Windows账户密码"
.\gitlab-runner.exe start
也可以使用 Administrator 账户:
powershell
.\gitlab-runner.exe install `
--user ".\Administrator" `
--password "账户密码"
3.2 修改 Windows 本地安全策略
如果.\gitlab-runner.exe start 执行出现下面的问题:
This service account does not have the required user right "Log on as a service."
解决方案如下:
- 按
Win + R,输入secpol.msc。 - 进入
Local Policies→User Rights Assignment(本地策略 → 用户权限分配)。 - 找到 Log on as a service / 作为服务登录。
- 双击打开。
- 点击 Add User or Group(添加用户或组)。
- 输入
.\Administrator。 - 点击 Check Names,确认账户。
- 点击 Apply → OK。
4. 确认与验证
4.1 确认服务使用的账户
powershell
Get-CimInstance Win32_Service -Filter "Name='gitlab-runner'" | Format-List Name, State, StartName, PathName
4.2 重启并验证 Runner
powershell
Restart-Service gitlab-runner
.\gitlab-runner.exe verify