Atlassian Bitbucket Docker 镜像文档

重要说明

注意：截至2024年2月15日，此Docker镜像同时以atlassian/bitbucket和atlassian/bitbucket-server名称发布。两个名称指向同一镜像。但2024年2月15日后，atlassian/bitbucket-server版本停止接收更新（包括现有和新标签）。如果您正在使用atlassian/bitbucket-server，请切换至atlassian/bitbucket镜像以获取最新更新和新标签。

镜像概述和主要用途

!Atlassian Bitbucket Server

Bitbucket Data Center 是一款企业级内部部署Git源代码管理解决方案，具备安全、高效的特性。可创建和管理代码库、配置细粒度权限、协作开发代码，同时保持服务器部署的灵活性。

本Docker容器旨在简化Bitbucket实例的部署和运行流程。

核心功能和特性

• 企业级源代码管理：基于Git的安全、高效内部部署解决方案
• 灵活的权限控制：支持细粒度的访问权限配置
• 代码协作工具：提供团队协作开发的完整功能
• 数据中心模式：支持集群部署，满足企业级扩展性需求
• 本地部署灵活性：可在自有服务器环境中部署，掌控数据安全

了解更多关于Bitbucket Data Center：<[***]>

使用场景和适用范围

• 企业级开发团队：需要集中管理代码库和协作流程的大型团队
• 内部部署需求：对数据隐私和服务器控制权有严格要求的组织
• 复杂权限管理：需要精细化权限控制的多团队协作场景
• 高可用性需求：通过集群部署实现业务连续性的关键业务系统
• 自管理基础设施：希望利用自有服务器资源部署代码管理平台的场景

系统要求

• Docker版本需≥20.10.10
• 建议分配至少2GiB内存（以容纳应用服务器和Git进程）
• 生产环境需使用持久化存储（本地目录或共享文件系统）

快速启动

数据卷准备

BITBUCKET_HOME目录用于存储代码库数据及其他关键信息，建议通过以下方式挂载：

• 主机目录作为数据卷
• 命名卷（推荐用于简化管理）

卷权限由入口脚本自动管理。以下示例使用命名卷：

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

启动容器

使用命名卷启动

bash
docker run -v bitbucketVolume:/var/atlassian/application-data/bitbucket \
  --name="bitbucket" \
  -d \
  -p 7990:7990 \
  -p 7999:7999 \
  atlassian/bitbucket

使用主机目录启动

bash
docker run -v /data/bitbucket:/var/atlassian/application-data/bitbucket \
  --name="bitbucket" \
  -d \
  -p 7990:7990 \
  -p 7999:7999 \
  atlassian/bitbucket

访问Bitbucket

启动成功后，Bitbucket可通过以下地址访问：
http://localhost:7990

注意：若在Mac OS X上使用docker-machine，请通过以下命令访问：
open [***] ip default):7990

注意事项

嵌入式搜索服务器

• 仅Bitbucket 10以下版本包含嵌入式搜索服务器
• 默认配置下，镜像会同时启动Bitbucket和嵌入式OpenSearch（为保持向后兼容性）
• 不推荐此配置（尤其是集群环境），存在已知的关闭问题
• 建议：运行独立的OpenSearch实例（可部署在另一个Docker容器中）

生产环境配置

• 强烈建议使用特定版本标签（而非latest）部署生产环境，latest标签频繁更新，无法保证向后兼容性
• 数据中心模式下，必须挂载共享文件系统以实现集群数据共享

高级使用

有关配置、故障排除、可支持性等高级内容，请参考完整文档。