theja0473/ansible-jira

An Ansible playbook to automate the installation of Atlassian Jira

Ansible deployment for JIRA

1. QuickStart

ansible-galaxy install fauzigo.jira
# Deploy to a remote
ansible-playbook jira.yml --extra-vars=/path/to/file_vars

Table of contents

• 1. QuickStart
• 2. Overview
• 3. Requirements
• 4. Usage
  • 4.1 Playbook Arguments
• 5. After Install

2. Overview

An Ansible playbook to automate the installation of Atlassian Jira, could posibly be used to keep it updated

The Task performed by the playbook are:

- install or check if java-1.7.0-openjdk-devel is installed
- create a group for jira
- create a user that belong to the group created before
- Download the standalone tar file given a version
- extract the tar file
- create a symlink to an shorter dir name for the extracted dir
- set the jira-home dir in the jira-application.properties file
- copy an init script or a service file depending on the EL major release 

3. Requirements

Ansible to be installed in the local machine.

Because I'm using RHEL the easiest way to install is:

yum install ansible

but as you are already here (github) you can try:

git clone git://github.com/ansible/ansible.git --recursive
cd ./ansible
source ./hacking/env-setup

4. Usage

1. git clone http://github.com/fauzigo/ansible-jira or ansible-galaxy install fauzigo.jira
2. create a vars file in you group_vars dir or host_vars or simply add them directory on your main yml file
3. run the Ansible playbook, the fastest way is:

ansible-playbook jira.yml --extra-vars=/path/to/file_var

4.1 Playbook Arguments

• jira_user_group: group that jira files are going to belong to
• jira_user_group_gid: group id
• jira_user: user that jira files are going to belong to
• jira_user_uid: user id
• jira_user_home_dir: path to where the sources are going to be, Default: /opt
• jira_home: jira-home path, if it's the first time installation use whereever you like, otherwise use your current
• jira_version: the version check latest in atlassian site
• jira_version_file_sha256sum: you should have this
• jira_download_link: link to download the .tar.gz file (note: it will be concatenated with the version var)

TODO: make gid, uid and sha256sum optional

Example:

ansible-playbook jira.yml --extra-vars 'jira_user_group=jira jira_user_group_gid=1000 jira_user=jira jira_user_uid=1000 jira_user_home_dir=/opt jira_home=/var/jira jira_download_link="http://www.atlassian.com/software/jira/downloads/binary/atlassian-jira" jira_version=6.3.9 jira_version_file_sha256sum=5ba3496347d78383e0201a80ecd0bafa9b6a2ea1e4841f4d843c1369d21da9a9'

TODO use the handler after install to run the application

5. After install

You can just ssh to the server(s) (more than one if you are using jira datacenter) and:

for releases version 6 or less [works with 7 as well]

service jira start

for releases version 7

systemctl start jira.service

Enjoy