Bamboo Agent Docker镜像文档

1. 镜像概述与主要用途

Bamboo Agent是一款可运行作业构建的服务。每个代理均具备定义的能力集，仅能运行需求与其能力匹配的作业。本Docker镜像旨在简化Bamboo远程代理的部署与运行，作为基础镜像提供，包含有限的内置构建工具，用户可基于此扩展自定义工具链。

注意：本镜像不包含Bamboo服务器。如需Bamboo Server Docker镜像，请参见atlassian/bamboo。

2. 核心功能与特性

2.1 内置能力

• JDK支持：JDK 11、JDK 17（v9.4.0及以上）、JDK 21（v10.1.0及以上）
• 构建工具：Git & Git LFS、Maven 3、Python 3

2.2 基础系统

• 基于Eclipse Temurin构建，默认搭载Ubuntu 24.04（Noble）
• 提供旧版Ubuntu 22.04（Jammy）兼容标签（jdk11-jammy、jdk17-jammy），仅用于兼容性迁移，不建议生产环境使用

3. 使用场景与适用范围

3.1 适用场景

• 作为Bamboo远程代理节点，运行与自身能力匹配的构建作业
• 作为基础镜像，扩展自定义构建工具链以满足特定项目需求
• 分布式构建环境中，提供轻量级、可扩展的代理节点

3.2 环境要求

• Docker版本需≥20.10.9

4. 使用方法与配置说明

4.1 Ubuntu基础版本说明

• 默认版本：基于Ubuntu 24.04（Noble），推荐生产环境使用，标签为jdk11、jdk17、jdk21（分别对应JDK 11、17、21）
• 兼容版本：提供Ubuntu 22.04（Jammy）标签jdk11-jammy、jdk17-jammy，仅用于兼容性迁移，不维护且不提供更新

4.2 数据卷建议

BAMBOO_AGENT_HOME目录用于存储仓库数据等持久化信息，建议通过以下方式挂载：

• 主机目录作为数据卷
• Docker命名卷（推荐，下文示例采用此方式）

4.3 快速启动步骤

步骤1：创建命名卷

docker volume create --name bambooAgentVolume

步骤2：启动代理容器

docker run -e BAMBOO_SERVER=[***] \
  -v bambooAgentVolume:/var/atlassian/application-data/bamboo-agent \
  --name="bambooAgent" \
  --hostname="bambooAgent" \
  -d atlassian/bamboo-agent-base

参数说明

• -e BAMBOO_SERVER：指定Bamboo服务器的agentServer URL（必填，需替换为实际服务器地址）
• -v bambooAgentVolume:/var/atlassian/application-data/bamboo-agent：挂载命名卷至代理数据目录
• --name：容器名称（自定义）
• --hostname：容器主机名（自定义）
• -d：后台运行容器

验证

启动成功后，代理将在Bamboo管理界面中显示，等待管理员审批即可使用。

4.4 高级用法

如需配置、故障排查、可支持性等高级内容，请参见完整文档。