Jira Cookbook

WARNING - This cookbook was essentially replaced by a new cookbook starting version 2.0. This is a breaking change.

Description

Installs/Configures Atlassian JIRA. Please see [COMPATIBILITY.md](COMPATIBILITY.md) for more information about JIRA releases that are tested and supported by this cookbook and its versions.

Requirements

Chef

• Chef 11+ for version 2.0.0+ of this cookbook

Platforms

• CentOS 6
• RHEL 6
• Ubuntu 12.04

Databases

• Microsoft SQL Server
• MySQL
• Postgres

Cookbooks

Required Opscode Cookbooks

• apache2 (if using apache2 recipe)
• ark
• database (if using database recipe)
• mysql (if using database recipe with MySQL)
• postgresql (if using database recipe with Postgres)

Required Third-Party Cookbooks

• mysql_connector (if using MySQL database)

Suggested Opscode Cookbooks

• java
• tomcat

JDK/JRE

The Atlassian JIRA Linux installer will automatically configure a bundled JRE. If you wish to use your own JDK/JRE, with say the java cookbook, then as of this writing it must be Oracle and version 1.6 (Supported Platforms)

Necessary configuration with java cookbook:
* node['java']['install_flavor'] = "oracle"
* node['java']['oracle']['accept_oracle_download_terms'] = true
* recipe[java]

A /ht to @seekely for the documentation nudge.

Attributes

These attributes are under the node['jira'] namespace.

JIRA Database Attributes

All of these node['jira']['database'] attributes are overridden by jira/jira encrypted data bag (Hosted Chef) or data bag (Chef Solo), if it exists

JIRA JVM Attributes

These attributes are under the node['jira']['jvm'] namespace.

JIRA Tomcat Attributes

These attributes are under the node['jira']['tomcat'] namespace.

Recipes

• recipe['jira'] 'Installs/configures Atlassian JIRA'
• recipe['jira::apache2'] 'Installs/configures Apache 2 as proxy (ports 80/443)'
• recipe['jira::container_server_configuration'] 'Configures container server for JIRA deployment'
• recipe['jira::database'] 'Installs/configures MySQL/Postgres server, database, and user for JIRA'
• recipe['jira::installer'] 'Installs/configures JIRA via installer'
• recipe['jira::standalone'] 'Installs/configures JIRA via standalone archive'

Usage

JIRA Server Data Bag

Optionally for securely overriding attributes on Hosted Chef, create a jira/jira encrypted data bag with the model below. Chef Solo can override the same attributes with a jira/jira unencrypted data bag of the same information.

required:
* ['database']['type'] - "mssql", "mysql", or "postgresql"
* ['database']['host'] - FQDN or "localhost" (localhost automatically installs ['database']['type'] server)
* ['database']['name'] - Name of JIRA database
* ['database']['user'] - JIRA database username
* ['database']['password'] - JIRA database username password

optional:
* ['database']['port'] - Database port, defaults to standard database port for ['database']['type']

Repeat for other Chef environments as necessary. Example:

{
  "id": "jira",
  "development": {
    "database": {
      "type": "postgresql",
      "host": "localhost",
      "name": "jira",
      "user": "jira",
      "password": "jira_db_password",
    }
  }
}

Default JIRA Installation

The simplest method is via the default recipe, which uses node['jira']['install_type'] (defaults to installer).

• Optionally (un)encrypted data bag or set attributes
  • knife data bag create jira
  • knife data bag edit jira jira --secret-file=path/to/secret
• Add recipe[jira] to your node's run list.

Standalone JIRA Installation

Operates similarly to installer installation, however has added benefits of using ark to create version symlinks of each install. Easily can rollback upgrades by changing node['jira']['version'].

• Optionally (un)encrypted data bag or set attributes
  • knife data bag create jira
  • knife data bag edit jira jira --secret-file=path/to/secret
• Set node['jira']['install_type'] to standalone
• Add recipe[jira] to your node's run list.

JIRA WAR Support

Starting from JIRA 7, WAR installation is no longer supported:
https://confluence.atlassian.com/jira/installing-jira-war-185729447.html

Custom JIRA Configurations

Using individual recipes, you can use this cookbook to configure JIRA to fit your environment.

• Optionally (un)encrypted data bag or set attributes
  • knife data bag create jira
  • knife data bag edit jira jira --secret-file=path/to/secret
• Add individual recipes to your node's run list.

Testing and Development

• Quickly testing with Vagrant: [VAGRANT.md](VAGRANT.md)
• Full development and testing workflow with Test Kitchen and friends: [TESTING.md](TESTING.md)

For Vagrant, you may need to add the following hosts entries:

• 192.168.50.10 jira-centos-6
• 192.168.50.10 jira-ubuntu-1204
• (etc.)

The running JIRA server is then accessible from the host machine:

CentOS 6 Box:
* Web UI (installer/standalone): https://jira-centos-6/

Ubuntu 12.04 Box:
* Web UI (installer/standalone): https://jira-ubuntu-1204/

Contributing

Please see contributing information in: [CONTRIBUTING.md](CONTRIBUTING.md)

Maintainers

• KLM Royal Dutch Airlines

License

Please see licensing information in: [LICENSE](LICENSE)