Регистрация

[PHP, PostgreSQL, SQL] Установка Redmine за 15 минут (RVM + RoR + Unicorn + Nginx)

Ответить на тему
Автор Сообщение
news_bot ®

Стаж: 7 лет
Сообщений: 27286

Создавать темы news_bot ® написал(а)
28-Янв-2021 17:33
Цитировать
Эта статья является результатом работы по установке и автономизации работы сервера на базе ОС Linux с Redmine по различным источникам (в том числе и по официальной инструкции), часть команд и последовательность действий были взяты из других источников. Все используемые источники указаны в конце статьи.
ВведениеВ общем задача звучала так: установить Redmine на сервер, где веб-сервер на nginx.Так как Redmine написан на RoR, то необходимо иметь RoR среду, но проблема в том, что разные RoR приложения могут требовать разные версии окружения. В моем случае необходимо было предусмотреть возможность установки RoR приложений с разным окружением, а значит нужен менеджер версий, который будет разворачивать нужную среду в нужном месте.
RVM - менеджер версий сред ruby, начиная от версий интепретатора и заканчивая джемами. Нужен для того чтобы запускать разные RoR приложения на одном сервере, которые могут требовать разные среды исполнения.
Также хотелось классический вариант веб-сервера на nginx. Однако, nginx не знает как исполнять приложение, и в данном случае выступает в качестве прокси на исполняющий веб-сервер RoR приложения.
Unicorn - веб-сервер для Rack (и RoR в том числе) приложений. Почему-то мне не захотелось использовать passenger, наверное потому что nginx должен быть скомпилирован с passenger, то есть не чистый nginx. А еще потому что Unicorn может быть свой для каждого RoR приложения, а не один глобальный.
Теперь задача становится более ясной: установить Redmine на сервер, развернув стек RoR+Unicorn+Nginx, с автоматическим запуском.ПодготовкаОтключение ipv6 Примечание: необязательно, написал потому что мне надо было решить проблему :)Установив на VPS Ubuntu 16.04 при попытке apt-get install не мог получить данные по ipv6:
0% [Connecting to archive.ubuntu.com (2001:67c:1562::15)]
Решение: отключить ipv6 добавив соответствующую информацию в /etc/sysctl.conf:
echo '' >> /etc/sysctl.conf
echo 'net.ipv6.conf.all.disable_ipv6 = 1' >> /etc/sysctl.conf
echo 'net.ipv6.conf.default.disable_ipv6 = 1' >> /etc/sysctl.conf
echo 'net.ipv6.conf.lo.disable_ipv6 = 1' >> /etc/sysctl.conf
sysctl -p
Установка общего софтаcurl для установки RVM (Ruby Version Manager):
apt-get install curl
Примечание: остальное необязательно если читатель пользуется другим софтом для этих дел :)Midnight Commander (файловый менеджер):
apt-get install mc
Nano (файловый менеджер):
apt-get install nano
УстановкаПолучение RedmineНа данный момент самая свежая стабильная версия Redmine 4.1.1. Заходим в директорию /opt/ скачиваем туда архив, распаковываем переименовываем в redmine и удаляем архив:
wget --no-check-certificate https://www.redmine.org/releases/redmine-4.1.1.tar.gz
tar xvzf redmine-4.1.1.tar.gz
mv redmine-4.1.1 redmine
rm redmine-4.1.1.tar.gz
Теперь путь до Redmine: /opt/redmine/Проверив владельца директории можно увидеть неизвестного юзера 1000, нам надо чтобы директорией владел www-data (чтобы автоматически поднимать сервис от юзера www-data):
chown -R www-data /opt/redmine/
PostgreSQL
Этот раздел нужен только если Вы выбрали в качестве СУБД PostgreSQL!
Здесь все просто, делаем как написано в официальной инструкции по установке redmine - устанавливаем PostgreSQL версии >9.2.Проверим текущую версию пакета в репозитории:
apt policy postgresql
Получаем:
postgresql:
  Installed: (none)
  Candidate: 9.5+173ubuntu0.3
  Version table:
     9.5+173ubuntu0.3 500
        500 http://archive.ubuntu.com/ubuntu xenial-updates/main amd64 Packages
        500 http://security.ubuntu.com/ubuntu xenial-security/main amd64 Packages
     9.5+173 500
        500 http://archive.ubuntu.com/ubuntu xenial/main amd64 Packages
Если все нормально двигаемся дальше, иначе ищем способ установить нужную версию пакета.
apt install postgresql
Теперь нужно зайти на сервер PostgreSQL (чтобы зайти надо сменить юзера терминала, потому что только юзер postgres может в psql), создать пользователя и базу данных:
sudo -i -u postgres
#Или su postgres
psql
CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'password' NOINHERIT VALID UNTIL 'infinity';
CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine;
ALTER DATABASE "redmine" SET datestyle="ISO,MDY";
Для выхода надо ввести \q
На работе уже использовалась СУБД PostgreSQL, в тоже место предполагалось ставить GitLab (он работает с PostgreSQL), поэтому здесь сделал так.
My SQL
Этот раздел нужен только если Вы выбрали в качестве СУБД MySQL!
Установка сервера MySQL:
apt-get install mysql-server
Вход в mysql:
mysql -u root -p
Действия с MySQL < 8.0 такие же как в официальной инструкции redmine, создать базу данных и пользователя, назначив ему полные привилегии:
CREATE DATABASE redmine CHARACTER SET utf8mb4;
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';
Однако, в MySQL >= 8.0 для пользователя необходимо использовать старый метод аутентификации mysqlnativepassword (и вот еще ссылка):
ALTER USER 'redmine'@'localhost' IDENTIFIED WITH mysql_native_password BY 'password';
У меня в одном проекте уже использовалась СУБД MySQL 8, поэтому решил поставить с использованием MySQL.
RVMСначала надо установить gnupg2 и установить проверочные ключи для установки RVM:
apt install gnupg2
gpg2 --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB
Теперь в директорию /opt/ надо скачать rvm скрипт:
curl -sSL https://get.rvm.io -o rvm.sh
Или так:
wget --output-document=rvm.sh https://get.rvm.io
Затем установка самого RVM (из директории /opt/):
cat rvm.sh | bash -s stable --rails
После установки RVM будет создана новая группа rvm, в которую надо поместить пользователя www-data (чтобы от него запускать RVM):
usermod -a -G rvm www-data
Окружение Ruby On Rails для текущей сессии терминала можно установить так (а можно и по другому):
source /usr/local/rvm/scripts/rvm
На данный момент мы скачали самую последнюю стабильную версию Redmine 4.1.1, которая требует версию Ruby [2.3, 2.6]. Узнаем что есть в RVM:
rvm list known
Вывод достаточно большой, но нас интересует именно это:
[ruby-]1.8.6[-p420]
[ruby-]1.8.7[-head] # security released on head
[ruby-]1.9.1[-p431]
[ruby-]1.9.2[-p330]
[ruby-]1.9.3[-p551]
[ruby-]2.0.0[-p648]
[ruby-]2.1[.10]
[ruby-]2.2[.10]
[ruby-]2.3[.8]
[ruby-]2.4[.9]
[ruby-]2.5[.7]
[ruby-]2.6[.5]
[ruby-]2.7[.0]
Последняя версия Ruby 2.6.5, установим ее и назначим использовать по умолчанию:
rvm install 2.6.5
rvm use 2.6.5
Создадим окружение для Redmine:
rvm gemset create redmine
echo "rvm use ruby-2.6.5@redmine" > /opt/redmine/.rvmrc
Теперь при входе в директорию /opt/redmine/ через терминал, для этой директории будет установлено окружение ruby-2.6.5@redmine:
Using /usr/local/rvm/gems/ruby-2.6.5 with gemset redmine
Настройка и тестовый запуск RedmineНастройка базы данныхФайл /opt/redmine/config/database.yml.sample является примером как должен выглядеть конфиг подключения к БД. Создадим конфиг:
touch /opt/redmine/config/database.yml
Запишем в конфиг данные для работы с БД:
production:
  adapter: postgresql
  database: redmine
  host: localhost
  username: redmine
  password: password
Сборка зависимостей и решение проблемТеперь надо собрать все зависимости RoR приложения:
bundle
При сборке RoR приложения в разных условиях могут возникать разные проблемы.
Используя PostgreSQL в качестве СУБД команда bundle может закончится ошибкой связанной с модулем pg:
Gem::Ext::BuildError: ERROR: Failed to build gem native extension.
...
Gem files will remain installed in /usr/local/rvm/gems/ruby-2.6.5/gems/pg-1.1.4
for inspection.
Results logged to
/usr/local/rvm/gems/ruby-2.6.5/extensions/x86_64-linux/2.6.0/pg-1.1.4/gem_make.out
An error occurred while installing pg (1.1.4), and Bundler cannot
continue.
Make sure that gem install pg -v '1.1.4' --source 'https://rubygems.org/'
succeeds before bundling.
Решение нашел здесь, а именно:
apt-get install libpq-dev
Для MySQL тоже возникает проблема с модулем mysql2 (детали ошибки аналогичны как и для PostgreSQL). Решение нашлось здесь, а именно:
apt-get install build-essential ruby-dev libmysqlclient-dev
Еще была проблема с nokogiri, решение нашел здесь, а именно:
apt-get install build-essential patch ruby-dev zlib1g-dev liblzma-dev
gem install nokogiri
Не забываем опять запустить bundleИнициализация БДТеперь нужно сделать 5-ый, 6-ой и 7-ой шаги: сгенерировать случайный ключ для сессий, создать структуру БД и инициализировать данные в БД:
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
Тестовый запускПробуем запустить Redmine на webrick:
bundle exec rails server webrick -e production
Если запуск прошел успешно, то на 3000 порту можно посмотреть сайт (localhost:3000 или ip:3000).В продакшене не рекомендуется использовать webrick, поэтому двигаемся дальше.UnicornВ /opt/redmine/GemFile запишем зависимость:
gem 'unicorn'
Создадим конфигурационный файл для unicorn:
touch /opt/redmine/config/unicorn.rb
И вставляем туда текст конфига:
# установка путей до приложения
app_dir = File.expand_path("../..", __FILE__)
shared_dir = "#{app_dir}/shared"
working_directory app_dir
# установка некоторых опций unicorn
worker_processes 2
preload_app true
timeout 30
# сокет файл для доступа nginx
listen "#{shared_dir}/sockets/unicorn.sock", :backlog => 64
# установка файлов логов
stderr_path "#{shared_dir}/log/unicorn.stderr.log"
stdout_path "#{shared_dir}/log/unicorn.stdout.log"
# установка pid файла, который будет сопоставим с процессом unicorn (чтобы по нему определять процесс)
pid "#{shared_dir}/pids/unicorn.pid"
before_fork do |server, worker|
    defined?(ActiveRecord::Base) and
        ActiveRecord::Base.connection.disconnect!
end
after_fork do |server, worker|
    defined?(ActiveRecord::Base) and
        ActiveRecord::Base.establish_connection
end
И опять:
bundle
Создаем директории в соответствии с конфигом и меняем владельца:
mkdir -p /opt/redmine/shared/pids /opt/redmine/shared/sockets /opt/redmine/shared/log
chown -R www-data:rvm shared
Теперь выполнив bundle (если нет ошибок), можно запускать unicorn (из директории /opt/redmine/):
unicorn_rails -c config/unicorn.rb -E production -D
Уничтожить процесс unicorn можно по pid файлу:
pkill -QUIT --pidfile /opt/redmine/shared/pids/unicorn.pid
Или вот еще варианты уничтожения процесса Unicorn.NginxСтавим nginx:
apt-get install nginx
Пишем в конфиг nginx (у меня путь /etc/nginx/nginx.conf), в секцию http (при этом виртуальные хосты должны быть отключены):
upstream redmine {
    server unix:/opt/redmine/shared/sockets/unicorn.sock fail_timeout=0;
}
server {
    listen 80;
    root /opt/redmine/public;
    try_files $uri/index.html $uri @redmine;
    location @redmine {
        proxy_pass http://redmine;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Host $http_host;
        proxy_redirect off;
    }
}
Или вот полный конфиг (для доступа к Redmine по ip адресу):
user www-data;
worker_processes auto;
pid /run/nginx.pid;
include /etc/nginx/modules-enabled/*.conf;
events {
  worker_connections 768;
}
http {
  sendfile on;
  tcp_nopush on;
  tcp_nodelay on;
  keepalive_timeout 65;
  types_hash_max_size 2048;
  server_names_hash_bucket_size 64;
  include /etc/nginx/mime.types;
  default_type application/octet-stream;
  # Logging Settings
  access_log /var/log/nginx/access.log;
  error_log /var/log/nginx/error.log;
  # Gzip Settings
  gzip on;
  upstream redmine {
    server unix:/opt/redmine/shared/sockets/unicorn.sock fail_timeout=0;
  }
  server {
    listen 80;
    root /opt/redmine/public;
    try_files $uri/index.html $uri @redmine;
    location @redmine {
      proxy_pass http://redmine;
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      proxy_set_header Host $http_host;
      proxy_redirect off;
    }
  }
}
Перезагружаем nginx:
service nginx restart
Если nginx запустился без ошибок, то пробуем обратится на сайт по ip адресу (или по localhost), Redmine должно работать.Автозагрузка
Если перезагрузить сервер (или внезапно уничтожить Unicorn), то сам Unicorn автоматически не поднимется, надо это организовать.
Почитать о том, что происходит ниже можно здесь и здесь.Идем в /etc/systemd/system/ и создаем файл redmine.service:
touch /etc/systemd/system/redmine.service
Записываем туда:
[Unit]
Description=redminerun
After=syslog.target network.target
[Service]
Type=forking
PIDFile=/opt/redmine/shared/pids/unicorn.pid
WorkingDirectory=/opt/redmine/
User=www-data
Group=rvm
Environment=RAILS_ENV=production
ExecStart=/opt/redmine/config/unicorn_start
ExecReload=/opt/redmine/config/unicorn_reload
ExecStop=/opt/redmine/config/unicorn_stop
OOMScoreAdjust=-100
TimeoutSec=30
Restart=always
RestartSec=20s
[Install]
WantedBy=multi-user.target
Вкратце:
  • PIDFile - pid файл процесса, по которому будет отслеживаться жизнь процесса
  • User и Group - юзер и группа, от которых будет производится запуск
  • ExecStart - команда запуска
  • ExecReload - команда перезагрузки
  • ExecStop - команда остановки
  • RestartSec - рестартовать процесс через N времени в случае если процесс отвалился
ExecStart, ExecReload, ExecStop могут быть путями до bash скриптов. Именно так и было мной сделано (потому что прежде выполнения команд старта/перезагрузки необходимо было разворачивать окружение, сделать это в файле конфига не представлялось возможным :))Создаем файлы скрипты в /opt/redmine/config/ меняем владельца и группу, и ставим права на запуск:
cd /opt/redmine/config/
touch unicorn_start unicorn_reload unicorn_stop
chown www-data:rvm unicorn_*
chmod +x unicorn_*
unicorn_start для запуска unicorn (запускаем rvm, переходим в директорию с redmine - установится нужное окружение, запускаем unicorn):
#!/bin/bash -
source /usr/local/rvm/scripts/rvm
cd /opt/redmine/
unicorn_rails -c config/unicorn.rb -E production -D
unicorn_stop для остановки сервиса:
#!/bin/bash -
pkill -QUIT --pidfile /opt/redmine/shared/pids/unicorn.pid
unicorn_reload для перезапуска сервиса (останавливаем и запускаем):
#!/bin/bash -
/opt/redmine/config/unicorn_stop
/opt/redmine/config/unicorn_start
Теперь просмотрев статус сервиса можно увидеть:
systemctl status redmine
● redmine.service - redminerun
   Loaded: loaded (/etc/systemd/system/redmine.service; disabled; vendor preset: enabled)
   Active: inactive (dead)
Включаем сервис:
systemctl enable redmine
Теперь можно start/reload/stop.Запустим сервис:
systemctl start redmine
Если запуск произошел успешно, значит все верно настроено, в случае перезагрузки или внезапного падения Unicorn - он будет поднят автоматически!
Источники Автор: Виталий Бутурлин
 ===========
 Источник:
habr.com
===========
Похожие новости: Теги для поиска: #_php, #_postgresql, #_sql, #_mail, #_opencart, #_php, #_javascript, #_bootstrap, #_linux, #_sql, #_wordpress, #_woocommerce, #_ajax, #_php, #_postgresql, #_sql
Профиль  ЛС 
Показать сообщения:     
Ответить на тему

Вы не можете начинать темы
Вы не можете отвечать на сообщения
Вы не можете редактировать свои сообщения
Вы не можете удалять свои сообщения
Вы не можете голосовать в опросах
Вы не можете прикреплять файлы к сообщениям
Вы не можете скачивать файлы

Текущее время: 16-Фев 20:15
Часовой пояс: UTC + 5