epicmorg/jira

!Atlassian JIRA

JIRA Software是敏捷团队使用的软件开发项目管理工具。

了解更多关于JIRA Software：<[***]>

概述

该Docker镜像旨在简化Atlassian JIRA Software的部署和运行流程，帮助用户快速搭建可用的JIRA实例，适用于敏捷团队进行软件开发项目的跟踪、管理和协作。

快速启动

JIRA_HOME目录用于存储应用数据等信息，推荐将主机目录挂载为数据卷，或在Docker版本≥1.9时使用命名卷。以下示例使用命名卷：

$> docker volume create --name jiraVolume
$> docker run -v jiraVolume:/var/atlassian/application-data/jira --name="jira" -d -p 8080:8080 epicmorg/jira

部署成功。JIRA现已可通过http://localhost:8080访问*

请确保容器已分配足够资源，推荐至少2GiB内存以满足应用服务器运行需求。详见系统要求。

* 注意：若在Mac OS X上使用docker-machine，请改用open http://$(docker-machine ip default):8080访问。

内存/堆大小

如需覆盖JIRA默认内存分配，可通过以下环境变量控制JVM最小堆（Xms）和最大堆（Xmx）：

• JVM_MINIMUM_MEMORY（默认：384m）
  JVM的最小堆大小

• JVM_MAXIMUM_MEMORY（默认：768m）
  JVM的最大堆大小

反向代理配置

若JIRA部署在反向代理服务器后（如此处描述），需通过以下环境变量配置，使JIRA感知代理设置：

• CATALINA_CONNECTOR_PROXYNAME（默认：NONE）
  反向代理的完全限定域名

• CATALINA_CONNECTOR_PROXYPORT（默认：NONE）
  访问JIRA所用的反向代理端口

• CATALINA_CONNECTOR_SCHEME（默认：http）
  访问JIRA所用的协议（http/https）

• CATALINA_CONNECTOR_SECURE（默认：false）
  当CATALINA_CONNECTOR_SCHEME为https时，设为true

JVM配置

如需传递额外JVM参数（如指定自定义信任存储），可通过以下环境变量实现：

• JVM_SUPPORT_RECOMMENDED_ARGS
  JIRA的额外JVM参数

示例： $> docker run -e JVM_SUPPORT_RECOMMENDED_ARGS=-Djavax.net.ssl.trustStore=/var/atlassian/application-data/jira/cacerts -v jiraVolume:/var/atlassian/application-data/jira --name="jira" -d -p 8080:8080 epicmorg/jira

Data Center集群配置

该镜像可作为Data Center集群的节点运行。通过以下参数可将JIRA启动为Data Center节点，无需手动配置cluster.properties文件。详见安装Jira Data Center了解各参数说明：

• CLUSTERED（默认：false）
  设为true启用集群配置，容器将在$JIRA_HOME目录下生成cluster.properties文件

• JIRA_NODE_ID（默认：jira_node_）
  节点唯一ID，默认包含Docker容器ID的前8位，可自定义覆盖

• JIRA_SHARED_HOME（默认：$JIRA_HOME/shared）
  所有Jira节点共享的主目录路径

• EHCACHE_PEER_DISCOVERY（默认：default）
  节点发现方式描述

• EHCACHE_LISTENER_HOSTNAME（默认：NONE）
  当前节点的缓存通信主机名，未设置时Jira Data Center将自动解析

• EHCACHE_LISTENER_PORT（默认：40001）
  节点监听端口

• EHCACHE_LISTENER_SOCKETTIMEOUTMILLIS（默认：2000）
  Ehcache监听器默认超时时间（毫秒）

• EHCACHE_MULTICAST_ADDRESS（默认：NONE）
  有效的多播组地址，当EHCACHE_PEER_DISCOVERY设为automatic时必填

• EHCACHE_MULTICAST_PORT（默认：NONE）
  多播心跳流量专用端口，当EHCACHE_PEER_DISCOVERY设为automatic时必填

• EHCACHE_MULTICAST_TIMETOLIVE（默认：NONE）
  多播包传播范围（0-255），当EHCACHE_PEER_DISCOVERY设为automatic时必填

• EHCACHE_MULTICAST_HOSTNAME（默认：NONE）
  发送/接收多播包的接口主机名或IP，当EHCACHE_PEER_DISCOVERY设为automatic时必填

升级

如需升级至JIRA新版本，只需停止当前jira容器并基于新版本镜像启动新容器：

$> docker stop jira
$> docker rm jira
$> docker run ...（参见上文启动命令）

由于数据存储在主机的数据卷目录中，升级后数据仍可访问。

注意：请勿使用-v选项意外删除jira容器及其卷。

备份

评估环境中，可使用内置数据库（文件存储于JIRA主目录），此时备份Docker卷即可。
若使用外部数据库，可配置JIRA每晚自动备份（包含数据库状态）至jiraVolume卷，或单独备份数据库并归档Docker卷以备份JIRA主目录。

详见数据备份与恢复文档：[***]

版本控制

latest标签对应Atlassian JIRA Software的最新发布版本，即epicmorg/jira:latest使用最新版JIRA。

可用版本

• epicmorg/jira:latest
• epicmorg/jira:7.10.0

支持

本Docker镜像不提供官方支持，仅供参考和演示使用。