Установка Redmine + Nginx + Thin на Debian 8 Jessie

Эта заметка по большей части копирует мою же заметку об установке redmine в Debian Wheezy, за некоторыми исключениями.
Во-первых, с выходом Debian Jessie успела обновиться версия Redmine.
Во-вторых, в этой версии Debian по-умолчанию стоит Apache 2.4, который заметно отличается от Apache 2.2, что делает их конфигурационные файлы несовместимыми. Наткнувшись на данную проблему, я решил, что это будет отличным поводом полностью и окончательно перейти на Nginx.

Устанавливать будем Redmine в виртуальной машине на хостинге Digital Ocean под управлением ОС Debian GNU/Linux 8.0 Jessie, а также, дополним его парой полезных “в хозяйстве” плагинов и тем оформления.

В интернете масса инструкций об установке редмайна в Debian. Однако с ними всеми возникают какие-то проблемы. Связанные то с различием в версиях Redmine (между той, которую пытаешься установить и той, о которой написан мануал), то с недостатком в системе пакетов, которые были у писателя мануала, и он просто не обратил на них внимания, то с неправильной фазой луны…
Моя предыдущая инструкция – не исключение, попытавшись провернуть её в Debian Jessie я сам же наткнулся на проблемы в настройке сервера Apache.

Обойдёмся без длинного предисловия, объясняющего, почему будем ставить redmine с нуля, а не пользоваться готовым образом, предоставляемым DigitalOcean, я это уже писал 🙂

В ходе этой установки я пользовался официальными мануалами с сайта redmine.org.


Кстати, если у вас нет аккаунта в DigitalOcean вы можете создать его и получить 10 долларов если пройдёте по этой реф-ссылке: https://www.digitalocean.com/?refcode=e5a7f5c338ab

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

Нужен дроплет созданный в Digital Ocean с операционной системой Debian 8.0, 64 битной (в моём случае). Для 32-битных систем разницы быть не должно.

Допустим у нас есть недавно созданный дроплет, (либо уже давно, возможно идея установить Redmine пришла когда рабочий сервер уже был). Мощность значения не имеет. Работать будет даже на тарифе в $5, правда чем дешевле – тем медленнее.

Желательно, чтобы к вашему IP-адресу был привязан какой-нибудь домен, а также его поддомены. В моём случае это mihanentalpo.me, а в качестве доменного имени для редмайна я буду использовать redmine.mihanentalpo.me

И еще, для Email-уведомлений, отправляемых Redmine’ом, вам понадобится учетная запись почты, например на Яндекс-почте (в примере я буду рассматривать её).

Кстати, если воспользоваться Яндекс-почтой для доменов, там же в комплекте есть и DNS-сервер, который позволит управлять привязками доменных имен к вашему IP.

2. Установка необходимого ПО

2.1 Установим nginx в качестве фронт-веб-сервера, который будет отображать наш thin-сервер с redmine’ом во внешний мир.

Здесь и далее, все команды выполняются от имени root, если не указано другое.

apt-get update
apt-get install nginx

2.2 Установим MySql в качестве сервера баз данных, его клиент, и заголовочные файлы клиента для компиляции некоторых библиотек необходимых Redmine’у

apt-get install mysql-server mysql-client libmysqlclient-dev

При установке (если у вас еще не было до этого установленного mysql-сервера), установщик попросит создать пароль для пользователя root mysql-сервер. Очень советую придумать хороший пароль, и где-нибудь записать его, например в KeePassX, ну или просто не забыть.

2.3 Установим еще пару девелоперских пакетов (содержащих заголовочные файлы для компиляции), они потянут за собой еще огромную кучу пакетов – придется согласиться

apt-get install libmagickcore-dev libmagickwand-dev

2.4 Установим пакет для сборки а также imagemagick (по информации в комментариях, эти пакеты не всегда ставятся автоматически)

apt-get install imagemagick build-essential

3. Установка самого Redmine

3.1 Зайдем на сайт редмайна

Заглянем на страницу http://www.redmine.org/projects/redmine/wiki/Download и посмотрим там ссылку на последнюю версию. В моём случае это версия 2.6.7, доступная по ссылке https://redmine.org/releases/redmine-2.6.7.tar.gz (нам нужна именно tar.gz)

3.2 Скачаем, распакуем и положим в /usr/local/share

cd /tmp
mkdir redmine
cd redmine
wget https://redmine.org/releases/redmine-2.6.7.tar.gz
tar -zxvf ./redmine-2.6.7.tar.gz
mv ./redmine-2.5.1 /usr/local/share/redmine

3.3 Ставим Ruby и всё что нужно для сборки компонентов редмайна (также, потянут за собой много всего):

apt-get install ruby ruby-dev rubygems libruby

3.4 Устанавливаем bundler – это менеджер зависимостей для приложений ruby, он позволяет для каждого приложения устанавливать из репозитория ruby-пакетов именно те версии, которые нужны приложению.

gem install bundler

gem – это программа, являющаяся интерфейсом для пакетного менеджера RubyGems. Это примерно тоже самое для ruby, что apt-get для Debian в целом.

3.5 Пришло время установить все ruby-пакеты (в ruby они называются “Gems” – камни самоцветы).

Но прежде чем мы будем это делать, добавим в список пакетов новый пакет – thin – это веб-сервер написанный на Ruby, который мы будем использовать в качестве бэкэнд-сервера.

Итак:
3.5.1 Открываем /usr/local/share/redmine/Gemfile (в нём хранится список gem-ов, которые надо установить).

nano /usr/local/share/redmine/Gemfile

3.5.2 Добавляем в файл нужную строку

Сначала находим строку с текстом вроде
[ruby] gem "awesome_nested_set", "2.1.6"
[/ruby] и сразу за ней добавляем строку:
[ruby] gem "thin"
[/ruby]

Эта строка позволит при установке автоматически установить и сервер thin

3.5.3 Запускаем установку всех необходимых Redmine’у пакетов-gem’ов:

gem "awesome_nested_set", "2.1.6"

Данная команда означает установить все Gem’ы, которые описаны в файле redmine/Gemfile кроме “test”, “postresql”, “sqlite”. Если вы хотите использовать в качестве базы данных PostgreSql или Sqlite – соответственно, нужно будет написать –without mysql, а вашу базу как раз оставить.

В конце установки должно появиться сообщение:
Your bundle is complete!

Если не появилось, придётся читать ошибки и разбираться что явилось их причиной.

3.6 Создаём базу данных для редмайна

Подключаемся к mysql:

gem "thin"

Создаём базу:

[sql] CREATE DATABASE redmine CHARACTER SET utf8;
[/sql]

Создаём пользователя, и даём ему все права на базу:

[sql] CREATE USER ‘redmine’@’localhost’ IDENTIFIED BY ‘ДлИнНыЙиСлОжНыЙпАрОлЬ’;
GRANT ALL PRIVILEGES ON redmine.* TO ‘redmine’@’localhost’;
[/sql]

Отключаемся:
[sql] exit;
[/sql]

3.7 Настроим редмайн на созданную нами базу данных:

(предполагается что мы всё еще в папке /usr/local/share/redmine)

cd /usr/local/share/redmine
bundle install --without development test postgresql sqlite

В папке config/ лежал файл с примерами настройки, мы взяли его за основу.

Открываем файл простейшим редактором:
Внимание! Если вы еще не знаете, что это за формат такой “yml”, вот здесь можно про него узнать: http://ru.wikipedia.org/wiki/YAML, а пока скажу лишь главное – пробелы и табуляции имеют значение!

mysql -uroot -p

Находим такие вот примерно строчки:

[code] production:
adapter: mysql2
database: redmine
host: localhost
username: root
password: ""
encoding: utf8
[/code]

и соответственно меняем их, в данном случае, так как база у нас и правда называется redmine, сервер и правда называется localhost, а тип сервера и правда mysql, нужно вписать только username: redmine и password: “ваш сложный пароль для пользователя redmine”.

3.8 Сгенерируем секретный ключ для хэширования сессий:

CREATE DATABASE redmine CHARACTER SET utf8;

При этом выскакивает ошибка:

Could not find gem ‘mysql2 (~> 0.3.11) ruby’ in the gems available on this machine.
Run `bundle install` to install missing gems.

Это означает, что нет пакета-Gem’а “mysql2”. Установим его отдельно:

CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'ДлИнНыЙиСлОжНыЙпАрОлЬ';
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';

После чего повторим:

exit;

rake – это “Ruby make”, то есть утилита аналогичная make. Также как make использует для работы Makefile, также rake использует Rakefile. То есть это – интерпретатор Rakefile, содержащий скрипты установки (и возможно, удаления) программ написанных на Ruby.

3.9 Выполним набор миграций, создающих базу данных
Перед запуском rake мы запишем в переменную окружения RAILS_ENV значение production, чтобы rake знал, о каком окружении идёт речь. Ведь у редмайна их целых 3 – development, production, и test.

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

Если всё верно – покажется множество надписей символизирующих изменения, вносимые в базу данных миграциями.
После этого запустим миграцию, заполняющую базу начальными данными (ведь база то еще пустая)

# nano config/database.yml

При запуске скрипт попросит выбрать язык, для русского выбираем “ru”.

Выполняем шифрацию паролей, хранящихся в базе данных (хотя их там пока не много, только один)

# rake generate_secret_token

4. Проверяем, работает ли редмайн с помощью тестового веб-сервер webrick:

Из той же папки /usr/local/share/redmine запускаем:

# gem install mysql2

После этого появятся сообщения вроде этих:

=> Booting WEBrick
=> Rails 3.2.17 application starting in production on http://0.0.0.0:3000
=> Call with -d to detach
=> Ctrl-C to shutdown server
[2014-06-26 18:59:41] INFO WEBrick 1.3.1
[2014-06-26 18:59:41] INFO ruby 1.9.3 (2012-04-20) [x86_64-linux] [2014-06-26 18:59:41] INFO WEBrick::HTTPServer#start: pid=27676 port=3000

Это будет означать что сервер запустился на вашем IP-адресе на 3000-м порту.

Пробуем открыть в браузере:
http://domain.com:3000 или http://123.123.123.123:3000 где domain.com – это имя вашего домена, а “123.123.123.123” – это ваш IP адрес. Работать должно и так и эдак – должна открыться синяя страничка редмайна практически без ничего.

После этого в консоли с сервером нажимаем Ctrl+C и больше никогда так не делаем, так как webrick – это сервер исключительно для тестирования, он не выдержит никакой нагрузки, и вполне вероятно имеет уязвимости, которые для тестового сервера не важны, а вот на боевом могут причинить вам ущерб.

5. Настраиваем сервер Thin

5.1 Создадим init-скрипт для thin:

# rake generate_secret_token

эта команда заставляет thin создать скрипт /etc/init.d/thin

5.2 Создадим специального пользователя для Redmine’а и передадим папку редмайна в его пользование:

# RAILS_ENV=production rake db:migrate

5.3 Создадим конфигурационный файл для запуска Redmine:

Создадим файл /etc/thin/redmine.yml и запишем в него:

--- 
pid: tmp/pids/thin.pid
group: redmine
wait: 30
timeout: 30
log: log/thin.log
max_conns: 1024
require: []

environment: production
max_persistent_conns: 512
servers: 1
daemonize: true
user: redmine
socket: /tmp/thin.sock
chdir: /usr/local/share/redmine

этот файл заставляет thin запустить сервер приложения Redmine но подключений ожидать не на каком-то сетевом адресе, а в файле-сокете. К этому файлу мы будем подключать Nginx в качестве фронтэнд-сервера.

5.4 Проверим работоспособность thin-севрера

Запустим сервер командой:

# RAILS_ENV=production rake redmine:load_default_data

Посмотрим, что появилось в лог-файле thin’a:

rake db:encrypt RAILS_ENV=production

В результате должно появиться что-то вроде:

# ruby script/rails server webrick -e production

что означает, что всё в порядке, и сервер работает.

5.5 Добавить thin в автозапуск

Чтобы thin запускался при старте системы, добавим его в автозапуск командой (от рута):

# thin install

(Спасибо за напоминание об этом tolik777)

6. Настраиваем сервер Nginx

6.1 Создаём файл виртуального хоста:

# nano /etc/nginx/sites-available/redmine.mihanentalpo.me

Имя файла лучше сделать соответствующим вашему домену, а он у вас врядли называется как у меня 🙂
В файле помещаем следующие настройки:

# adduser redmine
# chown -hR redmine:redmine /usr/local/share/redmine

Соответственно, директива server_name должна указывать на ваш домен третьего уровня, который вы назначили на Redmine

6.2 “Включаем” сайт:

Для того чтобы указанный выше конфигурационный файл заработал, необходимо чтобы он лежал в папке /etc/nginx/sites-enabled/. Добьемся этого при помощи символической ссылки:

# /etc/init.d/thin start

Проверяем сайт:
Открываем http://redmine.mihanentalpo.me и ….. видим содержимое папки /usr/share/redmine/public, а вовсе не редмайн 🙁 продолжаем битву:

Забыли переименовать файл:

# cat /usr/local/share/redmine/logs/thin.0.log

Вот теперь всё должно работать. Адрес http://redmine.mihanentalpo.me отлично показывает редмайн! Ура!

Поясню, что это такое сейчас было: Для работы приложения нужно, чтобы в папке сервера лежал файл dispatch.fcgi начинающийся с #!/bin/ruby

7. “Готовим” Redmine

Для того, чтобы начать работать с редмайном, осталось всего ничего. Последние настройки.

7.0 Дадим доступ к папкам tmp и files, иначе редмайн откажется редактировать пользователей, загружать файлы (и много чего еще):

Writing PID to tmp/pids/thin.0.pid
Changing process privilege to redmine:redmine
Using rack adapter
Thin web server (v1.6.3 codename Protein Powder)
Maximum connections set to 1024
Listening on /tmp/thin.0.sock, CTRL+C to stop

7.1 Сменим пароль админа

У администратора по умолчанию логин admin и пароль admin. Нужно сменить пароль раньше чем ваш сервер обнаружит какой-нибудь сетевой искатель приключений, знающий о стандартном пароле redmine.

Нажимаем “Вход”, логинимся под admin/admin, после чего переходим по ссылке “Администрирование”, а оттуда в пользователей, где и можно сменить пароль админа, и все остальные его настройки:

  • Рекомендую задать правильный почтовый адрес – пригодится для уведомлений
  • В блоке “Уведомления по email” поставить галку “Не извещать об изменениях, которые я сделал сам”, чтобы не доставать самого себя
  • Также желательно выбрать правильный часовой пояс, на случай, если сервер находится не в одном часовом поясе с вами.

7.2 Настроим почту для отправки уведомлений

В моём случае почта находится на Яндекс-почте для доменов, параметры её таковы:

почта: redmine@mihanentalpo.me
логин: redmine@mihanentalpo.me
пароль: большой и сложный 🙂
сервер: smtp.yandex.ru
порт: 25

Итак, для настройки почты используется файл config/configuration.yml, который, опять же, копируем из файла-примера:

update-rc.d -f thin defaults

В файле много разных примеров настройки почты, какой из них нам подходит я уже не вспомню, но главное, что в случае Яндекс-почты, должно получиться что-то вроде: (отступы важны!)

[code] default:
email_delivery:
delivery_method: :smtp
smtp_settings:
address: "smtp.yandex.ru"
port: 25
authentication: :login
user_name: "redmine@mihanentalpo.me"
password: "SuperPassword"
[/code]

7.3 Теперь выполним настройки приложения Redmine (В разделе “администрирование” ссылка “Настройки” на правой вкладке)

На какие настройки стоит обратить внимание:

Вкладка “Общее”

  • Имя компьютера – его редмайн будет использовать при генерации ссылок в письмах. Надо написать доменное имя, на котором редмайн работает. В моём случае это redmine.mihanentalpo.me

Вкладка “Отображение”

  • Тема – это внешний вид редмайна, сюда мы еще вернёмся
  • Язык по умолчанию – русский, если, конечно, вы не ставите редмайн для нерусских пользователей.

Вкладка “Аутентификация”

  • Необходима аутентификация – если вы настраиваете редмайн для каких-то частных проектов (а не для публичного OpenSource проекта) то эта опция поможет сделать так, чтобы любого неавторизованного пользователя “встречала” форма авторизации, и дальше не пускала.
  • Автоматический вход – позволяет задать время которое будут храниться Куки. От этого зависит, с одной стороны, безопасность, с другой – комфорт работы. Если поставить время больше – реже надо будет вводить логин/пароль, однако увеличивается риск потерять аккаунт в случае, если у вас утащат куки.

Вкладка “Проекты”

  • Главный плюс – позволяет задать для всех проектов функционал по умолчанию.
  • Также можно выбрать трекеры по умолчанию для новых проектов (это “ошибка”, “улучшение”, “поддержка”)

Вкладка “Уведомления по email”
Её содержимое появляется только если заданы настройки отправки почты, которые были описаны ранее. Если их не задать – данная вкладка будет пуста.

  • Исходящий email-адрес задаём таким же каким задавали его в конфигурации (в моём случае redmine@mihanentalpo.me)
  • Следует выбрать “Способ уведомления по умолчанию”
  • Также, стоит отметить галками те события, о которых нужно уведомлять
  • В блоке “Подстрочные примечания письма” можно написать русское пояснение, с указанием правильной ссылки, в моём случае это выглядит так: [code] Вы получили это письмо, поскольку данное уведомление разрешено
    в настройках вашего аккаунта Redmine.
    Чтобы сменить эти настройки вы можете перейти
    по адресу: http://redmine.mihanentalpo.me/my/account
    [/code]

    При это часть ссылки “/my/account” ведет на страницу аккаунта текущего пользователя.

Вкладка “Хранилище” позволяет подключить git-репозиторий (или другой репозиторий исходного кода), который может позволить “красиво” просматривать дерево коммитов, а также закрывать задачи путём дописывания в названиях коммитов определенных ключевых слов. Однако эта настройка выходит за рамки данной статьи, просто потому что мне в моей задаче не требуется привязка репозитория. Может быть в другой раз.

7.4 Установим пару полезных плагинов

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

1) Плагин, автоматически выставляющий 100% завершенность задачи когда ей выставляется статус “Готово”. В противном случае, проценты придется каждый раз выставлять вручную, иначе суммарный процент выполненных задач не будет подсчитываться правильно.

2) Плагин, автоматически сохраняющий редактируемые задачи в виде черновика. Это помогает в том случае, если вы долго писали текст задачи, и случайно нажали комбинацию кнопок переносящих вас на страницу назад, или на одну из ваших закладок. В этом случае, открыв страницу редактор вновь, вы увидите спасительную надпись “Черновик сохранён. Восстановить?”

Приступим:
1) Плагин автоматических ста процентов:

Находится по адресу http://www.redmine.org/plugins/redmine_auto_percent, а его репозиторий на Гитхабе: https://github.com/escline/redmine-auto-percent

Перейдём в папку с плагинами:

# Настраиваем upstream на сокет нашего "слушающего" сервера thin
upstream thin_server {
    server unix:/tmp/thin.0.sock;
}
# Веб-сервер видимый из вне
server
{
	#имя сервера
	server_name redmine.mihanentalpo.me;
 
	#НЕ Используем HTTPS(SSL)
	listen *:80;
 
	#логи
	access_log /var/log/nginx/redmine.mihanentalpo.me-access.log;
	error_log  /var/log/nginx/redmine.mihanentalpo.me-error.log;
 
	#Папка public редмайна
	root /usr/local/share/redmine/public;
 
	# Основной location. Он отдаёт все статические файлы "как следует", а все
	# нестатические адреса редиректит на прокси-сервер, которым и является thin
	location  / {		
		proxy_redirect off;
		proxy_set_header Host redmine.mihanentalpo.me;
		try_files $uri/index.html $uri.html $uri @thin;
	}
 
	# Именованый Location для того, чтобы было куда сослаться 
	location @thin
	{
		proxy_pass http://thin_server;
	}
}

Склонируем репозиторий плагина:

# ln -s /etc/nginx/sites-available/redmine.mihanentalpo.me /etc/nginx/sites-enabled/redmine.mihanentalpo.me
и перезапустим nginx:
# /etc/init.d/nginx restart

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

# mv public/dispatch.fcgi.example public/dispatch.fcgi

2) Плагин черновика:

Находится он здесь: http://www.redmine.org/boards/3/topics/13930, а его репозиторий здесь: https://github.com/jbbarth/redmine_drafts

Мы и так находимся в папке с плагинами, но а вдруг нет?

# chmod -R 0777 /usr/local/share/redmine/tmp
# chmod -R 0777 /usr/local/share/redmine/files

Клонируем репозиторий:

cp config/configuration.yml.example config/configuration.yml
nano config/configuration.yml

Запускаем миграции плагина:

# cd /usr/local/share/redmine/plugins

3) После установки модулей перезапускаем веб-сервер:

# git clone https://github.com/escline/redmine-auto-percent.git

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

7.5 Установим “красивую” тему

Стандартный внешний вид Redmine довольно минималистичен, и для тех кто хочет сделать его чуть “красивее”, есть множество тем, и лежат они здесь: http://www.redmine.org/projects/redmine/wiki/Theme_List

Я установлю тему “basecamp-with-icon” чтобы показать как это вообще делается, ну а еще и потому что считаю её одной из неплохих, наряду с темой “A1” и еще некоторыми.

Данная тема доступна в репозитории https://github.com/lqez/redmine-theme-basecamp-with-icon

Переходим в папку с темами

# rake redmine:plugins:migrate RAILS_ENV=production

Клонируем репозиторий:

# cd /usr/local/share/redmine/plugins

Перезапускаем вебсервер thin командой /etc/init.d/thin restart, после чего можно зайти в админ панельадминистрированиенастройки, выбрать там вкладку “Отображение” и из выпадающего списка “Тема” выбрать свежеустановленную тему, после чего, сохранив изменения, получить желаемую тему на своём экране.


So, what do you think ?