mrwork/bitbucket-pipelines

docker-bitbucket-pipelines

镜像概述

docker-bitbucket-pipelines是一款基于Atlassian Pipelines默认镜像构建的自定义Docker镜像，旨在为Bitbucket用户提供扩展化的CI/CD构建环境。该镜像继承了Atlassian官方Pipelines镜像的核心功能，同时允许用户根据项目需求定制工具链、依赖库及环境配置，适用于需要个性化构建流程的Bitbucket项目。

核心功能与特性

基础功能继承

• 完整继承Atlassian Pipelines默认镜像的基础环境，包含Git、Java、Python、Node.js等常用构建工具及运行时依赖。
• 支持Bitbucket Pipelines原生的CI/CD流程集成，兼容bitbucket-pipelines.yml配置文件语法。

自定义扩展能力

• 允许通过Dockerfile或构建脚本添加项目特定工具（如特定版本的编译器、测试框架、部署工具等）。
• 支持预配置环境变量、证书或密钥，简化构建过程中的认证与配置步骤。

环境优化

• 可能包含针对特定构建场景的性能优化（如缓存依赖目录、精简镜像体积等）。
• 保持与Atlassian官方镜像的兼容性，确保升级或迁移过程平滑。

使用场景与适用范围

适用场景

• Bitbucket项目CI/CD流程：作为Bitbucket Pipelines的构建环境镜像，用于代码编译、单元测试、打包及部署等环节。
• 自定义工具链需求：当官方默认镜像缺乏项目所需的特定工具或依赖版本时，提供扩展能力。
• 团队标准化环境：统一团队内多个项目的构建环境，减少"本地可运行，CI失败"的环境差异问题。

适用范围

• 使用Bitbucket作为代码托管平台的开发团队。
• 需要在CI/CD流程中集成非官方工具或自定义脚本的项目。
• 对构建环境稳定性、一致性有较高要求的企业级应用开发。

使用方法与配置说明

镜像获取

可通过Docker Hub或私有仓库拉取镜像（假设镜像标签为your-registry/docker-bitbucket-pipelines:latest）：

bash
docker pull your-registry/docker-bitbucket-pipelines:latest

本地测试

拉取后可本地运行容器验证环境：

bash
docker run -it --rm your-registry/docker-bitbucket-pipelines:latest /bin/bash

进入容器后，可通过java -version、node -v等命令检查预装工具版本。

在Bitbucket Pipelines中使用

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

yaml
image: your-registry/docker-bitbucket-pipelines:latest

pipelines:
  default:
    - step:
        name: Build and Test
        script:
          - echo "Running custom build steps..."
          - ./build.sh  # 执行项目自定义构建脚本

自定义配置

若需进一步调整镜像，可基于该镜像构建新的自定义版本（示例Dockerfile）：

dockerfile
FROM your-registry/docker-bitbucket-pipelines:latest

# 添加额外工具（如Maven 3.9.0）
RUN apt-get update && apt-get install -y maven=3.9.0-1

# 配置环境变量
ENV MAVEN_OPTS="-Xmx1024m"

# 添加自定义证书
COPY ./certs/ca.crt /etc/ssl/certs/

构建新镜像：

bash
docker build -t your-registry/custom-bitbucket-pipelines:v1 .

注意事项

• 确保镜像版本与Bitbucket Pipelines的运行环境兼容，避免因基础镜像版本差异导致的兼容性问题。
• 自定义工具添加时建议精简镜像体积，避免引入不必要依赖导致构建效率下降。
• 敏感信息（如API密钥、证书）建议通过Bitbucket Pipelines的"Repository variables"配置，而非硬编码到镜像中。