atmailtech/atmail-build-agent

atmail Bitbucket流水线构建代理镜像

概述

atmail Bitbucket流水线构建代理镜像是一个专为Bitbucket CI/CD流程设计的构建环境，旨在替代Atlassian官方的atlassian/default-image:2镜像。该镜像提供兼容的构建环境，支持各类软件项目的自动化构建、测试和部署流程。

核心功能与特性

• 兼容性保障：完全兼容Bitbucket流水线环境，可直接替换atlassian/default-image:2使用
• 优化构建效率：预配置常用构建工具和依赖，减少构建环境准备时间
• 环境一致性：提供标准化的构建环境，确保不同流水线任务执行结果的一致性
• 轻量级设计：在保持功能完整性的同时优化镜像体积，提升拉取和启动速度

使用场景

• 替代Bitbucket流水线中默认的atlassian/default-image:2镜像
• 执行Web应用、后端服务、库文件等各类项目的自动化构建流程
• 适用于需要标准化构建环境的团队或项目
• 用于CI/CD流程中的代码编译、单元测试、集成测试和打包等环节

使用方法

在Bitbucket流水线中配置

在bitbucket-pipelines.yml文件中指定该镜像作为构建环境：

yaml
image: atmail/bitbucket-pipeline-build-agent:latest

pipelines:
  default:
    - step:
        name: 构建与测试
        script:
          - ./compile.sh
          - ./run-tests.sh
          - ./package.sh

本地测试构建环境

如需本地验证构建环境，可通过以下命令启动容器：

bash
docker run -it --rm atmail/bitbucket-pipeline-build-agent:latest /bin/bash

自定义构建参数

可通过环境变量配置构建行为（具体支持的变量需参考镜像完整文档）：

yaml
image: atmail/bitbucket-pipeline-build-agent:latest

pipelines:
  default:
    - step:
        name: 自定义构建
        environment:
          BUILD_MODE: "production"
          ENABLE_OPTIMIZATIONS: "true"
        script:
          - ./build-with-params.sh

注意事项

• 确保Bitbucket有权限访问该镜像（如使用私有仓库需配置访问凭证）
• 根据项目需求，可能需要在流水线步骤中安装额外依赖
• 建议定期更新镜像版本以获取最新功能和安全更新
• 复杂构建场景可能需要配合bitbucket-pipelines.yml中的services配置使用