maven with jenkins maven documentation
Este tutorial explicará tudo sobre Jenkins e integração do Maven com Jenkins. Você também aprenderá a criar documentação para o projeto usando Maven:
Vamos conhecer o que é Jenkins, Maven Jenkins Integration, vantagens do Jenkins, como configurar Java e Maven no Jenkins, como criar um trabalho Jenkins com diferentes parâmetros, relatórios de resultados de execução do Jenkins com plugins TestNG, como passar Maven comandos na forma de metas no Jenkins, documentação Maven para projetos, etc. em detalhes.
=> Cuidado com a série de treinamento Maven simples aqui.
como escrever casos de teste em planilha excel
O que você aprenderá:
O que é Jenkins?
Jenkins é uma ferramenta de integração contínua de imensa importância no mundo do teste e desenvolvimento de software. É open-source e independente de plataforma. Em nosso trabalho diário, lidamos com estruturas de automação que abrangem várias centenas de casos de teste.
Até agora, vimos que, para executar nossos scripts do projeto Maven, temos que executar comandos Maven no prompt de comando ou abrir diretamente o Eclipse e acionar os scripts.
Portanto, estamos acionando manualmente os casos de teste para execução. Para automatizar esse processo, precisamos agendar jobs que executarão nossos casos de teste em um determinado momento e também cuidar de alguns parâmetros importantes. Todo esse processo é automatizado com a ajuda do Jenkins.
Assim, na realidade, se temos cerca de 800 casos de teste que precisam ser executados às três da manhã, então isso pode ser feito facilmente sem a necessidade de qualquer intervenção manual com a ajuda de jobs Jenkin.
Além disso, existem cenários em que casos de teste automatizados de Smoke ou Sanity precisam ser executados após algum check-in de código do lado do desenvolvimento no ambiente. Todos esses são atendidos automaticamente pelo Jenkins.
Jenkins tem o log de todas as modificações feitas em repositórios como SVN ou Git. Jenkins pode ser facilmente instalado e configurado em nosso sistema. Além disso, ele pode ser configurado em mais de uma máquina virtual se os builds precisarem ser acionados de maneira distribuída. Além disso, dá acesso por meio de links a todas as compilações recentes.
Jenkins possui recursos como integração com TestNG com a ajuda de plug-ins, notificações por e-mail sobre o status da compilação, o que o torna mais popular hoje em dia. Problemas e bugs são detectados e resolvidos muito cedo.
A maioria das tarefas de integração é executada automaticamente, economizando recursos e permitindo que o software seja lançado a qualquer momento sem problemas.
No ambiente Agile, temos analistas de negócios, desenvolvedores e testadores trabalhando juntos. Como resultado, pode haver um caso em que um analista de negócios (uma pessoa não técnica) precise ver e monitorar como é o resultado da execução.
Nesses casos, ele pode não precisar abrir um Eclipse ou configurar e executar comandos Maven para acionar os scripts. Ele pode executar os casos de teste com a ajuda de Jenkins e obter os resultados da execução.
Estamos na página inicial do Jenkins com um nome de trabalho como Projeto . Se uma empresa deseja ver os resultados da execução, o nome do trabalho precisa ser clicado e será redirecionado para a página abaixo.
Então Construa agora à esquerda da tela precisa ser clicado. Portanto, só precisamos abrir a URL do Jenkins (https: // localhost: 8080 / jenkins).
Embora os casos de teste sejam acionados por meio do Jenkins, é apenas o ambiente específico fornecido no Jenkins onde os casos de teste são executados. É um cenário comum que, se estivermos executando nossos casos de teste fora do Jenkins, eles falharão devido à versão de nossas ferramentas ou linguagem ou jars que não está alinhada com o que deveria funcionar.
Por exemplo, a versão Java ou nossa versão Maven foi atualizada ou desatualizada. Tudo isso pode ser evitado se estivermos usando as tarefas de Jenkin para nossa execução.
Assim, Jenkins tem contribuições importantes em nossa estrutura de teste, mantendo uma configuração centralizada em todas as localizações geográficas.
Vantagens do Jenkins
As vantagens do Jenkins estão listadas abaixo:
- Jenkins é um software de código aberto, independente de plataforma e portátil.
- Ele pode ser instalado e configurado facilmente. Pode ser usado com facilidade.
- O Jenkins automatizou os itens de integração e muitos dos problemas de integração não ocorrem, aumentando assim a eficiência e a produtividade dos desenvolvedores.
- Sua documentação é bem descrita e é conveniente para aprendê-la.
- Jenkins foi desenvolvido pelos desenvolvedores tendo em mente os recursos de que os desenvolvedores realmente precisam para trabalhar.
- Possui um grande número de plug-ins. Todos esses plug-ins tornam o Jenkins mais poderoso e popular entre os desenvolvedores.
- Jenkins auxilia os ambientes hospedados na nuvem.
- Possui uma grande comunidade de usuários facilmente acessíveis. Eles trabalham com feedbacks e se comunicam regularmente.
- Jenkins fornece ajuda para testar a automação das seguintes maneiras:
- Recurso de agendamento de execução de teste: Os profissionais de teste podem agendar seus casos de teste para execução e utilizar seu tempo para outras tarefas.
- Relatório de resultados de teste personalizado: Jenkins fornece detalhes sobre o padrão de resultados. As representações gráficas e os detalhes dos resultados de execução refletem no número total de casos de teste, tempos de execução e outras informações importantes.
- Funciona adequadamente com os processos de integração contínua: O tempo de teste é reduzido com Jenkins.
Java e caminho Maven definido no Jenkins
Em primeiro lugar, precisamos ter Java e Maven instalados em nossas máquinas. Assim que estivermos na landing page do Jenkins, inicialmente não haverá empregos.
Agora clique em Gerenciar Jenkins link da esquerda da tela.
Então clique em Configurações globais de ferramentas . Aqui temos que fazer as configurações para Java e Maven. Para configurar o Java, clique no Instalações JDK botão.
Aqui nós temos que dar Nome e JAVA_HOME caminho ou isso pode ser feito verificando Instalar automaticamente caixa de seleção.
Em seguida, precisamos ir para a seção Maven e clicar no Instalações Maven botão.
Aqui nós temos que dar Nome e MAVEN_HOME caminho ou isso pode ser feito verificando o Instalar automaticamente caixa de seleção.
Após realizar essas operações, clique em Salve na parte inferior da página.
Criar um trabalho no Jenkins
Em seguida, precisamos gerar um job para acionar os scripts de nosso projeto Maven. Clique no Novo item link da esquerda da tela.
Insira um Nome do item e selecione o Projeto Freestyle opção e clique em OK.
Seremos navegados para a página de configuração do trabalho. Aqui precisamos fornecer todas as informações específicas para nosso projeto. Primeiramente, precisamos fornecer a fonte do código do nosso projeto.
Jenkins Source Code Management
No Gestão do código fonte seção, geralmente selecionamos uma das GitHub ou Subversão e fornecer os links correspondentes. O Jenkins obterá automaticamente o código a partir daí.
No entanto, se nosso código estiver presente em nosso sistema local, precisamos clicar no Avançado botão sob o em geral seção , e então verifique Use o espaço de trabalho personalizado .
Precisamos colocar nosso projeto Maven dentro do .jenkins e forneça o caminho do arquivo pom que reside dentro do projeto Maven, começando com $ {JENKINS_HOME}.
Dessa forma, Jenkins obtém o código-fonte do projeto.
Jenkins não é usado apenas por testadores para acionar a execução do teste, mas também é usado extensivamente por desenvolvedores em seu trabalho. Algumas dessas opções são fornecidas no Ambiente de construção seção.
Em seguida, precisamos ir para a seção Build e selecionar Invocar destino Maven de nível superior opções na lista suspensa.
Então Invocar destinos Maven de nível superior seção será expandida. Aqui Versão Maven será pré-preenchido com a versão Maven que definimos no Configuração de ferramenta global .
Em Metas, temos que fornecer o comando Maven para acionar a execução. teste mvn –PRegressão. No Jenkins, podemos omitir o termo mvn e o resto do comando é suficiente.
Clique em Salve e criamos um trabalho com sucesso.
Apenas uma recapitulação do que discutimos até agora:
- Localização de nosso código (Git, Subversions ou de um diretório local).
- Comando Maven para acionar a execução.
Nosso trabalho será criado e ficará visível na página de destino do Jenkins:
Clique no Construa agora da esquerda da tela. Haverá um Histórico de construção seção à esquerda da tela visível após a conclusão da construção. O número de construção será visivelmente seguido por # juntamente com o carimbo de tempo . Agora navegue até o Saída do console .
Os resultados da execução:
Integração TestNG Jenkins para relatório de resultados de execução
Para obter os detalhes do resultado da execução do teste, navegue até o projeto Maven no Eclipse, vá para o alvo pasta então para o relatórios infalíveis pasta. Há um index.html arquivo dentro dos relatórios infalíveis. Obtenha a localização do arquivo e abra-o no navegador.
testng-results.xml e o plugin de relatórios TestNG são necessários para os resultados no Jenkins.
Clique em Gerenciar Jenkins link da esquerda da tela do Jenkins. Então clique em Gerenciar Plugins ligação.
c ++ inicializar variável estática
Instale o Plugin de resultados do TestNG .
Uma vez feito isso, devemos atualizar o trabalho que criamos a partir do Configurar link da esquerda da tela. Em seguida, navegue até o Ações pós-construção seção e selecione Publicar resultados do TestNG na lista suspensa.
testng-results.xml arquivo em nosso projeto Maven é preenchido automaticamente no Padrão de relatório XML TestNG campo por padrão. Em seguida, clique em Salvar.
Agendamento de trabalho no Jenkins
Navegue até o Build Triggers seção para agendar os tempos de construção.
Se selecionarmos Construa periodicamente , então teremos o Cronograma seção visível. Aqui temos que mencionar cinco parâmetros para agendar o trabalho, conforme mostrado abaixo.
- MINUTES em uma hora
- HORAS em um dia
- DAYMONTH dia em um mês
- MÊS em um ano
- DAYWEEK dia da semana
Para agendar os scripts às 8h00 da manhã, precisamos especificar conforme mostrado abaixo:
Agora devemos acionar o build novamente, para verificar os resultados do TestNG. Vá para a página de destino do Jenkins e clique no trabalho. Devemos agora ter um Resultados TestNG link dentro de nossa tela de trabalho.
Caso a execução não tenha falhas, o Último Resultado do Teste o link não mostrará falhas. Clique no link Resultados do TestNG para obter mais detalhes sobre os resultados.
Podemos clicar no Construir # número para obter mais detalhes sobre os resultados.
Para verificar nosso código, devemos clicar no Área de trabalho link à esquerda da tela. Dessa forma, Jenkins e Maven podem trabalhar juntos.
Documentação Maven para projeto
Podemos criar documentação para nosso projeto com a ajuda do Maven. Conforme discutido anteriormente, o Maven compreende três ciclos de vida, ou seja, limpo, local e padrão.
A tarefa de remover quaisquer erros e remover os artefatos da construção anterior é realizada no limpar ciclo. Enquanto o predefinição é responsável pelo processo total de implantação, o local ciclo de vida é para criar a documentação do projeto.
É considerada uma boa prática realizar a limpeza antes do local para que tenhamos uma documentação atualizada.
Navegue até a pasta do projeto e execute o seguinte comando no prompt de comando.
mvn site O processo de construção do projeto terá início. Após o sucesso da construção, a documentação do projeto deve ser gerada conforme mostrado abaixo.
Ao clicar no arquivo index.html, podemos ter a documentação detalhada do projeto consistindo principalmente nas informações do build e do projeto, sobre o projeto, integração contínua, dependências, lista de mala direta, licenças e assim por diante.
Seção de FAQs
P # 1) Como o Jenkins funciona com o Maven?
Responda: Jenkins funciona bem com o Maven seguindo certas pré-condições. Precisamos configurar os caminhos Java e Maven no Jenkins. Em seguida, precisamos criar os trabalhos do Jenkins com todos os parâmetros, incluindo ações pós-compilação, agendamento das compilações e assim por diante.
P # 2) O que são Maven e Jenkins?
Responda: Maven é uma ferramenta de gerenciamento de projetos e builds desenvolvida em Java. Jenkins é uma ferramenta de integração contínua de código aberto. Tanto o Maven quanto o Jenkins são amplamente utilizados na indústria atualmente.
P # 3) Qual é o objetivo do Maven no Jenkins?
Responda: Fornecemos os comandos Maven na seção Metas do Jenkins. Esta é uma etapa importante ao criar um trabalho do Jenkins.
P # 4) Por que usamos o Maven?
Responda: O Maven é uma ferramenta de gerenciamento e construção de projeto conduzida por um arquivo pom.xml. Isso tornou o processo de construção simples, fácil e consistente.
P # 5) O Maven é uma ferramenta de CI?
Responda: Não, o Maven não é uma ferramenta de integração contínua. É uma ferramenta de construção com mais recursos que o Ant. Jenkins é uma ferramenta de integração contínua.
P # 6) O que é pom xml no Maven?
Responda: Project Object Model ou pom é um arquivo xml que forma o núcleo do Maven. Ele contém a lista de dependências do projeto, configurações, perfis e assim por diante.
P # 7) Podemos integrar TestNG e Jenkins com Maven?
Responda: Sim, podemos integrar TestNG e Jenkins com Maven. Tudo isso é feito com a ajuda de plugins.
substring (0,0)
P # 8) Quais são as três construções do ciclo de vida do Maven?
Responda: Os três builds padrão do ciclo Maven estão listados abaixo.
- Predefinição
- Limpar
- Local
P # 9) Como definir XML de configurações do Jenkins?
Responda: No Jenkins, navegue até a seção Build do trabalho e clique em Avançado. Arquivo de configurações a opção estará visível lá. A localização do settings.xml deve ser especificada lá.
P # 10) Como faço para definir variáveis ambientais no Jenkins?
Responda: As variáveis ambientais no Jenkins podem ser definidas a partir do Configurar tela. No Construir seção, selecione Injetar variáveis de ambiente . Precisamos fornecer a variável de ambiente como padrão VARIABLE_NAME = VALUE.
Conclusão
Esperamos que uma grande parte do Maven, como sua integração com Jenkins, plug-ins TestNG para Jenkins para exibir resultados, criação de jobs no Jenkins, Java e Maven configurados no Jenkins, as configurações globais no Jenkins devem ser facilmente entendidas agora.
Além disso, os mecanismos de cronograma de construção do Jenkins, suas ações pós-construção, como o Jenkins lida com o código que reside no Git, ou qualquer outro repositório ou localmente, foi ilustrado em detalhes aqui. Pratique cada passo um por um e a fusão Maven Jenkins ficará clara. Também exploramos a documentação do Maven para projetos.
Jenkins, uma ferramenta de integração contínua, tem um uso real para desenvolvedores, testadores, analistas de negócios e assim por diante em um mundo ágil. Cada organização procura usar e adaptar processos de integração contínua de vez em quando.
=> Visite aqui para ver a série de treinamento Maven para todos.
Leitura recomendada
- O que é Maven - Tutorial Maven para iniciantes
- Plug-ins Gradle Vs Maven e Maven
- Jenkins CI Tutorial - O que é Jenkins Continuous Integration
- Jenkins Jobs: Configurando SCM, Build Jobs And Polling SCM
- Plug-ins do Jenkins: SCM, analisadores e instalação de plug-ins
- Integração do Maven com o TestNg usando o plug-in Maven Surefire
- Segurança Jenkins: Habilitando a segurança e a matriz de segurança do projeto
- Configurando o Maven com Eclipse Java IDE