Como criar uma nova tarefa de construção em Jenkins Projeto Freestyle

Por: Thomas Hamilton Thomas Hamilton
Hours Atualização do

⚡ Resumo Inteligente

Jenkins O Freestyle Project é uma tarefa de compilação repetível que agrupa o checkout do código-fonte, as etapas de compilação e as ações pós-compilação em uma única tarefa configurável, criada inteiramente por meio do Jenkins Interface web sem necessidade de escrever código de pipeline.

  • 🔘 Definição: Um trabalho de estilo livre é Jenkins'tipo de projeto de uso geral, configurado por meio de formulários em vez de um Jenkinsarquivo.
  • ☑️ Pré-requisitos: Uma corrida Jenkins É necessário, primeiramente, um controlador, um JDK no agente de compilação, o plugin Git e um repositório acessível.
  • ✅ Dez passos: Faça login, crie um novo item, dê um nome a ele, defina o repositório, adicione uma etapa de compilação, salve, compile e leia a saída do console.
  • 🧪 Exemplo resolvido: Um projeto HelloWorld obtido do GitHub compila com javac e é executado com java dentro de um Windows Etapa de compilação em lote.
  • 🛠️ Mapa de configuração: Seis seções do formulário — Geral, Fonte Code Gerenciamento, gatilhos de compilação, ambiente de compilação, etapas de compilação e ações pós-compilação — abrangem todas as opções.
  • ⚙️ Limite de escopo: Tarefas Freestyle são adequadas para automação de tarefa única; já o trabalho de entrega em várias etapas deve ser feito em uma tarefa Pipeline com controle de versão.
Saiba Mais

Como criar uma nova tarefa de construção em Jenkins Projeto Freestyle

O que é uma Jenkins Projeto Freestyle?

Jenkins Projeto Freestyle É um trabalho de compilação, script ou pipeline repetível que contém etapas e ações pós-compilação. Trata-se de uma tarefa aprimorada que pode abranger várias operações. Permite configurar gatilhos de compilação e oferece segurança baseada em projeto para o seu projeto. Jenkins projeto. Ele também oferece plugins para ajudar você a criar etapas e ações pós-compilação.

Os tipos de ações que você pode realizar em um Jenkins As etapas de compilação ou ações pós-compilação são bastante limitadas. Existem muitos plugins padrão disponíveis em um Jenkins Projeto Freestyle para te ajudar a superar esse problema.

O diagrama abaixo coloca o trabalho de estilo livre dentro do contexto mais amplo. integração contínua loop, desde a verificação do código-fonte até as ações pós-compilação que relatam o resultado.

Passos para criar um emprego em Jenkins Projeto Freestyle
Como criar um emprego em Jenkins

Pré-requisitos para criar um Jenkins Trabalho Freestyle

Antes que os dez passos abaixo funcionem perfeitamente, quatro coisas precisam estar em ordem. A falta de qualquer uma delas é o motivo mais comum para uma primeira construção freestyle falhar com uma bola vermelha em vez de uma azul.

  • Uma corrida Jenkins controlador. Jenkins Por padrão, escuta na porta 8080. Se Jenkins Ainda não está em execução, siga o passo a passo da instalação em primeiro lugar.
  • Um JDK na máquina que executa a compilação. O exemplo prático compila. Java, assim javac Deve estar no PATH do controlador ou agente que executa a tarefa. Confirme isso com uma linha de comando. java -version Etapa de compilação antes de adicionar qualquer outra coisa.
  • O plugin Git. O Git A opção só aparece em Fonte. Code Gerenciamento após a instalação do plugin, através de Gerenciar Jenkins > Plugins.
  • Um repositório acessível. Um HTTPS público URL Não requer credenciais. Um repositório privado requer uma credencial armazenada em Jenkins Primeiro, caso contrário, o processo de finalização da compra falha logo na primeira compilação.

Uma conta com o Trabalho/Criar É necessária permissão — em uma nova conta de usuário único. Jenkins A conta de administrador já possui isso.

Como criar uma nova tarefa de construção em Jenkins

O trabalho de construção freestyle é uma opção altamente flexível e fácil de usar. Você pode usá-lo para qualquer tipo de projeto; é fácil de configurar e muitas de suas opções aparecem em outros trabalhos de construção. Abaixo está um processo passo a passo para criar emprego em Jenkins.

Passo 1) Faça login em Jenkins

Para criar uma barreira temporária, você pode usar móveis que já estão em sua casa. Jenkins trabalho freestyle, faça login no seu Jenkins painel de controle, visitando o seu Jenkins caminho de instalação. Normalmente, ele será hospedado em localhost em http://localhost:8080 Se você instalado Jenkins Em outro caminho, use o apropriado. URL Para acessar seu painel de controle, conforme mostrado abaixo. Jenkins Exemplo de criação de empregos.

Jenkins painel alcançado no Jenkins Caminho de instalação após o login

Etapa 2) Criar novo item

Clique em "Novo Item"No canto superior esquerdo do seu painel. A captura de tela abaixo mostra onde esse link está localizado."

Link para "Novo item" no canto superior esquerdo da página. Jenkins painel de instrumentos

Etapa 3) Insira os detalhes do item

Na próxima tela,

  1. Insira o nome do item que deseja criar. Usaremos o “Hello world” para esta demonstração.
  2. Selecione o projeto Freestyle
  3. Clique em OK

Caixa de nome do item com o projeto Freestyle selecionado antes de clicar em OK.

Etapa 4) Insira os detalhes do projeto

Insira os detalhes do projeto que deseja testar. A página de configuração que será aberta é mostrada abaixo.

Detalhes do projeto inseridos no Jenkins Página de configuração de trabalho freestyle

Etapa 5) Insira o repositório URL

Sob a fonte Code Gestão, insira seu repositório URLTemos um repositório de testes localizado em https://github.com/kriru/firstJava.git

fonte Code Seção de gerenciamento com o repositório de teste Git URL entrou

Também é possível usar um repositório local.

Se o seu repositório do GitHub for privado, Jenkins Primeiro, validaremos suas credenciais de login com o GitHub e só então extrairemos o código-fonte do seu repositório do GitHub.

ARTIGOS RELACIONADOS

Etapa 6) Ajuste as configurações

Agora que você forneceu todos os detalhes, é hora de compilar o código. Ajuste as configurações em construir seção para construir o código no momento que você quiser. Você pode até programar a compilação para acontecer periodicamente, em horários definidos.

Em construção,

  1. Clique em "Adicionar etapa de compilação"
  2. Clique em "Execute Windows comando em lote”E adicione os comandos que deseja executar durante o processo de construção.

O menu suspenso que lista as etapas de compilação disponíveis tem esta aparência.

A opção "Adicionar etapa de compilação" foi aberta na página de configuração do trabalho Freestyle.

⚠️ Nota de versão: recentemente Jenkins libera rótulo desta área Etapas de construção em vez de Construire no Linux ou macOS agentes a opção equivalente é Executar shellO botão ainda se chama Adicionar etapa de compilação.

Aqui, adicionei os comandos java para compilar o código java.

Eu adicionei os seguintes comandos do Windows:

javac HelloWorld.java
java HelloWorld

A caixa de comando com essas duas linhas inseridas é mostrada abaixo.

Execute Windows Caixa de comando em lote contendo os comandos javac e java.

Etapa 7) Salve o projeto

Depois de inserir todos os dados,

  1. Clique Inscreva-se
  2. Economize o projeto.

Etapa 8) Construir código-fonte

Agora, na tela principal, clique no botão Build Now no lado esquerdo para construir o código-fonte.

Botão "Construir agora" no lado esquerdo da tela do projeto de estilo livre.

Etapa 9) Verifique o status

Depois de clicar em Construir agora, você pode ver o status da compilação executada em Histórico de compilação.

O painel Histórico de Compilação mostra o status da compilação freestyle que foi executada.

Etapa 10) Veja a saída do console

Clique no número da compilação e, em seguida, em "Saída do console" para ver o status da compilação executada. Deverá ser exibida uma mensagem de sucesso, desde que você tenha seguido a configuração corretamente, conforme mostrado abaixo. Jenkins Exemplo de criação de novo emprego.

Tela de saída do console mostrando a mensagem de sucesso da compilação concluída.

Em resumo, executamos um programa HelloWorld hospedado no GitHub. Jenkins Obtém o código do repositório remoto e o compila continuamente com uma frequência definida por você.

Jenkins Explicação das seções de configuração do projeto Freestyle

O passo a passo acima aborda apenas os campos necessários para o exemplo HelloWorld. A página de configuração em si é dividida em seis seções de formulário, e saber o que cada uma delas faz facilita muito a localização das demais opções.

Seção O que ele controla Configuração típica
Geral Descrição da tarefa, descarte de versões antigas, parâmetros e se a tarefa será executada em um agente específico. Descriptíon mais um limite de retenção de construção
fonte Code e Autônoma Qual repositório usar, com quais credenciais e qual branch? Git, um HTTPS URL, filial */master or */main
Construir gatilhos O que inicia a compilação automaticamente? Consultar o SCM, compilar periodicamente ou usar um webhook do GitHub.
Ambiente de construção Envoltórios aplicados em toda a construção. Exclua o espaço de trabalho antes do início da compilação; adicione registros de data e hora ao log do console.
Etapas de construção Os comandos que realizam o trabalho são executados de cima para baixo. Execute Windows comando em lote ou executar shell
Ações pós-compilação O que acontece depois que as etapas terminam, seja qual for o resultado? Archiverificar os artefatos, publicar um relatório de teste, enviar um e-mail

Dois hábitos economizam muito tempo de depuração posteriormente. Adicione as etapas de compilação na ordem em que devem ser executadas, porque Jenkins O processo os executa de cima para baixo e para na primeira falha. Em seguida, arquiva tudo o que a compilação produz como uma ação pós-compilação, pois o espaço de trabalho é reutilizado pela próxima compilação, enquanto os artefatos arquivados são mantidos por número de compilação.

Freestyle Project ou Pipeline: qual você deve usar?

O estilo livre não é o único tipo de projeto na tela Novo Item, e nem sempre é o mais adequado. A tabela abaixo o compara com outros tipos de projeto. Trabalho em oleoduto nos pontos que definem a maioria das escolhas reais.

Ponto de comparação Projeto Freestyle Pipeline
Como é definido Formulários da Web armazenados no trabalho config.xml no controlador A Jenkinsarquivo incluído com o código do aplicativo
Histórico de alterações Realizada por Jenkins, fora do seu repositório RevVisualizado e versionado como qualquer outro arquivo fonte.
Etapas e trabalho paralelo Uma única lista simples de etapas de construção. Palcos nomeados, ramificações paralelas e vista do palco
Curva de aprendizado Não é necessário nenhum script. Requer a sintaxe declarativa de pipeline.
Melhor ajuste Uma compilação, um script, uma tarefa agendada ou aprendizado. Jenkins Fluxos de construção, teste e implantação em várias etapas em diversos ambientes.

Uma regra prática: use o estilo livre enquanto a tarefa for simples e você ainda estiver aprendendo a usar a ferramenta, e vá transferindo o trabalho para um estilo mais flexível. pipeline de CI/CD Assim que atingir um segundo estágio ou precisar ser revisado juntamente com o código. Equipes que trabalham em pares Jenkins Com ferramentas de compilação, muitas vezes se chega a esse ponto rapidamente — um Maven e Selenium instalação é um gatilho comum para a mudança, e o mesmo raciocínio se aplica a qualquer teste de automação suíte que se executa em várias fases.

Perguntas Frequentes

A saída do console indica a causa. As três causas mais comuns são: a ausência do javac no PATH do agente, um repositório privado sem credenciais armazenadas e um nome de branch incorreto. Corrija a linha relatada e execute "Compilar agora" novamente.

Abra os Gatilhos de Construção e marque a opção. Construir periodicamenteEm seguida, insira a sintaxe do cron, como por exemplo: H 2 * * * para uma corrida noturna. O H Distribui a carga ao longo da hora. Enquete SCM Usa a mesma sintaxe, mas só compila quando o repositório é alterado.

Escolha Executar shell Em vez de Executar, selecione a opção Adicionar etapa de compilação no menu Executar. Windows Comando em lote. A opção exibida depende do sistema operacional do controlador ou agente ao qual o trabalho está vinculado, e não da sua máquina.

Armazene o token ou a chave SSH uma vez em Gerenciar Jenkins > CredenciaisEm seguida, selecione-a na lista suspensa Credenciais na Fonte. Code Seção de gestão. Jenkins A validação ocorre antes do checkout, portanto, uma credencial inválida interrompe a compilação imediatamente.

As ferramentas de aprendizado de máquina leem os logs do console e agrupam falhas repetidas, separando um erro de compilação genuíno de um agente instável ou um tempo limite excedido. Essa triagem direciona você para a linha relevante, em vez de percorrer um longo log manualmente.

Copiloto do GitHub O script em lote ou shell é gerado dentro de uma etapa de compilação, e sua interface de linha de comando (CLI) pode resumir um log de console com falha. Não é possível navegar pelo formulário de configuração clicando nele, portanto, revise cada comando gerado antes de salvar.

Adicione Archiveja os artefatos como uma ação pós-compilação e atribua a ela um padrão como: **/*.class. ArchiOs arquivos ved são armazenados por número de compilação, portanto, permanecem mesmo se o espaço de trabalho for reutilizado ou limpo na próxima execução.

Cada trabalho reside em JENKINS_HOME/jobs/<job-name>, com as configurações do formulário em config.xml e cada execução sob builds/Fazer backup dessa pasta é suficiente para mover ou restaurar o trabalho.

Resuma esta postagem com: