Forge Home

redmine

Module to install redmine

15,012 downloads

11,409 latest version

4.6 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Support the Puppet Community by contributing to this module

You are welcome to contribute to this module by suggesting new features, currency updates, or fixes. Every contribution is valuable to help ensure that the module remains compatible with the latest Puppet versions and continues to meet community needs. Complete the following steps:

  1. Review the module’s contribution guidelines and any licenses. Ensure that your planned contribution aligns with the author’s standards and any legal requirements.
  2. Fork the repository on GitHub, make changes on a branch of your fork, and submit a pull request. The pull request must clearly document your proposed change.

For questions about updating the module, contact the module’s author.

Version information

  • 2.3.0 (latest)
  • 2.0.0
  • 1.2.1
  • 1.0.1
  • 1.0.0
  • 0.0.2
  • 0.0.1
released Jun 9th 2015
This version is compatible with:
  • RedHat, CentOS, ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'johanek-redmine', '2.3.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add johanek-redmine
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install johanek-redmine --version 2.3.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

johanek/redmine — version 2.3.0 Jun 9th 2015

johanek-redmine

Build Status

This module installs redmine, running behind apache and passenger, and backed by mysql, mariadb or postgresql

Tested on CentOS 6.5, debian wheezy and Ubuntu 14.04 (Trusty)

Requirements

Required modules:

  • puppetlabs-mysql 2.0 or later
  • puppetlabs-stdlib
  • puppetlabs-apache
  • puppetlabs-concat
  • puppetlabs-postgresql 3.3.0 or later

Optional modules:

  • puppetlabs-vcsrepo if you want to download redmine from a repository (the default)

RedHat or CentOS:

  • EPEL yum repository needs to be configured

Example Usage

To install the default version of redmine

    class { 'apache': }
    class { 'apache::mod::passenger': }
    class { '::mysql::server': }
    class { 'redmine': }

To install version 2.5.0 from the official svn repository

    class { 'apache': }
    class { 'apache::mod::passenger': }
    class { '::mysql::server': }
    class { 'redmine':
      download_url => 'svn.redmine.org/redmine/tags/2.5.0',
      provider     => 'svn',
      version      => 'HEAD',
    }

Install default redmine with a postgresql database

    class { 'apache': }
    class { 'apache::mod::passenger': }
    class { '::postgresql::server': }
    class { 'redmine':
      database_adapter => 'postgresql',
    }

Installing Plugins

Plugins can be installed and configured via the redmine::plugin resource. For example, a simple plugin can be installed like this:

    redmine::plugin { 'redmine_plugin'
      source => 'git://example.com/redmine_plugin.git'
    }

Plugins can be installed via git (the default) or any other version control system.

Bundle updates and database migrations will be handled automatically. You can update your plugin by setting ensure => latest or directly specifying the version. More complex updates can be done by subscribing to the plugin resource (via subscribe => Redmine::Plugin['yourplugin'])

Uninstalling plugins can be done by simply setting ensure => absent. Again, database migration and deletion are done for you.

Redmine Parameters

#####version

Set to desired version. Default: 2.2.3

#####download_url

Download URL for redmine tar.gz when using wget as the provider. The repository url otherwise. When using wget, be sure to provide the full url. Default: https://github.com/redmine/redmine

#####provider

The VCS provider or wget. When setting the provider to wget, be sure to set download_url to a valid tar.gz archive. To use the svn provider you have to provide the full url to the tag or branch you want to download and unset the version. Default: git

#####database_server

Database server to use. Default: 'localhost' If server is not on localhost, the database and user must be setup in advance.

#####database_user

Database user. Default: 'redmine'

#####database_password

Database user password. Default: 'redmine'

#####production_database

Name of database to use for production environment. Default: 'redmine'

#####development_database

Name of database to use for development environment. Default: 'redmine_development'

#####database_adapter

Database adapter to use for database configuration. Can be either 'mysql' for ruby 1.8, 'mysql2' for ruby 1.9 or 'postgresql'. Default: 'mysql' or 'mysql2' depending on your ruby version.

#####smtp_server

SMTP server to use. Default: 'localhost'

#####smtp_domain

Domain to send emails from. Default: $::domain

#####smtp_port

SMTP port to use. Default: 25

#####smtp_authentication

Toggle SMTP authentication. Default: false

#####smtp_username

SMTP user name for authentication. Default: none

#####smtp_password

SMTP password for authentication. Default: none

#####vhost_aliases

Server aliases to use in the vhost config. Default 'redmine'. Expects a string.

#####vhost_servername

Server name to use in the vhost config. Default 'redmine'. Expects a string.

#####webroot

Directory in which redmine web files will be installed. Default: 'DOCROOT/redmine' DOCROOT is the document root of your apache server, usually /var/www or /var/www/html

#####install_dir

Path where redmine will be installed Default: '/usr/src/redmine'

#####override_options

Empty hash by default. Can be used to add additional options to the redmine configuration file. Example:

class { 'redmine':
  default_override => {'foo' => 'bar', 'bar' => 'baz'},
}

This will generate a config that looks like this:

default:
  # default setting of the module
  delivery_method: :smtp
  smtp_settings:
    address: localhost
    port: 25
    domain: example.com
  # user provided custom options
  bar: baz
  foo: bar

Currently does not support nested options.

#####plugins

Optional hash of plugins to install, which are passed to redmine::plugin

#####www_subdir

Optional directory relative to the site webroot to install redmine in. Undef by default. Expects a path string without leading slash. When using this option the vhost config is your responsibility. Example:

apache::vhost { 'www.somesite.com':
  priority        => 20,
  port            => '80',
  docroot         => '/usr/src/sites/www.somesite.com/website',
  servername      => 'www.somesite.com',
  serveraliases   => ['somesite.com'],
  directories     => [
                       { path => '/usr/src/sites/www.somesite.com/website',
                       },
                       { path    => '/usr/src/redmine',
                         options => 'FollowSymlinks ExecCGI',
                         custom_fragment => "PassengerAppRoot /var/www/html/redmine\n    RailsBaseURI /redmine",
                       },
                     ],
  aliases         => [
                       { alias            => '/redmine',
                         path             => '/usr/src/redmine',
                       },
                     ],
}

Plugin Parameters

#####ensure Wether the plugin should be installed. Possible values are installed, latest, and absent.

#####source Repository of the plugin. Required

#####version Set to desired version.

#####provider The vcs provider. Default: git

Contributing

See the wiki for further information about contributing to this module: https://github.com/johanek/johanek-redmine/wiki