Как установить инструмент управления проектами Redmine на Ubuntu 22.04

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

Redmine гибок и может использоваться для различных типов организаций и проектов, от малых до крупных. Он позволяет создавать и управлять несколькими проектами, и каждый проект имеет свою собственную вики, форумы, отслеживание проблем и т. д. Также он позволяет создавать пользовательские роли в зависимости от потребностей вашей организации и многое другое.

Redmine выпущен под лицензией GNU GPL v2 и может быть установлен на любой операционной системе, такой как Linux, Windows или macOS. Он поддерживает различные типы баз данных, включая PostgreSQL, MySQL и SQLite (по умолчанию).

В этом руководстве вы установите Redmine с веб-сервером Apache2 и сервером MySQL на сервере Ubuntu 22.04. Вы также защитите установку Redmine с помощью SSL-сертификатов.

Предварительные требования

В этом учебном пособии требуются следующие требования:

• Сервер Ubuntu 22.04 — в этом примере используется сервер Ubuntu с именем хоста redmine-server.
• Непользователь с правами sudo root — но также вы можете использовать пользователя root.
• Доменное имя, указывающее на IP-адрес вашего сервера — для производства вы должны убедиться, что ваше доменное имя указывает на IP-адрес вашего сервера.

Когда у вас все будет готово, вы можете перейти к первому шагу установки Redmine.

Установка зависимостей

Redmine — это инструмент управления проектами и отслеживания проблем с открытым исходным кодом, в основном написанный на Ruby и Ruby on Rails (RoR). Чтобы установить Redmine, сначала необходимо установить Ruby, а затем вы можете установить другие зависимости, такие как веб-сервер Apache2 и базу данных с использованием сервера MySQL.

В этом примере вы будете запускать Redmine с веб-сервером Apache2 и сервером MySQL.

Перед началом установки пакетов выполните команду apt ниже, чтобы обновить и обновить индекс пакетов Ubuntu.

sudo apt update

После обновления репозитория установите некоторые следующие зависимости пакетов с помощью команды apt ниже.

С помощью этой команды вы установите веб-сервер Apache2, за которым следует linapache2-mod-passenger, который будет использоваться для настройки приложения RoR, чтобы оно работало под Apache2. Вы также установите пакеты Ruby.

sudo apt install apache2 ruby ruby-dev build-essential libapache2-mod-passenger libmysqlclient-dev

Когда вас попросят подтвердить установку, введите y, а затем нажмите ENTER, чтобы продолжить.

После установки Apache2 и Ruby выполните следующую команду, чтобы установить сервер MySQL. Redmine поддерживает несколько СУБД, таких как PostgreSQL, MySQL/MariaDB и SQLite. В этом примере вы будете использовать сервер MySQL.

sudo apt install mysql-server

Введите y, когда вас попросят подтвердить установку, затем нажмите ENTER, чтобы продолжить.

Для установки Redmine вам также потребуется установить bundler на ваш сервер Ubuntu. Bundler — это командная строка, которая будет использоваться для управления пакетами Ruby Gems.

Выполните следующую команду, чтобы установить bundler в вашу систему.

sudo gem install bundler

После установки bundler вы увидите вывод, похожий на следующий:

Наконец, проверьте службы Apache2 и MySQL с помощью команды systemctl ниже. Это обеспечит работу и включение как служб Apache2, так и MariaDB.

Проверьте службу Apache2.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Ниже вы можете увидеть, что служба Apache2 включена и будет автоматически запускаться при загрузке системы. А текущее состояние службы работает.

Проверьте службу MySQL.

sudo systemctl is-enabled mysql  
sudo systemctl status mysql

Вы увидите аналогичный вывод, как следующий — служба MySQL включена и будет автоматически запускаться при загрузке. А текущее состояние службы MySQL работает.

Настройка сервера MySQL

После установки Apache2 и сервера MySQL вы настроите пароль root MySQL и защитите развертывание с помощью mysql_secure_installation. Затем вы также создадите новую базу данных MySQL и пользователя для Redmine.

Войдите в MySQL с помощью команды mysql ниже.

sudo mysql

Теперь измените пароль root MySQL с помощью следующего запроса. И обязательно измените пароль на свой пароль. Затем введите quit, чтобы выйти из оболочки MySQL.

ALTER USER root@localhost IDENTIFIED WITH mysql_native_password BY 'password';  
quit

Далее выполните следующую команду, чтобы начать защищать развертывание сервера MySQL.

sudo mysql_secure_installation

Когда вас попросят ввести пароль root MySQL, введите свой правильный пароль.

Затем вам будут предложены другие настройки MySQL, такие как отключение удаленного входа для пользователя root, удаление анонимного пользователя, удаление тестовой базы данных по умолчанию и перезагрузка всех привилегий таблиц. Для всех этих настроек сервера MySQL введите Y, чтобы подтвердить конфигурацию.

После защиты развертывания MySQL пришло время настроить новую базу данных и пользователя для Redmine.

Войдите в оболочку MySQL с помощью команды mysql ниже. Вам будет предложено ввести пароль root MySQL, введите правильный пароль для вашего пользователя root MySQL, затем нажмите ENTER.

sudo mysql -u root -p

Теперь выполните следующие запросы, чтобы создать новую базу данных MySQL и пользователя для Redmine. В этом примере вы создадите новую базу данных и пользователя redmine с паролем ‘secretPassword‘. Вы можете заменить пароль базы данных на свой пароль.

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

Далее выполните следующие запросы, чтобы проверить привилегии пользователя MySQL redmine. Убедитесь, что пользователь MySQL redmine имеет привилегии на базу данных redmine.

SHOW GRANTS FOR redmine@localhost;  
quit

Ниже вы можете увидеть пользователя MySQL redmine@localhost с привилегиями на базу данных redmine.

Наконец, введите quit, чтобы выйти из оболочки MySQL.

С установленными всеми зависимостями и созданными базой данных и пользователем MySQL вы готовы установить инструмент управления проектами Redmine на своем сервере Ubuntu.

Установка Redmine

На этом этапе вы установите последнюю версию Redmine. На момент написания последняя версия Redmine — v5.0.2.

Вы загрузите исходный код Redmine, настроите базу данных, установите зависимости Ruby через build, настроите секретный токен Redmine и мигрируете базу данных.

В этом примере вы установите Redmine в директории /opt/redmine.

Перейдите в директорию /opt.

cd /opt/

Теперь загрузите исходный код Redmine с помощью команды wget ниже. После загрузки вы увидите файл redmine-5.0.2.tar.gz в вашей директории /opt.

wget https://www.redmine.org/releases/redmine-5.0.2.tar.gz

Далее выполните следующую команду, чтобы извлечь исходный код Redmine redmine-5.0.2.tar.gz и создать новую символическую ссылку для директории Redmine на /opt/redmine.

tar -xvzf redmine-5.0.2.tar.gz  
sudo ln -s redmine-5.0.2 redmine

Основная директория установки Redmine будет /opt/redmine.

Перейдите в директорию /opt/redmine.

cd /opt/redmine/

Скопируйте конфигурацию базы данных по умолчанию ‘config/database.yml.example’ в ‘config/database.yml’. Затем откройте файл конфигурации базы данных ‘config/database.yml’ с помощью редактора nano.

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

В разделе ‘production’ измените данные базы данных MySQL и пользователя. Обязательно используйте правильного пользователя базы данных и пароль для Redmine.

production:  
  adapter: mysql2  
  database: redmine  
  host: localhost  
  username: redmine  
  password: "secretPassword"   
  # Используйте "utf8" вместо "utfmb4" для MySQL до 5.7.7  
  encoding: utf8mb4

Сохраните файл и выйдите из редактора, когда закончите.

Далее выполните следующую команду bundler, чтобы установить зависимости Ruby для приложения Redmine.

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

Вы увидите вывод, похожий на следующий:

После установки зависимостей Redmine выполните следующую команду, чтобы сгенерировать секретный токен Redmine и мигрировать базу данных.

bundle exec rake generate_secret_token  
RAILS_ENV=production bundle exec rake db:migrate

На следующем скриншоте вы можете увидеть, что секретный токен Redmine сгенерирован, и процесс миграции базы данных Redmine.

Наконец, загрузите данные по умолчанию в вашу установку Redmine с помощью следующей команды. Когда вас попросят выбрать язык, введите en для английского.

RAILS_ENV=production bundle exec rake redmine:load_default_data

Когда данные по умолчанию Redmine загружены, вы увидите сообщение о выводе: