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

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

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

Версия 16:20, 10 ноября 2009

Содержание

1 Общие сведения
2 Подготовка окружения
3 Установка компонентов
4 Настройка trac
5 Репозиторий SVN
6 Доступ к репозиторию по SSH
7 Подключение внешнего репозитория

Общие сведения

Trac - бесплатное программное обеспечение написанное на языке Python, представляющие из себя прекрасный инстумент для автоматизированного управления проектами и системой отлеживания ошибок (bug tracker). Имеет простой wiki-подобный web-интерфейс.

На хостинге 1Gb.ru trac можно запустить в режиме UNIX/Apache/FastCGI, для этого убедитесь в разделе личного кабинета /Управление сайтами и серверами/ что у вас правильно выбран тип сервера.

Подготовка окружения

Создаем в корне домашнего каталога файл .pydistutils.cfg для настройки путей инсталляции модулей:
[install]
prefix = $HOME/python

[easy_install]
install_dir = $HOME/python/lib64/python2.5/site-packages

Для настройки переменных PATH, PYTHONPATH и alias'ов добавьте строки в ваш ~/.bashrc:

export PATH=$PATH:$HOME/python/bin:$HOME/python/lib64/python2.5/site-packages
export PYTHONPATH=$PYTHONPATH:$HOME/python/lib64/python2.5/site-packages
alias easy_install=$HOME/python/lib64/python2.5/site-packages/easy_install

Выполняем команду:

source ~/.bashrc

для того, чтобы сделанные изменения вступили в силу.

Создаем различные каталоги:

mkdir -p ~/src ~/python/lib64/python2.5/site-packages ~/trac ~/svn

Симлинк:

cd ~/python; ln -s lib64 lib; cd

Установка компонентов

Установим свой easy_install:

$ cd ~/src && wget http://pypi.python.org/packages/2.5/s/setuptools/setuptools-0.6c11-py2.5.egg#md5=64c94f3bf7a72a13ec83e0b24f2749b2
$ /bin/bash ./setuptools-0.6c11-py2.5.egg

Устанавливаем модуль flup, для работы Trac в FastCGI режиме:

$ easy_install flup

Ставим trac:

$ easy_install trac

Также сразу ставим модуль WebAdmin для настройки trac через web-интерфейс:

$ easy_install http://svn.edgewall.com/repos/trac/sandbox/webadmin/

Настройка trac

Создание проекта

Создаем проект под именем demo_trac:

$ trac-admin ~/trac/demo_trac initenv

Рекомендую использовать базу данных MySQL, строка подключения для нее будет выглядить так:

mysql://db_name:db_password@db_host:3306/db_name

Остальные настройки проекта оставляем либо по-умолчанию, либо игнорируем.

Настройка FastCGI диспетчера и файла `.htaccess`

Переходим в каталог ~/http и делаем настройку FastCGI диспетчера и правил редиректа mod_rewrite:

Файл index.fcgi

#!/usr/bin/python

import sys, os, site

# Add a custom Python path.
PYTHON_CUSTOM_PATH = os.path.abspath (os.path.join (os.path.dirname (os.path.abspath (__file__)), \
                     '../python/lib64/python2.5/site-packages'))
sys.path.insert (0, PYTHON_CUSTOM_PATH)
site.addsitedir (PYTHON_CUSTOM_PATH)

# Add a custom trac env path.
MY_TRAC_ENV_PATH = os.path.abspath (os.path.join (os.path.dirname (os.path.abspath (__file__)), \
                   '../trac/demo_trac'))

os.environ['TRAC_ENV'] = MY_TRAC_ENV_PATH

from trac.web.main import dispatch_request
from flup.server.fcgi import WSGIServer

WSGIServer(dispatch_request).run()

Для того, чтобы у нас заработала авторизация, обязательно скопируйте файл index.fcgi в файл admin.fcgi:

$ cd ~/http && cp index.fcgi admin.fcgi

Файл .htaccess

DirectoryIndex index.fcgi

Options +FollowSymlinks

AddHandler fcgid-script .fcgi

RewriteRule ^(index.fcgi/chrome/site/)(.*)$ ./chrome/site/$2
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.fcgi/$1 [QSA,L]

<Files "admin.fcgi">
      AuthType Basic
      AuthUserFile /home/virtwww/имя_пользователя/trac/demo_trac/conf/trac.htpasswd
      AuthName "Trac Sign In"
      require valid-user
</Files>

RewriteRule ^index\.fcgi/login$ /admin.fcgi/login
RewriteRule ^admin\.fcgi/logout$ /index.fcgi/logout

Настройка авторизации

Добавляем администратора в trac:

$ trac-admin ~/trac/demo_trac
/trac/demo_trac]> permission add любое_имя_пользователя TRAC_ADMIN

Назначаем пароль:

$ cd ~/trac/demo_trac/conf/ && /usr/local/sbin/htpasswd -c trac.htpasswd любое_имя_пользователя

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

trac.ini

Включем WebAdmin, в конец файла добавляем строки:

[components]
webadmin.* = enabled

Остальные опции на ваше усмотрение.

Патч для создания правильных URI

Для создания "красивых" URI патчим файл ~/python/lib/python2.5/site-packages/Trac-0.11.5-py2.5.egg/trac/web/api.py (ваш путь может немного отличаться).

Строку:

base_path = property(fget=lambda self: self.environ.get('SCRIPT_NAME', ),

меняем на:

base_path = property(fget=lambda self: os.path.dirname(self.environ.get('SCRIPT_NAME', )),

Репозиторий SVN

Создаем локальный репозиторий:

$ cd ~/svn && svnadmin create название_репозитория

Добавляем какого-нибудь пользователя, редактируя файл conf/passwd:

[users]
имя_пользователя = пароль

в файле trac.ini указываем путь к нашему репозиторию:

repository_dir = /полный_путь

Доступ к репозиторию по SSH

Подключение внешнего репозитория

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

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

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

Версия 16:20, 10 ноября 2009

Содержание

Общие сведения

Подготовка окружения

Установка компонентов

Настройка trac

Создание проекта

Настройка FastCGI диспетчера и файла `.htaccess`

Настройка авторизации

trac.ini

Патч для создания правильных URI

Репозиторий SVN

Доступ к репозиторию по SSH

Подключение внешнего репозитория

Просмотры

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

Навигация

Поиск

Инструменты

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

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

Версия 16:20, 10 ноября 2009

Содержание

Общие сведения

Подготовка окружения

Установка компонентов

Настройка trac

Создание проекта

Настройка FastCGI диспетчера и файла .htaccess

Настройка авторизации

trac.ini

Патч для создания правильных URI

Репозиторий SVN

Доступ к репозиторию по SSH

Подключение внешнего репозитория

Просмотры

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

Навигация

Поиск

Инструменты

Настройка FastCGI диспетчера и файла `.htaccess`