Jira Cookbook

This cookbook installs and configures jira.

Requirements

cookbooks

• ark - https://github.com/opscode-cookbooks/ark.git
• postgresql - https://github.com/opscode-cookbooks/postgresql
• mysql - https://github.com/chef-cookbooks/mysql

Attributes

jira::default

Key	Type	Description	Default
['jira']['version']	String	version of jira to download and install	6.4.11
['jira']['base_url']	String	url to download jira from	http://downloads.atlassian.com/software/jira/downloads
['jira']['user']	String	user to start and run jira as	jira
['jira']['group']	String	group to start and run jira as	jira
['jira']['dir']	String	base directory to store the jira app and home dir in	/opt/jira
['jira']['home_dir']	String	the jira home directory path	/var/jira
['jira']['app_properties']['jira_home']	String	tells jira where to look for home directory	/usr/local/jira/home_dir
['jira']['catalina']['connector']['port']	Integer	catalina port	8080
['jira']['catalina']['connector']['max_threads']	Integer	catalina max threads	150
['jira']['catalina']['connector']['min_spare_threads']	Integer	catalina min spare threads	25
['jira']['catalina']['connector']['connection_timeout']	Integer	catalina connection timeout	20000
['jira']['catalina']['connector']['enable_lookups']	String	catalina enable lookups	false
['jira']['catalina']['connector']['max_http_header_size']	Integer	catalina max http header size	8192
['jira']['catalina']['connector']['protocol']	String	catalina protocol	HTTP/1.1
['jira']['catalina']['connector']['use_body_encoding_for_uri']	String	catalina body coding for URI	true
['jira']['catalina']['connector']['redirect_port']	Integer	catalina redirect port	8443
['jira']['catalina']['connector']['accept_count']	Integer	catalina accept count	100
['jira']['catalina']['connector']['disable_upload_timeout']	String	catalina disable upload timeout	true
['jira']['catalina']['connector']['https_proxy']	Boolean	catalina use https proxy	false
['jira']['catalina']['connector']['scheme']	String	catalina proxy scheme	https
['jira']['catalina']['connector']['proxy_port']	Integer	catalina proxy port	443
['jira']['catalina']['connector']['proxy_name']	String	catalina proxy name	node['fqdn']

jira::database

Key	Type	Description	Default
['jira']['database']['type']	String	the type of database to use	postgresql
['jira']['database']['user']	String	the user to connect to the db with	jira
['jira']['database']['password']	String	the password to connect to the db with	jira
['jira']['database']['host']	String	the database host	localhost
['jira']['database']['name']	String	the name of the database to use	jira

Usage

jira::default

The default recipe includes the necessary recipes to install jira but does not include the database recipe by default.

This cookbook is meant to make configuring jira very easy just by using attributes. For instance in order to set a new setting in jira-application.properties such as jira.title = My Jira you can include it as the following. You should be able to use any and all variables supported by jira just use an underscore instead of a period as the attribute name.

{
  "name":"my_node",
  "attributes": {
    "jira": {
      "app_properties": {
        "jira_title" = "My Jira"
      }
    }
  },
  "run_list": [
    "recipe[jira]"
  ]
}

If you are using a proxy in front of jira for ssl you can have jira set up for that by setting http_proxy to true and changing the proxy_name. ( by default the proxy name is the fqdn of the node jira is installed on)

{
  "name":"my_node",
  "attributes": {
    "jira": {
      "catalina": {
        "connector": {
          "https_proxy": true,
          "proxy_name": "tickets.my_domain.com"
        }
      }
    }
  },
  "run_list": [
    "recipe[jira]"
  ]
}

jira::database

By default the database installed and used is postgresql.

{
  "name":"my_node",
  "run_list": [
    "recipe[jira::database]"
  ]
}

Contributing

1. Fork the repository on Github
2. Create a named feature branch (like add_component_x)
3. Write you change
4. Write tests for your change (if applicable)
5. Run the tests, ensuring they all pass
6. Submit a Pull Request using Github

License and Authors

Authors:

• Jim Rosser
• Victoria Blessing