datacore/gitlab-runner

GitLab Runner Docker镜像

镜像概述

本镜像为GitLab Runner的Docker化部署版本，用于在GitLab CI/CD环境中执行自动化构建、测试和部署任务。原Docker Hub镜像地址已变更，当前最新镜像托管于https://hub.docker.com/repository/docker/gjrtimmer/gitlab-runner%E3%80%82

核心功能与特性

• 与GitLab服务器无缝集成，支持CI/CD流水线任务执行
• 支持多种执行器类型（Docker、Shell、Kubernetes等）
• 可配置并发任务处理，提高CI/CD效率
• 支持自定义构建环境和缓存机制
• 轻量级部署，易于集成到现有DevOps流程

使用场景

• GitLab项目的自动化构建、测试和部署流程
• 需要隔离执行环境的CI/CD任务
• 多项目共享Runner资源的场景
• 企业内部GitLab实例的CI/CD基础设施搭建

使用方法

拉取镜像

bash
docker pull gjrtimmer/gitlab-runner:latest

基本运行命令

bash
docker run -d --name gitlab-runner --restart always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /srv/gitlab-runner/config:/etc/gitlab-runner \
  gjrtimmer/gitlab-runner:latest

注册Runner

容器启动后，需注册Runner以连接GitLab服务器：

bash
docker exec -it gitlab-runner gitlab-runner register

根据提示输入GitLab服务器URL、注册令牌、Runner描述、标签及执行器类型等信息。

Docker Compose配置示例

yaml
version: '3'
services:
  gitlab-runner:
    image: gjrtimmer/gitlab-runner:latest
    restart: always
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./config:/etc/gitlab-runner
    environment:
      - TZ=Asia/Shanghai

配置说明

主要挂载卷

• /etc/gitlab-runner: Runner配置文件目录，持久化存储Runner配置
• /var/run/docker.sock: 当使用Docker执行器时，需挂载Docker socket以实现容器内构建

环境变量

• TZ: 设置时区，如Asia/Shanghai
• 其他GitLab Runner配置参数可通过gitlab-runner register命令或修改配置文件进行设置

注意事项

• 确保GitLab服务器版本与Runner版本兼容
• 使用Docker执行器时，需正确配置权限以避免容器访问问题
• 生产环境建议使用持久化存储卷保存Runner配置，防止容器重启后配置丢失