Atlassian软件容器镜像文档

镜像概述

本镜像为Atlassian系列软件提供容器化部署解决方案，集成了Jira（项目管理）、Confluence（协同文档）、Bitbucket（代码仓库）、Crowd（用户管理）、Bamboo（CI/CD）等多款Atlassian核心产品。通过容器化封装，简化了传统部署流程中的环境配置复杂度，支持快速启动、灵活扩展与统一管理，适用于开发团队、企业IT部门及各类需要高效协作工具的组织。

核心功能与特性

1. 多产品集成支持

• 覆盖Atlassian主流协作工具：Jira Software（项目管理）、Confluence（知识库）、Bitbucket Server（代码托管）、Crowd（身份认证）、Bamboo（持续集成/部署）。
• 支持各产品独立部署或组合使用，满足不同场景需求。

2. 简化部署流程

• 容器化封装消除了传统部署中对操作系统依赖、库文件冲突等问题，一键启动即可完成基础环境配置。
• 内置初始化脚本，自动完成产品基础配置，减少手动操作步骤。

3. 数据持久化与可靠性

• 支持通过Docker数据卷（Volume）挂载产品数据目录，确保配置、用户数据、附件等关键信息持久化存储，避免容器重启导致数据丢失。
• 兼容主流外部数据库（MySQL、PostgreSQL等），支持数据分离部署，提升可靠性。

4. 灵活配置能力

• 通过环境变量自定义产品参数（如端口、数据库连接、管理员账户等）。
• 支持外部配置文件挂载，满足高级定制需求（如反向代理配置、SSL证书集成等）。

5. 版本兼容性管理

• 镜像标签与Atlassian产品版本对应，支持指定产品版本部署（如:jira-9.14.0、:confluence-8.5.0），便于版本控制与升级规划。

使用场景与适用范围

1. 开发团队协作工具部署

• 快速搭建团队内部协作平台，集成项目管理（Jira）、代码托管（Bitbucket）、文档协作（Confluence）流程。

2. 企业级协作系统搭建

• 为中大型企业提供一站式协作解决方案，支持多团队、多项目并行管理，通过Crowd实现统一身份认证。

3. CI/CD流程集成

• 结合Bitbucket（代码仓库）与Bamboo（CI/CD工具），构建自动化开发流水线，提升研发效率。

4. 临时测试环境

• 快速启动独立的Atlassian产品实例，用于功能测试、版本升级验证或培训环境搭建。

使用方法与配置说明

基本部署（Docker Run）

示例1：部署Jira Software

bash
docker run -d \
  --name jira-software \
  -p 8080:8080 \
  -v jira-data:/var/atlassian/application-data/jira \
  -e "JIRA_DB_TYPE=postgresql" \
  -e "JIRA_DB_HOST=db-host" \
  -e "JIRA_DB_PORT=5432" \
  -e "JIRA_DB_NAME=jira_db" \
  -e "JIRA_DB_USER=jira_user" \
  -e "JIRA_DB_PASSWORD=secure-password" \
  atlassian/software:jira-9.14.0

示例2：部署Confluence

bash
docker run -d \
  --name confluence \
  -p 8090:8090 \
  -p 8091:8091 \  # Synchrony端口（实时协作功能）
  -v confluence-data:/var/atlassian/application-data/confluence \
  -e "CONFLUENCE_DB_TYPE=mysql" \
  -e "CONFLUENCE_DB_HOST=db-host" \
  -e "CONFLUENCE_DB_PORT=3306" \
  -e "CONFLUENCE_DB_NAME=confluence_db" \
  -e "CONFLUENCE_DB_USER=confluence_user" \
  -e "CONFLUENCE_DB_PASSWORD=secure-password" \
  atlassian/software:confluence-8.5.0

Docker Compose部署示例

以下为集成Jira、Confluence与PostgreSQL数据库的docker-compose.yml示例：

yaml
version: '3.8'

services:
  postgres:
    image: postgres:14
    environment:
      POSTGRES_USER: atlassian
      POSTGRES_PASSWORD: secure-db-password
      POSTGRES_MULTIPLE_DATABASES: jira_db,confluence_db
    volumes:
      - postgres-data:/var/lib/postgresql/data
    restart: always

  jira:
    image: atlassian/software:jira-9.14.0
    depends_on:
      - postgres
    ports:
      - "8080:8080"
    environment:
      JIRA_DB_TYPE: postgresql
      JIRA_DB_HOST: postgres
      JIRA_DB_PORT: 5432
      JIRA_DB_NAME: jira_db
      JIRA_DB_USER: atlassian
      JIRA_DB_PASSWORD: secure-db-password
      JIRA_ADMIN_*** ***
      JIRA_ADMIN_PASSWORD: admin-password
    volumes:
      - jira-data:/var/atlassian/application-data/jira
    restart: always

  confluence:
    image: atlassian/software:confluence-8.5.0
    depends_on:
      - postgres
    ports:
      - "8090:8090"
      - "8091:8091"
    environment:
      CONFLUENCE_DB_TYPE: postgresql
      CONFLUENCE_DB_HOST: postgres
      CONFLUENCE_DB_PORT: 5432
      CONFLUENCE_DB_NAME: confluence_db
      CONFLUENCE_DB_USER: atlassian
      CONFLUENCE_DB_PASSWORD: secure-db-password
    volumes:
      - confluence-data:/var/atlassian/application-data/confluence
    restart: always

volumes:
  postgres-data:
  jira-data:
  confluence-data:

配置参数说明

1. 核心环境变量

2. 持久化存储路径

各产品数据目录需通过卷挂载持久化，路径如下：

• Jira：/var/atlassian/application-data/jira
• Confluence：/var/atlassian/application-data/confluence
• Bitbucket：/var/atlassian/application-data/bitbucket
• Crowd：/var/atlassian/application-data/crowd
• Bamboo：/var/atlassian/application-data/bamboo

3. 高级配置

• 外部配置文件挂载：将自定义server.xml（Tomcat配置）、atlassian-jira-config.properties等文件挂载至产品配置目录（如/opt/atlassian/jira/conf/）。
• SSL集成：通过挂载SSL证书至容器，并配置环境变量SSL_ENABLED=true、SSL_CERT_PATH、SSL_KEY_PATH启用HTTPS。
• 反向代理配置：设置环境变量PROXY_NAME（域名）、PROXY_PORT（代理端口）、PROXY_SCHEME（http/https），适配反向代理场景。

注意事项

• 镜像运行需满足Atlassian产品系统要求（如内存≥4GB，推荐8GB+）。
• 首次启动时需完成产品初始化配置（如许可证输入、数据库连接验证），可通过容器日志（docker logs <容器名>）查看进度。
• 生产环境建议使用外部数据库（而非容器内数据库），并定期备份数据卷。