一、添加官方镜像仓库
# For Debian/Ubuntu/Mint
`curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh | sudo bash`
# For RHEL/CentOS/Fedora
`curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh | sudo bash`
二、安装
安装最新版本
# For Debian/Ubuntu/Mint
export GITLAB_RUNNER_DISABLE_SKEL=true; sudo -E apt-get install gitlab-runner
# For RHEL/CentOS/Fedora
export GITLAB_RUNNER_DISABLE_SKEL=true; sudo -E yum install gitlab-runner
安装指定版本
# for DEB based systems
apt-cache madison gitlab-runner
export GITLAB_RUNNER_DISABLE_SKEL=true; sudo -E apt-get install gitlab-runner=10.0.0
# for RPM based systems
yum list gitlab-runner --showduplicates | sort -r
export GITLAB_RUNNER_DISABLE_SKEL=true; sudo -E yum install gitlab-runner-10.0.0-1
安装完成后,可以使用 gitlab-runner -v 命令查看当前版本,如笔者环境如下:
Version: 12.4.0
Git revision: 1564076b
Git branch: 12-4-stable
GO version: go1.10.8
Built: 2019-10-21T14:38:12+0000
OS/Arch: linux/amd64
三、注册
步骤
- 获取runner token -> 进行注册
注册指令
sudo gitlab-runner register
此时会出现交互式的注册界面,如果想进行非交互式注册,可以使用如下方式
sudo gitlab-runner register \
--non-interactive \
--url "$https://gitlab.com/" \
--registration-token "$PROJECT_REGISTRATION_TOKEN" \
--executor "shell" \
--description "devops-runner" \
--tag-list "build,deploy" \
--run-untagged="true" \
--locked="false" \
--access-level="not_protected"
如果命令行出现如下提示,那恭喜,注册成功!
Registering runner... succeeded
相关命令参考
gitlab-runner register # 默认交互模式,非交互式添加 --non-interactive
gitlab-runner list # 列出保存在配置文件中的所有运行程序
gitlab-runner verify # 检查runner是否可以连接,但不验证GitLab服务是否正在使用runner
-delete 删除
gitlab-runner unregister # 使Gitlab取消已注册的runner
# 使用令牌注销
gitlab-runner unregister --url $url --token $token
# 使用名称注销(同名注销第一个)
gitlab-runner unregister --name test-runner
# 注销所有
gitlab-runner unregister --all-runners
执行器选择
类型
- shared
- group
- specific
状态
- locked
- paused
附:更多细节可以通过官方文档GitLab Docs ,选择Runner子文档进行详细参考。