weahead/builder

CI构建器容器说明

镜像概述和主要用途

本容器专为CI（持续集成）构建器设计，集成了多种开发、部署及版本控制工具，旨在提供一个统一、便捷的环境，满足CI/CD（持续集成/持续部署）流程中的构建、测试和部署需求，减少环境配置差异带来的问题。

核心功能和特性

容器包含以下工具，覆盖开发、容器化、部署及数据处理等多个环节：

• Node.js：JavaScript运行环境，支持前端和后端JavaScript应用开发与构建
• Now.sh CLI：Vercel平台的命令行工具，用于快速部署前端和后端应用
• Docker：容器化平台，支持应用打包、分发和运行
• Docker Compose：Docker的编排工具，用于定义和运行多容器Docker应用
• Rancher CLI：Rancher容器管理平台的命令行工具，支持集群管理和应用部署
• Git：分布式版本控制系统，用于代码管理和版本控制
• cURL：命令行工具，用于数据传输（如API请求、文件下载等）
• jq：轻量级JSON处理器，用于解析和转换JSON数据

使用场景和适用范围

• CI/CD流水线：作为自动化构建、测试和部署的执行环境
• 多工具开发场景：需要同时使用Node.js、Docker、Git等工具的开发任务
• 统一环境配置：确保团队成员或CI系统使用一致的工具版本和环境
• 快速部署流程：结合Now.sh CLI、Rancher CLI等工具实现应用快速部署

使用方法和配置说明

基本使用（Docker Run）

通过以下命令启动容器，挂载工作目录并执行构建任务：

bash
# 挂载当前目录作为工作目录，运行npm构建命令
docker run -v $(pwd):/app -w /app ci-builder:latest npm run build

# 执行Git操作（如拉取代码）
docker run -v $(pwd):/app -w /app ci-builder:latest git pull origin main

# 使用Docker Compose启动服务
docker run -v /var/run/docker.sock:/var/run/docker.sock -v $(pwd):/app -w /app ci-builder:latest docker-compose up -d

说明：挂载/var/run/docker.sock可使容器内Docker命令访问宿主机Docker服务。

环境变量配置

可通过环境变量调整工具行为，常用变量包括：

• NODE_ENV：Node.js环境（如production、development），默认development
• DOCKER_HOST：Docker服务地址，默认使用宿主机Docker（通过挂载/var/run/docker.sock）
• RANCHER_URL：Rancher服务器地址，用于Rancher CLI连接集群
• RANCHER_ACCESS_KEY、RANCHER_SECRET_KEY：Rancher CLI认证凭据

示例：配置Rancher CLI连接集群

bash
docker run -e RANCHER_URL=https://rancher.example.com \
  -e RANCHER_ACCESS_KEY=xxx \
  -e RANCHER_SECRET_KEY=yyy \
  ci-builder:latest rancher cluster list

许可证

本容器使用X11许可证。