Bamboo Specs Runner 镜像文档

镜像概述

本镜像为Atlassian Bamboo官方提供，用于在容器环境中运行Bamboo Specs文件。Bamboo Specs是定义Bamboo构建计划、部署项目、环境配置等的配置文件，支持Java、YAML等格式。该镜像提供隔离的执行环境，确保Specs文件在统一、可控的条件下执行，是实现Bamboo配置即代码（Configuration as Code）的关键组件。

核心功能与特性

• 容器化隔离环境：在独立容器中执行Specs文件，避免与主机环境依赖冲突，提升执行稳定性。
• 多格式支持：兼容Bamboo Specs的主流格式，包括Java类文件（通过Maven/Gradle编译）和YAML配置文件。
• Bamboo Server集成：可直接与Bamboo Server通信，支持从Server拉取Specs文件、提交执行结果（如自动更新Bamboo配置）。
• 一致性保障：统一的运行时环境确保不同开发/部署阶段（本地开发、CI流水线、生产环境）执行结果一致。
• 轻量级设计：基于精简基础镜像，减少资源占用，加快启动速度。

使用场景

1. Bamboo配置即代码实践

将Bamboo Specs文件纳入Git等版本控制系统后，通过本镜像自动执行Specs文件，实现配置的版本化管理与自动更新。例如：开发者提交Specs文件变更后，CI流水线调用该镜像执行文件，自动更新Bamboo Server配置。

2. 多环境配置验证

在开发、测试环境中使用该镜像验证Specs文件的正确性，确保配置在正式部署前无语法错误或逻辑问题。

3. CI/CD流水线集成

作为CI/CD流程的环节之一，在代码构建前执行Specs文件，检查配置合规性；或在代码合并后自动应用配置变更。

使用方法

基本使用（本地文件执行）

通过挂载本地Specs文件目录，直接执行指定文件：

docker run --rm \
  -v /path/to/local/specs:/specs \  # 挂载本地Specs文件目录到容器内/specs
  atlassian/bamboo-specs-runner:latest \  # 镜像名称（具体版本需替换为实际标签）
  /specs/my-bamboo-specs.yaml  # 容器内Specs文件路径（支持YAML或编译后的Java类文件）

与Bamboo Server集成

指定Bamboo Server地址及认证信息，从Server拉取Specs文件并执行：

docker run --rm \
  -e BAMBOO_SERVER_URL="[***]" \  # Bamboo Server URL
  -e BAMBOO_USERNAME="admin" \  # Bamboo认证用户名（需具备Specs执行权限）
  -e BAMBOO_PASSWORD="your-password" \  # Bamboo认证密码
  atlassian/bamboo-specs-runner:latest \
  --server  # 从Bamboo Server拉取Specs文件执行（默认拉取当前登录用户的Specs）

环境变量说明

执行结果说明

• 执行成功：容器退出码为0，Bamboo Server配置将根据Specs文件自动更新（若与Server集成）。
• 执行失败：容器退出码非0，日志输出错误详情（如文件语法错误、权限不足等），需修复后重新执行。

注意事项

• 文件权限：挂载本地文件时，确保容器内用户（通常为bamboo）对挂载目录有读权限。
• 版本兼容性：镜像版本需与Bamboo Server版本匹配（如Bamboo 9.x对应镜像版本建议使用9.x系列）。
• 敏感信息：避免在命令行直接暴露密码，可通过Docker Secrets或环境变量文件传递敏感信息。