Como Configurar Jenkins Master e Slave no Ubuntu

Jenkins é um servidor de automação bifurcado do projeto Hudson. Ele tem suporte para muitos sistemas de software SCM (Gerenciamento de Controle de Fonte), incluindo Git, SVN e Mercurial. O Jenkins fornece centenas de plugins para automatizar seu projeto. O Jenkins oferece suporte para uma arquitetura ‘master/slave’, permitindo que ele hospede um grande número de compilações de projetos.

Como funciona a arquitetura ‘master/slave’ do Jenkins?

A arquitetura master/slave do Jenkins é usada para ambientes de construção distribuídos, onde a carga de trabalho de construção de projetos é distribuída para vários nós agentes, e podemos usar diferentes ambientes para cada construção.

Na arquitetura ‘master/slave’ do Jenkins, um master se representa como uma instalação básica do Jenkins e lida com todas as tarefas para o sistema de construção. O nó master do Jenkins será usado para agendar trabalhos, monitorar nós escravos, despachar compilações para nós escravos, registrar e representar o resultado da construção, e executar trabalhos de construção diretamente.

Os nós escravos do Jenkins são configurados para descarregar projetos de construção do master, e é necessária uma conexão estabelecida entre o master e os escravos. Os nós escravos do Jenkins podem rodar em vários sistemas operacionais, como Windows e Linux, e não há necessidade de instalar pacotes completos do Jenkins neles.

Este tutorial nos ensinará como configurar a arquitetura master-slave do Jenkins usando a versão mais recente do Ubuntu. Aprenderemos a configurar o servidor master do Jenkins e adicionar outros nós Ubuntu como escravos do Jenkins.

Pré-requisitos

• Servidor Ubuntu (Ubuntu 22.04 - Ubuntu 16.04) - master - 10.0.15.10
• slave01 - 10.0.15.21
• slave02 - 10.0.15.22
• Privilégios de root

O que faremos?

1. Instalar Jenkins Master
2. Configurar Credenciais do Jenkins Master
3. Configurar Nós Agentes Escravos
4. Adicionar Novos Nós Escravos
5. Preparar Nós Agentes Escravos para Executar Construção
6. Testando

Passo 1 - Instalar Jenkins Master

Neste tutorial, não cobriremos a instalação básica do Jenkins. Vários artigos no HowtoForge cobrem a instalação do Jenkins.

• Instalar Jenkins no Ubuntu 16.04
• Instalar Jenkins no Ubuntu 18.04
• Instalar Jenkins no Ubuntu 20.04
• Instalar Jenkins no Ubuntu 22.04
• Instalar Jenkins no CentOS 7

A seguir está nosso servidor master Ubuntu com o Jenkins instalado.

Passo 2 - Configurar Credenciais do Jenkins Master

Quando você tiver o servidor master do Jenkins instalado, precisamos configurar o próprio servidor master. Por padrão, existem diferentes maneiras de iniciar nós agentes do Jenkins, podemos lançar os nós agentes através de SSH, uma conta administrativa do Windows e via Java Web Start (JNLP), escolha a melhor maneira dependendo da configuração do seu ambiente e sistema operacional.

Para este guia, lançaremos os nós agentes através de ssh, e precisamos configurar as credenciais do Jenkins em nosso servidor master.

Gerar Chave SSH

Usaremos a autenticação de chave ssh para configurar nossos nós agentes, então precisamos gerar a chave ssh para o usuário Jenkins e, em seguida, fazer o upload manual da chave para cada nó servidor usando ‘ssh-copy-id’.

No servidor master do Jenkins, faça login no usuário Jenkins e gere a chave ssh.

su - jenkins  
ssh-keygen

E você obterá a chave privada ‘id_rsa’ e a chave pública ‘id_rsa.pub’ no diretório ‘.ssh’.

Configurar Credenciais no Jenkins

Abra seu painel do Jenkins e clique no menu ‘Credenciais’ à esquerda.

E clique no link do domínio ‘global’.

Agora clique em ‘Adicionar Credenciais’.

Agora escolha o método de autenticação.

• Tipo: Nome de usuário SSH com chave privada
• Escopo: Global
• Nome de usuário: jenkins
• Chave privada: Digite diretamente e cole a chave privada ‘id_rsa’ do usuário Jenkins do servidor master.

Clique em ‘OK’.

E a credencial do Jenkins com o método de chave de autenticação ssh foi criada.

Passo 3 - Configurar Nós Escravos

Agora configuraremos os servidores nós escravos instalando java nesses servidores e criando um novo usuário Jenkins.

Instalar Java

Instale os pacotes ‘software-properties-common’ e adicione o repositório PPA do java.

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

Agora instale o java OpenJDK usando o comando apt abaixo.

sudo apt install openjdk-8-jdk -y

Após a instalação ser concluída, verifique a versão do java instalada.

java -version

E você obterá o Java OpenJDK 1.8 instalado no sistema.

Adicionar Novo Usuário Jenkins

Agora adicione o usuário ‘Jenkins’ a todos os nós agentes.

Execute o comando abaixo.

useradd -m -s /bin/bash jenkins  
passwd Jenkins

O usuário ‘Jenkins’ para os nós agentes foi criado.

Copiar a Chave SSH do Master para o Slave

Em seguida, devemos fazer o upload da chave ‘id_rsa.pub’ do master para os nós servidores escravos. Precisamos fazer o upload para cada nó servidor usando o comando ‘ssh-copy-id’ como abaixo.

ssh-copy-id [email protected]  
ssh-copy-id [email protected]

Digite a senha do usuário Jenkins.

A chave ssh ‘id_rsa.pub’ foi carregada em todos os nós agentes.

Passo 4 - Adicionar Novos Nós Escravos

No painel do Jenkins, clique no menu ‘Gerenciar Jenkins’ e clique em ‘Gerenciar Nós’.

Clique em ‘Novo Nó’.

Digite o nome do nó ‘slave01’, escolha o ‘agente permanente’ e clique em ‘OK’.

Agora digite os detalhes das informações do nó.

• Descrição: servidor agente do nó slave01
• Diretório raiz remoto: /home/jenkins
• Rótulos: slave01
• Método de lançamento: Lançar agente escravo via SSH, digite o endereço IP do host ‘10.0.15.21’, escolha a autenticação usando a credencial ‘Jenkins’.

Agora clique no botão ‘Salvar’ e aguarde o servidor master se conectar a todos os nós agentes e iniciar os serviços do agente.

Abaixo estão os resultados quando o servidor master está conectado a todos os nós agentes.

Os nós escravos do Jenkins foram adicionados ao servidor master.

Passo 5 - Preparar Nós Agentes Escravos para Executar Construção

Neste passo, configuraremos o master do Jenkins para executar a construção nos nós agentes escravos.

Clique no menu ‘Gerenciar Jenkins’ e depois clique em ‘Configurar Sistema’.

Agora vá para a seção ‘Configurações de Escravo’ e defina tudo o que você precisa, conforme mostrado abaixo.

Mais informações sobre as ‘Configurações de Escravo’ no link.

Clique no botão ‘Salvar’ e agora estamos prontos para executar a construção nos nós agentes escravos.

Passo 6 - Testando

Agora queremos criar uma nova construção simples para o Jenkins e executar a construção nos nós agentes ‘slave01’ e ‘slave02’.

No painel do Jenkins, clique no menu ‘Novo Item’.

Digite o nome do item, escolha o projeto freestyle e clique em ‘OK’.

Na seção geral, digite a descrição do trabalho e marque a opção ‘Restringir onde este projeto pode ser executado’.

Na ‘Expressão de Rótulo’, especifique o nó, como ‘slave01’.

Mova para a seção de construção e escolha a opção ‘Executar shell’, digite o comando abaixo.

top -b -n 1 | head -n 10 && hostname

Clique no botão ‘Salvar’, e você será redirecionado para a página do trabalho.

Clique em ‘Construir Agora’ para construir o projeto e, em seguida, clique no item na seção ‘Histórico de Construção’.

E o seguinte é meu resultado.

Construção no nó agente ‘slave01’.

Construção no nó agente ‘slave02’.

A instalação e configuração da arquitetura master/slave do Jenkins e as construções distribuídas do Jenkins foram concluídas com sucesso.

Referências

• https://wiki.jenkins.io/