Atlassian JIRA Docker镜像文档

镜像概述

本镜像提供了Atlassian JIRA的容器化部署方案，支持多种运行模式，包括基础部署、持久化存储、数据库集成、反向代理配置及集群部署。通过环境变量和配置文件可灵活定制JIRA实例，满足开发测试和生产环境的不同需求。

核心功能与特性

• 灵活部署：支持基础运行、持久化存储、PostgreSQL/MySQL数据库集成
• 环境定制：通过环境变量配置内存分配、时区、Java选项、代理设置等
• 备份恢复：支持从远程服务器恢复备份，自动防止重复同步
• 集群支持：通过jira.node.id配置集群节点，使用共享目录
• 远程调试：支持Tomcat远程调试端口映射
• 证书管理：可导入额外SSL证书
• Liquibase集成：支持数据库变更管理、应用链接更新、配置修改等
• 模板自定义：允许替换JIRA模板文件
• 反向代理兼容：支持jwilder/nginx-proxy实现域名访问

使用场景

• 开发/测试环境快速部署JIRA实例
• 生产环境持久化配置与高可用部署
• 集群模式部署以支持多节点扩展
• 集成现有数据库（PostgreSQL/MySQL）实现数据持久化
• 通过反向代理（如nginx-proxy）配置自定义域名访问
• 自动化备份恢复与数据库变更管理

使用方法

基础运行

docker run -d -p 8080:8080 xalt/jira

OSX用户注意：需先获取boot2docker IP：

boot2docker ip

然后通过 http://[Docker主机IP]:8080 访问

结合反向代理（nginx-proxy）

1. 首先运行nginx-proxy：

docker run -d -p 80:80 -v /var/run/docker.sock:/tmp/docker.sock:ro jwilder/nginx-proxy

2. 部署JIRA并指定域名：

docker run -d -e VIRTUAL_HOST=subdomain.domain.tld -e VIRTUAL_PORT=8080 xalt/jira

持久化存储与PostgreSQL集成

1. 启动PostgreSQL容器：

docker run --name mypgdb -p 5432:5432 \
  -e POSTGRES_USER=testpg \
  -e POSTGRES_PASSWORD=testpg \
  -e POSTGRES_DB=pgdb \
  -d xalt/postgres

2. 启动JIRA并挂载持久化目录、链接数据库：

docker run --name myjira \
  -v /data/confluence:/var/atlassian/atlassian-jira \
  --link mypgdb:pgdb \
  -d \
  -e RAM_MIN=2048 \
  -e RAM_MAX=4096 \
  -e VIRTUAL_HOST=subdomain.yourdomain.tld \
  -p 8080:8080 xalt/jira

远程调试配置

docker run -p 8080:8080 -p 5005:5005 \
  -e JIRA_REMOTE_DEBUG=true \
  -d \
  -e RAM_MIN=2048 \
  -e RAM_MAX=4096 xalt/jira

Docker Compose配置示例

jira:
  image: xalt/jira
  volumes:
    - /data/[你的目录]:/var/atlassian/jira  # 持久化存储
  links:
    - mysql:db  # 链接MySQL容器
  environment:
    - TIME_ZONE=Europe/Berlin  # 时区设置
    - VIRTUAL_HOST=[你的域名]  # nginx-proxy域名
    - VIRTUAL_PORT=8080  # 代理端口
    - RAM_MIN=2048m  # 最小内存
    - RAM_MAX=8048m  # 最大内存
    - HTTPS=true  # 启用HTTPS代理
    - PROXY_NAME=[你的域名]  # 服务器代理名
    - NEWRELIC_LICENSE=xxxxxxxxxxxxxxxxxxxxxxxx  # NewRelic许可（可选）
    - NEWRELIC_APP_NAME=[应用名]  # NewRelic应用名（可选）
    - NEWRELIC=true  # 启用NewRelic（可选）
  restart: always

mysql:
  image: mysql:5.6
  volumes:
    - /data/mysql/conf:/etc/mysql/conf.d  # MySQL配置持久化
    - /data/mysqljira:/var/lib/mysql  # MySQL数据持久化
  environment:
    - MYSQL_ROOT_PASSWORD=[强密码]  # root密码
    - MYSQL_DATABASE=jira  # 数据库名
    - MYSQL_USER=jira  # JIRA数据库用户
    - MYSQL_PASSWORD=[强密码]  # JIRA用户密码
  restart: always

容器启动配置

环境变量说明

基础配置

• TIMEZONE：容器时区设置，默认不启用。示例：TIMEZONE=Europe/Berlin（将更新/etc/localtime）

备份恢复

通过以下变量配置启动时从远程服务器恢复备份：

• BACKUP_HOST：备份服务器IP/域名。示例：BACKUP_HOST=192.168.123.123
• BACKUP_USER：备份服务器登录用户。示例：BACKUP_USER=root
• BACKUP_PATH：备份路径。示例：BACKUP_PATH=/backup/jira1
• BACKUP_KEY_FILE：SSH密钥文件路径。示例：BACKUP_KEY_FILE=/tmp/id_rsa

DONTSYNC文件：在JIRA_HOME或JIRA_HOME_SHARED目录下创建DONTSYNC文件可阻止备份恢复。恢复后会自动创建该文件。

集群配置

• JAVA_OPTS：设置JVM参数，-Djira.node.id非"false"时启用集群模式。示例：JAVA_OPTS=-Djira.node.id=node-1（此时使用JIRA_HOME_SHARED作为共享目录）

资源配置

• RAM_MIN：最小Java堆内存（MB）。示例：RAM_MIN=2048
• RAM_MAX：最大Java堆内存（MB）。示例：RAM_MAX=4096
• JIRA_REMOTE_DEBUG：启用远程调试，默认禁用。示例：JIRA_REMOTE_DEBUG=true（需映射5005端口）

网络与代理

• PROXY_NAME：代理服务器名。示例：PROXY_NAME=test2.domain.com
• HTTPS：启用HTTPS代理，设置proxyPort=443和scheme=https。示例：HTTPS=true

数据库

• DB_POOL_SIZE：数据库连接池最大连接数。示例：DB_POOL_SIZE=30

证书与插件

• IMPORTCERT：启用证书导入。示例：IMPORTCERT=true
• IMPORTPATH：证书目录路径。示例：IMPORTPATH=/var/certificates
• INSTALL_PLUGINS：启用插件自动安装，需配合INSTALL_PLUGINS_URLS_V1或INSTALL_PLUGINS_URLS_V2指定插件URL

自定义JIRA模板

配置步骤

1. 挂载自定义模板目录到容器：

volumes:
  - ./custom_templates:/var/atlassian/jira/custom_templates

2. 从容器复制需修改的模板文件（例如使用docker cp）：

docker cp [容器ID]:/opt/atlassian/jira/atlassian-jira/WEB-INF/classes/templates/plugins/footer/footer.vm ./custom_templates/

3. 编辑模板文件后，设置环境变量启用自定义：

environment:
  - CUSTOM_TEMPLATES_ENABLED=true
  - "CUSTOM_TEMPLATES_FILES=/opt/atlassian/jira/atlassian-jira/WEB-INF/classes/templates/plugins/footer/footer.vm|/opt/atlassian/jira/atlassian-jira/template/standard/text.vm"

多个文件用|分隔，需指定容器内完整路径

工作机制

容器启动时会将自定义模板复制到JIRA文件系统，并备份原文件（添加.bak及时间戳后缀）。每次重启会检查文件差异并重新应用。

Liquibase数据库变更管理

Liquibase用于管理JIRA数据库变更，通过环境变量启用和配置。

基础配置

• LIQUIBASE：启用Liquibase，默认禁用。示例：LIQUIBASE=true
• LIQUIBASE_RESET：重置Liquibase校验和，强制重新运行变更集。示例：LIQUIBASE_RESET=true
• LIQUIBASE_BASEURL：设置JIRA基础URL。示例：LIQUIBASE_BASEURL=[***]

应用链接更新

更新应用链接URL，变量格式为LIQUIBASE_APPLICATION_LINK_[ID]，值为"旧URL=新URL"。示例：

LIQUIBASE_APPLICATION_LINK_CONFLUENCE=[***]

Crowd配置更新

更新Crowd集成配置：

• LIQUIBASE_CROWD_OLD：旧Crowd URL
• LIQUIBASE_CROWD_NEW_APP_NAME：新应用名
• LIQUIBASE_CROWD_NEW_APP_PASS：新应用密码
• LIQUIBASE_CROWD_NEW_URL：新Crowd URL

横幅配置

设置JIRA横幅：

• LIQUIBASE_BANNER_CONFIG：启用横幅配置。示例：LIQUIBASE_BANNER_CONFIG=true
• LIQUIBASE_BANNER_TYPE：横幅类型（如"system"）
• LIQUIBASE_BANNER_TITLE：横幅标题
• LIQUIBASE_BANNER_TEXT：横幅内容

邮件服务器配置

• LIQUIBASE_REMOVE_MAILSERVER：移除邮件服务器配置。示例：LIQUIBASE_REMOVE_MAILSERVER=true

MiniOrange SSO配置

• LIQUIBASE_MINIORANGE_CONFIG：启用MiniOrange配置。示例：LIQUIBASE_MINIORANGE_CONFIG=true
• LIQUIBASE_MINIORANGE_CUSTOM_APP_NAME：身份提供者名称
• LIQUIBASE_MINIORANGE_CLIENT_ID：客户端ID
• LIQUIBASE_MINIORANGE_CLIENT_SECRET：客户端密钥
• LIQUIBASE_MINIORANGE_SCOPE：访问范围
• LIQUIBASE_MINIORANGE_ACCESSTOKEN_END_POINT：访问令牌端点
• LIQUIBASE_MINIORANGE_AUTHORIZE_END_POINT：授权端点
• LIQUIBASE_MINIORANGE_SINGLE_LOGOUT_URL：单点登出URL

数据库连接（默认从dbconfig.xml获取，可选自定义）

• LIQUIBASE_DB_URL：数据库URL
• LIQUIBASE_USERNAME：数据库用户名
• LIQUIBASE_PASSWORD：数据库密码
• LIQUIBASE_DRIVER：数据库驱动类

更多资源

• 相关镜像：访问 Docker Hub xalt仓库 获取其他Atlassian工具镜像
• 源代码：Bitbucket xalt仓库

开源贡献

欢迎通过Pull Request贡献代码，或发送邮件至维护者获取仓库访问权限。

技术支持

如需帮助集成镜像到基础设施或CI流程，请联系：***