Jenkins no Debian 12

Em determinada atividade foi necessário instalar o Jenkins no Debian 12.

Antes de começar a instalação, o requisito deste é o Java 21 – que pode ser encontrado aqui.

Pré-requisito

$ sudo apt update
$ sudo apt dist-upgrade
$ sudo apt install -y wget apt-transport-https gpg

Instalação

Instale as chaves do repositório:

$ wget -qO - https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null

Adicione o repositório:

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

Atualize e instale o Jenkins:

$ sudo apt update
$ sudo apt install jenkins

Verifique se está funcionando corretamente:

$ sudo systemctl status jenkins

Execute o seguinte comando para obter a senha inicial:

$ sudo cat /var/lib/jenkins/secrets/initialAdminPassword

Com um resultado parecido com este:

85e14342549942dc808eafa33103df33

Salve essa informação que é necessária para o primeiro acesso.

Docker

Para evitar os conflitos que existem na construção dos projetos com versões de SDKs diferentes e manter o ambiente mais limpo e organizado, iremos utilizar o Docker.

Siga esse guia para instalação.

Ao concluir a instalação é necessário adicionar o usuário do sistema Jenkins ao grupo do Docker:

$ sudo sed -i '/^docker:/ s/$/,jenkins/' /etc/group
$ sudo getent group docker

Isso é necessário para que haja a devida comunicação entre o Jenkins e o Docker.

Configuração

Acesse o servidor que estará em http://127.0.0.1:8080:

Forneça o código que foi obtido acima e clique no botão Continue.

Na próxima tela clique no botão Install suggested plugins:

E aguarde a conclusão da configuração:

Após a configuração é apresentada uma tela para criar o usuário administrativo:

Clique no botão Save and Continue.

Forneça o endereço do Jenkins e clique no botão Save and Finish.

Clique no botão Start using Jenkins para começar a utilizar o sistema.

Plugins necessários

Os seguintes plugins são necessários para o próximo passo que é criar trabalhos de construção integrados com o Git:

• Docker Pipeline (docker-workflow)
• Git Parameter (git-parameter)
• Pipeline: Stage View (pipeline-stage-view)
• SSH Agent (ssh-agent)

Execute os seguintes passos para os instalar.

No menu lateral esquerdo, escolha o submenu Manage Jenkins:

Escolha a opção Plugins:

No menu lateral esquerdo, escolha o submenu Available plugins:

Forneça o nome dos plugins da lista acima na caixa de texto Search available plugins.

Clique no botão Install.

A página será atualizada e começará a instalação dos plugins.

Siga para o final desta página e marque a caixa de seleção Restart Jenkins when installation is complete and no jobs are running.

Quando a instalação estiver concluída automaticamente o Jenkins será reinicializado.

Área de acesso do Jenkins:

Próximos passos

• Configurando um projeto Git no Jenkins