Trac

O que é?

Trac é uma ferramenta de gerenciamento e controle de mudanças em projetos de desenvolvimento de software. Tem como propósito permitir que desenvolvedores construam software de qualidade auxiliando no rastreamento das mudanças do projeto e quais os seus impactos. Ele foi desenvolvido em Python e está sobre a licença GPL desde meados de 2005.

Recursos

O Trac possibilita realizar o planejamento de um projeto incluindo milestones, roadmaps, sistema de wiki, além de fornecer interface com sistemas de controle de versão como Subversion, Git e Mercurial. No Trac é possível fazer links com páginas da wiki, bugs, tarefas, mensagens de commit. Outra funcionalidade importante é uma linha do tempo que mostra todos os eventos que foram realizados no projeto permitindo acompanhar o progresso do projeto.

Quem Usa o Trac?

Projetos Open Source	Educação e Governo	Companias	Ornanizações Internacionais
Django	NASA Langley Research Center	Agile42	United Nations Office at Geneva
Fedora hosted projects	University of Oxford	BitNami	IRTF / IETF
JQuery	Fachhochschule Kärnten - Medical Information Technology	JavaParty

Para uma lista completa dos usuários consulte: http://trac.edgewall.org/wiki/TracUsers

Como Instalar

Nos tópicos seguintes contém instruções genéricas de instalação do Trac versão 1.0. Caso necessite, visite a pagina com os guias de instalação para cada plataforma. Esse tutorial não cobre instalação e configuração das dependencias, confira os links para mais informações.

Dependências

Para a completa instalação do Trac, é necessário os seguintes pacotes de software instalados:

Python (versão 2.5 ~ 3.0)
setuptools (versão ≥ 0.6)
Genshi (versão ≥ 0.6)

Também é necessário um banco de dados. Os três principais são SQLite, PostgreSQL ou MySQL.

SQLite

As versões de Python 2.5, 2.6 ou 2.7 já utilizam o banco SQLite pelo modulo sqlite3. Opcional: você pode instalar a nova versão do pysqlite. Mais informações PySqlite

PostgreSQL

Instalação do PostgreSQL e o conector Python:

PostgreSQL (versão 8.0 ou posterior)
psycopg2 (versão 2.0 ou posterior)

Mais informações DatabaseBackend.

MySQL

Instalação do MySQL e conector Python:

MySQL (versão 5.0 ou posterior)
MySQLdb (versão 1.2.2 ou posterior)

Dependências Opcionais

O Trac tem a possibilidade de integrar com ferramentas de controle de versão como o Subversion e Git.

Instalando o Trac

Há vários modos de instalar o sistema Trac. Não é necessário um web server pois o Trac ja contem um standalone server.

Utilizando o easy_install

É possível utilizar o setuptools para realizar a instalação do Trac.

Trac 1.0:

$ easy_install Trac==1.0

Última versão de desenvolvimento:

$ easy_install Trac==dev

Criando um Ambiente de Projeto

Um ambiente Trac é o backend onde são guardados as informações das páginas wiki, ticket, report, configuração, etc.

Um novo ambiente é criado usando o comando trac-admin:

$ trac-admin /<diretorio_para_o_projeto> initenv

O sistema irá mostrar algumas informações da criação e pedirá o nome do projeto e a conexão com o banco de dados. Caso você não queira especificar nenhuma das opções, apenas pressione <ENTER>

Iniciando o Servidor Standalone

O ambiente de projeto criado pode ser acessado pela interface web com o comando

$ tracd --port 8000 /path/to/myproject

Se nenhum problema ocorrer, abra o browser acessando o link http://localhost:8000/

Configurando um repositório Git

É necessário ter o git instalado na máquina e um repositório local. No arquivo <diretorio_do_projeto>/conf/trac.ini altere os seguintes campos:

[Trac]

repository_type = git

repository_dir = <diretorio_do_repositorio_local>/git

Para versões mais atuais Trac 1.1.3:

[repositories]

type = git

dir = <diretorio_do_repositorio_local>/git

Configurando Autenticação

Criação de Usuário

Instale recurso htpasswd provido pela Apache:

$ sudo apt-get install apache2-utils

Crie um usário e senha:

$ sudo htpasswd -c /caminho/do/diretorio/.htpasswd admin

Exemplo:

$sudo htpasswd -c /home/usuario/Documentos/trac_tutorial/.htpasswd admin

Permisão de adminstrador para o usuário

$ trac-admin /home/usuario/Documentos/trac_tutorial permission add admin TRAC_ADMIN

$ cd /home/usuario/Documentos

$ tracd -p 8080 --basic-auth="trac_tutorial, trac_tutorial/.htpasswd, Testando" trac_tutorial/

Adicionando mais de um repositório ao projeto

 Faça o login na aplicação com uma conta de administrador

Admin > Repositories
De um nome e o local do repositório.

Referências

http://trac.edgewall.org/