intellihrci/gitlab-builder

GitLab Runner 通用工具镜像

镜像概述

本镜像为GitLab Runner设计，集成了CI/CD流程中常用的工具集，旨在简化GitLab CI/CD配置，减少Runner环境搭建时间，确保构建、测试和部署过程的一致性与高效性。

核心功能与特性

• 工具集成：包含版本控制（如git）、网络工具（如curl、wget）、构建工具（如make、gcc）、容器工具（如docker-cli）等常见CI/CD依赖工具
• 兼容性：与GitLab Runner完全兼容，支持.gitlab-ci.yml中定义的各类任务
• 环境一致性：提供标准化工具环境，避免因本地工具版本差异导致的构建问题
• 轻量级设计：在保证功能完整性的前提下优化镜像体积，提升拉取和启动速度

使用场景与适用范围

• 代码构建：支持多种编程语言（如Java、Python、Node.js等）的项目构建
• 自动化测试：提供测试框架依赖工具，支持单元测试、集成测试等场景
• 应用部署：集成部署相关工具，支持将构建产物部署到各类环境
• 持续集成流程：适用于GitLab CI/CD流水线中的各阶段任务执行

使用方法与配置说明

在GitLab CI配置中使用

在.gitlab-ci.yml中直接引用本镜像：

yaml
stages:
  - build
  - test

build_job:
  stage: build
  image: [镜像名称]  # 替换为实际镜像名称
  script:
    - git --version  # 验证git工具
    - make build     # 执行构建命令

test_job:
  stage: test
  image: [镜像名称]  # 替换为实际镜像名称
  script:
    - curl --version  # 验证curl工具
    - make test       # 执行测试命令

本地测试（docker run）

通过以下命令启动容器进行本地工具验证：

bash
docker run -it --rm [镜像名称] /bin/bash

进入容器后可直接使用集成的工具：

bash
# 示例：检查工具版本
git --version
curl --version
docker --version  # 需确保宿主机已安装Docker且容器具备相应权限

环境变量配置

可通过环境变量调整工具行为，常见配置项：

工具列表（部分）

• 版本控制：git
• 网络工具：curl, wget, ping
• 构建工具：make, gcc, g++, cmake
• 容器工具：docker-cli, docker-compose
• 包管理：apt, yum（根据基础镜像而定）
• 脚本工具：bash, python3, nodejs

注意事项

• 如需使用Docker相关功能，需确保GitLab Runner以特权模式运行或挂载宿主机Docker套接字（/var/run/docker.sock）
• 部分工具可能需要根据项目需求额外安装依赖，可在CI脚本中通过包管理工具进行补充
• 定期更新镜像以获取最新工具版本和安全补丁