Статьи

Redmine Руководство по установке и началу работы

Май 23, 2019
Redmine — это бесплатный и гибкий инструмент с открытым исходным кодом для управления проектами и отслеживания ошибок, написанный с использованием среды Ruby on Rails .

Redmine поддерживает несколько проектов, с собственной вики, форумом, трекером времени и управлением проблемами.

Кроме того, Redmine реализует платформу плагинов, поэтому ее можно настраивать в зависимости от ваших требований. Существуют плагины для работы с Kanban, Scrum, плагинами уведомлений или отчетами.

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

Redmine может быть установлен по-разному:

  • Использование webrick (не рекомендуется в производственной среде).
  • Беги с дворнягой и фастчги.
  • Используя Пассажира.
  • Или упакуйте Redmine в войну и разверните в Java-контейнер, такой как Tomcat или Glassfish.

В этом посте я собираюсь показать вам, как упаковать Redmine 1.3 в файл war, чтобы его можно было запускать в Tomcat7 и Linux . По идее должна быть работа с Glassfish , JBoss или любой другой ОС .

Прежде всего, скачайте JRuby 1.6.6, поэтому откройте терминал

wget http://jruby.org.s3.amazonaws.com/downloads/1.6.6/jruby-bin-1.6.6.tar.gz

Распакуйте загруженный файл и перейдите в каталог / usr / share .

tar xvzf jruby-bin-1.6.6.tar.gz
sudo mv jruby-1.6.6 / /usr/share/jruby-1.6.6

Затем обновите переменные среды с помощью установочного каталога JRuby .

sudo gedit / etc / environment

1
2
PATH= … :/usr/share/jruby-1.6.6/bin
JRUBY_HOME="/usr/share/jruby-1.6.6"

Наконец, попробуйте выполнить jruby, чтобы убедиться, что он установлен правильно:

jruby -v

И информация о версии JRuby должна быть напечатана на консоли.

Следующим шагом является установка необходимых драгоценных камней :

1
2
3
4
5
6
7
8
9
gem install rack -v=1.1.1
gem install rails -v=2.3.14
gem install rdoc -v=2.4.2
gem install activerecord-jdbcmysql-adapter -v=1.2.2
gem install warbler -v=1.3.2
gem install jruby-openssl -v=0.7.5
gem install rubytree -v=0.8.2
gem install i18n -v=0.4.2
gem install tree -v=0.2.1

Установка Redmine

Скачайте Redmine 1.3 и установите их в каталог / usr / share:

1
2
3
4
wget http://rubyforge.org/frs/download.php/75597/redmine-1.3.0.tar.gz
 
tar xvzf redmine-1.3.0.tar.gz
sudo mv redmine-1.3.0 /usr/share/redmine-1.3.0

Redmine требует базы данных для работы. В этом случае я уже установил mySQL5 , но также поддерживается postgeSQL . Итак, давайте настроим MySQL в Redmine .

cd /usr/share/redmine-1.3.0/config/

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

1
2
cp database.yml.example database.yml
sudo gedit database.yml
1
2
3
4
5
6
7
production:
  adapter: jdbcmysql
  database: redmine
  host: localhost
  username: redmine
  password: redmine
  encoding: utf8

После этой модификации пришло время создать пользователя и базу данных Redmine в mySQL .

mysql -u root -p

1
2
3
create database redmine character set utf8;
create user ‘redmine’@’localhost’ IDENTIFIED BY ‘redmine’;
grant all privileges on redmine.* to ‘redmine’@’localhost’;

Теперь пришло время инициализировать Redmine

1
2
cd /usr/share/redmine-1.3.0
rake generate_session_store

Следующий шаг необходим, потому что мы устанавливаем Redmine 1.3, в следующих версиях Redmine 1.4 и выше не будет необходимости. Откройте config / environment.rb и прокомментируйте следующее как:

config.gem ‘rubytree’,: lib => ‘tree’

А затем создайте схему базы данных и заполните их данными по умолчанию с помощью следующих сценариев.

1
2
RAILS_ENV=production rake db:migrate
RAILS_ENV=production rake redmine:load_default_data

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

1
2
cd /usr/share/redmine-1.3.0
jruby script/server webrick -e production

и откройте браузер по адресу http: // localhost: 3000, чтобы начать проверку установки.

Redmine веб-страница будет отображаться, вы можете войти с именем пользователя и паролем admin / admin

На данный момент у нас правильно установлен Redmine .

Настройка электронной почты

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

Если ваш почтовый сервер требует протокол безопасности tls, вы должны установить плагин action_mailer_optional_tls .

Этот плагин требует Git, если вы еще не установили, введите:

sudo apt-get установить git

и затем выполните следующую команду в каталоге Redmine :

скрипт jruby / установка плагина git: //github.com/collectiveidea/action_mailer_optional_tls.git

Давайте настроим доставку электронной почты:

1
2
3
cd /usr/share/redmine-1.3.0/config/
cp configuration.yml.example configuration.yml
sudo gedit configuration.yml

Внутри файла конфигурации вы найдете общие настройки электронной почты. В зависимости от вашего почтового сервера эти атрибуты могут сильно различаться, поэтому на этом этапе я собираюсь показать вам простую конфигурацию SMTP-сервера с использованием простой аутентификации в производственной среде. Перейти к последней строке файла configuration.yml и добавить следующие строки в рабочий раздел.

01
02
03
04
05
06
07
08
09
10
production: # this line is already present in configuration.yml.
   email_delivery:
  delivery_method: :smtp
  smtp_settings:
    address: "example.com"
    port: 25
    authentication: :plain
    domain: 'example.com'
    user_name: 'myaccount'
    password: 'password'

Все атрибуты говорят сами за себя.

И прежде чем создавать файл war , давайте проверим, правильно ли настроена электронная почта Мы снова используем вебрик .

1
2
cd /usr/share/redmine-1.3.0
jruby script/server webrick -e production

Затем откройте браузер по адресу http: // localhost: 3000 и войдите в систему с учетной записью администратора.

Настройте адрес электронной почты администратора, нажав ссылку « Моя учетная запись» , а в разделе « Электронная почта » установите адрес электронной почты администратора.

После этого мы собираемся протестировать конфигурацию электронной почты, в главном меню перейдите в « Администрирование» -> « Настройки» -> « Уведомления по электронной почте», добавьте электронную почту и нажмите «Проверить электронную почту». Через некоторое время тестовое сообщение будет отправлено на адрес электронной почты администратора.

Нам удалось установить Redmine , теперь пришло время упаковать его в Tomcat .

Упаковка Redmine

Перед запуском из-за несовместимости с установленным гемом jruby-rack , мы должны запустить следующие команды для установки версии 1.0.10 jruby-rack .

1
2
gem uninstall jruby-rack
gem install jruby-rack -v=1.0.10

Команда Warble требует файл конфигурации. Этот файл создан с помощью следующей команды:

1
2
3
4
5
cd /usr/share/redmine-1.3.0
warble config
 
cd config/
sudo gedit warble.rb

Отредактируйте раздел Warble :: Config и настройте разделы config.dirs , config.gems и config.webxml.rails.env следующим образом:

1
2
3
4
5
Warbler::Config.new do |config|
  config.dirs = %w(app config lib log vendor tmp extra files lang)
  config.gems += ["activerecord-jdbcmysql-adapter", "jruby-openssl", "i18n", "rack", "tree"]
  config.webxml.rails.env = ENV['RAILS_ENV'] || 'production'
end

И, наконец, запустить:

трель

И Redmine War была создана и готова к развертыванию в Tomcat .

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

Я желаю, чтобы вы нашли это полезным.

Справка: Руководство по установке и началу работы с Redmine от нашего партнера JCG  

122
Share: