3.4 Runner 常用命令

参考：https://docs.gitlab.com/runner/commands/README.html#registration-related-commands

// 查看命令的最新列表：

$ gitlab-runner --help

//查看子命令的帮助

gitlab-runner <command> --help

1. 使用环境变量

大多数命令都支持将环境变量作为配置传递给命令的方法。

$ gitlab-runner run --help

2. 在调试模式下运行

在寻找某些未定义行为或错误的原因时，调试模式特别有用。

要在调试模式下运行命令，请在命令前添加—debug：

gitlab-runner --debug <command>

3. 与注册相关的命令

以下命令允许您注册新的 Runner，或者列出并验证他们是否仍在注册。

gitlab-runner register        //注册 runner，分为交互式和非交互式
gitlab-runner list           //列出配置文件中（config.toml）所有的 Runners
gitlab-runner verify         //检查注册的 Runner 是否可以连接到GitLab，无法验证是否被 GitLab 使用
gitlab-runner unregister     //注销特定的 Runner

//交互式注册

gitlab-runner register --name my-runner --url http://gitlabtest.xiodi.cn --registration-token my-registration-token

//或者在注册之前，配置以下环境变量

export CI_SERVER_URL=http://gitlab.example.com
export RUNNER_NAME=my-runner
export REGISTRATION_TOKEN=my-registration-token
export REGISTER_NON_INTERACTIVE=true
gitlab-runner register

//非交互式

gitlab-runner register --non-interactive <other-arguments>

//或者在register命令之前配置环境变量:

<other-environment-variables>
export REGISTER_NON_INTERACTIVE=true
gitlab-runner register

4. 服务相关命令

以下命令允许您将运行程序作为系统或用户服务进行管理。使用它们来安装，卸载，启动和停止 Runner 服务。

• gitlab-runner install
• gitlab-runner uninstall
• gitlab-runner start
• gitlab-runner stop
• gitlab-runner restart
• gitlab-runner status

所有与服务相关的命令都接受这些参数:

更多参考：https://docs.gitlab.com/runner/commands/README.html#service-related-commands

5. 内部命令

GitLab Runner是作为一个二进制文件分发的，并且包含一些在构建过程中使用的内部命令。

gitlab-runner artifacts-downloader
从GitLab下载工件档案。

gitlab-runner artifacts-uploader
将工件档案上传到GitLab。

gitlab-runner cache-archiver
创建缓存存档，将其存储在本地或将其上传到外部服务器。

gitlab-runner cache-extractor
从本地或外部存储的文件还原缓存档案。