Запуск Redmine в Debian 11.1 и Ubuntu Server 21.10

Краткая инструкция по установке и первоначальной настройке менеджера проектов Redmine в связке с веб-сервером Apache и СУБД MariaDB на ОС Debian GNU/Linux 11.1 и Ubuntu Server 21.10.

В первую очередь необходимо залогиниться с правами суперпользователя root. Если сервер разворачивается на Ubuntu Server, то вводим

# sudo -i

Устанавливаем консольный браузер Links для удобства

# apt install links

Затем СУБД MariaDB

# apt install mariadb-client mariadb-server

Далее запускаем первоначальную настройку MariaDB

# /usr/bin/mysql_secure_installation

Установим необходимые пакеты

# apt install build-essential ruby-dev libxslt1-dev libmariadb-dev libxml2-dev zlib1g-dev imagemagick libmagickwand-dev curl

а также Apache с модулем passenger

# apt install apache2 libapache2-mod-passenger

Теперь добавим пользователя redmine и определим его в группу www-data

# useradd -r -m -d /opt/redmine -s /usr/bin/bash redmine
# usermod -aG redmine www-data

После этого входим в консоль mysql

# mysql -u root -p

и создадим базу данных redmine_db с пользователем dbuser, который будет иметь на БД полные права:

CREATE DATABASE redmine_db;
GRANT ALL PRIVILEGES ON redmine_db.* to 'dbuser'@'localhost' IDENTIFIED BY '147258';
FLUSH PRIVILEGES;
EXIT;

147258 — это пароль пользователя БД dbuser.

Далее с помощью консольного браузера Links заходим на сайт Redmine и скачиваем архив последней версии в /tmp/

# links https://redmine.org/

Затем распаковываем этот архив в директорию /opt/redmine/ с правами пользователя redmine

# sudo -u redmine tar xzf /tmp/redmine-4.2.3.tar.gz -C /opt/redmine/ --strip-components=1

После этого входим под пользователем redmine

# su - redmine

копируем конфиги из примеров (example)

# cp /opt/redmine/config/configuration.yml.example /opt/redmine/config/configuration.yml
# cp /opt/redmine/config/database.yml.example /opt/redmine/config/database.yml
# cp /opt/redmine/public/dispatch.fcgi.example /opt/redmine/public/dispatch.fcgi

открываем файл конфигурации базы данных

nano /opt/redmine/config/database.yml

находим секцию production и приводим её к такому виду:

production:
  adapter: mysql2
  database: redmine_db
  host: localhost
  username: dbuser
  password: "147258"
  encoding: utf8

Далее выходим из пользователя redmine

# exit

Теперь переходим в домашний каталог пользователя redmine

# cd /opt/redmine/

и устанавливаем bundler

# gem install bundler

Затем снова входим под пользователем redmine

# su - redmine

устанавливаем зависимости

# bundle install --without development test --path vendor/bundle

генерируем сессионные токены

# bundle exec rake generate_secret_token

создаём структуру базы данных

# RAILS_ENV=production bundle exec rake db:migrate

вносим данные конфигурации по умолчанию

# RAILS_ENV=production REDMINE_LANG=ru bundle exec rake redmine:load_default_data

после выполнения этой команды должно появиться такое сообщение:

Default configuration data loaded

задаём пользовательские права на необходимые директории

# chown -R redmine:redmine files log tmp public/plugin_assets
# chmod -R 755 /opt/redmine

запускаем тест сервера с использованием webrick

# bundle exec rails server webrick -e production

на другой машине в сети в адресной строке браузера вводим:

http://IP_адрес_сервера:3000

должна появиться домашняя страница Redmine

выходим из режима тестирования сочетанием клавиш Ctrl + C и из консоли пользователя redmine

# exit

Переходим к конфигурации Apache. Открываем файл:

# nano /etc/apache2/sites-available/000-default.conf

и в конце допишем такой блок:

Listen 3000
<VirtualHost *:3000>
        ServerName localhost
        RailsEnv production
        DocumentRoot /opt/redmine/public

        <Directory "/opt/redmine/public">
                Allow from all
                Require all granted
        </Directory>

        ErrorLog ${APACHE_LOG_DIR}/redmine_error.log
        CustomLog ${APACHE_LOG_DIR}/redmine_access.log combined
</VirtualHost>

Перезапустим Apache

# systemctl restart apache2

и проверим работу модуля passenger

# /usr/sbin/apache2ctl -M | grep passenger

в консоли должна появиться такая строчка:

passenger_module (shared)

После этого на другой машине в сети в адресной строке браузера вводим:

http://IP_адрес_сервера:3000

логинимся: admin / admin

и попадаем в консоль администратора Redmine, где необходимо настроить работу менеджера проектов из дашборда.

Источник: https://kifarunix.com/install-redmine-with-mariadb-on-debian-10-buster/