jbuncle/gitlab-runner

Gitlab Docker runner

镜像概述

Gitlab Docker runner是GitLab CI/CD（持续集成/持续部署）系统的官方执行器，专为在Docker环境中运行自动化任务而设计。它作为GitLab CI/CD流水线的工作节点，负责执行GitLab项目中定义的.gitlab-ci.yml配置文件中的构建、测试、部署等任务，通过环境变量与GitLab服务器建立通信，实现CI/CD流程的自动化执行。

核心功能与特性

• CI/CD任务执行：作为GitLab CI/CD的工作节点，运行.gitlab-ci.yml中定义的自动化任务（构建、测试、部署等）。
• Docker环境支持：基于Docker容器化运行，确保任务执行环境的一致性和隔离性。
• 灵活配置：通过环境变量配置与GitLab服务器的连接参数，无需手动修改配置文件。
• 自动注册：启动时可通过配置的注册令牌自动注册到GitLab服务器，简化部署流程。

使用场景

• 开发团队CI/CD流程：适用于需要自动化构建、测试、部署的GitLab项目，帮助开发团队实现代码提交后的自动验证和交付。
• 多环境一致性保障：通过Docker容器化环境，确保不同开发、测试、生产环境中任务执行的一致性，减少"在我电脑上能运行"的问题。
• 轻量级部署：作为Docker容器运行，部署简单，资源占用可控，适合中小型项目或团队快速搭建CI/CD能力。

使用方法与配置说明

环境变量配置

Gitlab Docker runner通过以下环境变量进行配置，用于与GitLab服务器建立连接和注册：

Docker 运行示例

基本运行命令

通过docker run命令启动Gitlab Docker runner，需指定必要的环境变量（至少包含GITLAB_REGISTRATION_TOKEN）：

bash
docker run -d \
  --name gitlab-runner \
  --restart always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e GITLAB_REGISTRATION_TOKEN="your_registration_token_from_gitlab" \
  -e GITLAB_PROTOCOL="https" \
  -e GITLAB_VHOST="gitlab.example.com" \
  gitlab/gitlab-runner:latest

说明：-v /var/run/docker.sock:/var/run/docker.sock 挂载宿主机Docker套接字，使runner能够在容器内创建新的Docker容器执行任务。

使用自定义本地IP配置

若GitLab服务器与runner在同一网络且需通过本地IP访问，可配置GITLAB_LOCAL_HOST：

bash
docker run -d \
  --name gitlab-runner \
  --restart always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e GITLAB_LOCAL_HOST="192.168.1.100" \
  -e GITLAB_REGISTRATION_TOKEN="your_registration_token" \
  -e GITLAB_PROTOCOL="http" \
  gitlab/gitlab-runner:latest

验证与管理

runner启动后，会自动使用提供的注册令牌注册到GitLab服务器。可通过GitLab服务器的"Settings > CI/CD > Runners"页面查看已注册的runner状态。如需停止或重启runner，可使用标准Docker命令：

bash
# 停止runner
docker stop gitlab-runner

# 重启runner
docker restart gitlab-runner

# 查看日志
docker logs gitlab-runner