Eclipse stack-build-agent 镜像文档

概述

stack-build-agent是Eclipse Foundation提供的Docker镜像，作为构建环境的代理服务组件，为自动化构建流程提供稳定、高效的运行环境。该镜像集成常见构建工具与依赖管理系统，简化构建环境配置，支持多种项目类型构建需求，适用于各类软件开发项目的CI/CD pipeline。

核心功能与特性

• 构建环境代理：协调构建任务分配与执行，作为构建流程的代理节点
• 工具集成：内置Git、Maven、Gradle、npm等常用构建工具，满足多语言项目需求
• 依赖管理：自动缓存与管理项目依赖，减少重复下载，提升构建速度
• 环境隔离：通过容器化确保构建环境一致性，避免环境差异导致的构建问题
• CI/CD集成：兼容主流CI/CD平台（Jenkins、GitHub Actions等），支持无缝集成现有流程

使用场景

• 自动化构建流水线：用于软件开发项目的持续集成/持续部署流程
• 多语言项目构建：支持Java、JavaScript、Python等多种编程语言的项目构建
• 构建环境标准化：为团队提供统一构建环境，减少"在我机器上能运行"问题
• 依赖缓存优化：通过代理服务缓存构建依赖，降低外部网络依赖，提升构建稳定性

使用方法与配置说明

基础使用

通过Docker命令启动容器，指定必要的环境变量与端口映射：

docker run -d --name stack-build-agent -p 8080:8080 eclipsefdn/stack-build-agent

环境变量配置

持久化存储

为确保依赖缓存与配置持久化，建议挂载本地目录：

docker run -d --name stack-build-agent \
  -p 8080:8080 \
  -v /local/cache:/var/cache/build \
  -e LOG_LEVEL=DEBUG \
  eclipsefdn/stack-build-agent

Docker Compose 配置示例

version: '3.8'
services:
  build-agent:
    image: eclipsefdn/stack-build-agent
    container_name: stack-build-agent
    ports:
      - "8080:8080"
    environment:
      - AGENT_PORT=8080
      - BUILD_CACHE_DIR=/var/cache/build
      - LOG_LEVEL=INFO
      - REMOTE_REGISTRY_URL=[***]
    volumes:
      - ./build-cache:/var/cache/build
    restart: unless-stopped

注意事项

• 确保宿主机端口未被占用，修改端口时需同步调整AGENT_PORT环境变量与端口映射
• 依赖缓存目录建议使用持久化存储，避免容器重启后缓存丢失
• 可通过自定义Dockerfile基于此镜像扩展，添加项目特定工具或配置