可以通过在 config.toml 文件中设置 when 属性来实现仅为推送 tag 时执行。具体步骤如下:
打开 GitLab Runner 所在的服务器,找到该 Runner 的配置文件,一般位于
/etc/gitlab-runner/config.toml。在该文件中找到
[runners]部分,找到需要修改的 Runner 对应的[runner]标签下面的[[runners]]部分。在该部分下新增一个
when属性,并将值设置为"on_tags",表示仅在推送 tag 时执行。
示例:
[[runners]]
name = "MyRunner"
url = "https://gitlab.com/"
token = "XXXXXXXXXXXXXX"
executor = "shell"
[runners.cache]
[runners.cache.s3]
[runners.cache.gcs]
[runners.shell]
# 设置仅为推送 tag 时执行
when = "on_tags"
- 修改完成后保存并退出文件。重启 GitLab Runner 生效。
注意事项:
- 如果使用 Docker 或 Kubernetes 等容器技术运行 GitLab Runner,则需要在容器内部修改配置文件。
- 当前 Runner 上已经存在的作业不会受影响,只有新推送的 tag 才会触发相应的作业。




