Вступ

Redmine – це потужний і гнучкий інструмент управління проектами з відкритим вихідним кодом, який забезпечує відстеження проблем, облік часу, вікі-функції та інтеграцію контролю версій. Він побудований на Ruby on Rails і підтримує декілька серверів баз даних, включаючи MySQL і PostgreSQL. У цьому посібнику ми розглянемо покроковий процес встановлення Redmine на Ubuntu 22.04.

Передумови

Перш ніж ми почнемо, переконайтеся, що ваша система відповідає наступним вимогам:

  • Свіже встановлення Ubuntu 22.04
  • Користувач без прав root з привілеями sudo
  • Функціональне підключення до Інтернету
  • Доменне ім’я (необов’язково, але рекомендується)

Крок 1: Оновлення системних пакетів

По-перше, оновіть список пакунків та оновіть наявні пакунки, щоб переконатися, що ваша система є актуальною:

sudo apt update && sudo apt upgrade -y

Крок 2: Встановлення необхідних залежностей

Redmine потребує декількох залежностей, зокрема Ruby, Bundler та сервер бази даних. Ми встановимо ці пакунки спочатку.

sudo apt install -y curl gnupg2 git-core libmysqlclient-dev imagemagick libmagickwand-dev libpq-dev build-essential libssl-dev libreadline-dev zlib1g-dev

Крок 3: Встановлення Ruby

Ubuntu 22.04 не включає останню версію Ruby за замовчуванням, тому ми встановимо Ruby за допомогою rbenv.

git clone https://github.com/rbenv/rbenv.git ~/.rbenv
cd ~/.rbenv && src/configure && make -C src
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
джерело ~/.bashrc

git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
echo 'export PATH="$HOME/.rbenv/plugins/ruby-build/bin:$PATH"' >> ~/.bashrc
джерело ~/.bashrc

Тепер встановіть Ruby:

rbenv install 3.2.0 # Використовуйте останню стабільну версію
rbenv global 3.2.0
ruby -v # Перевірити встановлення

Крок 4: Встановлення сервера баз даних

Redmine підтримує MySQL та PostgreSQL. У цьому посібнику ми будемо використовувати MySQL.

sudo apt install -y mysql-server

Захистіть встановлення MySQL:

sudo mysql_secure_installation

Створіть базу даних Redmine і користувача:

sudo mysql -u root -p

Усередині оболонки MySQL виконайте наступні команди:

CREATE DATABASE redmine CHARACTER SET utf8mb4;
СТВОРИТИ КОРИСТУВАЧА 'redmine'@'localhost' ІДЕНТИФІКОВАНИЙ ЗА 'strongpassword';
НАДАТИ ВСІ ПРИВІЛЕЇ НА redmine.* користувачу 'redmine'@'localhost';
ЗМИТИ ПРИВІЛЕЇ;
ВИХІД;

Крок 5: Встановіть Redmine

Завантажте та розпакуйте останню стабільну версію Redmine:

cd /var/www/
wget https://www.redmine.org/releases/redmine-5.0.0.tar.gz
sudo tar -xvf redmine-5.0.0.0.tar.gz
sudo mv redmine-5.0.0 redmine
cd redmine

Налаштуйте підключення до бази даних:

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

Змініть розділ MySQL наступним чином:

production:
  adapter: mysql2
  database: redmine
  host: localhost
  username: redmine
  password: "strongpassword"
  encoding: utf8mb4

Крок 6: Встановлення пакунка та залежностей

Запустіть наступні команди для встановлення пакувальника та необхідних камінців:

gem install bundler
bundle install --without development test

Крок 7: Налаштування бази даних

Запустіть наступні команди для ініціалізації бази даних:

bundle exec rake db:migrate RAILS_ENV=production
bundle exec rake redmine:load_default_data RAILS_ENV=production

Крок 8: Налаштування дозволів на файли

Переконайтеся, що Redmine має правильні дозволи:

sudo mkdir -p tmp tmp/pdf public/plugin_assets
sudo chown -R www-data:www-data files log tmp public/plugin_assets
sudo chmod -R 755 files log tmp public/plugin_assets

Крок 9: Запустіть Redmine

Ви можете запустити Redmine за допомогою вбудованого сервера WEBrick:

bundle exec rails server -e production

Або ж налаштуйте Redmine на запуск з Passenger та Apache або Nginx для виробничого використання.

Крок 10: Доступ до Redmine

Відкрийте веб-браузер і перейдіть за адресою

http://your-server-ip:3000

Увійдіть, використовуючи облікові дані за замовчуванням:

  • Ім’я користувача: admin
  • Пароль: admin

Висновок

Ви успішно встановили Redmine на Ubuntu 22.04. Для виробничих середовищ розгляньте можливість налаштування зворотного проксі з Nginx або Apache, включення SSL і налаштування автоматичного резервного копіювання. Тепер Redmine готовий до ефективного управління вашими проектами!