Redmine - быстрый старт

Материал из 1GbWiki.

(Различия между версиями)
Перейти к: навигация, поиск
Версия 11:36, 30 октября 2013 (править)
Renton (Обсуждение | вклад)
(Установка Redmine)
← К предыдущему изменению
Версия 13:12, 30 октября 2013 (править) (отменить)
Renton (Обсуждение | вклад)
(Установка Redmine)
К следующему изменению →
Строка 111: Строка 111:
$ echo 'gem "thin"' >> ~/http/Gemfile.local $ echo 'gem "thin"' >> ~/http/Gemfile.local
-'''4.''' Используя <code>bundler</code> ставим gem'ы необходимые для работы Redmine:+'''4.''' Создаем файл конфигурации '''<code>~/http/config/database.yml</code>''' приложения:
- $ cd ~/http && bundle install --without development test+
- +
-'''5.''' Устанавливаем веб-сервер Thin:+
- $ gem install thin --no-rdoc --no-ri+
- +
-'''6.''' Создаем файл конфигурации '''<code>~/http/config/database.yml</code>''' приложения:+
$ cp ~/http/config/database.yml.example ~/http/config/database.yml $ cp ~/http/config/database.yml.example ~/http/config/database.yml
и прописываем параметры доступа к базе данных для '''<code>production</code>''' окружения: и прописываем параметры доступа к базе данных для '''<code>production</code>''' окружения:
Строка 135: Строка 129:
---- ----
 +'''5.''' Используя <code>bundler</code> ставим gem'ы необходимые для работы Redmine:
 + $ cd ~/http && bundle install --without development test
-'''7.''' Наполняем базу данными:+'''6.''' Наполняем базу данными:
$ cd ~/http && rake generate_secret_token && RAILS_ENV=production rake db:migrate && RAILS_ENV=production REDMINE_LANG=ru rake redmine:load_default_data $ cd ~/http && rake generate_secret_token && RAILS_ENV=production rake db:migrate && RAILS_ENV=production REDMINE_LANG=ru rake redmine:load_default_data
-'''8.''' Если вы все сделали правильно, то можно перезапустить web-сервер:+'''7.''' Если вы все сделали правильно, то можно перезапустить web-сервер:
$ ~/init.d/mongrel restart production $ ~/init.d/mongrel restart production
Установка завершена. Логин и пароль администратора: Установка завершена. Логин и пароль администратора:

Версия 13:12, 30 октября 2013

Данная статья предназначена для технических специалистов.

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

В связи с тем, что на сервере могут обновиться версии программ, измениться конфигурация приложений, документация в статье может не соответствовать действительности, поэтому вы должны быть готовы разобраться с возможными проблемами самостоятельно или с помощью специалистов из платной поддержки http://1gbsup.ru/paidsu/, обычная поддержка хостинга не оказывает консультации по установке и отладке скриптов.


Redmine это простая и в то же время очень гибкая и функциональная система управления проектами, построенная на фреймворке Ruby on Rails. В статье пойдет речь о том, как запустить Redmine на виртуальном хостинге 1Gb.ru.

Содержание

Подготовка сайта

1. В разделе личного кабинета "Базы данных" создайте базу MySQL 5. 2. Для того чтобы на сайте можно было запускать Rails приложения, вам необходимо переключить сайт (если сайта нет, то создайте его с главной страницы личного кабинета по ссылке "Зарегистрировать, привязать домен и создать сайт", тип сервера любой) в режим Rails из раздела кабинета "Хостинг Ruby on Rails":

Перевод сайта в режим "хостинг Ruby on Rails" в личном кабинете 1Gb.ru
Перевод сайта в режим "хостинг Ruby on Rails" в личном кабинете 1Gb.ru

3. Тут же можно настроить окружение по умолчанию для нашего приложения:

Настройка окружения
Настройка окружения

В течение часа на сайте заработает тестовое приложение Rails и открыв сайт в обозревателе вы увидите стандартную заставку:

Тестовая страница Rails приложения
Тестовая страница Rails приложения

Настройка окружения

На хостинге ставится 2-ая версия Rails, для последних же версий Redmine требуется 3-я версия фреймворка. Поэтому нам необходимо подготовить окружение для запуска Rails 3.

Для установки Ruby on Rails 3-ей версии нам потребуется Ruby 1.9.
На новых серверах хостинга 1Gb.ru, версия ruby 1.9 уже установлена общесистемно в каталог /opt, чтобы это проверить, нужно выполнить такую команду:

$ /opt/ruby/current/bin/ruby -v

если Ruby есть, то увидите примерно такой ответ:

ruby 1.9.2p0 (2010-08-18 revision 29036) [x86_64-linux]

в этом случае можно пропустить шаг установки Ruby и переходить к пункту "6 . Настройка переменных окружения".

Если ruby нет, то переходим к установке.

1. Создаем каталог для исходных текстов:

$ mkdir ~/src && cd ~/src

2. Скачиваем последнюю версию Ruby такой командой:

$ lynx -source http://www.ruby-lang.org/en/downloads/ | grep -B2 recommended | awk '/<a href="http:/ {url = gensub(/.*href="(.*)">.*/,"\\1",""); system ("wget "url)}'

либо скачиваем вручную с сайта http://www.ruby-lang.org/en/downloads/ желаемую версию Ruby.

3. Распаковка:

$ tar xvfz ruby-1.*

4. Устанавливаем Ruby в свой домашний каталог в папку ~/opt

$ cd ruby-1.* && ./configure --prefix=${HOME}/opt/ruby/$(echo ${PWD##*/} \
| sed 's/^ruby-\(.*\)$/\1/') --disable-install-doc --disable-install-rdoc --disable-install-capi && make && make install

при конфигурации вы можете добавить еще какие-то свои опции, но на мой взгляд ничего заслуживающего внимания там нет.

5. Если все прошло успешно, переходим в каталог с ruby и для удобства делаем symlink:

$ cd ~/opt/ruby && rm -f current && ln -vs $(ls -1t | head -n 1) current

6. Настройка переменных окружения.
В файл ~/.bashrc добавляем пути к локальным gems, ruby:

$ grep -q RUBYOPT ~/.bashrc || sed -i '/^# rails environment/,+5d;/happen/a #\n# rails 3 environment\nunset RUBYOPT\
export GEM_HOME="${HOME}/.gems"\nexport GEM_PATH="${GEM_HOME}:/opt/ruby/current/lib/ruby"\
export PATH="${GEM_HOME}/bin:/opt/ruby/current/bin:${PATH}"' ~/.bashrc

Полностью файл ~/.bashrc может выглядить так:

# /etc/skel/.bashrc
 #
 # This file is sourced by all *interactive* bash shells on startup,
 # including some apparently interactive shells such as scp and rcp
 # that can't tolerate any output.  So make sure this doesn't display
 # anything or bad things will happen !
 #
 # rails 3 environment
 unset RUBYOPT
 export GEM_HOME="${HOME}/.gems"
 export GEM_PATH="${GEM_HOME}:/opt/ruby/current/lib/ruby"
 export PATH="${GEM_HOME}/bin:/opt/ruby/current/bin:${PATH}"
 
 # Test for an interactive shell.  There is no need to set anything
 # past this point for scp and rcp, and it's important to refrain from
 # outputting anything in those cases.
 if [[ $- != *i* ]] ; then
         # Shell is non-interactive.  Be done now!
         return
 fi
 
 # Midnight Commander chdir enhancement
 if [ -f /usr/share/mc/mc.gentoo ]; then
     . /usr/share/mc/mc.gentoo
 fi
 
 # Put your fun stuff here.
 
 export PERL5LIB=${HOME}/perl/lib64/perl5:${HOME}/perl/lib64/perl5/site_perl:${HOME}/perl/lib64/perl5/vendor_perl

7. Импорт окружения:

$ source ~/.bashrc

8. Для того чтобы вместо Mongrel'а запускался наш web-сервер, в файле ~/.railsrc прописываем версию своего Rails и полный путь к web-серверу:

$ echo -e "RAILS_VERSION=3\nMONGREL_BIN_MY=\${HOME}/.gems/bin/thin" > ~/.railsrc

Установка Redmine

Все нижеприведенные команды показывают как установить Redmine последней stable версии 2.3.0 (на момент написания статьи).

Вы же можете по аналогии поставить любую версию. Актуальные версии, а также версии зависимых пакетов и инструкцию по установке можно посмотреть на официальном сайте Redmine.

1. Устанавливаем bundler:

$ gem install bundler --no-rdoc --no-ri

2. Удаляем тестовое приложение и скачиваем последнюю версию Redmine:

$ cd ~/http && rm -rfv ./* && svn co http://svn.redmine.org/redmine/branches/2.3-stable/ ./

3. Также добавляем ряд gem'ов для удовлетворения зависимостей приложения:

$ echo 'gem "thin"' >> ~/http/Gemfile.local

4. Создаем файл конфигурации ~/http/config/database.yml приложения:

$ cp ~/http/config/database.yml.example ~/http/config/database.yml

и прописываем параметры доступа к базе данных для production окружения:

production:
  adapter: mysql2
  database: имя_бд
  host: адрес_сервера_бд
  username: имя_бд
  password: пароль_бд
  encoding: utf8

все эти параметры есть в личном кабинете на странице "Пароли на ресурсы".


Обратите внимание, что имя адапатера должно быть mysql2 .


5. Используя bundler ставим gem'ы необходимые для работы Redmine:

$ cd ~/http && bundle install --without development test

6. Наполняем базу данными:

$ cd ~/http && rake generate_secret_token && RAILS_ENV=production rake db:migrate && RAILS_ENV=production REDMINE_LANG=ru rake redmine:load_default_data

7. Если вы все сделали правильно, то можно перезапустить web-сервер:

$ ~/init.d/mongrel restart production

Установка завершена. Логин и пароль администратора:

admin
admin
Redmine готов к работе
Redmine готов к работе

Демо-версию размещенную на хостинге 1Gb.ru можно посмотреть тут http://test-l19-redmine.1gb.ru/

Решение проблем

Обычно для решения всех проблем достаточно посмотреть лог-файлы приложения, они находится в ~/logs_ror и в ~/http/log

См. также

Ссылки

Личные инструменты