Atlassian Jira for Docker
This revision of docker-atlassian-jira will install:
This application is ready to launch on a Docker host:
prompt> docker run -d -p 8080:8080 -p 8443:8443 markeissler/atlassian-jira:latest
As configured, data on the following volumes will be created to persist data between container starts:
Data Persistence over NFS
It may be desirable to configure data persistence over NFS, in which case NFS volumes are mounted at the locations described in the Data Persistence section above. NFS support requires that the underlying Docker host supports NFS; if deploying to a Docker swarm a potential boot2docker.iso candidate that supports NFS is the [boot2docker-nfs.iso (https://github.com/markeissler/boot2docker-nfs).
Certain JIRA directories are moved out of the application configuration directory and into an ephemeral runtime storage area to prevent data corruption startup failures. Specfically, cache directories are moved so that clean re-starts are possible; often, when an instance dies Tomcat will not be shutdown cleanly and data corruption is likely to occur with regard to the felix plugin cache).
|/var/atlassian/jira_runtime||runtime storage for caches and indexes|
You can enable SSL by simply copying a PKCS12 format certificate (
certificate.p12) into the
JIRA_HOME directory (
/var/atlassian/jira) and then restarting the container. The PKCS12 file format has been selected to make it easier to generate certificates using
openssl command that will create a PKCS12 file from a private key (
server_key.pem) and public certficate (
prompt> openssl pkcs12 -export -in server_cert.pem \ -inkey server_key.pem -out certificate.p12 \ -passout pass:changeit -name "jira"
On container startup, the PCKS12 format certificate.p12 file will be converted and stored in the system JKS keystore.
Docker Swarm Support
While docker-atlassian-jira does not support multi-node clustering it does support deployment to a cluster with a failover configuration (where only a single JIRA instance is active at any time).
This configuration requires that Data Persistence over NFS has been configured to share JIRA configuration information among replicated instances.
Redeployment Index Regeneration
Indexes are stored in ephemeral storage; consequently, when redeploying the application on top of existing persistent storage (i.e. Data Persistence over NFS) it will be necessary to manually trigger a rebuild of all indexes. Log in as a user with administrative permissions, then navigate to:
Cog > System > Advanced > Indexing
Click on the <kbd>Re-Index</kbd> button.
For general troubleshooting information check the Troubleshoot document.
Upstream Release Notes
Release notes for all versions of JIRA can be viewed online:
docker-atlassian-jira is the work of Mark Eissler.
docker-atlassian-jira was inspired by the work of Martin Aksel Jensen, specifically his ongoing efforts to provide up-to-date dockerized versions of other popular [Atlassian (https://www.atlassian.com/) applications.
docker-atlassian-jira is licensed under the MIT open source license.
Without open source, there would be no Internet as we know it today.