Public | Automated Build

Last pushed: 2 years ago
Short Description
Short description is empty for this repo.
Full Description

atlassian-jira

The atlassian-jira container can be used to spin up an instance of
Atlassian JIRA®.

Quick Start

To quickly spin up an instance of Atlassian JIRA®, simply specify a port
forwarding rule and run the container:

$ docker run \
    -p 8080:8080 \
    jleight/atlassian-jira

Usage

If you want to change the context root of the application (by default the
application listens on /) you can follow the instructions in the
context root section of this document.

If you are not planning on running Atlassian JIRA® behind a reverse proxy, you
can follow the instructions in the simple section. If you plan to use
a reverse proxy, further instructions can be found in the
reverse proxy section of this document.

If you are planning to use a different authentication mode, follow the
instructions in the authentication section of this document.

Simple

Atlassian JIRA® stores instance-specific data inside a folder it defines as the
jira.home directory. This container defines the jira.home directory as
/var/opt/atlassian and exposes it as a volume. As such, it is recommended to
either map this volume to a host directory, or to create a data container for
the volume.

A data container can be created by running the following command:

$ docker create \
    --name jira-data \
    jleight/atlassian-jira

The application container can then be started by running:

$ docker run \
    --name jira \
    --volumes-from jira-data \
    -p 8080:8080 \
    jleight/atlassian-jira

Context Root

If you want to run Atlassian JIRA® under a context root other than /, you can
specify an extra environment variable when running the container:

  • TC_ROOTPATH: the new context root for Atlassian JIRA®.

It can be specified in the docker run command like this:

$ docker run \
    --name jira \
    --volumes-from jira-data \
    -p 8080:8080 \
    -e TC_ROOTPATH=/jira \
    jleight/atlassian-jira

Atlassian JIRA® can then be accessed at http://${HOST_IP}:8080/jira.

Reverse Proxy

If you are using a reverse proxy to proxy connections to Atlassian JIRA®, you
will need to specify two extra environment variables when starting this
container.

The variables are as follows:

  • TC_PROXYNAME: the domain name at which Atlassian JIRA® will be accessible.
  • TC_PROXYPORT: the port on which Atlassian JIRA® will be accessible.

For example, if you are planning on running Atlassian JIRA® at
https://example.com/jira, you would use the following command:

$ docker run \
    --name jira \
    --volumes-from jira-data \
    -p 8080:8080 \
    -e TC_PROXYNAME=example.com \
    -e TC_PROXYPORT=443 \
    -e TC_ROOTPATH=/jira \
    jleight/atlassian-jira

Once your proxy server is configured, Atlassian JIRA® should be accessible
at https://example.com/jira.

Authentication

By default, Atlassian JIRA® is configured to use JiraSeraphAuthenticator
for authentication. This allows for authentication and authorization to be
performed against an internal directory of users.

If you want to switch to one of the other authentication providers, you can
specify the JIRA_AUTH environment variable with one of the following values:

  • JiraSeraphAuthenticator (default)
  • SSOSeraphAuthenticator

If you are using the SSOSeraphAuthenticator authenticator, you can also supply
the application's name, password, and Atlassian Crowd's® base URL as environment
variables:

  • CROWD_APP_NAME the application name configured in Atlassian Crowd®.
  • CROWD_APP_PASS the password configured in Atlassian Crowd®.
  • CROWD_BASE_URL the base URL of Atlassian Crowd®, including "/crowd".

Building on the previous reverse proxy example, here's how you can switch to
Atlassian Crowd® single sign-on authentication running behind the same proxy:

$ docker run \
    --name jira \
    --volumes-from jira-data \
    -p 8080:8080 \
    -e TC_PROXYNAME=example.com \
    -e TC_PROXYPORT=443 \
    -e TC_ROOTPATH=/jira \
    -e JIRA_AUTH=SSOSeraphAuthenticator \
    -e CROWD_APP_NAME=jira \
    -e CROWD_APP_PASS=somesecretpassword \
    -e CROWD_BASE_URL=https://example.com/crowd \
    jleight/atlassian-jira
Docker Pull Command
Owner
jleight
Source Repository

Comments (0)