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

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

(Различия между версиями)
Перейти к: навигация, поиск
Версия 18:33, 15 марта 2018 (править)
Renton (Обсуждение | вклад)
(Настройка сайта)
← К предыдущему изменению
Версия 18:56, 15 марта 2018 (править) (отменить)
Renton (Обсуждение | вклад)
(Настройка окружения)
К следующему изменению →
Строка 25: Строка 25:
== Настройка окружения == == Настройка окружения ==
 +'''1.''' Каждая версия Redmine требует определенных версий Rails и Ruby, поэтому необходимо сразу определиться, какую версию Redmine вы хотите поставить, и, соответственно, выбрать версии Rails, Ruby. Для выбора используйте страницу http://www.redmine.org/projects/redmine/wiki/RedmineInstall, в таблице перечислены текущие стабильные версии Redmine, а также версии Rails, Ruby.
-На хостинге ставится 2-ая версия Rails, для последних же версий Redmine требуется 3-я версия фреймворка. Поэтому нам необходимо подготовить окружение для запуска Rails 3.<br /><br />+'''2.''' Зайдите на сайт по [http://www.1gb.ru/putty SSH] и запустите команду:
 + $ /opt/hostpublic/sbin/1gb_rails_init.sh
-Для установки Ruby on Rails '''3-ей''' версии нам потребуется Ruby '''1.9'''.<br />+'''3.''' Укажите какую версию Rails вы будете использовать:
-На новых серверах хостинга 1Gb.ru, версия ruby 1.9 уже установлена общесистемно в каталог /opt, чтобы это проверить, нужно выполнить такую команду:+ Which version of Ruby on Rails will you use (choices: 2, 3, 4 or 5):
- $ /opt/ruby/current/bin/ruby -v+
-если Ruby есть, то увидите примерно такой ответ:+
- ruby 1.9.2p0 (2010-08-18 revision 29036) [x86_64-linux]+
-в этом случае можно пропустить шаг установки Ruby и переходить к пункту '''"6 . Настройка переменных окружения"'''.+
-Если ruby нет, то переходим к установке.<br /><br />+'''4.''' На основе выбранной версии Rails, будет предложено установить наиболее подходящую версию Ruby или явно укажите версию из таблицы с сайта http://www.redmine.org/projects/redmine/wiki/RedmineInstall. Установка займет 5-15 минут.
-'''1.''' Создаем каталог для исходных текстов:+ Install the best version of Ruby (choices: 1.8.7-p374, 2.0, 2.4.3) [default: 2.0]:
- $ mkdir ~/src && cd ~/src+
-'''2.''' Скачиваем последнюю версию Ruby такой командой:+
- $ lynx -source <nowiki>http://www.ruby-lang.org/en/downloads/</nowiki> | 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+
-при конфигурации вы можете добавить еще какие-то свои опции, но на мой взгляд ничего заслуживающего внимания там нет.<br /><br />+
-'''5.''' Если все прошло успешно, переходим в каталог с ruby и для удобства делаем symlink:+
- $ cd ~/opt/ruby && rm -f current && ln -vs $(ls -1t | head -n 1) current+
- +
-'''6.''' '''Настройка переменных окружения.'''<br />+
-В файл <code>~/.bashrc</code> добавляем пути к локальным 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+
- +
-Полностью файл <code>~/.bashrc</code> может выглядить так:+
- <nowiki># /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</nowiki>+
- +
-'''7.''' Импорт окружения:+
- $ source ~/.bashrc+
- +
-'''8.''' Для того чтобы вместо Mongrel'а запускался наш web-сервер, в файле <code>~/.railsrc</code> прописываем версию своего Rails и полный путь к web-серверу:+
- $ echo -e "RAILS_VERSION=3\nMONGREL_BIN_MY=\${HOME}/.gems/bin/thin" > ~/.railsrc+
== Установка Redmine == == Установка Redmine ==

Версия 18:56, 15 марта 2018

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

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

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


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

Содержание

Настройка сайта

1. Переключите сайт (а если сайта нет, то создайте его с главной страницы личного кабинета по ссылке Зарегистрировать, привязать домен и создать сайт Изображение:Blank.gif, тип сервера любой) в режим Ruby on Rails из раздела кабинета полный список функций -> Хостинг Ruby on Rails

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

2. Задайте окружение production:

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

3. Для работы Redmine требуется база данных. Redmine может работать с базами MySQL и PostgreSQL. В личном кабинете в разделе начало -> Базы данных нужного вам типа.

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

1. Каждая версия Redmine требует определенных версий Rails и Ruby, поэтому необходимо сразу определиться, какую версию Redmine вы хотите поставить, и, соответственно, выбрать версии Rails, Ruby. Для выбора используйте страницу http://www.redmine.org/projects/redmine/wiki/RedmineInstall, в таблице перечислены текущие стабильные версии Redmine, а также версии Rails, Ruby.

2. Зайдите на сайт по SSH и запустите команду:

$ /opt/hostpublic/sbin/1gb_rails_init.sh

3. Укажите какую версию Rails вы будете использовать:

Which version of Ruby on Rails will you use (choices: 2, 3, 4 or 5):

4. На основе выбранной версии Rails, будет предложено установить наиболее подходящую версию Ruby или явно укажите версию из таблицы с сайта http://www.redmine.org/projects/redmine/wiki/RedmineInstall. Установка займет 5-15 минут.

Install the best version of Ruby (choices: 1.8.7-p374, 2.0, 2.4.3) [default: 2.0]:

Установка 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. И web-сервер thin:

$ cd && gem install thin --version $(gem list thin | sed 's/^t.*(\([0-9\.]\+\)).*/\1/') --no-rdoc --no-ri

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

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

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

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

См. также

Ссылки

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