Skip to main content

Установка Redmine 5.1.2 на Debian 12

Описание

Redmine - это гибкое веб-приложение для управления проектами.

Оно написано с использованием фреймворка Ruby on Rails и является кросс-платформенным и совместимым с базами данных.

Redmine имеет открытый исходный код и выпускается на условиях GNU General Public License версии 2 (GPL).

Установка

В данной установке используется образ Debian 12 netinstall.

Подготовка ОС для установки

Перед установкой необходимо обновить пакеты:

apt -y update
apt -y upgrade

Настройка локали:

dpkg-reconfigure locales

Создание пользователя:

useradd -r -m -d /opt/redmine -s /usr/bin/bash redmine

Добавление пользователя Redmine в группу www-data:

usermod -aG www-data redmine

Установка дополнительных пакетов:

apt -y install sudo wget mc htop chrony apt-transport-https ca-certificates gnupg2 curl

PostgreSQL

Раздел только для установки Redmine c базой данных PostgreSQL!

Установка Ruby, Apache2, PostgreSQL и других дополнительных пакетов:

apt -y install ruby ruby-dev apache2 apache2-dev libapache2-mod-passenger build-essential libxslt1-dev libxml2-dev zlib1g-dev imagemagick libmagickwand-dev postgresql postgresql-contrib libpq-dev libmariadb-dev

Для работы коннектора требуется установка gem "mysql2", даже если Вы будете использовать PostgreSQL. 
Поэтому требуется установка библиотеки libmariadb-dev.

Заходим под пользователем postgres:

su - postgres

Подключаемся к серверу PostgreSQL:

psql

Задаем пароль для пользователя postgres:

ALTER USER postgres WITH PASSWORD 'Ваш_пароль';

Создаем базу данных с именем redmine и владельцем postgres:

CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=postgres;

Закрываем соединение с Postgres:

\q

Выходим из под пользователя postgres:

exit

MariaDB (MySQL)

Необходимо создать базу данных в MySQL для Redmine.

Для подключения к MySQL используем следующую команду:

mysql

После подключения создаем базу данных и пользователя:

CREATE DATABASE redmine CHARACTER SET utf8mb4;
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'password';

После создания применяем изменения и выходим из MySQL:

FLUSH PRIVILEGES;
EXIT;

Меняем уровень транзакций:

SET GLOBAL TRANSACTION ISOLATION LEVEL READ COMMITTED;

Проверяем изменения:

select @@session.tx_isolation;

Redmine

Загружаем и распаковываем Redmine:

mkdir /opt/redmine
wget https://www.redmine.org/releases/redmine-5.1.2.tar.gz
tar -xvzf redmine-5.1.2.tar.gz -C /opt/redmine/ --strip-components=1
cd /opt/redmine/

Копируем дефолтный файл конфигурации в текущую конфигурацию:

cp config/database.yml.example config/database.yml

Редактируем файл текущей конфигурации:

nano config/database.yml

Для работы с PostgreSQL приводим раздел конфигурации production к виду:

production:
  adapter: postgresql
  database: redmine
  host: localhost
  username: postgres
  password: "Ваш_пароль_пользователя_postgres_в_БД"

Для работы с MySQL приводим раздел конфигурации production к виду:

production:
  adapter: mysql2
  database: redmine
  host: localhost
  username: redmine
  password: "Ваш_пароль_к_базе_данных"
  # Use "utf8" instead of "utfmb4" for MySQL prior to 5.7.7
  encoding: utf8mb4
  variables:
    # Recommended `transaction_isolation` for MySQL to avoid concurrency issues is
    # `READ-COMMITTED`.
    # In case of MySQL lower than 8, the variable name is `tx_isolation`.
    # See https://www.redmine.org/projects/redmine/wiki/MySQL_configuration
    transaction_isolation: "READ-COMMITTED"

Начиная с версии 5.1.1 redmine использует в коннекторе transaction_isolation: "READ-COMMITTED", в установленной нами MariaDB используется старое значение, поэтому необходимо заменить transaction_isolation на tx_isolation.

Меняем

transaction_isolation: "READ-COMMITTED"

на

tx_isolation: "READ-COMMITTED"

Установка bundler:

gem install bundler

Установка gems необходимых для Redmine:

bundle config set --local without 'development test' 
bundle install

Вариант установки bundler и gems с указанием каталога, пример:

gem install bundle --install-dir /opt/redmine/gems/ --lock
bundle config set --local path '/opt/redmine/gems/'
bundle install

Генерируем секретный токен:

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

Создаем несколько необходимых файлов и каталогов с помощью следующей команды:

for i in tmp tmp/pdf public/plugin_assets; do [ -d $i ] || mkdir -p $i; done

Устанавливаем права доступа и владельца для каталога /opt/redmine:

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

Apache2

Настройка apache2 для redmine.

Необходимо создать файл виртуальной конфигурации Apache2 для Redmine и записать конфигурацию.

Создаем файл:

nano /etc/apache2/sites-available/redmine.conf

Добавляем строки:

<VirtualHost *:80>
	ServerName redmine.example.com
	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>

Сохраните и закройте файл конфигурации.

Подключаем файл виртуального хоста Redmine:

a2ensite redmine

Перезапускаем службу apache2:

systemctl restart apache2

UFW

Устанавливаем фаервол ufw:

apt -y install ufw

Включаем политики входящих и исходящих соединений по умолчанию:

ufw default deny incoming
ufw default allow outgoing

Открываем необходимые нам порты:

ufw allow ssh
ufw allow http
ufw allow https

Добавляем ufw в автозагрузку:

systemctl enable ufw
systemctl restart ufw

Включаем ufw:

ufw enable

Перечитываем правила:

ufw reload

Проверяем статус и открытые порты:

ufw status