Integração contínua de projeto Java com Jenkins

Para demonstrar a configuração de um projeto novo, iremos utilizar um projeto simples, criado para esse tutorial. Ele possui apenas duas classes bem simples e uma classe de teste com o JUnit. Além disso, o projeto possui um build.xml configurado para compilar o  projeto, executar os testes e gerar um jar. Você pode também ir aplicando todos os passos em seu próprio projeto. Se você ainda não desenvolve com integração contínua, vai poder mudar bastante a forma com que sua equipe desenvolve e receber um feedback contínuo do que está acontecendo.

Como o projeto se encontra em um repositório Git, será necessário instalar um plugin do Git no Jenkins (inicialmente, o Jenkins só suporta CVS e SVN). Para isso, vá até o plugin manager do Jenkins (Manage Jenkins > Manage Plugins) na aba Avaiable, habilite o Git Plugin e clique em Download now and install after restart (pode ser que não exista nenhum plugin disponível na aba Avaiable, nesse caso, vá até a aba Advanced e clique em Check Now para atualizar o repositório de plugins). Depois do término da instalação do plugin, você deverá reiniciar o Jenkins.

Com o plugin instalado, podemos criar uma nova task no Jenkins para compilar e executar os testes do nosso projeto. Clique em New Job, dê um nome a ele, selecione a opção Build a free-style software project e clique em Ok. Você será redirecionado para a página de configurações do projeto.

Na seção Source Code Management, selecione Git e coloque a url pública do repositório (git://github.com/csokol/jenkins-exemplo.git). Em Build Triggers, selecione Poll SCM e no campo Schedule coloque "*/5 * * * *". Essa configuração determina que o Jenkins irá verificar se houve alterações no repositório desde o último build a cada cinco minutos. Se existir alguma, irá atualizar o seu repositório e executar o job.

Nesse projeto temos duas targets principais do ant que queremos executar no Jenkins, uma para executar os testes e outra para gerar um jar do projeto, pronto para ser distribuído. Para configurar a execução dessas targets, selecione a opção Invoke Ant na seção Build e no campo Targets coloque test jar, essas são as targets que executa os testes e gera o jar, respectivamente.

Agora, precisamos configurar as ações que o Jenkins irá executar depois de executar o ant. Caso exista alguma falha nos testes ou na criação do jar, o Jenkins deve notificar a equipe, para isso, na seção Post-build Actions selecione E-mail Notification e adicione os emails que devem ser notificados em caso de falha no build. Além disso, gostaríamos também de guardar o jar gereado pelo ant, para isso, selecione Archive the artifacts e coloque target/*.jar no campo Files to archive. Assim, toda vez que o job for executado, o Jenkins irá disponibilizar o jar para download em sua interface. Clique em Save para salvar as configurações.

Pronto! Agora o projeto está configurado e cada alteração no repositório irá disparar o Job no Jenkins, executando os testes de unidade:

Como nesse momento o Job nunca foi executado, o primeiro irá iniciar automaticamente e você poderá vizualizá-lo no painel do lado esquerdo em Build history. Você também pode inicar o processo manualmente, clicando em Build Now. Com o build finalizado, você pode visualizar sua página de status, onde poderá baixar o jar criado e também examinar o resultado dos testes em Console Output.

O Jenkins oferece muitos outros recursos além dos descritos aqui, ele é capaz de executar diversas tarefas, como colocar deployar um war em um servidor em produção, gerar relatórios de cobertura de testes, calcular métricas sobre o código do projeto, entre outras. Você poderá conhecer essas funcionalidades explorando os plugins disponíveis ou mesmo desenvolvendo o seu.