moveworkforward/atlas-run-standalone

Atlassian独立产品Docker镜像文档

镜像概述

本Docker镜像提供Atlassian系列产品的独立运行环境，基于官方产品发行版构建，通过容器化设计简化Jira（项目管理）、Confluence（知识库）、Bitbucket（代码管理）等工具的部署流程。镜像无需复杂外部依赖协调，支持一键启动，适用于需要快速搭建团队协作平台的场景，降低企业级协作工具的部署门槛。

核心功能与特性

• 多产品支持：兼容Jira Software、Jira Service Management、Confluence、Bitbucket等主流Atlassian产品
• 独立运行架构：容器内置基础运行环境，无需外部复杂依赖（如独立应用服务器）
• 简化部署流程：通过环境变量配置核心参数，省去手动安装与配置步骤
• 数据持久化：支持挂载数据卷保存应用配置、用户数据及产品日志，避免容器重启数据丢失
• 可扩展性配置：支持自定义JVM参数（内存分配、性能调优）及网络端口映射
• 版本兼容性：基于Atlassian官方稳定版构建，确保产品功能完整性与安全性

使用场景与适用范围

• 中小企业协作平台搭建：快速部署完整的团队协作工具链（项目管理+知识库+代码管理）
• 开发/测试环境：临时部署用于功能验证、版本测试或演示环境搭建
• 私有化部署需求：满足企业数据本地化存储要求，避免依赖第三方SaaS服务
• 轻量级团队协作：小团队或部门级协作场景，无需复杂集群架构

使用方法与配置说明

前置条件

• Docker Engine 19.03+ 或 Docker Desktop 2.0+
• 目标产品所需外部数据库（如PostgreSQL、MySQL，具体版本参考Atlassian官方文档）
• 宿主机至少2GB内存（推荐4GB+，根据产品类型调整）

快速启动示例（以Jira Software为例）

1. 基础启动命令

bash
docker run -d \
  --name atlassian-jira \
  -p 8080:8080 \  # 宿主机端口:容器内端口（默认8080）
  -v jira-data:/var/atlassian/application-data/jira \  # 数据持久化卷
  -e ATL_PRODUCT=jira-software \  # 指定产品类型（jira-software/jira-service-management/confluence/bitbucket）
  -e ATL_DB_TYPE=postgresql \  # 数据库类型（postgresql/mysql）
  -e ATL_DB_HOST=192.168.1.100 \  # 数据库主机地址
  -e ATL_DB_PORT=5432 \  # 数据库端口
  -e ATL_DB_NAME=jira_db \  # 数据库名称
  -e ATL_DB_USER=jira_admin \  # 数据库用户名
  -e ATL_DB_PASSWORD=SecurePass123 \  # 数据库密码
  atlassian/standalone-products:latest

2. Docker Compose配置示例（含数据库）

yaml
version: '3.8'

services:
  atlassian-app:
    image: atlassian/standalone-products:latest
    container_name: atlassian-confluence
    restart: always
    ports:
      - "8090:8090"  # Confluence默认端口为8090
    volumes:
      - confluence-data:/var/atlassian/application-data/confluence
    environment:
      - ATL_PRODUCT=confluence
      - ATL_DB_TYPE=mysql
      - ATL_DB_HOST=db
      - ATL_DB_PORT=3306
      - ATL_DB_NAME=confluence_db
      - ATL_DB_USER=confluence_admin
      - ATL_DB_PASSWORD=SecurePass456
      - JVM_MINIMUM_MEMORY=1g  # JVM初始内存
      - JVM_MAXIMUM_MEMORY=2g  # JVM最大内存
    depends_on:
      - db

  db:
    image: postgres:13  # 以PostgreSQL为例（版本需符合Atlassian产品要求）
    container_name: atlassian-db
    restart: always
    environment:
      - POSTGRES_DB=confluence_db
      - POSTGRES_USER=confluence_admin
      - POSTGRES_PASSWORD=SecurePass456
    volumes:
      - db-data:/var/lib/postgresql/data

volumes:
  confluence-data:
  db-data:

核心配置参数（环境变量）

数据持久化与备份

• 数据卷挂载：核心数据目录为/var/atlassian/application-data/<product>（如Jira对应/var/atlassian/application-data/jira），需通过-v参数挂载宿主机目录或命名卷实现持久化
• 备份建议：定期备份挂载的数据卷目录，或通过docker exec执行产品内置备份命令（如Confluence的confluence backup）

访问与初始化

1. 容器启动后，通过宿主机IP+映射端口访问（如http://localhost:8080）
2. 根据产品引导页面完成初始化配置（如许可证输入、管理员账户创建、组织信息设置）
3. 初始化完成后即可正常使用产品功能

注意事项

• 数据库兼容性：需确保外部数据库版本符合Atlassian官方兼容性矩阵（如Jira 9.x要求PostgreSQL 12+）
• 资源分配：避免容器内存/CPU资源不足导致产品运行异常，建议根据用户规模调整JVM参数
• 安全配置：生产环境需配置HTTPS（可通过反向代理如Nginx实现），并限制数据库访问权限
• 版本更新：升级镜像前需备份数据卷，确保新版本与当前数据schema兼容

更多详细配置与故障排查，请参考Atlassian官方产品文档及Docker镜像维护说明。