Bitbucket Mesh Docker 镜像文档

!Atlassian Bitbucket Mesh

镜像概述与主要用途

Bitbucket Data Center 是一款企业级本地部署的 Git 源码管理解决方案，具备安全、高效及可扩展性，支持仓库创建与管理、细粒度权限控制及代码协作。Bitbucket Mesh 是 Bitbucket Data Center 的可选扩展性扩展组件，用于提升系统的性能与扩展性。

本 Docker 镜像（atlassian/bitbucket-mesh）旨在简化 Bitbucket Data Center 环境中 Mesh 节点的部署与运行。该镜像仅能配合 Bitbucket Data Center 服务器使用，无法独立运行。

重要注意事项

• 生产环境建议：生产环境中强烈建议使用特定版本标签（如 atlassian/bitbucket-mesh:8.10.0）拉取镜像，而非 latest 标签。latest 标签指向的镜像频繁更新，无法保证向后兼容性。
• Docker 版本要求：需使用 Docker 20.10.10 及以上版本。

核心功能与特性

• 扩展性扩展：作为 Bitbucket Data Center 的扩展组件，提升系统在大规模代码协作场景下的并发处理能力与稳定性。
• 无缝集成：与 Bitbucket Data Center 服务器深度集成，支持仓库数据的高效同步与管理。
• 数据持久化：通过 Docker 卷挂载支持 MESH_HOME 目录的数据持久化，确保仓库数据、配置等关键信息不丢失。
• 容器化部署：简化 Mesh 节点的部署流程，降低环境配置复杂度，适合容器化管理策略。

使用场景与适用范围

• 企业级 Bitbucket Data Center 部署：适用于已部署 Bitbucket Data Center 的企业，需扩展系统处理能力以支持更多用户、更大规模代码库或更高并发操作。
• 高性能协作需求：在团队规模扩大、代码仓库数量激增或并行操作频繁的场景下，通过 Mesh 节点分担负载，提升系统响应速度。
• 容器化架构适配：适合采用 Docker 容器化部署策略的企业，便于 Mesh 节点的标准化部署、升级与运维。

使用方法与配置说明

快速启动

前提条件

• 已安装 Docker 20.10.10 及以上版本。
• 为 MESH_HOME 目录（用于存储仓库数据、日志等）准备持久化存储（推荐使用 Docker 命名卷或主机目录挂载）。

步骤

1. 创建命名卷（推荐用于数据持久化，卷权限由容器入口脚本自动管理）：

   bash
   docker volume create --name bitbucketMeshVolume
   

2. 启动 Mesh 容器：

   bash
   docker run -v bitbucketMeshVolume:/var/atlassian/application-data/mesh \
     --name="bitbucket-mesh" \
     -d \
     -p 7777:7777 \
     atlassian/bitbucket-mesh
   

参数说明

• -v bitbucketMeshVolume:/var/atlassian/application-data/mesh：将命名卷 bitbucketMeshVolume 挂载到容器内的 MESH_HOME 目录（/var/atlassian/application-data/mesh），用于持久化数据。
• --name="bitbucket-mesh"：指定容器名称为 bitbucket-mesh，便于后续管理（如启动、停止、查看日志等）。
• -d：以守护进程模式运行容器（后台运行）。
• -p 7777:7777：将容器内 Mesh 服务默认端口（7777）映射到主机端口 7777，确保外部可访问。
• atlassian/bitbucket-mesh：Docker 镜像名称（生产环境建议替换为具体版本标签，如 atlassian/bitbucket-mesh:8.10.0）。

资源配置建议

• 内存：建议为容器分配至少 2GiB 内存，以满足应用服务器及 Git 进程的运行需求。具体资源需求可参考 Bitbucket 支持平台文档。

高级用法

对于高级配置（如自定义 JVM 参数、网络配置、日志管理、故障排查等），请参考 Bitbucket Mesh 完整文档。

如需部署 Bitbucket Data Center 与 Mesh 节点的完整集群方案，参见 Bitbucket ***文档。