Redmine On CentOS 7

Install Redmine 3.x and Redmine plugins on CentOS. The role installs Redmine along with Unicorn and Nignx.

In future versions, we will support other Linux distributions. Right now, only CentOS 7 is supported.

Note On Debian And Ubuntu:

• Debian Stretch provides the Redmine package and can be installed via apt.
• Ubuntu multiverse provides the Redmine package and can be installed via apt.

This role will install the required RPM packages from the official CentOS 7 repositories. Redmine will be downloaded from redmine.org and required Ruby gems from rubygems.org.

To start Redmine use the command:

    systemctl start redmine

To stop Redmine use the command:

    systemctl stop redmine

Requirements

If you are using MySQL or PostgreSQL, you have to provide the database server name, database name, database username and password via the variables:

• redmine_sql_username
• redmine_sql_password
• redmine_sql_database_name
• redmine_sql_database_host

Make sure port 80 is open in your firewall. If you serve Redmine over HTTPS make sure port 443 is open too.

If you set redmine_configure_selinux to yes then libselinux-python and policycoreutils-python packages are required. These packages can be installed via CentOS Base.

centos_base_selinux_packages: true

If you are using a container with minimal packages, you will have to install some essential packages like @Developement Tools, zlib, etc. You can install them via CentOS Base by setting the variable:

centos_base_basic_packages: true

If you use redmine_nginx_config_template: tls, make sure the file /etc/ssl/private/dhparam.pem is present so that Diffie-Hellman key exchage works.

Ruby >= 2.1 maybe required at some point. If somewhere in the gems dependency chain, Ruby 2.1 is set as a required package, you could use Ruby Ansible role. At the moment, Redmine works on Ruby 2.0.

Role Variables

These variables are available with the following default values:

Dependencies

• CentOS Base

If you need a recent version of Ruby use:

• Ruby

Example playbook

    - hosts: servers
      vars:
       - centos_base_enable_epel: true
       - centos_base_basic_packages: true
       - redmine_sql_username: redmine
       - redmine_sql_password: password
       - redmine_sql_database_name: redmine
       - remmine_sql_database_host: localhost
       - redmine_version: 3.4.2
       - redmine_nginx_bind_ip: 192.168.100.130
       - redmine_configure_selinux: yes
      remote_user: centos
      roles:
         - bngsudheer.centos_base
         - bngsudheer.redmine

Example playbook to install Redmine with plugins

     - hosts: servers
       vars:
        - centos_base_enable_epel: true
        - centos_base_basic_packages: true
        - centos_base_selinux_packages: true
        - redmine_sql_username: redmine
        - redmine_sql_password: password
        - redmine_sql_database_name: redmine
        - remmine_sql_database_host: localhost
        - redmine_version: 3.4.6
        - redmine_nginx_bind_ip: 192.168.100.130
        - redmine_configure_selinux: yes
        - redmine_plugins:
          - name: scrum
            base_name: scrum
            url: https://redmine.ociotec.com/attachments/download/481/scrum-v0.18.1.tar.gz
            create_base_directory: false
       remote_user: centos
       roles:
          - bngsudheer.centos_base
          - bngsudheer.redmine

Restricting Access To Redmine Based On IP Addresses

If you use the tls Nginx configuration template, you can maintain a list of allow rules within a text file. For example /etc/nginx/my-allowlist could contain:

allow 1.2.3.4;
allow 1.2.3.5;

Let the role know about your allowlist:

redmine_nginx_config_template: tls
redmine_nginx_allowlist: true
redmine_nginx_allowlist_path: /etc/nginx/my-allowlist

License

BSD

Developement

You need a few Python packages to run molecule tests:

python-vagrant
docker
molecule

To run molecule tests locally, you might want to set the ANSIBLE_ROLES_PATH variable.

export ANSIBLE_ROLES_PATH=/path/to/ansible-role-redmine/molecule/default/roles

Vagrant tests are not included in TravisCI. Run them locally:

molecule test --scenario-name=selinux_vagrant -d vagrant

Author Information

Sudheer Satyanarayana

• Blog: https://www.techchorus.net
• Twitter: https://www.twitter.com/bngsudheer
• Work: https://www.gavika.com