GitLab Runner安装注册配置管理-Windows系列-PHP中文网

GitLab Runner安装注册配置管理

蓮花仙者

发布： 2025-09-08 08:58:02

原创

1032人浏览过

gitlab runner安装注册配置管理 gitlab runner是一个开源项目，负责执行您的作业并将结果发送回gitlab。它与gitlab ci协同工作，gitlab ci是gitlab提供的开源持续集成服务，用于管理作业。

安装GitLab Runner的要求是，它使用Go语言编写，可以作为二进制文件运行，无需特定语言环境。它旨在支持GNU/Linux，macOS和Windows操作系统。如果您可以在其他操作系统上编译Go二进制文件，这些系统也可能运行GitLab Runner。

如果您计划使用Docker，请确保安装最新版本。GitLab Runner至少需要Docker

v1.13.0

登录后复制

。

GitLab Runner的版本应与GitLab版本保持一致。

您可以在GNU/Linux，macOS，FreeBSD和Windows上安装和使用GitLab Runner。安装方法包括使用Docker，手动下载二进制文件，或使用GitLab提供的rpm/deb软件包存储库。

在CentOS上安装：

curl -LJO https://gitlab-runner-downloads.s3.amazonaws.com/latest/rpm/gitlab-runner_<arch>.rpm
rpm -i gitlab-runner_<arch>.rpm
rpm -Uvh gitlab-runner_<arch>.rpm

登录后复制

在macOS上安装：

sudo curl --output /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/v12.6/binaries/gitlab-runner-darwin-amd64
sudo chmod +x /usr/local/bin/gitlab-runner
gitlab-runner install
gitlab-runner start

登录后复制

使用Docker运行：

mkdir ~/data/gitlab-runner/config
docker run --rm -t -id -v ~/data/gitlab-runner/config:/etc/gitlab-runner gitlab/gitlab-runner:v12.9.0

登录后复制

GitLab Runner的注册类型包括：

shared：用于运行整个平台项目的作业（gitlab）
group：用于运行特定组下的所有项目作业（group）
specific：用于运行指定的项目作业（project）

注册状态包括：

locked：锁定状态，无法运行项目作业
paused：暂停状态，不会运行作业

获取shared类型runner的token：

GitLab Runner安装注册配置管理

获取group类型runner的token：

进入group -> Settings -> CI/CD -> Runners -> Group Runners

GitLab Runner安装注册配置管理

获取specific类型runner的token：

餐饮E站通-在线订餐系统免费版

在线订餐系统源码,提供给设计人员参考一个小型的在线订餐管理系统源码，采用三层模式开发，代码注释详细前台可以进行用户注册、菜单管理及订餐后台管理员可以进行菜单管理、新闻管理、菜肴管理、用户管理操作数据库采用的是Sql2005（由于数据库在App_Data下，如果装了Sql2005数据库会自动配置）

查看详情

进入具体的项目 -> Settings -> CI/CD -> Runners -> Specific Runners

GitLab Runner安装注册配置管理

启动容器并进行交互式注册：

docker run --rm -t -i -v ~/data/gitlab-runner/config:/etc/gitlab-runner gitlab/gitlab-runner:v12.6.0 register
Runtime platform                                    arch=amd64 os=linux pid=6 revision=ac8e767a version=12.6.0
Running in system-mode.
Please enter the gitlab-ci coordinator URL (e.g. https://gitlab.com/):http://192.168.1.105
Please enter the gitlab-ci token for this runner:4tutaeWWL3srNEcmHs1s
Please enter the gitlab-ci description for this runner:[00e4f023b5ae]: devops-service-runner
Please enter the gitlab-ci tags for this runner (comma separated):build
Registering runner... succeeded                     runner=4tutaeWW
Please enter the executor: parallels, virtualbox, docker-ssh+machine, kubernetes, docker+machine, custom, docker, docker-ssh, shell, ssh:shell
Runner registered successfully. Feel free to start it, but if it's running already the config should be automatically reloaded!

登录后复制

非交互式注册：

docker run -itd --rm -v ~/data/gitlab-runner/config:/etc/gitlab-runner  gitlab/gitlab-runner:v12.6.0 register \
  --non-interactive \
  --executor "shell" \
  --url "http://192.168.1.200:30088/" \
  --registration-token "JRzzw2j1Ji6aBjwvkxAv" \
  --description "devops-runner" \
  --tag-list "build,deploy" \
  --run-untagged="true" \
  --locked="false" \
  --access-level="not_protected"

登录后复制

效果：

GitLab Runner安装注册配置管理

常用命令：

启动命令：

gitlab-runner --debug <command>   #调试模式排查错误特别有用。
gitlab-runner <command> --help    #获取帮助信息
gitlab-runner run       #普通用户模式  配置文件位置 ~/.gitlab-runner/config.toml
sudo gitlab-runner run  # 超级用户模式  配置文件位置/etc/gitlab-runner/config.toml

登录后复制

注册命令：

gitlab-runner register  #默认交互模式下使用，非交互模式添加 --non-interactive
gitlab-runner list      #此命令列出了保存在配置文件中的所有运行程序
gitlab-runner verify    #此命令检查注册的runner是否可以连接，但不验证GitLab服务是否正在使用runner。
--delete 删除
gitlab-runner unregister   #该命令使用GitLab取消已注册的runner。
#使用令牌注销
gitlab-runner unregister --url http://gitlab.example.com/ --token t0k3n
#使用名称注销（同名删除第一个）
gitlab-runner unregister --name test-runner
#注销所有
gitlab-runner unregister --all-runners

登录后复制

服务管理：

gitlab-runner install --user=gitlab-runner --working-directory=/home/gitlab-runner
# --user指定将用于执行构建的用户
#`--working-directory  指定将使用**Shell** executor 运行构建时所有数据将存储在其中的根目录
gitlab-runner uninstall #该命令停止运行并从服务中卸载GitLab Runner。
gitlab-runner start     #该命令启动GitLab Runner服务。
gitlab-runner stop      #该命令停止GitLab Runner服务。
gitlab-runner restart   #该命令将停止，然后启动GitLab Runner服务。
gitlab-runner status #此命令显示GitLab Runner服务的状态。当服务正在运行时，退出代码为零；而当服务未运行时，退出代码为非零。

登录后复制

运行Pipeline：

stages:
  - build
  - deploy
build:
  stage: build
  tags:
    - build
  only:
    - master
  script:
    - echo "mvn clean "
    - echo "mvn install"
deploy:
  stage: deploy
  tags:
    - deploy
  only:
    - master
  script:
    - echo "hello deploy"

登录后复制

GitLab Runner安装注册配置管理