From 50e518a8269acc417cee97265ea410150c4b4794 Mon Sep 17 00:00:00 2001 From: Bryce Johnson Date: Wed, 8 Aug 2012 12:47:40 +1000 Subject: [PATCH] Initial jira puppet module --- LICENSE | 175 ++++++++++++++++++++++++++++ README.md | 5 +- jira.yaml | 68 +++++++++++ manifests/config.pp | 40 +++++++ manifests/init.pp | 22 ++++ manifests/install.pp | 53 +++++++++ manifests/params.pp | 60 ++++++++++ manifests/service.pp | 24 ++++ templates/dbconfig.mysql.xml.erb | 24 ++++ templates/dbconfig.postgres.xml.erb | 15 +++ templates/etc/rc.d/init.d/jira.erb | 85 ++++++++++++++ 11 files changed, 570 insertions(+), 1 deletion(-) create mode 100644 LICENSE create mode 100644 jira.yaml create mode 100644 manifests/config.pp create mode 100644 manifests/init.pp create mode 100644 manifests/install.pp create mode 100644 manifests/params.pp create mode 100644 manifests/service.pp create mode 100644 templates/dbconfig.mysql.xml.erb create mode 100644 templates/dbconfig.postgres.xml.erb create mode 100644 templates/etc/rc.d/init.d/jira.erb diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..67db858 --- /dev/null +++ b/LICENSE @@ -0,0 +1,175 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. diff --git a/README.md b/README.md index cb9c23d..6c84878 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,7 @@ puppet-jira =========== -Atlassian JIRA Puppet Module \ No newline at end of file +Atlassian JIRA Puppet Module + + +UNTESTED...DO NOT USE...I am not ready for you master. \ No newline at end of file diff --git a/jira.yaml b/jira.yaml new file mode 100644 index 0000000..1765e9f --- /dev/null +++ b/jira.yaml @@ -0,0 +1,68 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2012 Bryce Johnson +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +#----------------------------------------------------------------------------- +# +# 1.) Place this file in your hieradata directory +# 2.) Modify the database settings below according to your setup +# +# Atlassian jira Git Enterprise Source Control Server +jira_name: jira +jira_version: 5.1.1 +jira_package_format: zip + +# Directory where the webapp will run from +jira_install_dir: /opt/jira +# If you can put this on another filesystem, and even better, a fs that's +# on another physical disk, you will be happier, but not required +jira_home_dir: /opt/jira-home + +# Database configuration - please change these according to your setup +# Comment out or uncomment for your db product as this value is also +# overloaded as the jdbc driver db +jira_db: postgresql +#jira_db: mysql +#jira_db: oracle + +jira_dbtype: postgres72 +#jira_dbtype: mysql + +jira_dbdriver: org.postgresql.Driver +#jira_dbdriver: com.mysql.jdbc.Driver + +# Change these values to your jira database credentials +jira_dbuser: jiraadm +jira_dbpassword: jiraadm + +jira_dbname: jira +# Change port depending on your db product +jira_dbport: 5432 +#jira_dbport: 3306 +#jira_dbport: 1521 + +# Change if your database isn't on localhost. This module will only check +# to make sure that the service is running and start it if it is not on +# localhost db's only. So if your remote database, which is suggested, isn't +# available, that's your fault. +jira_dbserver: localhost + +# Tomcat configuration +# TODO because I'm never a fan of the stock tomcat settings +jira_javahome: /opt/java/jdk1.6.0_33 +jira_jvm_xmx: 1024m +jira_jvm_optional: -XX:-HeapDumpOnOutOfMemoryError +#jira_jvm_optional: -XX:NewSize=256m -XX:MaxNewSize=256m -XX:SurvivorRatio=16 +# the New and SR figures are purely optional +# for heap dumps add -XX:-HeapDumpOnOutOfMemoryError +# by default jira has 256m permgen which is a good setting to go with diff --git a/manifests/config.pp b/manifests/config.pp new file mode 100644 index 0000000..6b90c5a --- /dev/null +++ b/manifests/config.pp @@ -0,0 +1,40 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2012 Bryce Johnson +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +#----------------------------------------------------------------------------- +class jira::config{ + + require jira::params + + exec { 'mkdirp-homedir': + cwd => "${jira::params::tmpdir}", + command => "/bin/mkdir -p ${jira::params::homedir}", + creates => "${jira::params::homedir}" + } + + if "${jira::params::db}" == 'postgresql' { + file { "${jira::params::homedir}/dbconfig.xml": + content => template('jira/dbconfig.postgres.xml.erb'), + mode => '0600', + require => [Class['jira::install'],Exec['mkdirp-homedir']], + } + } + if "${jira::params::db}" == 'mysql' { + file { "${jira::params::homedir}/dbconfig.xml": + content => template('jira/dbconfig.mysql.xml.erb'), + mode => '0600', + require => [Class['jira::install'],Exec['mkdirp-homedir']], + } + } +} \ No newline at end of file diff --git a/manifests/init.pp b/manifests/init.pp new file mode 100644 index 0000000..0ccd47d --- /dev/null +++ b/manifests/init.pp @@ -0,0 +1,22 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2012 Bryce Johnson +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +#----------------------------------------------------------------------------- + +class jira { + include jira::params + include jira::install + include jira::config + include jira::service +} diff --git a/manifests/install.pp b/manifests/install.pp new file mode 100644 index 0000000..4e809a3 --- /dev/null +++ b/manifests/install.pp @@ -0,0 +1,53 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2012 Bryce Johnson +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +#----------------------------------------------------------------------------- +class jira::install { + + require jira::params + + case $::osfamily { + 'Darwin' : { # assuming you did download wget - ill maybe fix this and check for it + exec { 'wget-jira-package': + cwd => "${jira::params::tmpdir}", + command => "${jira::params::cmdwget} --no-check-certificate ${jira::params::downloadURL}", + creates => "${jira::params::tmpdir}/atlassian-${jira::params::product}-${jira::params::version}.${jira::params::format}", + } + } + default : { + exec { 'wget-jira-package': + cwd => "${jira::params::tmpdir}", + command => "${jira::params::cmdwget} --no-check-certificate ${jira::params::downloadURL}", + creates => "${jira::params::tmpdir}/atlassian-${jira::params::product}-${jira::params::version}.${jira::params::format}", + } + } + } + + exec { 'mkdirp-installdir': + cwd => "${jira::params::tmpdir}", + command => "/bin/mkdir -p ${jira::params::installdir}", + creates => "${jira::params::installdir}", + } + exec { 'unzip-jira-package': + cwd => "${jira::params::installdir}", + command => "/usr/bin/unzip -o -d ${jira::params::installdir} ${jira::params::tmpdir}/atlassian-${jira::params::product}-${jira::params::version}.${jira::params::format}", + creates => "${jira::params::webappdir}", + require => [Exec['wget-jira-package'],Exec['mkdirp-installdir']], + } + + file { '/etc/rc.d/init.d/jira': + content => template('jira/etc/rc.d/init.d/jira.erb'), + mode => '0755', + } +} diff --git a/manifests/params.pp b/manifests/params.pp new file mode 100644 index 0000000..e20cedb --- /dev/null +++ b/manifests/params.pp @@ -0,0 +1,60 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2012 Bryce Johnson +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +#----------------------------------------------------------------------------- +class jira::params { + # resource types do not allow hiera to be expressed directly + # so continuing to use params.pp as a variable holder + # they are also required for the var lookup for the templates + $version = hiera('jira_version') + $product = hiera('jira_name') + $format = hiera('jira_package_format') + $installdir = hiera('jira_install_dir') + $webappdir = "${installdir}/atlassian-${product}-${version}-standalone" + $homedir = hiera('jira_home_dir') + + # Database Settings + $db = hiera('jira_db') + $dbuser = hiera('jira_dbuser') + $dbpassword = hiera('jira_dbpassword') + $dbserver = hiera('jira_dbserver') + $dbname = hiera('jira_dbname') + $dbport = hiera('jira_dbport') + $dbdriver = hiera('jira_dbdriver') + $dbtype = hiera('jira_dbtype') + $dburl = "jdbc:${db}://${dbserver}:${dbport}/${dbname}" + + # JVM Settings + $javahome = hiera('jira_javahome') + $jvm_xmx = hiera('jira_jvm_xmx') + $jvm_optional = hiera('jira_jvm_optional') + + # With my experience, this URL shouldn't ever change and can be + # used for all Atlassian products, their versions, and file format. + # It's also cdn cached. :) + # TODO: maybe toss this into atlassian.yaml for hiera + $downloadURL = "http://www.atlassian.com/software/${product}/downloads/binary/atlassian-${product}-${version}.${format}" + + case $::osfamily { + 'Darwin' : { + # HTFU macboy - go download and install wget + $cmdwget = '/usr/local/bin/wget' + $tmpdir = '/tmp' + } + default : { + $cmdwget = '/usr/bin/wget' + $tmpdir = '/tmp' + } + } +} diff --git a/manifests/service.pp b/manifests/service.pp new file mode 100644 index 0000000..74463ba --- /dev/null +++ b/manifests/service.pp @@ -0,0 +1,24 @@ +#----------------------------------------------------------------------------- +# Copyright (c) 2012 Bryce Johnson +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +#----------------------------------------------------------------------------- +class jira::service { + + service { 'jira': + ensure => 'running', + name => 'jira', + enable => true, + require => Class['jira::config'], + } +} \ No newline at end of file diff --git a/templates/dbconfig.mysql.xml.erb b/templates/dbconfig.mysql.xml.erb new file mode 100644 index 0000000..213f79e --- /dev/null +++ b/templates/dbconfig.mysql.xml.erb @@ -0,0 +1,24 @@ + + + + defaultDS + default + mysql + + <%= scope.lookupvar('jira::params::dburl') %>?useUnicode=true&characterEncoding=UTF8&sessionVariables=storage_engine=InnoDB + <%= scope.lookupvar('jira::params::jira_dbdriver') %> + <%= scope.lookupvar('jira::params::dbuser') %> + <%= scope.lookupvar('jira::params::dbpassword') %> + 20 + 20 + 30000 + select 1 + 60000 + 300000 + 20 + true + 300 + true + 3 + + \ No newline at end of file diff --git a/templates/dbconfig.postgres.xml.erb b/templates/dbconfig.postgres.xml.erb new file mode 100644 index 0000000..d665f71 --- /dev/null +++ b/templates/dbconfig.postgres.xml.erb @@ -0,0 +1,15 @@ + + + + defaultDS + default + postgres72 + public + + <%= scope.lookupvar('jira::params::dburl') %> + org.postgresql.Driver + <%= scope.lookupvar('jira::params::dbuser') %> + <%= scope.lookupvar('jira::params::dbpassword') %> + 15 + + \ No newline at end of file diff --git a/templates/etc/rc.d/init.d/jira.erb b/templates/etc/rc.d/init.d/jira.erb new file mode 100644 index 0000000..e0dfe1e --- /dev/null +++ b/templates/etc/rc.d/init.d/jira.erb @@ -0,0 +1,85 @@ +#!/bin/bash +#----------------------------------------------------------------------------- +# Copyright (c) 2012 Bryce Johnson +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +#----------------------------------------------------------------------------- +### BEGIN INIT INFO +# Provides: jira +# Required-Start: +# Required-Stop: +# Should-Start: +# Should-Stop: +# Default-Start: 2 3 4 5 +# Default-Stop: 0 1 6 +# Short-Description: Start up jira Git Server +# Description: Atlassian jira Enterprise Git Server +# This service starts up the tomcat webapp. +### END INIT INFO +ACTION=$1 +SERVICE=jira +lockfile=/var/lock/subsys/$SERVICE + +export JAVA_HOME=<%= scope.lookupvar('jira::params::javahome') %> + + +function restart() { + stop + start +} + +function stop() { + echo -n $"Shutting down $SERVICE: " + <%= scope.lookupvar('jira::params::webappdir') %>/bin/stop-jira.sh + RETVAL=$? + echo + + #If all is well remove the lockfile + [ $RETVAL -eq 0 ] && rm -f $lockfile + return $RETVAL +} + +function start() { + echo -n $"Starting $SERVICE: " + <%= scope.lookupvar('jira::params::webappdir') %>/bin/start-jira.sh + RETVAL=$? + echo + + #If all is well touch the lock file + [ $RETVAL -eq 0 ] && touch $lockfile + return $RETVAL +} + + + +function execute() { + case "$ACTION" in + start) + start + ;; + stop) + stop + ;; + status) + status $SERVICE + ;; + restart) + restart + ;; + *) + echo "Usage: $0 {start|stop|status|restart}" + exit 1 + esac +} + +execute \ No newline at end of file