Explorando a Interface do Jenkins

Introdução

Bem-vindo à sua primeira experiência prática com o Jenkins. Jenkins é um poderoso servidor de automação open-source usado para construir, testar e implantar software, uma prática conhecida como Integração Contínua e Implantação Contínua (CI/CD).

Neste laboratório, você se familiarizará com os aspectos fundamentais da interface do usuário do Jenkins. Guiar-lhe-emos pelo painel principal, mostraremos como criar e configurar seu primeiro projeto simples, executar uma compilação (build) e inspecionar os resultados. O serviço Jenkins já está instalado e em execução neste ambiente, para que você possa se concentrar diretamente na exploração de seus recursos.

Ao final deste laboratório, você será capaz de:

• Navegar pelo painel principal do Jenkins.
• Criar um novo projeto Freestyle.
• Executar um job de compilação (build) manualmente.
• Visualizar o histórico de compilações (build history) e a saída do console (console output).

Vamos começar.

Acessando e Explorando o Painel do Jenkins

Nesta etapa, você fará login na interface web do Jenkins e se familiarizará com o painel principal. O serviço Jenkins já está em execução em um contêiner para você.

Primeiro, acesse a interface web do Jenkins. No topo da sua tela LabEx, clique na aba Desktop Interface. Dentro da área de trabalho virtual, abra o navegador web Firefox. O navegador abrirá automaticamente em http://localhost:8080, então você não precisa inserir o URL manualmente. Nenhum login é necessário.

Você verá o painel principal do Jenkins. Reserve um momento para observar seus componentes principais:

• Barra Lateral de Navegação (Esquerda): Este é o seu menu de navegação principal. Você encontrará links importantes como New Item (para criar novos jobs) e Build History (uma visão global de todas as builds).
• Área de Conteúdo Principal: Esta área exibe uma lista de todos os jobs que você criou. Inicialmente, ela estará vazia.

Agora que você está familiarizado com o painel, está pronto para criar seu primeiro projeto.

Criando um Projeto Freestyle

Nesta etapa, você criará seu primeiro job (tarefa) no Jenkins usando o tipo "Freestyle project". Um projeto Freestyle é uma opção altamente flexível e fácil de usar, perfeita para iniciantes e para uma ampla variedade de tarefas de automação.

1. Na interface web do Jenkins, clique em New Item (Novo Item) na barra de navegação lateral esquerda.

2. Na próxima página, você precisará fornecer um nome para o seu projeto e selecionar seu tipo.

   • No campo Enter an item name (Insira um nome de item), digite My-First-Job.
   • Selecione Freestyle project na lista de opções.
   • Clique no botão OK na parte inferior.

3. Você estará agora na página de configuração do projeto. É aqui que você define o que seu job fará. Para este laboratório, adicionaremos uma única e simples etapa de compilação (build step). Role a página para baixo até a seção Build Steps (Etapas de Compilação).

4. Clique no botão suspenso Add build step (Adicionar etapa de compilação) e selecione Execute shell (Executar shell). Isso permite que você execute comandos shell como parte da sua compilação.

5. Uma caixa de comando aparecerá. Nesta caixa, digite o seguinte comando:

   echo "Hello from my first Jenkins job!"

6. Finalmente, role até o final da página e clique no botão Save (Salvar).

Após salvar, o Jenkins o redirecionará para a página principal do seu projeto recém-criado, My-First-Job.

Executando o Job de Build

Nesta etapa, você executará, ou fará o "build", do job que acabou de criar. Executar um job significa processar as etapas que você configurou para ele.

Você deve estar atualmente na página do projeto para My-First-Job. Se você navegou para outra página, pode retornar clicando no nome dele no painel principal do Jenkins.

1. Na página do projeto para My-First-Job, observe a barra lateral de navegação à esquerda. Você verá uma opção chamada Build Now (Construir Agora).

2. Clique em Build Now para iniciar o processo de build.

Assim que você clicar, um novo build será agendado. Você o verá aparecer na seção Build History (Histórico de Builds) no canto inferior esquerdo. O build será atribuído um número, começando com #1.

Um pequeno ícone de status aparece ao lado do número do build. Um ícone verde piscando significa que o build está em andamento. Um círculo verde sólido significa que o build foi bem-sucedido. Como nosso job é muito simples, ele será concluído em apenas um ou dois segundos.

Você agora acionou com sucesso seu primeiro build.

Visualizando a Saída do Console

Nesta etapa, você aprenderá a verificar os resultados da sua compilação (build). Revisar a saída é uma parte crítica de qualquer processo de automação, pois informa exatamente o que aconteceu e se foi bem-sucedido.

1. Na página do projeto My-First-Job, observe a seção Histórico de Compilações (Build History) no canto inferior esquerdo. Você deverá ver sua primeira compilação, rotulada como #1, com um círculo verde indicando sucesso.

2. Clique no número da compilação #1 para acessar a página de detalhes dessa compilação específica.

3. Na página da compilação, você verá vários detalhes sobre ela, como quando foi executada. O link mais importante aqui para depuração (debugging) é Saída do Console (Console Output). Clique em Console Output na barra lateral esquerda.

4. A página de Saída do Console exibe um log detalhado de cada ação que o Jenkins executou durante a compilação. Você verá que o Jenkins iniciou a compilação, executou seu comando shell e, em seguida, marcou a compilação como concluída.

A saída deve ser semelhante a esta:

Started by user admin
Running as SYSTEM
Building in workspace /var/jenkins_home/workspace/My-First-Job
[My-First-Job] $ /bin/sh -xe /tmp/jenkins12345.sh
+ echo 'Hello from my first Jenkins job!'
Hello from my first Jenkins job!
Finished: SUCCESS

Como você pode ver, o log inclui o comando echo que configuramos e sua saída: Hello from my first Jenkins job!. O status final Finished: SUCCESS confirma que o job foi executado sem erros.

Resumo

Parabéns por completar este laboratório introdutório. Você deu seus primeiros passos com sucesso no mundo do Jenkins.

Neste laboratório, você aprendeu a:

• Acessar o painel do Jenkins e identificar seus componentes principais.
• Criar um novo projeto Freestyle do zero.
• Configurar uma etapa de compilação simples de "Execute shell".
• Acionar manualmente uma compilação para o seu projeto.
• Encontrar e inspecionar o histórico de compilações e a saída detalhada do console para verificar o resultado.

Essas habilidades fundamentais são os blocos de construção para criar pipelines de automação mais complexos e poderosos. Agora você está bem preparado para explorar recursos mais avançados do Jenkins.