flakm/gitlab-runner-auto-register
flakm
自动构建
这是一个Docker化的GitLab Runner镜像，支持自动注册到GitLab实例，简化CI/CD runner的部署与自动化配置，可灵活配置多项目注册及多种运行参数。
2 次收藏下载次数: 0状态：自动构建维护者：flakm仓库类型：镜像最近更新：7 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Gitlab Runner 自动注册镜像
镜像概述
本镜像基于GitLab官方文档创建，添加自动注册功能，可通过指定URL和令牌完成GitLab Runner的自动注册，解决默认镜像需外部执行脚本注册的问题，便于自动化部署。
核心功能
- 自动注册到GitLab实例
- 支持多项目注册（需管理员令牌）
- 灵活配置Docker运行参数（特权模式、卷挂载等）
- 自定义runner名称、标签列表等参数
Gitlab Runner版本对应
| 标签 | 版本 |
|---|---|
0.0.3 | 10.2.0 |
0.0.4-0.0.9 | 10.4.0 |
11.7.0 | 11.7.0 |
使用场景
- CI/CD流程的自动化部署与配置
- 多项目共享同一GitLab Runner
- 简化大规模runner集群管理
配置说明
环境变量
| 属性 | 描述 | 默认值 | 是否必填 |
|---|---|---|---|
CI_SERVER_URL | GitLab实例URL | - | 是 |
REGISTRATION_TOKEN | 项目CI/CD设置中的注册令牌（位于/settings/ci_cd页面） | - | 是 |
DOCKER_PRIVILEGED | 是否以特权模式运行Docker容器 | false | 否 |
REGISTER_LOCKED | Runner是否锁定到当前项目 | true | 否 |
ADMIN_TOKEN | 管理员权限访问令牌（用于多项目注册） | - | 否 |
PROJECTS_TO_REGISTER | 注册的项目ID，用逗号/分号分隔 | - | 否 |
CUSTOM_RUNNER_NAME | Runner描述名称 | $HOSTNAME | 否 |
DOCKER_VOLUMES | Runner挂载卷 | - | 否 |
DOCKER_IMAGE | Runner使用的Docker镜像 | docker:18.01.0-ce | 是 |
REGISTER_EXTRA_ARGS | 注册额外参数（如多--docker-volumes） | - | 否 |
RUNNER_TAG_LIST | Runner标签列表 | - | 否 |
部署示例
基础运行
bashREGISTRATION_TOKEN="你的注册令牌" docker run -d -e CI_SERVER_URL="https://gitlab.com/" \ -e REGISTRATION_TOKEN="$REGISTRATION_TOKEN" \ --name gitlab-runner \ -v /var/run/docker.sock:/var/run/docker.sock \ flakm/gitlab-runner-auto-register:latest
多项目注册
bashREGISTRATION_TOKEN="你的注册令牌" ADMIN_TOKEN="你的管理员令牌" PROJECTS_TO_REGISTER="5309683;4904307" docker run -d -e "CI_SERVER_URL=https://gitlab.com/" \ -e REGISTRATION_TOKEN="$REGISTRATION_TOKEN" \ -e ADMIN_TOKEN="$ADMIN_TOKEN" \ -e PROJECTS_TO_REGISTER="$PROJECTS_TO_REGISTER" \ -e REGISTER_LOCKED="false" \ --name gitlab-runner-testing \ -v /var/run/docker.sock:/var/run/docker.sock \ flakm/gitlab-runner-auto-register:latest
查看状态与配置
bash# 查看注册日志 docker logs gitlab-runner # 查看注册详情 docker exec -i gitlab-runner cat /etc/gitlab-runner/config.toml # 手动注册新runner docker exec -i gitlab-runner gitlab-runner register
更多信息
查看环境变量详细说明：
bashdocker run --rm --entrypoint "/usr/bin/gitlab-runner" flakm/gitlab-runner-auto-register:latest register --help
灵感来源
基于以下项目fork：
- https://github.com/pcodk/gitlab-runner-auto-register
- https://github.com/ayufan/gitlab-ci-multi-runner ===END===
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 gitlab-runner-auto-register 镜像标签
docker pull docker.xuanyuan.run/flakm/gitlab-runner-auto-register:<标签>
DockerHub 原生拉取命令
docker pull flakm/gitlab-runner-auto-register:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"