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

Jenkins é um servidor de automação bifurcado 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 software 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, eu vou mostrar como instalar a versão estável mais recente do Jenkins no Ubuntu Server 18.04 LTS (Bionic Beaver). Vamos rodar o Jenkins em nosso próprio nome de domínio e vamos instalar e configurar o Jenkins para rodar sob o proxy reverso do servidor web Apache.

Pré-requisitos

• Ubuntu 18.04
• Privilégios de root

O que faremos?

1. Instalar Java
2. Instalar Jenkins
3. Instalar e Configurar Apache2 como um Proxy Reverso para Jenkins
4. Configurar o Firewall UFW
5. Configurar Jenkins
6. Segurança do Jenkins
7. Testes

Passo 1 - Instalar Java

Jenkins é uma aplicação baseada em Java, então precisamos instalar o Java OpenJDK no servidor. Neste passo, vamos instalar o Java 8 de um repositório PPA que adicionaremos primeiro.

Instale os pacotes software-properties-common, depois adicione o repositório PPA do Java OpenJDK.

sudo apt install software-properties-common apt-transport-https -y  
sudo add-apt-repository ppa:openjdk-r/ppa -y

Agora instale o Java 8 usando o comando apt.

sudo apt install openjdk-8-jdk -y

Quando a instalação estiver completa, verifique a versão do Java instalada no sistema.

java -version

E você verá que o Java OpenJDK 1.8 está agora instalado no sistema Ubuntu 18.04.

Nota:

• Se você tiver várias versões do Java no seu sistema, altere a versão padrão do Java usando o comando abaixo.

sudo update-alternatives --config java

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

Agora atualize o repositório e instale o Jenkins.

sudo apt update  
sudo apt install jenkins -y

Quando a instalação estiver completa, inicie o serviço Jenkins e adicione-o ao tempo de inicialização.

systemctl start jenkins  
systemctl enable jenkins

O Jenkins agora está em funcionamento no servidor Ubuntu 18.04, rodando na porta padrão ‘8080’. Verifique usando netstat como abaixo.

netstat -plntu

E você verá o resultado como abaixo.

Passo 3 - Instalar e Configurar Apache2 como um Proxy Reverso para 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, vamos instalar o Apache e habilitar alguns módulos necessários, e depois criaremos o arquivo de host virtual com o nome de domínio jenkins.hakase-labs.io 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 ele aparecer.

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

sudo apt install apache2 -y

Quando a instalação estiver completa, 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 para o Jenkins no diretório sites-available.

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

Cole a configuração do host virtual abaixo.

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

Salve e saia, então ative o host virtual do Jenkins com o comando a2ensite.

a2ensite jenkins

Reinicie os serviços Apache e Jenkins.

systemctl restart apache2  
systemctl restart jenkins

A instalação e configuração do apache2 como um proxy reverso para o Jenkins foi concluída.

Passo 4 - Configurar o Firewall UFW

Antes de habilitar o firewall UFW no servidor Ubuntu, precisamos adicionar as portas de serviços básicos, como SSH, HTTP e HTTPS.

Adicione os serviços SSH, HTTP e HTTPS ao firewall ufw.

ufw allow ssh  
ufw allow http  
ufw allow https

Agora inicie e habilite o firewall ufw.

ufw enable

type ‘y’ e pressione Enter.

O firewall UFW agora está habilitado, e a porta HTTP foi adicionada.

Passo 5 - Configurar Jenkins

O Jenkins está rodando no nome de domínio ‘ http://jenkins.hakase-labs.io ‘. Abra seu navegador web e digite a URL.

Você verá a tela que solicita que você insira a senha inicial de 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 de administrador do Jenkins com o comando cat.

cat /var/lib/jenkins/secrets/initialAdminPassword

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

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

Instalações de plugins do Jenkins em andamento.

Após a instalação dos plugins estar completa, precisamos criar uma nova senha de administrador. Digite seu nome de usuário de administrador, senha, e-mail etc. e clique em ‘Salvar e Continuar’.

Para a configuração da instância, digite o nome de domínio do Jenkins ‘http://jenkins.hakase-labs.io’ e clique no botão ‘Salvar e Finalizar’.

Agora clique no botão ‘Começar a usar o Jenkins’.

E você será redirecionado para o painel de administração do Jenkins.

A instalação e configuração do Jenkins foi concluída com sucesso.

Passo 6 - Segurança do Jenkins

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’.

O Jenkins fornece vários métodos de autorização na seção ‘Controle de Acesso’. Vamos usar a ‘Segurança Baseada em Matriz’, para que possamos controlar todos os privilégios dos usuários.

Adicione o usuário ‘hakase’ na caixa ‘Usuário/Grupo’ e clique em adicionar.

Dê ao usuário ‘hakase’ todos os privilégios marcando todas as opções e clique no botão ‘Salvar’.

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

Passo 7 - Testes

Nesta seção, queremos criar um trabalho simples para o servidor Jenkins. Vamos criar um trabalho simples para testar o Jenkins e descobrir a carga do servidor com o comando top.

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

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

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’.

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

Após o trabalho ter sido executado, 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.

A instalação e configuração da ferramenta de automação Jenkins com Apache2 como um proxy reverso no Ubuntu 18.04 foi concluída com sucesso.

Referências

• https://wiki.jenkins.io/
• https://wiki.jenkins.io/Standard+Security+Setup
• https://jenkins-le-guide-complet.github.io/