rkcreation/gitlab-runner

docker-gitlab-runner

镜像概述

docker-gitlab-runner是一个Docker化的GitLab Runner实现，核心特性是能够基于容器的启动（docker run）和停止（docker stop）事件，自动完成Runner的注册与注销流程，简化GitLab CI/CD Runner的管理和维护。

核心功能和特性

• 自动注册/注销：容器启动时自动向GitLab注册Runner，停止时自动从GitLab注销，无需手动管理Runner生命周期
• 支持DinD模式：集成Docker-in-Docker（DinD）功能，可在CI/CD流水线中直接构建和推送Docker镜像

使用场景

适用于需要动态管理GitLab Runner的CI/CD环境，包括但不限于：

• 临时Runner场景：按需启动Runner，任务完成后自动注销
• 自动扩展Runner集群：根据构建任务负载动态启停Runner
• 隔离化构建环境：通过容器化Runner实现不同项目或任务的环境隔离

使用方法

前提条件

需提供GitLab Runner注册令牌（gitlab_runner_token），该令牌可从GitLab项目或群组的CI/CD设置中获取。

Docker运行示例

bash
docker run -d \
  --name gitlab-runner \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e gitlab_runner_token=YOUR_REGISTRATION_TOKEN \
  -e CI_SERVER_URL=https://gitlab.example.com/ \
  docker-gitlab-runner

docker-compose配置示例

yaml
version: '3'
services:
  gitlab-runner:
    image: docker-gitlab-runner
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - gitlab_runner_token=YOUR_REGISTRATION_TOKEN
      - CI_SERVER_URL=https://gitlab.example.com/

在.gitlab-ci.yml中使用

当Runner启用DinD模式时，CI/CD流水线配置示例：

yaml
image: docker:stable
variables:
  DOCKER_HOST: tcp://docker:2375/
  DOCKER_DRIVER: overlay2
services:
  - docker:dind

build:
  script:
    - docker build -t my-image .
    - docker push my-image

配置参数