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

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

(Различия между версиями)

Версия 12:29, 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

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

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

В течение часа на сайте заработает тестовое приложение 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

Установка Redmine

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

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

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

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

2. Устанавливаем gem'ы:

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

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

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

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

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

5. Создаем файл конфигурации ~/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 .

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 готов к работе

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

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

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

См. также

Ссылки

1Gb.ru - Ruby on Rails (рус.) - описание предложения "хостинг Ruby on Rails" на сайте 1Gb.ru.
Redmine (англ.) - официальный сайт проекта Redmine, документация, сообщество и многое другое.
Сообщество redprojects (рус.) - русскоязычное сообщество пользователей Redmine.
Простая установка Redmine на VDS (первый раз открываться может долго).

Получено с https://www.1gb.ru/wiki/index.php?title=Redmine_-_%D0%B1%D1%8B%D1%81%D1%82%D1%80%D1%8B%D0%B9_%D1%81%D1%82%D0%B0%D1%80%D1%82

Категории: Программирование | Ruby

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

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

Версия 12:29, 15 февраля 2013

Содержание

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

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

Установка Redmine

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

См. также

Ссылки

Просмотры

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

Навигация

Поиск

Инструменты