epicmorg/confluence

Atlassian Confluence Server Docker镜像文档

!Atlassian Confluence Server

1. 镜像概述和主要用途

Atlassian Confluence Server是一款团队协作平台，用于创建、组织和讨论工作内容。该Docker镜像旨在简化Confluence Server的部署流程，帮助用户快速搭建实例，集中管理团队知识，避免信息分散在邮件或共享驱动器中，提升协作效率。

官方产品详情：[***]
Dockerfile仓库：https://hub.docker.com/r/epicmorg/confluence

2. 核心功能和特性

• 知识集中管理：捕获并存储团队知识，便于查找、使用和更新。
• 空间隔离：支持为每个团队、项目或部门创建独立空间，定制专属内容结构。
• 多样化内容创建：支持编写会议记录、产品需求、文件列表、项目计划等多种内容。
• 灵活部署：通过Docker容器化部署，简化环境配置，支持数据卷挂载持久化存储。
• 可配置性能：支持自定义JVM内存分配、反向代理设置及额外JVM参数。
• 备份与升级：支持数据备份策略，可无缝升级至新版本。

3. 使用场景和适用范围

• 团队协作：适用于中小型团队集中管理文档和讨论。
• 项目管理：用于跟踪项目计划、需求文档和进度汇报。
• 知识共享：作为企业知识库，存储和传递重要信息。
• 部门协作：支持不同部门独立管理内容，同时保持平台统一性。
• 评估环境：快速搭建Confluence评估实例，测试功能特性。

4. 使用方法和配置说明

4.1 快速启动

Confluence数据（如配置、内容等）存储在CONFLUENCE_HOME目录，建议通过数据卷挂载主机目录以持久化数据。

启动命令：

bash
docker run -v /data/your-confluence-home:/var/atlassian/application-data/confluence \
  --name="confluence" -d -p 8090:8090 -p 8091:8091 epicmorg/confluence

访问方式：

启动成功后，通过 http://localhost:8090 访问Confluence。

注意：若使用Mac OS X的docker-machine，需通过 open http://$(docker-machine ip default):8090 访问。

资源要求：

建议为容器分配至少2GiB内存以满足应用服务器运行需求。详情参考Atlassian支持平台。

4.2 内存/堆大小配置

可通过环境变量自定义JVM堆内存分配：

示例（设置最小2GiB，最大4GiB）：

bash
docker run -e JVM_MINIMUM_MEMORY=2048m -e JVM_MAXIMUM_MEMORY=4096m \
  -v /data/your-confluence-home:/var/atlassian/application-data/confluence \
  --name="confluence" -d -p 8090:8090 -p 8091:8091 epicmorg/confluence

4.3 反向代理设置

若Confluence部署在反向代理服务器后方，需通过以下环境变量配置代理信息：

示例（HTTPS反向代理）：

bash
docker run -e CATALINA_CONNECTOR_PROXYNAME=confluence.example.com \
  -e CATALINA_CONNECTOR_PROXYPORT=443 \
  -e CATALINA_CONNECTOR_SCHEME=https \
  -e CATALINA_CONNECTOR_SECURE=true \
  -v /data/your-confluence-home:/var/atlassian/application-data/confluence \
  --name="confluence" -d -p 8090:8090 -p 8091:8091 epicmorg/confluence

4.4 JVM额外配置

通过JVM_SUPPORT_RECOMMENDED_ARGS环境变量传递额外JVM参数（如自定义信任库）。

示例（指定信任库）：

bash
docker run -e JVM_SUPPORT_RECOMMENDED_ARGS="-Djavax.net.ssl.trustStore=/var/atlassian/application-data/confluence/cacerts" \
  -v /data/your-confluence-home:/var/atlassian/application-data/confluence \
  --name="confluence" -d -p 8090:8090 -p 8091:8091 epicmorg/confluence

4.5 升级

升级Confluence至新版本需停止旧容器，使用新版本镜像启动（数据卷保留）：

bash
# 停止并删除旧容器
docker stop confluence
docker rm confluence

# 使用新版本镜像启动（参数与初次启动一致）
docker run -v /data/your-confluence-home:/var/atlassian/application-data/confluence \
  --name="confluence" -d -p 8090:8090 -p 8091:8091 epicmorg/confluence:latest

警告：升级时请勿使用-v选项删除容器及数据卷，以免丢失数据。

4.6 备份

评估环境备份：

若使用内置数据库，直接归档挂载的主机目录（如/data/your-confluence-home）即可。

生产环境备份：

• 支持Confluence自动备份功能。
• 若使用外部数据库，建议采用生产备份策略。

详情参考站点备份与恢复。

5. 版本控制

5.1 标签说明

• epicmorg/confluence:latest：对应最新稳定版Confluence Server。
• epicmorg/confluence:<版本号>：指定具体版本（如5.10.8），安装对应版本。

5.2 可用版本

• latest
• 5.6.4
• 5.10.8

6. 已知问题

在Mac OS X（Docker 1.11.0版本，配合docker-machine）中，CONFLUENCE_HOME挂载目录可能出现权限错误，导致启动失败：

Error writing state to confluence.cfg.xml
com.atlassian.config.ConfigurationException: Couldn't save confluence.cfg.xml to /var/atlassian/confluence-home directory.

详情参考https://github.com/docker/docker/issues/4023%E3%80%82
解决方法：暂不使用Mac OS X，待Docker新版本修复该问题。

7. 支持信息

本镜像适用于Confluence评估场景。由于许可限制，镜像使用OpenJDK，不支持生产环境。

生产环境需基于https://github.com/oracle/docker-images/tree/master/OracleJDK%E6%9E%84%E5%BB%BA%E8%87%AA%E5%AE%9A%E4%B9%89%E9%95%9C%E5%83%8F%EF%BC%8C%E8%AF%A6%E6%83%85%E5%8F%82%E8%80%83%E6%9B%B4%E6%96%B0Confluence Docker镜像至Oracle JDK。

产品支持：support.atlassian.com。