alpinelinux/gitlab-runner-helper

GitLab Runner辅助镜像（多架构支持版）

镜像概述

本镜像为GitLab Runner的辅助工具镜像，旨在扩展官方gitlab-runner-helper镜像的架构支持范围。它能够在更多硬件架构（如ARM、ARM64、AMD64等）上运行，辅助GitLab Runner完成CI/CD流程中的任务执行、资源清理、工件处理等操作，确保跨架构环境下CI/CD流水线的稳定运行。

核心功能与特性

• 多架构支持：相比官方镜像，支持更多硬件架构（包括但不限于ARMv7、ARM64、AMD64、ppc64le等），满足多样化部署需求。
• 与GitLab Runner兼容：完全兼容GitLab Runner的工作流，可无缝集成到现有CI/CD流水线中。
• 轻量级设计：优化镜像体积，减少资源占用，提升任务执行效率。
• 功能完整性：保留官方gitlab-runner-helper的全部核心功能，包括任务执行辅助、文件系统操作、缓存管理等。

使用场景与适用范围

• 需要在非x86架构（如ARM开发板、嵌入式设备）上部署GitLab Runner的场景。
• 多架构环境下的CI/CD流水线构建与测试，确保软件在不同架构上的兼容性。
• 对官方镜像架构支持不足的补充，满足特定硬件环境下的CI/CD需求。

使用方法与配置说明

基本使用（独立运行）

可通过以下命令运行镜像，验证架构兼容性：

bash
docker run --rm [镜像名称]:[标签] --version

与GitLab Runner集成

在GitLab Runner配置中，通过指定helper_image参数使用本镜像：

1. 编辑GitLab Runner配置文件（通常为config.toml）
2. 在[[runners]]部分添加或修改：

   toml
   [runners.docker]
     helper_image = "[镜像名称]:[标签]"
   

3. 重启GitLab Runner服务使配置生效：

   bash
   gitlab-runner restart
   

环境变量

本镜像保持与官方gitlab-runner-helper一致的环境变量支持，主要包括：

• CI_JOB_ID：当前CI任务ID（由GitLab Runner自动注入）
• CI_PROJECT_DIR：项目工作目录（由GitLab Runner自动注入）
• RUNNER_TEMP_DIR：临时文件目录（默认/tmp）

注意事项

• 确保使用与GitLab Runner版本匹配的镜像标签，避免版本兼容性问题。
• 在非x86架构环境中部署时，需确保Docker引擎已正确配置多架构支持（如通过qemu-user-static等工具）。