Como Instalar o Servidor de Automação Jenkins com Apache no Ubuntu 16.04

Jenkins é um servidor de automação derivado do projeto Hudson. Jenkins é uma aplicação baseada em servidor que roda em um contêiner de servlet Java, possui suporte para muitos sistemas de SCM (Gerenciamento de Controle de Fonte), incluindo Git, SVN e Mercurial. Jenkins fornece centenas de plugins para automatizar seu projeto. Jenkins foi criado por Kohsuke Kawaguchi, lançado pela primeira vez em 2011 sob a Licença MIT, e é um software livre.

Neste tutorial, vou mostrar como instalar a versão mais recente do Jenkins no Ubuntu Server 16.04. Vamos rodar o Jenkins em nosso próprio nome de domínio e vamos instalar e configurar o Jenkins para rodar sob o servidor web apache com o proxy reverso para o Jenkins.

Pré-requisitos

Ubuntu Server 16.04 - 64bit
Privilégios de Root

Passo 1 - Instalar Java OpenJDK 7

Jenkins é baseado em Java, então precisamos instalar a versão 7 do Java OpenJDK no servidor. Neste passo, vamos instalar o Java 7 de um repositório PPA que adicionaremos primeiro.

Por padrão, o Ubuntu 16.04 vem sem o pacote python-software-properties para gerenciar repositórios PPA, então devemos instalar este pacote primeiro. Instale o python-software-properties com o comando apt.

apt-get install python-software-properties

Em seguida, adicione o repositório PPA do Java ao servidor.

add-apt-repository ppa:openjdk-r/ppa  
Apenas pressione ENTER

Atualize o repositório do Ubuntu e instale o Java OpenJDK com o comando apt.

apt-get update  
apt-get install openjdk-7-jdk

Verifique a instalação digitando o comando abaixo:

java -version

e você obterá a versão do Java que está instalada no servidor.

Instalar Java 7 openJDK no Ubuntu 16.04

Passo 2 - Instalar Jenkins

Jenkins fornece um repositório Ubuntu para os pacotes de instalação e vamos instalar o Jenkins a partir deste repositório.

Adicione a chave e o repositório do Jenkins ao sistema com o comando abaixo.

wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo apt-key add -  
echo 'deb https://pkg.jenkins.io/debian-stable binary/' | tee -a /etc/apt/sources.list

Atualize o repositório e instale o Jenkins.

apt-get update  
apt-get install jenkins

Quando a instalação estiver concluída, inicie o Jenkins com este comando systemctl.

systemctl start jenkins

Verifique se o Jenkins está rodando verificando a porta padrão usada pelo Jenkins (porta 8080). Eu vou verificar com o comando netstat abaixo:

netstat -plntu

O Jenkins está instalado e rodando na porta 8080.

Jenkins foi instalado na porta 8080

Passo 3 - Instalar e Configurar o Apache como Proxy Reverso para o Jenkins

Neste tutorial, vamos rodar o Jenkins atrás de um servidor web apache, vamos configurar o apache como o proxy reverso para o Jenkins. Primeiro, vou instalar o apache e habilitar alguns módulos necessários, e depois criarei o arquivo de host virtual com o nome de domínio my.jenkins.id para o Jenkins. Por favor, use seu próprio nome de domínio aqui e substitua-o em todos os arquivos de configuração onde quer que apareça.

Instale o servidor web apache2 do repositório do Ubuntu.

apt-get install apache2

Quando a instalação estiver concluída, habilite os módulos proxy e proxy_http para que possamos configurar o apache como servidor frontal/proxy reverso para o Jenkins.

a2enmod proxy  
a2enmod proxy_http

Em seguida, crie um novo arquivo de host virtual no diretório sites-available.

cd /etc/apache2/sites-available/  
vim jenkins.conf

Cole a configuração do host virtual abaixo.

  
    ServerName        my.jenkins.id  
    ProxyRequests     Off  
    ProxyPreserveHost On  
    AllowEncodedSlashes NoDecode  
   
      
      Order deny,allow  
      Allow from all  
      
   
    ProxyPass         /  http://localhost:8080/ nocanon  
    ProxyPassReverse  /  http://localhost:8080/  
    ProxyPassReverse  /  http://my.jenkins.id/

Salve o arquivo. Em seguida, ative o host virtual do Jenkins com o comando a2ensite.

a2ensite jenkins

Reinicie o Apache e o Jenkins.

systemctl restart apache2  
systemctl restart jenkins

Verifique se as portas 80 e 8000 estão em uso pelo Jenkins e Apache.

netstat -plntu

Verifique se o Apache e o Jenkins estão rodando

Passo 4 - Configurar o Jenkins

O Jenkins está rodando no nome de domínio ‘my.jenkins.id’. Abra seu navegador web e digite a URL. Você verá a tela que solicita que você insira a senha inicial do administrador. Uma senha já foi gerada pelo Jenkins, então só precisamos mostrar e copiar os resultados para a caixa de senha.

Mostre a senha inicial do administrador do Jenkins com o comando cat.

cat /var/lib/jenkins/secrets/initialAdminPassword  
   
a1789d1561bf413c938122c599cf65c9

Cole os resultados na tela e clique em ‘Continuar‘.

Instalação e Configuração do Jenkins

Agora devemos instalar alguns plugins no Jenkins para ter uma boa base para uso posterior. Escolha ‘Instalar Plugins Sugeridos‘, clique nele.

Instalar Plugins do Jenkins

Instalações de plugins do Jenkins em andamento.

Plugins do Jenkins sendo instalados

Após a instalação do plugin, precisamos criar uma nova senha de administrador. Digite seu nome de usuário de administrador, senha, e-mail etc. e clique em ‘Salvar e Concluir‘.

Criar conta de administrador do Jenkins

Clique em iniciar e comece a usar o Jenkins. Você será redirecionado para o painel de administração do Jenkins.

Redirecionado para o painel de administração

Instalação e Configuração do Jenkins concluídas com sucesso.

O painel de administração do Jenkins

Passo 5 - Segurança do Jenkins

A partir do painel de administração do Jenkins, precisamos configurar as configurações de segurança padrão para o Jenkins, clique em ‘Gerenciar Jenkins‘ e depois em ‘Configurar Segurança Global‘.

Configurações de Segurança Global do Jenkins

O Jenkins fornece vários métodos de autorização na seção ‘Controle de Acesso‘. Eu seleciono ‘Segurança Baseada em Matriz‘ para poder controlar todos os privilégios dos usuários. Habilite o usuário administrador na caixa ‘Usuário/Grupo‘ e clique em adicionar. Dê ao administrador todos os privilégios marcando todas as opções, e dê ao anônimo apenas permissões de leitura. Agora clique em ‘Salvar‘.

Configurar Permissões do Jenkins

Você será redirecionado para o painel, e se houver a opção de login, basta digitar seu usuário e senha de administrador.

Passo 6 - Testando um trabalho de automação simples

Nesta seção, eu só quero testar um trabalho simples para o servidor Jenkins. Vou criar um trabalho simples para testar o Jenkins e descobrir a carga do servidor com o comando top.

A partir do painel de administração do Jenkins, clique em ‘Criar Novo Trabalho‘.

Criar um novo Trabalho no Jenkins

Digite o nome do trabalho, vou usar ‘Verificando Sistema’ aqui, selecione ‘Projeto Freestyle‘ e clique em ‘OK‘.

Configurar novo Trabalho do Jenkins

Vá para a aba ‘Construir‘. Na opção ‘Adicionar etapa de construção‘, selecione a opção ‘Executar shell‘.

Digite o comando abaixo na caixa.

top -b -n 1 | head -n 5

Clique em ‘Salvar‘.

Iniciar um Trabalho do Jenkins

Agora você está na página do trabalho do ‘Projeto verificando sistema’. Clique em ‘Construir Agora‘ para executar o trabalho ‘verificando sistema’.

Após a execução do trabalho, você verá o ‘Histórico de Construção‘, clique no primeiro trabalho para ver os resultados.

Aqui estão os resultados do trabalho executado pelo Jenkins.

Construir e executar um Trabalho do Jenkins

A instalação do Jenkins com o servidor web Apache no Ubuntu 16.04 foi concluída com sucesso.