xalt/bitbucket

Atlassian Stash Docker镜像文档

1. 镜像概述

Atlassian Stash 是一款本地部署的 Git 源代码管理解决方案，具备安全、高效和企业级特性。该解决方案允许用户创建和管理 Git 仓库、配置细粒度权限，并支持团队协作开发，所有操作均基于自有服务器环境，提供数据管理的灵活性。

主要用途：为企业或团队提供本地化的 Git 代码仓库管理平台，支持版本控制、权限管理和协作开发流程。

2. 核心功能与特性

• 企业级 Git 仓库管理：支持创建、克隆、分支和合并 Git 仓库，满足大规模代码库管理需求。
• 细粒度权限控制：可针对仓库、分支或特定操作设置精细化访问权限，确保代码安全。
• 本地部署架构：数据存储在用户自有服务器，保障数据隐私与自主可控。
• 高性能操作：优化 Git 操作处理流程，支持高效的代码拉取、推送和合并操作。
• 协作开发支持：集成代码审查、提交历史追踪和团队协作工具，提升开发效率。

3. 使用场景与适用范围

适用场景

• 企业或团队内部 Git 源代码管理系统的功能评估与测试。
• 开发环境中临时搭建的代码仓库服务。

适用范围

仅用于评估和测试环境，Atlassian 明确不支持将此 Docker 镜像用于生产环境部署。

4. 使用方法与配置说明

4.1 环境准备

• 确保 Docker 环境已安装并正常运行。
• 宿主机需分配至少 2GiB 内存，以满足应用服务器和 Git 进程的资源需求。

4.2 数据卷配置与权限设置

Stash 数据（含仓库文件、配置信息等）需持久化存储，推荐通过宿主机目录挂载为数据卷。

4.2.1 创建数据目录

在宿主机创建数据存储目录（示例：/data/stash）：

bash
mkdir -p /data/stash

4.2.2 设置目录权限

Stash 容器内使用 daemon 用户运行，需确保宿主机数据目录可被该用户写入：

bash
docker run -u root -v /data/stash:/var/atlassian/application-data/stash atlassian/stash chown -R daemon /var/atlassian/application-data/stash

4.3 启动容器（docker run 命令）

通过以下命令启动 Stash 容器，映射必要端口并挂载数据卷：

bash
docker run -v /data/stash:/var/atlassian/application-data/stash \
  --name="stash" \
  -d \
  -p 7990:7990 \  # Web 访问端口
  -p 7999:7999 \  # SSH 访问端口（Git 操作）
  atlassian/stash

4.4 Docker Compose 配置示例

创建 docker-compose.yml 文件，简化部署流程：

yaml
version: '3'
services:
  stash:
    image: atlassian/stash
    container_name: stash
    restart: always
    ports:
      - "7990:7990"
      - "7999:7999"
    volumes:
      - /data/stash:/var/atlassian/application-data/stash
    environment:
      # 目前无额外环境变量需求，主要通过数据卷和端口配置
    mem_limit: 2g  # 限制内存使用（推荐 2GiB）

启动服务：

bash
docker-compose up -d

4.5 访问应用

• 本地访问：容器启动后，通过 http://localhost:7990 访问 Stash 界面。
• boot2docker 用户（Mac OS X）：使用 open http://$(boot2docker ip):7990 访问。

5. 升级方法

1. 停止当前容器：

   bash
   docker stop stash
   

2. 删除容器（数据卷数据不会丢失）：

   bash
   docker rm stash
   

3. 使用新版本镜像启动： 执行 4.3 节或 4.4 节的启动命令，确保数据卷挂载路径不变。

6. 备份策略

6.1 内置数据库备份

若使用 Stash 内置数据库，直接备份宿主机数据卷目录即可：

bash
tar -czf stash_backup_$(date +%Y%m%d).tar.gz /data/stash

6.2 外部数据库备份

若使用外部数据库（如 MySQL、PostgreSQL），需采用 Stash DIY Backup 方案，具体步骤参考 官方文档。
注意：Stash Backup Client 工具不支持 Docker 环境。

7. 版本管理

• latest 标签：对应最新发布的 Stash 版本。
• 特定版本标签：如 atlassian/stash:3.5，对应 3.5.x 系列的最新补丁版本。

8. 注意事项

• 资源要求：宿主机需分配至少 2GiB 内存，否则可能导致性能问题。
• 生产环境限制：Atlassian 不提供 Docker 镜像的生产环境支持，仅用于评估。
• 数据卷保护：删除容器时禁止使用 -v 选项，避免误删数据卷。
• 权限检查：启动前务必完成数据目录权限配置（4.2.2 节），否则可能导致数据写入失败。

9. 问题跟踪

如遇镜像使用问题，可在 Bitbucket 仓库 提交 issue。