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）：

mkdir -p /data/stash

4.2.2 设置目录权限

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

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 容器，映射必要端口并挂载数据卷：

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 文件，简化部署流程：

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）

启动服务：

docker-compose up -d

4.5 访问应用

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

5. 升级方法

1. 停止当前容器：

   docker stop stash
   

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

   docker rm stash
   

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

6. 备份策略

6.1 内置数据库备份

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

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。