CoffeeITWorks.ansible_role_redmine

ansible-role-redmine

This role installs Redmine versions 3.3, 3.4, or 4.x using Apache and Passenger. You'll need to set up HTTPS by yourself. You can also install Redmine in an LXC container managed by this role.

To get started, run this command:

git clone https://github.com/gitinsky/ansible-role-redmine.git roles/redmine

It has been tested on Ubuntu 16.04 and works with Ansible version 2.6 or higher. This role will remove the default Apache configuration file.

Dependency

This role requires the ruby-rvm role. Create a requirements.yml file and use the command ansible-galaxy install -r requirements.yml.

Here’s an example of what the requirements.yml file should look like:

- src: https://github.com/CoffeeITWorks/ansible-role-ruby-rvm.git
  name: coffeeitworks.ansible_role_ruby_rvm

Variables

You can view and change the variables in defaults/main.yml. To change the Redmine version, update the following variables:

redmine_svn_version: 3.4  # Specify the desired Redmine version
ruby_version: '2.4.5'  # Must be compatible with your Redmine version
redmine_bundle_version: 1.17.3  # Specify the Bundler version to avoid errors
redmine_bundler_gem: 'bundler -v "{{ redmine_bundle_version }}"'  # Command to install the correct Bundler version

Official Documentation

You can refer to the official documentation here: How to Install Redmine on Ubuntu Server

Example Playbook

Here is an example playbook to get you started:

- hosts: redmine_servers
  become: yes
  become_method: sudo
  vars:
    ruby_version: '2.3.6'  # Match this with your Redmine version
  environment: "{{ proxy_env }}"
  roles:
    - role: ansible_redmine
      tags: [ "redmine_servers" ]
      # This role requires ruby-rvm

    - role: ansible_redmine_plugins
      tags: [ "redmine_servers", "redmine_servers_plugins"]

    - role: ansible_redmine_git_sync
      tags: [ "redmine_servers", "redmine_servers_git_sync"]

    - role: ansible_redmine_emails
      tags: [ "redmine_servers", "redmine_servers_emails"]

    #- role: ansible_redmine_backup
    #  tags: [ "redmine_servers", "redmine_servers_backup"]

    - role: postfix_client
      tags: [ "postfix_clients", "redmine_servers_all" ]

Notes About Upgrading from Previous Redmine Versions

The best method is to set up a new machine using this role and then transfer the database and data files. After that, run this role again to ensure that all updates and requirements for plugins and Gemfiles are met.

You can also perform an in-place upgrade, but it may require some manual steps. For example, you might need to run the following commands as the root user:

gpg --keyserver hkp://pool.sks-keyservers.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB
rm -rf /usr/local/rvm/
rm /etc/apache2/sites-enabled/redmine.conf
rm -rf /home/redmine/.rvm/
rm /etc/apache2/conf-enabled/passenger.conf

This will ensure everything is clean before the upgrade.

For any open issues, you can visit: https://github.com/CoffeeITWorks/ansible-role-redmine/issues

Informazioni sul progetto