Redmine - быстрый старт
Материал из 1GbWiki.
Версия 11:34, 30 октября 2013 (править) Renton (Обсуждение | вклад) (→Установка Redmine) ← К предыдущему изменению |
Версия 11:36, 30 октября 2013 (править) (отменить) Renton (Обсуждение | вклад) (→Установка Redmine) К следующему изменению → |
||
Строка 106: | Строка 106: | ||
'''2.''' Удаляем тестовое приложение и скачиваем последнюю версию Redmine: | '''2.''' Удаляем тестовое приложение и скачиваем последнюю версию Redmine: | ||
- | $ cd ~/http && rm -rfv ./* && svn co <nowiki>http://svn.redmine.org/redmine/branches/</nowiki>'''2. | + | $ cd ~/http && rm -rfv ./* && svn co <nowiki>http://svn.redmine.org/redmine/branches/</nowiki>'''2.3-stable'''/ ./ |
'''3.''' Также добавляем ряд gem'ов для удовлетворения зависимостей приложения: | '''3.''' Также добавляем ряд gem'ов для удовлетворения зависимостей приложения: |
Версия 11:36, 30 октября 2013
Данная статья предназначена для технических специалистов. Вы должны знать основы программирования, уметь пользоваться консольными программами и официальной документацией от разработчиков. В связи с тем, что на сервере могут обновиться версии программ, измениться конфигурация приложений, документация в статье может не соответствовать действительности, поэтому вы должны быть готовы разобраться с возможными проблемами самостоятельно или с помощью специалистов из платной поддержки http://1gbsup.ru/paidsu/, обычная поддержка хостинга не оказывает консультации по установке и отладке скриптов. |
Redmine это простая и в то же время очень гибкая и функциональная система управления проектами, построенная на фреймворке Ruby on Rails. В статье пойдет речь о том, как запустить Redmine на виртуальном хостинге 1Gb.ru.
Содержание |
Подготовка сайта
1. В разделе личного кабинета "Базы данных"
создайте базу MySQL 5.
2. Для того чтобы на сайте можно было запускать Rails приложения, вам необходимо переключить сайт (если сайта нет, то создайте его с главной страницы личного кабинета по ссылке "Зарегистрировать, привязать домен и создать сайт"
, тип сервера любой) в режим Rails из раздела кабинета "Хостинг Ruby on Rails"
:
3. Тут же можно настроить окружение по умолчанию для нашего приложения:
В течение часа на сайте заработает тестовое приложение 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. Используя bundler
ставим gem'ы необходимые для работы Redmine:
$ cd ~/http && bundle install --without development test
5. Устанавливаем веб-сервер Thin:
$ gem install thin --no-rdoc --no-ri
6. Создаем файл конфигурации ~/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 .
7. Наполняем базу данными:
$ 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-сервер:
$ ~/init.d/mongrel restart production
Установка завершена. Логин и пароль администратора:
admin admin
Демо-версию размещенную на хостинге 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 (первый раз открываться может долго).