sameersbn/gitlab-ci-multi-runner

sameersbn/gitlab-ci-multi-runner:1.1.4-7

镜像概述

本镜像用于创建GitLab CI多运行器的Docker容器基础镜像，可作为构建自定义CI runner镜像的基础，支持GitLab CI/CD流程中的自动化任务执行。

核心功能

1. GitLab CI注册：通过环境变量（CI_SERVER_URL、RUNNER_TOKEN等）快速注册到GitLab CI服务器。
2. 持久化存储：支持挂载卷保存运行器状态和配置，确保容器重启后数据不丢失。
3. SSH部署密钥：自动生成无密码SSH部署密钥，用于访问私有Git仓库。
4. SSL证书信任：可配置信任自定义SSL证书，适配使用自签名证书的GitLab服务器。
5. 灵活配置：支持通过命令行参数自定义运行器启动行为。

使用场景

适用于GitLab CI/CD环境中，为项目提供自动化构建、测试、部署等CI任务的运行环境，尤其适合需要自定义CI runner的场景。

配置说明

安装方式

拉取镜像（推荐）

bash
docker pull sameersbn/gitlab-ci-multi-runner:1.1.4-7

自行构建

bash
docker build -t sameersbn/gitlab-ci-multi-runner github.com/sameersbn/docker-gitlab-ci-multi-runner

快速启动

通过环境变量注册并启动运行器：

bash
docker run --name gitlab-ci-multi-runner -d --restart=always \
  --volume /srv/docker/gitlab-runner:/home/gitlab_ci_multi_runner/data \
  --env='CI_SERVER_URL=http://git.example.com/ci' \
  --env='RUNNER_TOKEN=xxxxxxxxx' \
  --env='RUNNER_DESCRIPTION=myrunner' \
  --env='RUNNER_EXECUTOR=shell' \
  sameersbn/gitlab-ci-multi-runner:1.1.4-7

若未指定环境变量，首次运行时会交互式提示输入注册信息。

持久化配置

挂载卷/home/gitlab_ci_multi_runner/data以保存运行器数据：

bash
mkdir -p /srv/docker/gitlab-runner
# SELinux用户需执行以下命令
chcon -Rt svirt_sandbox_file_t /srv/docker/gitlab-runner

SSL证书信任

将自签名证书文件ca.crt放置于持久化卷的certs目录下（/srv/docker/gitlab-runner/certs/ca.crt），以信任GitLab服务器的SSL证书。

维护操作

升级镜像

1. 拉取更新镜像：docker pull sameersbn/gitlab-ci-multi-runner:1.1.4-7
2. 停止当前容器：docker stop gitlab-ci-multi-runner
3. 删除旧容器：docker rm -v gitlab-ci-multi-runner
4. 启动新容器：使用上述快速启动命令（保留原配置）

容器shell访问

bash
docker exec -it gitlab-ci-multi-runner bash