Instalando Trac integrado com Subversion no Windows

O Trac Project é uma ferramenta open source que visa facilitar algumas atividades corriqueiras na Gerência de Configuração de Software. Possui alguns recursos bem interessantes como controles de milestones (entregas), Bug Tracking (controle e acompanhamento de bugs), integração com subversion que permite ligar tarefas e bugs as revisões dos fontes, wiki e por aí vai…

Tenho feito alguns estudos usando essa ferramenta, e tenho me surpreendido pela versatilidade e gama de recursos. É uma ferramente simples, mas muito bem elaborada.

Então mãos a obra, vamos começar a instalação! Mas antes duas informações importantes: 1º) este artigo segue os passos descritos na documentação do projeto Trac e 2º) o ambiente onde vamos instalar o Trac já possui o Subversion instalado e configurado com permissões.

Python

O primeiro é proceder com a instalação do Python. Para fazer download do python basta entrar em http://www.python.org/download/ e localizar a última versão disponibilizada para Windows. No momento que este arquivo foi escrita a última versão estável era 2.5.1. Até o momento não é possível utilizar a última versão do Python porque uma das bibliotecas requeridas (ClearSilver) não possui versão compatível com Python 2.5 para Windows. Optei então pelva versão 2.4:

A instalação do Python é relativamente simples, basta avançar as páginas e observar com atenção as opções que são apresentadas. Após a conclusão do assistente de instalação será necessáio reiniciar o Windows.

Dependências

Genshi: É uma biblioteca Python que provê a integração de uma série de componentes de interpretação, geração HTML, XML e outros formatos textuais de saída para Web. No site de downloads existem diversos formatos para download, inclusive executável de instalação. Neste artigo utilizaremos a opção Genshi-0.4.4.win32.exe. O próprio instalador localiza a versão compatível do Python instalada:

SetupTools: As ferramentas de instalação são muito úteis para “empacotar” softwares, plug-ins e atualizações. Para os conhecedores do linux é algo semelhante ao apt-get e rpm. Porém é feito com o uso do python, o que permite implementar lógica durante o processo de instalação. A instação das SetupTools são bastante semelhantes ao Genshi, basta fazer o download do instalador e Next, Next e Finish. Só é preciso se certificar de ter escolhido uma versão compatível com a versão do Python instalada, no caso 2.4.

ClearSilver: apartir da versão 0.11 esta biblioteca tende a não ser mais necessária para instalação, porém esta versão do Trac ainda está em desenvolvimento. Assim como o Genshi, o ClearSilver serve para construção da camada visual da aplicação. Alguns plug-ins podem necessitar dela, então é melhor instalarmos. Faça o download no site e siga o assistente até o final. É em função desta lib que não estamos utilizando a versão 2.5 do python.

Pysqlite: Por padrão o SqlLite é o banco de dados utilizado pelo Trac, entretanto também tem suporte a Postgres e MySql. Para versões inferiores a 2.5 é necessário instalar a API PySQLite. Atenção: o Pysqlite 2.4 não é suportado pela versão 0.10.4 do trac, é necessário utilizar a versão Pysqlite 2.3.5 ou a versão 0.10.5 dev do Trac.

Trac Project

Basta fazer o download do executável de instalação do Trac e percorrer o assistente de instalação. Assim como nas outras instalações, é reconhecida a versão instalada do Python e é sugerido um diretório de instalação:

Criando o projeto

Aparentemente isto é suficiente para o Trac funcionar. Podemos hospedá-lo de duas formas, com um servidor standalone ou utilizando o apache e fazendo acesso HTTP. Nos próximos passos vamos criar um projeto com o nome de Teste. Daqui para frente acabou a mamata dos assistentes, agora o Prompt é o nosso melhor amigo. Numa janela do Command do Windows navegue até a pasta Scripts do Python

# cd Python24\Scripts
# C:\Python24\Python.exe trac-admin ..\share\trac\projects\teste initenv

Depois é necessário entrar com alguns informações referentes ao projeto, tais como nome e conexão de dados. Não é necessário informar todos parâmetros, pois podem ser alterados no arquivo de configuração Trac.ini. Quando não entramos com dados, é assumido o valor padrão, por exemplo My Project.Os dados solicitados são:

1. Project Name [My Project]: Teste
2. Database connection string [sqlite:db/trac.db]: valor padrão
3. Repository Item [svn]: valor padrão
4. Path to repository [/path/to/repos/: (em branco configuraremos o subversion na próxima parte)
5. Temple directory [....]: valor padrão

Testando a configuração

Testar a configuração é bastante simples usando o servidor standalone do Trac: o tracd, que se encontra na pasta Scripts. Para iniciá-lo basta executar a seguinte linha de comando no prompt:

python tracd --port=8080 ..\share\trac\projects\teste

Para verificar se tudo ocorreu bem, basta entrar no seu navegador e digitar o endereço do sote dp projeto teste:

http://localhost:8080/teste

Bom, por enquanto é isso! No próximo post configuraremos o mod_python para rodar o Trac no Apache e depois configuraremos a integração com o Subversion.

Abraço