Como Instalar o Jenkins no Ubuntu 22.04

Jenkins é uma ferramenta de automação de código aberto para Integração Contínua/Entrega Contínua (CI/CD). é totalmente escrito em Java com o suporte de mais de 1000 plugins para construir, implantar e automatizar seu projeto. O Jenkins se tornou uma das principais ferramentas de automação que acelera seu processo de desenvolvimento por meio da automação. O Jenkins integra processos do ciclo de vida de desenvolvimento, como construção, documentação, teste, empacotamento, estágio, implantação, análise estática e muitos mais.

O Jenkins suporta várias ferramentas de controle de versão, como Git, Subversion, Mercurial, CVS, Perforce e RTC. Além disso, pode executar Apache Ant, Apache Maven, scripts de shell e comandos em lote do Windows. O Jenkins tem um forte suporte da comunidade com documentação extensa e um wiki, o que torna o Jenkins uma das ferramentas de automação CI/CD mais utilizadas. Além disso, oferece muitas ferramentas diferentes, linguagens e tarefas de automação para automatizar seu processo de desenvolvimento e implantação.

Neste tutorial, você aprenderá como instalar o Jenkins na versão mais recente do Ubuntu 22.04. Este tutorial também cobre como configurar o Apache2 como um proxy reverso para o Jenkins com uma conexão SSL habilitada em cima dele. No final, você também aprenderá como criar o primeiro projeto de construção do Jenkins para executar scripts ou comandos de shell.

Pré-requisitos

Um servidor Ubuntu 20.04
Um usuário não-root com privilégios de administrador root.

Instalando o Java

Neste primeiro passo, você instalará o Java OpenJDK e JRE em seu sistema Ubuntu. A versão mais recente do Jenkins requer o Java v11, e agora você o instalará em seu sistema.

Antes de começar a instalar qualquer pacote, execute o comando apt abaixo para atualizar e refrescar seu repositório Ubuntu.

sudo apt update

Agora instale o Java OpenJDK 11 usando o seguinte comando.

sudo apt install openjdk-11-jre

Digite Y para confirmar e pressione ENTER para iniciar a instalação. Agora a instalação do Java OpenJDK começará.

instalando java openjdk

Após a instalação ser concluída, execute o comando java abaixo para verificar e confirmar a versão do java.

java --version

Na captura de tela a seguir, você pode ver que o Java OpenJDK 11 está instalado na máquina Ubuntu 22.04.

Instalando o Jenkins

Agora que você instalou o java em seu sistema Ubuntu, você começará a instalar o Jenkins na máquina Ubuntu 22.04.

Existem várias maneiras de instalar o Jenkins, a maneira mais fácil é usando o pacote pré-construído do Jenkins fornecido pelo repositório oficial do Jenkins. E para fazer isso, você precisará adicionar o repositório do Jenkins ao seu sistema Ubuntu.

Execute o comando abaixo para adicionar a chave GPG para o repositório do jenkins.

curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo tee \  
  /usr/share/keyrings/jenkins-keyring.asc > /dev/null

Depois disso, adicione o repositório do Jenkins ao seu sistema usando o comando abaixo.

echo deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] \  
  https://pkg.jenkins.io/debian-stable binary/ | sudo tee \  
  /etc/apt/sources.list.d/jenkins.list > /dev/null

Agora execute o comando apt abaixo para atualizar e refrescar todos os repositórios do seu sistema.

sudo apt update

Na captura de tela abaixo, você pode ver que o repositório do Jenkins foi adicionado.

adicionar repositório jenkins

Em seguida, você pode instalar o Jenkins usando o comando apt abaixo.

sudo apt install jenkins

Digite Y para confirmar a instalação e pressione ENTER para continuar. A instalação do Jenkins agora começará.

instalar jenkins

Após a instalação ser concluída, execute o seguinte comando para iniciar e habilitar o serviço do Jenkins.

sudo systemctl start jenkins  
sudo systemctl enable jenkins

Agora verifique o serviço do Jenkins usando o comando abaixo.

sudo systemctl status jenkins

Na captura de tela a seguir, o serviço do Jenkins está ativo e em execução. Ele está rodando em localhost com a porta padrão 8080. Além disso, o Jenkins agora está habilitado, o que significa que ele será executado automaticamente na inicialização do sistema.

iniciar habilitar verificar serviço jenkins

Configurando o Apache2 como um Proxy Reverso

Neste ponto, o Jenkins está em funcionamento no endereço padrão localhost com a porta 8080. Agora, você instalará e configurará o servidor web Apache2 como um proxy reverso para o jenkins.

O servidor web Apache2 estará rodando na frente do serviço Jenkins e abrirá as portas padrão HTTP e HTTPS para acesso do cliente.

Execute o comando apt abaixo para instalar o pacote apache2 em seu sistema.

sudo apt install apache2

Digite Y para confirmar a instalação e pressione ENTER para continuar.

instalando apache2

Agora, após a instalação ser concluída, execute o comando abaixo para habilitar alguns módulos do apache2 que são necessários para a configuração do proxy reverso.

sudo a2enmod ssl rewrite headers proxy proxy_http

Agora você verá a saída como na captura de tela a seguir.

habilitar módulos apache2

Em seguida, crie uma nova configuração de host virtual /etc/apache2/sites-available/jenkins.conf usando o editor nano.

sudo nano /etc/apache2/sites-available/jenkins.conf

Adicione a seguinte configuração ao arquivo. E certifique-se de alterar o nome do domínio e o caminho dos certificados SSL.

  
    ServerAdmin  webmaster@localhost  
    Redirect permanent / https://jenkins.howtoforge.local/  
  
  
  
    SSLEngine On  
    SSLCertificateFile /etc/letsencrypt/live/jenkins.howtoforge.local/fullchain.pem  
    SSLCertificateKeyFile /etc/letsencrypt/live/jenkins.howtoforge.local/privkey.pem  
    ServerAdmin  webmaster@localhost  
    ProxyRequests     Off  
    ProxyPreserveHost On  
    AllowEncodedSlashes NoDecode  
      
        Order deny,allow  
        Allow from all  
      
    ProxyPass         /  http://localhost:8080/ nocanon  
    ProxyPassReverse  /  http://localhost:8080/  
    ProxyPassReverse  /  http://jenkins.howtoforge.local/  
    RequestHeader set X-Forwarded-Proto "https"  
    RequestHeader set X-Forwarded-Port "443"

Salve e feche o arquivo quando terminar.

Em seguida, execute o seguinte comando para ativar a configuração do host virtual jenkins.conf.

sudo a2ensite jenkins.conf

Depois disso, verifique e confirme todas as suas configurações do Apache2 usando o comando abaixo.

sudo apachectl configtest

Certifique-se de obter a mensagem de saída como “ Syntax OK “, o que significa que todas as suas configurações do Apache2 estão corretas.

Por fim, execute o comando abaixo para reiniciar o serviço Apache2 e aplicar novas alterações à sua configuração do Apache2.

sudo systemctl restart apache2

Agora o servidor web Apache2 está em funcionamento com a configuração de proxy reverso para o Jenkins.

configurar apache2 proxy reverso jenkins

Iniciar a Instalação do Jenkins

Neste ponto, você está pronto para iniciar a instalação e configuração do Jenkins a partir do seu navegador web. Mas antes de começar a configurar o Jenkins, você precisará obter e pegar a senha de inicialização para o Jenkins.

A senha de inicialização para o Jenkins está disponível no arquivo /var/lib/jenkins/secrets/initialAdminPassword. Este arquivo contém a senha secreta gerada para inicializar sua instalação do Jenkins.

Execute o comando abaixo para verificar e obter a senha inicial do jenkins.

ls /var/lib/jenkins/secrets/initialAdminPassword  
cat /var/lib/jenkins/secrets/initialAdminPassword

Na captura de tela abaixo, você pode ver uma string aleatória gerada pelo Jenkins. Você pode ter um segredo aleatório diferente.

Copie a senha secreta inicial para suas anotações, isso será usado mais tarde para configurar o Jenkins.

senha inicialização jenkins

Abra seu navegador web e visite a URL de instalação para sua instalação do Jenkins (por exemplo, https://jenkins.howtoforge.local).

Na primeira página, você será solicitado a inserir a senha de inicialização para o Jenkins. Cole sua senha secreta para inicializar a instalação e configuração do Jenkins e clique em Continuar.

inicialização senha jenkins

Agora clique no botão “ Instalar plugins sugeridos “ para iniciar a configuração do Jenkins com plugins adicionais. Esta opção é boa para iniciantes, pois instalará automaticamente alguns plugins do Jenkins que podem ser necessários para seu projeto.

instalar plugins sugeridos

Agora a instalação do plugin do Jenkins começará e iniciará.

jenkins instalando plugins

Após o processo de instalação ser concluído, você será solicitado a criar um novo usuário administrador para o Jenkins.

Digite o novo usuário administrador, senha, endereço de e-mail e o nome completo para sua instalação do Jenkins e clique no botão Salvar e Continuar.

configurar admin jenkins

Para a URL de instalação do Jenkins, insira seu domínio do Jenkins e clique em Salvar e Concluir.

configurar url jenkins

E agora você verá a seguinte página. Clique no botão Reiniciar para reiniciar o serviço do Jenkins e aplicar novas configurações.

reiniciar jenkins

Uma vez que o Jenkins seja reiniciado, visite novamente o nome de domínio da sua URL de instalação do Jenkins e agora você verá a página de login do Jenkins.

Digite seu usuário administrador e senha para o Jenkins e clique em Entrar.

Uma vez que você tenha feito login, você verá o seguinte painel do Jenkins.

painel do jenkins

Agora você instalou e configurou com sucesso o Jenkins na versão mais recente do Ubuntu 22.04 com o Apache2 como um proxy reverso para sua implantação.

Criando a Primeira Construção do Jenkins

Após ter instalado e configurado com sucesso o Jenkins, agora você criará uma nova primeira construção do Jenkins a partir do painel do Jenkins.

No painel do Jenkins, clique no menu Novo Item para criar um novo projeto de construção do Jenkins.

jenkins criar construção

Digite o nome do projeto e selecione o tipo do projeto, em seguida clique em OK. Neste demo, o nome do projeto é “primeira construção” com o tipo de projeto “ Projeto Freestyle “.

criar construção freestyle jenkins

Na “ seção geral “, insira a descrição da sua construção.

Agora vá para a aba “ Construir “ e escolha a construção como “ Executar shell “ e insira o seguinte comando como o comando de construção.

echo "Este é um teste de construção no jenkins"

Este projeto apenas exibirá uma mensagem “Este é um teste de construção no jenkins” na saída da construção do Jenkins.

Agora clique no botão Salvar.

configurar construção executar shell

Agora, nos detalhes do projeto “ primeira construção “, clique no menu “ Construir Agora “ para iniciar e executar a construção do Jenkins.

construir projeto

Após o processo ser concluído, você pode ver a seção de histórico de construção no menu inferior como na captura de tela a seguir.

Clique no número da construção para obter detalhes da operação de construção que foi concluída.

histórico de construção jenkins

Agora clique no menu “ Saída do Console “ e você verá a saída da sua primeira construção do Jenkins, que é a mensagem “ Este é um teste de construção no jenkins “. E a construção do Jenkins foi um sucesso.

saída da construção jenkins

Conclusão

Parabéns! Você agora instalou com sucesso o Jenkins no servidor Ubuntu 22.04 mais recente com o Apache2 como um proxy reverso com conexão segura HTTPS habilitada. Além disso, você aprendeu a inicialização básica e a configuração do Jenkins, e também criou o primeiro projeto de construção simples usando o Jenkins.