userhome/ci-builder

ci-builder

镜像概述

ci-builder是一个集成了多种构建工具的Docker镜像，旨在为CI/CD流程提供统一的构建环境。该镜像预装了开发和构建过程中常用的工具，可简化构建环节的环境配置，提高CI/CD流水线的一致性和效率。

核心功能和特性

该镜像包含以下关键工具和包：

• bash：提供shell环境，支持脚本执行和命令行操作
• make：用于构建自动化，支持Makefile定义的构建流程
• curl：用于HTTP/HTTPS请求，可用于下载依赖或API调用
• git：版本控制工具，支持代码拉取、提交等操作
• openssh-client：提供SSH客户端功能，支持远程服务器访问和认证
• ca-certificates：包含根证书集合，确保HTTPS连接的安全性
• python：提供Python运行环境，支持Python脚本执行和依赖管理
• protobuf：Protocol Buffers工具，用于数据序列化和接口定义
• util-linux：提供基础系统工具，如lsblk、mount等系统管理命令

使用场景和适用范围

• CI/CD流水线中的构建阶段，用于自动化编译、打包、测试等任务
• 需要多种构建工具的开发环境，确保本地开发与CI环境一致性
• 临时构建环境，快速启动包含完整工具链的容器进行项目构建

使用方法和配置说明

基础使用

通过以下命令启动ci-builder容器：

bash
docker run --rm -it ci-builder

挂载项目目录

将本地项目目录挂载到容器中，进行项目构建：

bash
docker run --rm -v $(pwd):/app -w /app ci-builder make build

在CI/CD流程中使用

在GitLab CI/CD配置文件（.gitlab-ci.yml）中使用：

yaml
build:
  image: ci-builder
  script:
    - git clone https://github.com/example/project.git
    - cd project
    - make build
    - curl -X POST https://api.example.com/upload -F "file=@output.tar.gz"

环境变量配置

可通过环境变量配置工具行为，例如设置Git用户名和***：

bash
docker run --rm -e GIT_USER_NAME="CI Builder" -e GIT_USER_EMAIL="ci@example.com" ci-builder git config --global user.name "$GIT_USER_NAME"

注意事项

• 该镜像仅包含构建工具，不含特定语言的SDK（如Java、Node.js等），如需使用需额外安装
• 建议根据具体构建需求，在该镜像基础上构建自定义镜像，添加项目特定依赖
• 容器默认以非root用户运行，如需root权限可添加--user root参数