klud/gitlab-runner

ARM设备专用GitLab Runner镜像

![build status]([***]

标签说明

注意：Alpine是默认镜像，执行docker pull klud/gitlab-runner时会下载该版本。

镜像概述

本镜像基于GitLab Runner官方仓库构建，专为ARM架构设备设计，提供Alpine（轻量）和Ubuntu（兼容更多依赖）两种基础镜像版本，用于在ARM平台上运行GitLab CI/CD流水线任务。

核心功能

1. 支持ARM架构设备的CI/CD任务执行
2. 提供轻量Alpine和兼容型Ubuntu两种版本选择
3. 支持Docker executor，可在容器内运行构建任务
4. 支持配置缓存目录和特权模式，解决Docker-in-Docker场景问题
5. 支持通过命令行或配置文件自定义Runner参数

使用场景

1. ARM平台项目的自动化构建、测试与部署
2. 边缘计算设备上的CI/CD流水线落地
3. ARM架构下开源项目的持续集成需求

配置说明

容器部署方式

方式一：直接挂载配置卷

sh
docker run -d --name arm-runner \
-v $(pwd)/.runner:/etc/gitlab-runner \
--restart=always \
klud/gitlab-runner

方式二：使用配置容器挂载卷

sh
docker run -d --name runner-config \
    -v /etc/gitlab-runner \
    armhf/busybox \
    /bin/true

docker run -d --name arm-runner --restart=always \
    --volumes-from runner-config \
    klud/gitlab-runner

方式三：使用Docker executor（需挂载Docker socket）

sh
docker run -d --name arm-runner --restart=always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v $(pwd)/.runner:/etc/gitlab-runner \
  klud/gitlab-runner

Docker Compose部署

yaml
version: "2"
services:
  runner:
    image: klud/gitlab-runner
    container_name: arm-runner
    restart: always
    volumes:
      - $(pwd)/.runner:/etc/gitlab-runner
      - /var/run/docker.sock:/var/run/docker.sock

Runner注册

交互式注册

sh
docker exec -it arm-runner gitlab-runner register

根据提示输入GitLab协调器URL、注册令牌、Runner描述、执行器类型（如docker）及Docker镜像等信息。

非交互式注册

sh
docker exec -it arm-runner \
gitlab-runner register -n \
--url https://gitlab.domain.tld \
--registration-token XXXXXXXXXXXXXXXXXXXX \
--executor docker \
--description "ARM Runner by ulm0" \
--docker-image "docker:17.12" \
--tag-list "docker,arm" \
--docker-privileged

故障排除

若使用Docker-in-Docker时出现无法连接Docker守护进程的错误，需修改Runner配置文件（位于挂载的.runner目录下的config.toml），添加特权模式和Docker socket挂载：

toml
concurrent = 1
check_interval = 0

[[runners]]
  name = "ARM Runner by ulm0"
  url = "https://gitlab.domain.tld"
  token = "XXXXXXXXXXXXXXXXXXXX"
  executor = "docker"
  [runners.docker]
    tls_verify = false
    image = "docker:17.12"
    privileged = true
    disable_cache = false
    cache_dir = "cache"
    volumes = ["/var/run/docker.sock:/var/run/docker.sock","/cache"]
  [runners.cache]

修改后重启容器：docker restart arm-runner。

![forthebadge]([] ![forthebadge]([]