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

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

(Различия между версиями)
Перейти к: навигация, поиск
Версия 10:39, 15 февраля 2013 (править)
Renton (Обсуждение | вклад)

← К предыдущему изменению
Версия 10:42, 15 февраля 2013 (править) (отменить)
Renton (Обсуждение | вклад)
(Подготовка сайта)
К следующему изменению →
Строка 14: Строка 14:
== Подготовка сайта == == Подготовка сайта ==
-* В разделе личного кабинета '''<code>"Базы данных"</code>''' создайте базу MySQL 5.+'''1.''' В разделе личного кабинета '''<code>"Базы данных"</code>''' создайте базу MySQL 5.
-* Для того, чтобы на сайте можно было запускать Rails приложения, вам необходимо переключить сайт (если сайта нет, то создайте его с главной страницы личного кабинета по ссылке '''<code>"Зарегистрировать, привязать домен и создать сайт"</code>''', тип сервера любой) в данный режим из раздела кабинета '''<code>"Хостинг Ruby on Rails"</code>''':+'''2.''' Для того чтобы на сайте можно было запускать Rails приложения, вам необходимо переключить сайт (если сайта нет, то создайте его с главной страницы личного кабинета по ссылке '''<code>"Зарегистрировать, привязать домен и создать сайт"</code>''', тип сервера любой) в режим Rails из раздела кабинета '''<code>"Хостинг Ruby on Rails"</code>''':
[[Изображение:Ror_add_newsite.jpg|480px|thumb|center|Перевод сайта в режим "хостинг Ruby on Rails" в личном кабинете 1Gb.ru]]<br clear="both" /> [[Изображение:Ror_add_newsite.jpg|480px|thumb|center|Перевод сайта в режим "хостинг Ruby on Rails" в личном кабинете 1Gb.ru]]<br clear="both" />
-* Тут же можно настроить окружение по умолчанию для нашего приложения:+'''3.''' Тут же можно настроить окружение по умолчанию для нашего приложения:
[[Изображение:Ror_env.jpg|480px|thumb|center|Настройка окружения]]<br clear="both" /> [[Изображение:Ror_env.jpg|480px|thumb|center|Настройка окружения]]<br clear="both" />

Версия 10:42, 15 февраля 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 приложения

Установка Redmine

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

  • Удаляем тестовое приложение и скачиваем последнюю версию Redmine:
$ cd ~/http && rm -rfv ./* && svn co svn://rubyforge.org/var/svn/redmine/branches/1.1-stable ./
  • Добавляем ряд gem'ов для удовлетворения зависимостей:
$ echo 'gem "builder", "~> 2.1.2"' >> ~/http/Gemfile.local 
$ echo 'gem "mongrel"' >> ~/http/Gemfile.local
  • Ставим обязательные пакеты для данной версии Redmine:
$ gem install -v=0.4.2 i18n --no-rdoc --no-ri
$ gem install mysql --no-rdoc --no-ri
$ gem install rails -v=нужная_вам_версия_Rails* --no-rdoc --no-ri
$ gem install rack -v=нужная_вам_версия_Rack* --no-rdoc --no-ri
$ gem install mongrel --no-rdoc --no-ri
$ gem install bundler --no-rdoc --no-ri

----------
* версии Rails приведены в таблице http://www.redmine.org/projects/redmine/wiki/RedmineInstall#Ruby-38-Ruby-on-Rails-38-Rack

ВАЖНОЕ ЗАМЕЧАНИЕ. В том случае, если вы используете Rails версии 2.3.8 или выше (см. rails -v) и Mongrel версии ниже 1.2.0 (см. mongrel_rails --version), то необходимо добавить инициализатор в приложение:

$ cd ~/http/config/initializers/ && wget 'https://gist.github.com/raw/826692/cb0dcf784c30e6a6d00c631f350de99ab99e389d/mongrel.rb'
$ fgrep -q "'$(rails -v | awk '{print $2}')'" ~/http/config/initializers/mongrel.rb || sed -i "s#'].include#', '$(rails -v | awk '{print $2}')'].include#" ~/http/config/initializers/mongrel.rb


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

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

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

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

  • В файл ~/http/config/environment.rb дописываем строки:
ENV['GEM_HOME']="#{ENV['HOME']}/.gems"
ENV['GEM_PATH']="#{ENV['GEM_HOME']}:/usr/lib/ruby/gems/1.8"
  • Устанавливаем зависимые пакеты из ~/http/Gemfile, ~/http/Gemfile.local
$ bundle install --without development test
  • Наполняем базу данными:
cd ~/http && rake generate_session_store && RAILS_ENV=production rake db:migrate && RAILS_ENV=production rake redmine:load_default_data
  • Если вы все сделали правильно, то можно перезапустить web-сервер:
~/init.d/mongrel restart production

Все, можно работать. Логин и пароль администратора:

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

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

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

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

См. также

Ссылки

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