Guia de Instalação e Configuração do HUDSON

Update: Aug 24th, 2010

1. Instalação

O requisito mínimo para para instalar e usar o Hudson é ter JRE 1.5 ou superior. O Hudson, por si só, já vem com o servlet engine Winstone embutido. Entretando, também podemos rodá-lo em qualquer container que suporte Servlet 2.4/JSP 2.0 ou superior, como Glassfish, Tomcat 5, JBoss, Jetty 6, etc. A seguir, iremos apresentar as instruções para instalação no Ubuntu utilizando ou não o Glassfish:

1.1. Instalando Hudson no Glassfish

– Baixe a ultima versão do hudson no link: http://hudson-ci.org/latest/hudson.war e faça o deployment no glassfish como você faria com qualquer outro arquivo war.
– Depois que o arquivo war esteja descompactado, execute o comando “chmod 755” no diretório hudson/WEB-INF “explodido”.
– O Hudson deve estar disponível no Glassfish (possivelmente, http://localhost:8080/hudson)

1.2. Instalando Hudson utilizando Winstone (servidor embutido)

1.2.1 Adicione a seguinte linha para seu /etc/apt/sources.list:

deb http://hudson-ci.org/debian binary/

1.2.2 Atualize o APT index:

sudo apt-get update

1.2.3 Instale o Hudson:

sudo apt-get install hudson

1.2.4 Acesse o endereço de instalação do Hudson na porta 8080 (http://localhost:8080)

2. Configuração

2.1. Controle de acesso – usuarios

2.1.1 Acesse “Gerenciar Hudson -> Configure System”
2.1.2 Habilite o checkbox “Habilitar segurança”
2.1.3 Habilite o radiobox Hudson’s own user database
2.1.4 Opcionalmente você poderá desmarcar o checkbox “Permitiar que usuários se inscrevam”

2.1.5 Clique em “Salvar” no fim da página. Irá aparecer a opção de “Manage Users” no gerenciamento do Hudson.

2.1.6 Adicione um usuário em “Gerenciar Hudson -> Manage Users -> Criar Usuário”

2.1.7 Volte até a página de configuração do sistema “Gerenciar Hudson -> Configure System”. O Hudson possui vários esquemas de autenticação, como listado a seguir:

  • Segurança baseada em matriz
  • Logged-in users can do anything
  • Anyone can do anything
  • Project-based Matrix Authorization Strategy
  • Modo legado

2.1.8 Iremos abordar o método “Segurança baseada em matriz”. Neste esquema, você pode configurar quem pode fazer o quê usando uma grande tabela. Por hora, queremos definir o usuário, que você acabou de criar, como o administrador do sistema. Então clique na opção “Segurança baseada em matriz” e aparecerá a tabela com apenas um usuário: anônimo.
2.1.9 Em “Usuário/grupo para adicionar” digite o login do usuário que você acabou de criar e clique em adicionar.
2.1.10 Marque a opção de administrador para seu usuário e clique em “Salvar” no fim da página. Você será redirecionado para a página de login.

2.1.11 A partir deste momento os usuários que se cadastrarem (ou forem cadastrados pelo administrador) só terão acesso quando o administrador conceder as devidas permissões, como nos passos anteriores 2.1.9 e 2.1.10.

2.2. Endereços para ANT, MAVEN, JDK

O processo de configuração do ANT, MAVEN, JDK são simplificados quando já existe uma instalação prévia dos mesmos. Partindo desta suposição, basta clicar no botão Add Ant, Add Maven ou Add JDK e desmarcar a opção “Install automatically”. Em seguida, informar o caminho de instalação e um identificador de cada um, de acordo com a necessidade. Ao final, clicar em “Salvar” no fim da página. As opções Ant e Maven são obrigatórias de acordo com a necessidade.

2.3. E-MAIL

Se você não possui um servidor de email que aceite fazer relay abertamente para a maquina do Hudson, então poderá configurar um facilmente no ubuntu. Para isso siga os passos a abaixo:

2.3.1 apt-get install exim
2.3.2 sudo dpkg-reconfigure exim4-config
2.3.3 Na segunda tela, escolha o tipo geral de configuração de email:
“site internet; mensagens são enviadas e recebidas diretamente via SMTP”

2.3.4 Daí por diante pode seguir aceitando a opção padrão até o fim.

2.3.5 Feito a configuração do servidor de email, acesse Gerenciar Hudson -> Configure System
2.3.6 Certifique-se de que o Servidor SMTP esteja configurado como localhost e informe o email do administrador do sistema na parte sobre “Notificação de E-mail”. Esse email irá aparecer como rementente das mensagens contendo relatórios de erros para os envolvidos.

  1. ricardo
    Feb 17th, 2011 at 09:44
    Reply | Quote | #1

    Tem como vocês me passarem um telefone para contato? Sou professor e gostaria de conversar com você para uma palestra.

  2. renato
    Jun 2nd, 2011 at 10:49
    Reply | Quote | #2

    é necessario instalar o Maven e o Ant, não tem como usar somente o Subversion

  3. anderson
    Jun 3rd, 2011 at 14:29
    Reply | Quote | #3

    @renato
    O Hudson utiliza o Maven e o ant como forma de complemento dos projetos. Fica sem sentido não instalar os mesmos. Se usar só o subversion é melhor utilizar o Tortoise ou outro do tipo.

  4. Fabio
    Oct 13th, 2011 at 12:15
    Reply | Quote | #4

    Anderson, sou totalmente novo em testes, e tenho uma duvida, e possivel utilizar o hudson com um projeto ja existente??? obrigado

  5. anderson
    Oct 14th, 2011 at 14:39
    Reply | Quote | #5

    Pode sim mas você terá que transferir o projeto existente para o padrão do Hudson. Que no final acaba por reescrever o projeto para a plataforma. Faço isso aqui em alguns projetos e funciona quando bem feito :D.