GitLab Runner 速查
共 24 条 GitLab Runner 注册与 CI 配置，涵盖安装与注册、.gitlab-ci.yml、变量与产物、Runner 命令、执行器。 支持搜索与分类筛选，点击即可复制。
安装与注册
Runner 负责执行 CI 任务。
| 命令 | 说明 |
|---|---|
| 交互式注册（填 URL、token、executor） | |
| 注册参数：实例地址与注册令牌 | |
| 选择执行器（docker / shell / k8s） | |
| 描述与标签（决定任务能否被接） | |
| 校验已注册 Runner 的连通性 |
.gitlab-ci.yml
流水线定义。
| 命令 | 说明 |
|---|---|
| 阶段定义（按顺序执行） | |
| 定义一个任务 | |
| 条件触发（替代旧 only/except） | |
| 旧的触发方式 | |
| 指定任务的容器镜像 |
变量与产物
传递数据与缓存。
| 命令 | 说明 |
|---|---|
| 定义变量 | |
| 产物（可下载、可传给后续阶段） | |
| 缓存依赖加速 | |
| 指定要拉取哪些上游产物 | |
| 绑定部署环境 |
Runner 命令
日常运维。
| 命令 | 说明 |
|---|---|
| 列出已注册 Runner | |
| 前台运行 | |
| 注销指定 Runner | |
| 安装并启动系统服务 |
执行器
按平台选择。
| 命令 | 说明 |
|---|---|
| 每个任务起一个容器（隔离好，最常用） | |
| 直接在宿主机执行（快，但隔离差） | |
| 在 k8s 集群中起 Pod 执行 | |
| 并发数配置 | |
| 镜像拉取策略与卷挂载 |
使用说明
GitLab Runner 速查：安装与注册、.gitlab-ci.yml、变量与产物、Runner 命令、执行器；支持搜索与分类筛选，点击即可复制。
- 按用途点分类：安装与注册、.gitlab-ci.yml、变量与产物、Runner 命令、执行器。
- 点「命令」列复制到终端或 .gitlab-ci.yml。
- 注册时选对 executor（多为 docker）并打标签，任务用 tags 匹配。
- 把依赖放进 cache、产出放进 artifacts，能显著加快流水线。
常见问题
- 任务一直 pending 怎么办？
- 多半是没有匹配标签或 Runner 离线：检查任务 tags 与 Runner 的 tag-list、再用 gitlab-runner verify 确认连通。
- cache 和 artifacts 的区别？
- cache 用于跨任务/跨流水线加速复用中间产物（可能失效）；artifacts 是正式的构建产物，可下载并传给后续阶段。
- 需要联网吗？
- 速查内容本地可用；运行流水线需连接 GitLab 实例。