Встановлення Redmine на VPS для

Конфігурація

Після встановлення основних компонентів необхідно налаштувати їх для стабільної та безпечної роботи Redmine. Це включає налаштування Nginx як зворотного проксі, запуск Puma як системного сервісу та увімкнення HTTPS.

1. Налаштування Puma як системного сервісу (systemd)

Щоб Redmine запускався автоматично при старті сервера та працював у фоновому режимі, ми налаштуємо Puma як сервіс systemd.

Створіть файл сервісу для Puma:

sudo nano /etc/systemd/system/redmine.service # Створення нового файлу сервісу

Вставте наступний вміст, замінивши redmineuser на ім'я вашого користувача, а /var/www/redmine на шлях до вашої інсталяції Redmine:

[Unit]
Description=Puma HTTP Server for Redmine
After=network.target postgresql.service

[Service]
Type=simple
User=redmineuser
Group=redmineuser
WorkingDirectory=/var/www/redmine
Environment=RAILS_ENV=production
ExecStart=/home/redmineuser/.rvm/bin/rvm-auto-ruby bundle exec puma -C /var/www/redmine/config/puma.rb
ExecReload=/bin/kill -s HUP $MAINPID
TimeoutSec=15
RestartSec=2
Restart=on-failure

[Install]
WantedBy=multi-user.target

Збережіть та закрийте файл.

Тепер створіть файл конфігурації Puma config/puma.rb:

nano /var/www/redmine/config/puma.rb # Створення файлу конфігурації Puma

Вставте наступний вміст:

# config/puma.rb
# Замініть 'redmineuser' на ім'я вашого користувача
# Замініть '/var/www/redmine' на шлях до вашої інсталяції Redmine

workers Integer(ENV['WEB_CONCURRENCY'] || 2)
threads_count = Integer(ENV['RAILS_MAX_THREADS'] || 5)
threads threads_count, threads_count

rackup DefaultRackup
port        ENV['PORT']     || 3000
environment ENV['RACK_ENV'] || 'production'

pidfile    "/var/www/redmine/tmp/pids/puma.pid"
state_path "/var/www/redmine/tmp/pids/puma.state"
stdout_redirect "/var/www/redmine/log/puma.stdout.log", "/var/www/redmine/log/puma.stderr.log", true

# On workers boot
on_worker_boot do
  ActiveRecord::Base.establish_connection if defined?(ActiveRecord)
end

# Allow puma to be restarted by rails restart command.
plugin :tmp_restart

Збережіть та закрийте файл.

Перезавантажте systemd, увімкніть та запустіть сервіс Redmine:

sudo systemctl daemon-reload           # Перезавантаження конфігурації systemd
sudo systemctl enable redmine.service  # Увімкнення автозапуску сервісу Redmine
sudo systemctl start redmine.service   # Запуск сервісу Redmine
sudo systemctl status redmine.service  # Перевірка статусу сервісу

Переконайтеся, що сервіс запущено та він не містить помилок. Вивід має бути зеленим "active (running)".

2. Налаштування Nginx як зворотного проксі

Встановіть Nginx, якщо його ще не встановлено:

sudo apt install nginx -y # Встановлення Nginx

Створіть новий файл конфігурації Nginx для Redmine:

sudo nano /etc/nginx/sites-available/redmine.conf # Створення файлу конфігурації Nginx

Вставте наступний вміст, замінивши your_domain.com на ваш домен:

upstream redmine {
    server unix:///var/www/redmine/tmp/sockets/puma.sock fail_timeout=0;
    # Або, якщо Puma слухає TCP-порт:
    # server 127.0.0.1:3000;
}

server {
    listen 80;
    server_name your_domain.com; # Замініть на ваш домен
    return 301 https://$host$request_uri; # Перенаправлення HTTP на HTTPS
}

server {
    listen 443 ssl http2;
    server_name your_domain.com; # Замініть на ваш домен

    ssl_certificate /etc/letsencrypt/live/your_domain.com/fullchain.pem; # Буде створено Certbot
    ssl_certificate_key /etc/letsencrypt/live/your_domain.com/privkey.pem; # Буде створено Certbot
    ssl_session_timeout 1d;
    ssl_session_cache shared:SSL:10m;
    ssl_session_tickets off;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384';
    ssl_prefer_server_ciphers on;

    root /var/www/redmine/public; # Шлях до public директорії Redmine

    access_log /var/log/nginx/redmine_access.log;
    error_log /var/log/nginx/redmine_error.log;

    location / {
        try_files $uri @redmine;
    }

    location @redmine {
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Host $http_host;
        proxy_redirect off;
        proxy_pass http://redmine; # Використовуємо upstream redmine
    }

    error_page 500 502 503 504 /500.html;
    client_max_body_size 100M; # Максимальний розмір завантажуваних файлів
    keepalive_timeout 10;
}

Збережіть та закрийте файл. Активуйте конфігурацію, створивши символічне посилання та видаливши стандартну:

sudo ln -s /etc/nginx/sites-available/redmine.conf /etc/nginx/sites-enabled/ # Створення символічного посилання
sudo rm /etc/nginx/sites-enabled/default # Видалення стандартної конфігурації Nginx
sudo nginx -t                          # Перевірка синтаксису конфігурації Nginx
sudo systemctl restart nginx           # Перезапуск Nginx

Якщо Puma налаштований на сокет, то в config/puma.rb потрібно додати рядок bind "unix:///var/www/redmine/tmp/sockets/puma.sock" та переконатися, що директорія tmp/sockets існує і має потрібні права.

mkdir -p /var/www/redmine/tmp/sockets
chmod 777 /var/www/redmine/tmp/sockets # Тимчасово для тестування, пізніше можна обмежити

3. Налаштування TLS/HTTPS за допомогою Certbot

Настійно рекомендується використовувати HTTPS для захисту трафіку. Ми скористаємося Certbot для отримання безкоштовних SSL/TLS сертифікатів від Let's Encrypt.

sudo apt install certbot python3-certbot-nginx -y # Встановлення Certbot та плагіна для Nginx
sudo certbot --nginx -d your_domain.com           # Отримання та встановлення сертифіката (замініть домен)

Certbot автоматично змінить вашу конфігурацію Nginx для використання HTTPS та налаштує автоматичне продовження сертифікатів. Дотримуйтесь інструкцій на екрані. Переконайтеся, що ваш домен вже вказує на IP-адресу вашого VPS.

4. Перевірка працездатності

Відкрийте ваш домен (https://your_domain.com) у браузері. Ви повинні побачити сторінку входу в Redmine. За замовчуванням ім'я користувача: admin, пароль: admin. Обов'язково змініть його при першому вході.

Ви також можете перевірити доступність за допомогою curl:

curl -I https://your_domain.com # Перевірка HTTP-заголовків

Переконайтеся, що статус HTTP 200 OK. Якщо виникли проблеми, перевірте логи Nginx (/var/log/nginx/error.log) та Puma/Redmine (/var/www/redmine/log/puma.stderr.log або /var/www/redmine/log/production.log).

Резервне копіювання та обслуговування

Регулярне резервне копіювання та своєчасне обслуговування є критично важливими для будь-якої production-системи, включно з Redmine. Це дозволить уникнути втрати даних та забезпечити стабільну роботу.

1. Що резервувати

Для повного відновлення Redmine вам знадобляться три основні компоненти:

1. База даних Redmine: Містить усі завдання, проєкти, користувачів, налаштування та інші структуровані дані.
2. Директорія files: Зберігає всі прикріплені файли, зображення та документи, завантажені користувачами.
3. Файли конфігурації Redmine: Ключові файли, такі як config/database.yml, config/configuration.yml (для налаштувань пошти та інших опцій) та config/initializers/secret_token.rb.

2. Простий скрипт авторезервного копіювання

Створимо простий Bash-скрипт, який виконуватиме резервне копіювання цих компонентів. Створіть директорію для резервних копій та сам скрипт.

sudo mkdir -p /var/backups/redmine # Створення директорії для зберігання резервних копій
sudo chown redmineuser:redmineuser /var/backups/redmine # Зміна власника
nano /home/redmineuser/redmine_backup.sh # Створення скрипта резервного копіювання

Вставте наступний вміст у скрипт, замінивши redmine_user, redmine_db, /var/www/redmine та /var/backups/redmine на свої значення.

#!/bin/bash

# Змінні
DB_USER="redmine_user"
DB_NAME="redmine_db"
REDMINE_ROOT="/var/www/redmine"
BACKUP_DIR="/var/backups/redmine"
TIMESTAMP=$(date +%Y%m%d%H%M%S)

# Створення директорії для поточної резервної копії
CURRENT_BACKUP_DIR="$BACKUP_DIR/$TIMESTAMP"
mkdir -p "$CURRENT_BACKUP_DIR"

echo "Починаємо резервне копіювання Redmine в $CURRENT_BACKUP_DIR..."

# 1. Резервне копіювання бази даних PostgreSQL
echo "Дамп бази даних..."
sudo -u postgres pg_dump -Fc "$DB_NAME" > "$CURRENT_BACKUP_DIR/redmine_db.dump"
if [ $? -eq 0 ]; then
    echo "Дамп бази даних успішно створено."
else
    echo "Помилка при створенні дампа бази даних."
fi

# 2. Резервне копіювання директорії files
echo "Копіювання файлів..."
rsync -a "$REDMINE_ROOT/files" "$CURRENT_BACKUP_DIR/"
if [ $? -eq 0 ]; then
    echo "Файли успішно скопійовано."
else
    echo "Помилка при копіюванні файлів."
fi

# 3. Копіювання файлів конфігурації
echo "Копіювання конфігураційних файлів..."
cp "$REDMINE_ROOT/config/database.yml" "$CURRENT_BACKUP_DIR/"
cp "$REDMINE_ROOT/config/configuration.yml" "$CURRENT_BACKUP_DIR/"
cp "$REDMINE_ROOT/config/initializers/secret_token.rb" "$CURRENT_BACKUP_DIR/"
if [ $? -eq 0 ]; then
    echo "Конфігураційні файли успішно скопійовано."
else
    echo "Помилка при копіюванні конфігураційних файлів."
fi

# 4. Видалення старих резервних копій (наприклад, старших за 7 днів)
echo "Видалення старих резервних копій (старших за 7 днів)..."
find "$BACKUP_DIR" -maxdepth 1 -mtime +7 -exec rm -rf {} \;
echo "Резервне копіювання завершено."

Зробіть скрипт виконуваним:

chmod +x /home/redmineuser/redmine_backup.sh # Робимо скрипт виконуваним

3. Налаштування Cron для автоматичного запуску резервного копіювання

Додайте скрипт до планувальника Cron, щоб він запускався автоматично, наприклад, щодня о 3:00 ночі.

crontab -e # Відкриття crontab для поточного користувача

Додайте наступний рядок у кінець файлу:

0 3 * * * /home/redmineuser/redmine_backup.sh >> /var/log/redmine_backup.log 2>&1

Цей рядок означає: "Щодня о 3 годині 0 хвилин запускати скрипт і перенаправляти його вивід у лог-файл".

4. Куди зберігати резервні копії

Зберігати резервні копії на тому ж сервері, що й робоча система, ризиковано. Якщо сервер вийде з ладу, ви втратите і систему, і резервні копії. Рекомендується використовувати зовнішні сховища:

• S3-сумісне сховище: Такі сервіси, як AWS S3, Backblaze B2, DigitalOcean Spaces. Ви можете використовувати утиліти типу s3cmd або rclone для автоматичного завантаження резервних копій.
• Окремий VPS: Орендуйте невеликий VPS виключно для зберігання резервних копій та синхронізуйте їх туди по SSH/rsync.
• Локальний NAS/сервер: Якщо у вас є власна інфраструктура, можна налаштувати синхронізацію з нею.

Наприклад, для відправки на S3 можна додати в скрипт рядок, що використовує aws cli або rclone після створення локальної резервної копії.

5. Оновлення: Rolling vs. Maintenance Window

Підтримання Redmine та базового ПЗ в актуальному стані важливе для безпеки та отримання нових функцій.

• Оновлення ОС та системних пакетів: Рекомендується застосовувати оновлення безпеки регулярно (раз на тиждень/місяць) у "вікно обслуговування" (maintenance window), коли навантаження на сервер мінімальне.

  
  sudo apt update && sudo apt upgrade -y # Оновлення системних пакетів
  sudo apt autoremove -y # Видалення непотрібних пакетів
  

• Оновлення Ruby: Оновлення Ruby мають бути ретельно протестовані, оскільки вони можуть вплинути на роботу Redmine. Використовуйте RVM для встановлення нової версії Ruby, протестуйте Redmine з нею, потім переключіться.
• Оновлення Redmine:
  • Завжди робіть повну резервну копію перед оновленням Redmine.
  • Зупиніть сервіс Redmine (sudo systemctl stop redmine.service).
  • Завантажте нову версію Redmine, розпакуйте її, скопіюйте файли (крім files, config, plugins).
  • Оновіть геми (bundle install --without development test).
  • Виконайте міграції бази даних (bundle exec rake db:migrate RAILS_ENV=production).
  • Запустіть сервіс Redmine (sudo systemctl start redmine.service).

Плануйте оновлення Redmine як окремі проєкти, бажано спочатку протестувавши їх на стейджинг-сервері.

Troubleshooting + FAQ

У цьому розділі зібрані відповіді на часто задавані питання та рішення типових проблем, які можуть виникнути при встановленні та експлуатації Redmine на VPS.

1. Redmine не запускається або видає помилку 502 Bad Gateway з Nginx. Що перевіряти?

Помилка 502 Bad Gateway зазвичай означає, що Nginx не може зв'язатися з бекенд-додатком (Puma). Це може бути викликано кількома причинами:

• Puma не запущено: Перевірте статус сервісу Puma: sudo systemctl status redmine.service. Якщо він неактивний, подивіться логи Puma: journalctl -u redmine.service або /var/www/redmine/log/puma.stderr.log.
• Неправильна конфігурація Nginx: Переконайтеся, що proxy_pass у конфігурації Nginx вказує на правильну адресу/сокет Puma (наприклад, http://127.0.0.1:3000 або unix:///var/www/redmine/tmp/sockets/puma.sock). Перевірте синтаксис Nginx: sudo nginx -t.
• Проблеми з дозволами: Переконайтеся, що користувач Nginx (зазвичай www-data) має доступ до сокета Puma, якщо ви використовуєте сокет.
• Проблеми з базою даних: Якщо Puma запускається, але відразу падає, можливо, Redmine не може підключитися до бази даних. Перевірте config/database.yml і переконайтеся, що PostgreSQL запущено (sudo systemctl status postgresql).

2. Як налаштувати відправку пошти з Redmine?

Для відправки сповіщень з Redmine (наприклад, про нові завдання або коментарі) необхідно налаштувати параметри SMTP. Відредагуйте файл config/configuration.yml (якщо його немає, скопіюйте configuration.yml.example):

# config/configuration.yml
default:
  email_delivery:
    delivery_method: :smtp
    smtp_settings:
      address: "smtp.your-email-provider.com" # Наприклад, smtp.mail.ru, smtp.gmail.com
      port: 587 # Або 465 для SSL
      authentication: :plain
      domain: "your_domain.com" # Ваш домен
      user_name: "noreply@your_domain.com" # Ваш email
      password: "your_email_password" # Пароль від пошти
      enable_starttls_auto: true

Після збереження файлу перезапустіть сервіс Redmine (Puma): sudo systemctl restart redmine.service. Перевірте відправку тестового листа в налаштуваннях Redmine (Адміністрування -> Налаштування -> Сповіщення електронною поштою).

3. Який VPS-конфіг мінімально підійде для Redmine?

Для Redmine та невеликої команди (до 10 користувачів) мінімально рекомендується VPS з 2 ядрами CPU, 4 ГБ оперативної пам'яті та 80 ГБ SSD-диска. Це забезпечить досить комфортну роботу без помітних затримок. Для більших команд або інтенсивного використання варто розглянути 4 ядра CPU та 8 ГБ RAM.

4. Що вибрати — VPS чи dedicated для цього завдання?

Для більшості сценаріїв використання Redmine (невеликі та середні команди, до 50 активних користувачів) VPS буде оптимальним та економічно вигідним рішенням. Dedicated сервер варто обирати, якщо у вас дуже велика команда, вкрай високе навантаження, суворі вимоги до продуктивності та ізоляції ресурсів, або якщо ви плануєте розміщувати безліч інших ресурсоємних сервісів на тому ж фізичному обладнанні.

5. Як оновити Redmine до нової версії?

Процес оновлення Redmine включає кілька кроків:

1. Резервне копіювання: Зробіть повну резервну копію бази даних та директорії files.
2. Зупинка Redmine: sudo systemctl stop redmine.service.
3. Завантаження нової версії: Завантажте новий архів Redmine, розпакуйте його в нову директорію.
4. Копіювання файлів: Скопіюйте ваші config/database.yml, config/configuration.yml, config/initializers/secret_token.rb, а також директорію files та plugins зі старої установки в нову.
5. Встановлення гемів: Перейдіть до нової директорії Redmine та виконайте bundle install --without development test.
6. Міграція бази даних: bundle exec rake db:migrate RAILS_ENV=production.
7. Запуск Redmine: sudo systemctl start redmine.service.

Завжди читайте офіційні інструкції з оновлення для конкретної версії Redmine, оскільки можуть бути специфічні кроки.

6. Чому не відображаються зображення/файли або виникають помилки при їх завантаженні?

Ця проблема найчастіше пов'язана з неправильними правами доступу до директорії files або відсутністю ImageMagick. Перевірте наступне:

• Права доступу: Переконайтеся, що директорія /var/www/redmine/files та весь її вміст доступні для запису користувачем, під яким працює Puma (redmineuser) та Nginx (www-data). Виконайте: sudo chown -R redmineuser:redmineuser /var/www/redmine/files та sudo chmod -R 755 /var/www/redmine/files.
• ImageMagick: Redmine використовує ImageMagick для обробки зображень (наприклад, для прев'ю). Переконайтеся, що його встановлено: sudo apt install imagemagick libmagickwand-dev -y.
• Розмір файлів: Перевірте client_max_body_size у конфігурації Nginx. Якщо намагаєтеся завантажити файл більшого розміру, ніж дозволено, Nginx може відхилити запит.

7. Як змінити порт, на якому працює Puma?

За замовчуванням Puma прослуховує порт 3000. Щоб змінити його, відредагуйте файл /var/www/redmine/config/puma.rb та змініть рядок port ENV['PORT'] || 3000 на бажаний порт, наприклад: port 3001. Потім перезапустіть сервіс Redmine: sudo systemctl restart redmine.service. Не забудьте оновити конфігурацію Nginx, якщо ви використовуєте TCP-порт замість сокета.

Висновки та наступні кроки

Вітаємо! Ви успішно встановили та налаштували Redmine на вашому VPS, створивши надійну та повністю контрольовану платформу для управління проєктами та відстеження завдань. Тепер ваша команда може ефективно співпрацювати, відстежувати прогрес та досягати цілей, маючи повний контроль над своїми даними та інструментами.

Щоб максимально використати потенціал вашої нової системи, розгляньте наступні кроки:

• Інтеграція з системами контролю версій: Налаштуйте інтеграцію Redmine з вашими репозиторіями Git або SVN для автоматичного зв'язування комітів із завданнями та перегляду змін прямо з Redmine.
• Встановлення плагінів: Вивчіть обширну бібліотеку плагінів Redmine для розширення функціональності, такої як додаткові звіти, діаграми, інтеграції з іншими сервісами або покращення користувацького інтерфейсу.
• Моніторинг продуктивності: Впровадьте інструменти моніторингу (наприклад, Prometheus + Grafana) для відстеження завантаження сервера, використання пам'яті та диска, а також продуктивності самого Redmine, щоб своєчасно реагувати на потенційні проблеми.