Integração contínua com Jenkins

Livros

Conheça os outros livros.

Intercâmbio de Conteúdos Digitais

De A a Zabbix

Gerência de Configuração com Puppet

Arquivos

Recursos didáticos para auxiliar na leitura e execução dos exercícios.

Máquinas Virtuais

Repositório git

Applivro

Errata 1-Mar/2019

Errata 2-Ajuste na configuração do Nexus – Nov/2019

Errata 3-Ajuste nas configurações das VMs e comandos de alguns contêineres – Nov/2020

Errata 2-Ajuste na configuração do Nexus – Nov/2019

Olá, pessoal!

Com as novas versões do Sonatype Nexus lançadas ao longo de 2019, é necessário realizar o passo a passo abaixo para obter a senha inicial e permitir acesso anônimo aos artefatos hospedados no Nexus para que o pipeline dos capítulos 8 e 9 do livro funcionem corretamente.

A senha inicial do Nexus pode ser obtida com o comando a seguir.

cat /docker/nexus/data/admin.password

Pode ser que demore alguns minutos para o arquivo ser criado após o conteiner do Nexus ter sido executado pela primeira vez.

Acesse o nexus hospedado na porta 8081/TCP do host ci-server.domain.com.br. Faça login no Nexus, com o login admin e a senha inicial. Caso tenha alterado a senha durante o primeiro acesso do Nexus, informe a nova senha cadastrada. Será solicitado uma nova senha.

Quando for perguntado se deve permitir acesso anônimo ao Nexus, diga que sim.

Caso, não tenha habilitado o acesso anônimo durante o primeiro acesso ao Nexus, acesse o menu Security > Anonymous. Marque a opção Allow anonymous users to access the server, conforme mostra a figura a seguir. Depois clique em Save.

Pronto! Pode continuar seguindo as instruções do livro.

Bons estudos!

Errata 3-Ajuste nas configurações das VMs e comandos de alguns contêineres – Nov/2020

Olá, pessoal!

Torço para que vocês e seus familiares fiquem bem em meio à pandemia e desejo saúde aos que precisam!

Durante a leitura do livro, Thiago Augusto Negrão Orbite encontrou alguns problemas e após vários testes e um detalhado troubleshooting encontramos a solução que será detalhada a seguir e que pode ajudar outras pessoas que vierem a ter esses problemas. Thiago, muito obrigado pela confiança e tempo investido!

Problema 1: O contêiner do Nexus não estava iniciando por falta de memória.

Lendo o log de cima para baixo, o primeiro erro que ocorre é esse:

ERROR [FelixStartLevel] *SYSTEM com.orientechnologies.orient.core.storage.impl.local.paginated.OLocalPaginatedStorage - Exception <code>0CDBA14C</code> in storage <code>plocal:/nexus-data/db/OSystem</code>: 2.2.36 (build d3beb772c02098ceaea89779a7afd4b7305d3788, branch 2.2.x)
<strong>java.lang.OutOfMemoryError</strong>: null
at sun.misc.Unsafe.allocateMemory(Native Method)
at java.nio.DirectByteBuffer.(DirectByteBuffer.java:127)
Onde java.lang.OutOfMemoryError é uma mensagem padrão do Java que indica falta de memória.

Solução: Aumentar a quantidade de memória RAM da VM ci-server de 3 GB para 4GB. Essa VM é utilizada para executar vários outros serviços, tais como: Jenkins, Sonarqube, Gogs e PostgreSQL. Com o passar do tempo novas funcionalidades são adicionadas a estes serviços e para todos funcionarem corretamente na mesma VM é necessário aumentar a quantidade de memória.

Problema 2: O contêiner do Nexus não estava iniciando por falta de espaço em disco.

Após corrigir o problema anterior, apareceu no log o seguinte erro:

<strong>OLowDiskSpaceException</strong>: Error occurred while executing a write operation to database 'OSystem' due to limited free space on the disk (4012 MB). The database is now working in read-only mode. Please close the database (or stop OrientDB), make room on your hard drive and then reopen the database. The minimal required space is 4096 MB. Required space is now set to 4096MB (you can change it by setting parameter storage.diskCache.diskFreeSpaceLimit) .
DB name="OSystem

O trecho do log indica que o Nexus precisa de pelo menos 4 GB de espaço em disco para criar o banco de dados.

Solução: Aumentar o tamanho do disco (HD) das VMs de 10 GB para 30 GB.

As soluções dos problemas 1 e 2 foram aplicadas ao arquivo capitulo_02/vagrant/Vagrantfile conforme mostrado neste commit:

https://gitlab.com/livro/jenkins/-/commit/eec27883006a2a5854c93e0552e8e975a141538a

Problema 3: Erro de sintaxe na opção --restart no comando que inicia os contêineres do Nexus, Jenkins e Sonarqube.

Solução: A alteração foi aplicada conforme mostrado nestes commits:

Antes:

--restart always

Depois:

--restart=always

Problema 4: Obter a senha inicial do Nexus.

Solução: A solução já tinha sido publicado em Nov/2019 na Errata 2. Também foi reforçado o comando no arquivo capitulo_02/nexus.txt, conforme mostrado em: https://gitlab.com/livro/jenkins/-/blob/master/capitulo_02/nexus.txt.

Problema 5: Erro ao configurar o LDAP utilizando o plugin Jenkins Configuration as a Code (JCasC).

Solução: A solução já tinha sido publicado no arquivo capitulo_03/jenkins.yaml, conforme mostrado em: https://gitlab.com/livro/jenkins/-/blob/master/capitulo_03/jenkins.yaml.

Este é um plugin que muda muito rápido com o tempo e a configuração também depende do trabalho dos desenvolvedores responsáveis por cada um dos outros 1.500 plugins do Jenkins para manter a compatibilidade a cada nova versão do JCasC.

JCasC releases: https://github.com/jenkinsci/configuration-as-code-plugin/releases

Plugins Jenkins: https://plugins.jenkins.io

Na execução do livro você não precisará ter o Jenkins integrado ao LDAP, mas entendo a importância disso para uso no trabalho e por isso fiz uma rápida pesquisa e separei estes links para quem tiver interesse em saber mais sobre este plugin:

Bons estudos!

Resumo

Neste livro você entenderá os conceitos e as diferenças entre Continuous Integration, Continuous Delivery e Continuous Deploy. Conhecerá um caso de uso do Jenkins ao ser integrado com as ferramentas: Gogs, Maven, Nexus, SonarQube, Docker, Terraform e Shell Script. Este conjunto de ferramentas permite automatizar um cliclo de desenvolvimento, testes e implantação de uma aplicação web. Você também conhecerá alguns conceitos próprios do Jenkins, aprenderá a configurá-lo como código, alterar o tema, instalar plugins, gerenciar usuários, credenciais e escrever pipelines. Para ler e praticar os conhecimentos compartilhados neste livro não é necessário nenhum conhecimento prévio sobre Jenkins e o público alvo são estudantes da área de Tecnologia da Informação, administradores de sistemas, administradores de rede, desenvolvedores e gerentes.

Características

Estas são algumas das características do Jenkins.

Integração

Integre o Jenkins a ferramentas de versionamento de código, testes, build, orquestração de conteineires, gerência de configuração, deploy e envio de notificações.
Automação

Automatize tarefas que vão desde o push no repositório Git até o deploy em ambientes de teste, homologação e produção.
Pipeline

Desenvolva pipelines em etapas que facilitem a visualização do andamento do trabalho automatizado realizado pelo Jenkins.
Agilidade

Com o Jenkins você conseguirá identificar problemas em alguma etapa do pipeline mais rápido e fazer deploy com maior frequência de forma automatizada confiável.