Atlassian Bitbucket Server Docker镜像文档

镜像概述和主要用途

!Atlassian Bitbucket Server

Bitbucket Server 是一款本地部署的 Git 源代码管理解决方案，具备安全、高效和企业级特性。支持创建与管理代码仓库、配置细粒度权限、实现代码协作，且可灵活部署在自有服务器环境中。

本 Docker 镜像旨在简化 Bitbucket Server 的部署流程，快速搭建可用实例。

了解更多关于 Bitbucket Server 的信息：<[***]>

核心功能和特性

• 仓库管理：创建、管理 Git 仓库，支持分支策略与代码审查流程
• 权限控制：细粒度权限设置，确保代码访问安全
• 企业级协作：支持团队协作开发，集成代码评论、拉取请求等功能
• 灵活部署：通过 Docker 容器化部署，简化环境配置与维护
• 扩展性：支持作为 Smart Mirror 或 Data Center 集群节点运行，满足大规模部署需求
• 监控支持：集成 JMX 监控，便于性能数据采集与分析

使用场景和适用范围

• 企业内部代码管理：需本地部署、数据私有化的组织
• 团队协作开发：中小型开发团队的代码版本控制与协作平台
• 安全合规需求：对代码存储位置、访问审计有严格要求的场景
• 大规模部署：通过 Data Center 模式支持集群部署，满足高可用性与性能需求

使用方法和配置说明

系统要求

• 建议分配至少 2GiB 内存，以满足应用服务器和 Git 进程运行需求
• 支持的 Docker 版本：1.9+（推荐使用命名卷时）

快速启动

BITBUCKET_HOME 目录用于存储仓库数据等持久化信息，推荐通过数据卷（Docker 1.9+ 推荐命名卷）挂载主机目录，确保数据持久化。卷权限由入口脚本自动管理。

使用命名卷启动

# 创建命名卷
$> docker volume create --name bitbucketVolume

# 启动容器
$> docker run -v bitbucketVolume:/var/atlassian/application-data/bitbucket \
              --name="bitbucket" \
              -d \
              -p 7990:7990 \
              -p 7999:7999 \
              atlassian/bitbucket-server

使用主机目录启动

# 启动容器（主机目录 /data/bitbucket 作为数据卷）
$> docker run -v /data/bitbucket:/var/atlassian/application-data/bitbucket \
              --name="bitbucket" \
              -d \
              -p 7990:7990 \
              -p 7999:7999 \
              atlassian/bitbucket-server

成功启动后，Bitbucket 可通过 http://localhost:7990 访问。

注意：若在 Mac OS X 中使用 docker-machine，需通过 open [***] ip default):7990 访问。

反向代理设置

当 Bitbucket 部署在反向代理服务器后方时（参考 官方文档），需通过环境变量配置反向代理参数，使 Bitbucket 感知代理环境。

Bitbucket Server 5.0+（推荐）

由于 5.0 版本迁移至 Spring Boot，反向代理配置方式变更。推荐通过环境变量文件或 -e 参数传递配置。

示例：使用环境变量文件

创建 secure-bitbucket.env 文件：

SERVER_SECURE=true          # 是否启用 HTTPS（true/false）
SERVER_SCHEME=https         # 访问协议（http/https）
SERVER_PROXY_PORT=443       # 反向代理端口
SERVER_PROXY_NAME=bitbucket.example.com  # 反向代理域名

启动容器：

$> docker run -v bitbucketVolume:/var/atlassian/application-data/bitbucket \
              --name="bitbucket" \
              -d \
              -p 7990:7990 \
              -p 7999:7999 \
              --env-file=/path/to/secure-bitbucket.env \
              atlassian/bitbucket-server:5.0

Bitbucket Server < 5.0

通过 docker run 的 -e 参数指定以下环境变量：

示例：

$> docker run -v /data/bitbucket:/var/atlassian/application-data/bitbucket \
              --name="bitbucket" \
              -d \
              -p 7990:7990 \
              -p 7999:7999 \
              -e CATALINA_CONNECTOR_PROXYNAME=bitbucket.example.com \
              -e CATALINA_CONNECTOR_PROXYPORT=443 \
              -e CATALINA_CONNECTOR_SCHEME=https \
              -e CATALINA_CONNECTOR_SECURE=true \
              atlassian/bitbucket-server:4.14

JVM 配置（仅 Bitbucket Server 5.0+）

通过环境变量覆盖默认 JVM 内存配置或传递额外参数：

示例：

$> docker run -v bitbucketVolume:/var/atlassian/application-data/bitbucket \
              --name="bitbucket" \
              -d \
              -p 7990:7990 \
              -p 7999:7999 \
              -e JVM_MINIMUM_MEMORY=2g \
              -e JVM_MAXIMUM_MEMORY=4g \
              -e JVM_SUPPORT_RECOMMENDED_ARGS="-Djavax.net.ssl.trustStore=/var/atlassian/application-data/bitbucket/truststore.jks" \
              atlassian/bitbucket-server

应用模式设置（仅 Bitbucket Server 5.0+）

支持以 Smart Mirror 或 Data Center 集群模式运行，通过以下环境变量配置：

Data Center 集群示例

1. 创建自定义 Docker 网络：

$> docker network create --driver bridge --subnet=172.18.0.0/16 myBitbucketNetwork

2. 启动集群节点（TCPIP 模式）：

$> docker run --network=myBitbucketNetwork \
              --ip=172.18.1.1 \
              -e ELASTICSEARCH_ENABLED=false \
              -e HAZELCAST_NETWORK_TCPIP=true \
              -e HAZELCAST_NETWORK_TCPIP_MEMBERS=172.18.1.1:5701,172.18.1.2:5701 \
              -e HAZELCAST_GROUP_NAME=bitbucket-cluster \
              -e HAZELCAST_GROUP_PASSWORD=cluster-pass \
              -v /data/bitbucket-shared:/var/atlassian/application-data/bitbucket/shared \
              --name="bitbucket-node1" \
              -d \
              -p 7990:7990 \
              -p 7999:7999 \
              atlassian/bitbucket-server

JMX 监控配置（仅 Bitbucket Server 5.0+）

通过以下环境变量启用并配置 JMX 监控（参考 官方文档）：

示例：

$> docker run -v /data/bitbucket:/var/atlassian/application-data/bitbucket \
              --name="bitbucket" \
              -d \
              -p 7990:7990 \
              -p 7999:7999 \
              -p 3333:3333 \
              -e JMX_ENABLED=true \
              -e JMX_REMOTE_AUTH=password \
              -e JMX_REMOTE_PORT=3333 \
              -e JMX_REMOTE_RMI_PORT=3333 \
              -e RMI_SERVER_HOSTNAME=bitbucket.example.com \
              -e JMX_PASSWORD_FILE=/var/atlassian/application-data/bitbucket/jmx.password \
              atlassian/bitbucket-server

升级方法

1. 停止并删除当前容器：

$> docker stop bitbucket
$> docker rm bitbucket

2. 拉取目标版本镜像：

$> docker pull atlassian/bitbucket-server:<目标版本>  # 如 7.21.0

3. 使用原数据卷启动新容器（数据自动保留）：

$> docker run -v bitbucketVolume:/var/atlassian/application-data/bitbucket \
              --name="bitbucket" \
              -d \
              -p 7990:7990 \
              -p 7999:7999 \
              atlassian/bitbucket-server:<目标版本>

注意：升级时不要使用 -v 选项删除容器卷，以免丢失数据。

备份策略

• 内置数据库：直接备份挂载的 BITBUCKET_HOME 目录（如 /data/bitbucket）。
• 外部数据库：参考 Bitbucket Server DIY Backup 方案。

更多备份详情见 官方文档。

版本控制

• latest 标签：对应最新版本（不推荐生产环境使用）。
• 推荐使用特定版本标签（如 atlassian/bitbucket-server:7.21），避免破坏性更新影响环境。版本标签格式为 主版本.次版本（如 7.21 会自动更新至最新 7.21.x 版本）。

问题反馈

如遇镜像相关问题，请提交 issue。

技术支持

产品支持请访问 support.atlassian.com。