Compilar aplicações Java

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Use o Azure Pipelines para automatizar a compilação, o teste e a implantação de aplicativos Java. Este artigo explica como configurar um pipeline para projetos Java usando ferramentas como Maven, Gradle ou Ant. Você também aprenderá como implantar seu aplicativo em serviços do Azure, como Serviço de Aplicativo, Funções ou Kubernetes.

** Use um pipeline para:

• Construa seu projeto com Maven, Gradle ou Ant.
• Execute testes e ferramentas de análise de código.
• Publique a sua aplicação utilizando um pipeline e artefactos do Azure.
• Implante a sua aplicação no Serviço de Aplicações do Azure, nas Azure Functions ou no Azure Kubernetes Service.

Se você trabalha em projetos Android, consulte Criar, testar e implantar aplicativos Android.

Pré-requisitos

Produto	Requisitos
Azure DevOps	- Um projeto Azure DevOps. - Capacidade de executar pipelines em agentes hospedados pela Microsoft. Você pode comprar um trabalho paralelo ou solicitar um nível gratuito. - Conhecimentos básicos de YAML e Azure Pipelines. Para obter mais informações, consulte Crie o seu primeiro pipeline. - Permissões:      - Para criar um pipeline: você deve estar no grupo Colaboradores e o grupo precisa ter a permissão Criar pipeline de compilação definida como Permitir. Os membros do grupo Administradores de Projeto podem gerenciar pipelines.     - Para criar conexões de serviço: Deve ter a função de Administrador ou Criador para conexões de serviço.
GitHub	- Uma conta GitHub. - Uma ligação de serviço do GitHub para autorizar o Azure Pipelines.
Azure	Uma assinatura do Azure.

Criar um repositório GitHub

Fork o seguinte repositório para sua conta GitHub:

https://github.com/MicrosoftDocs/pipelines-java

Criar um fluxo de trabalho

1. Entre na sua organização do Azure DevOps e vá para o seu projeto.

2. Vá para Pipelines e selecione Novo pipeline ou Criar pipeline se estiver criando o primeiro pipeline no projeto.

3. Siga as etapas do assistente, começando selecionando GitHub como o local do seu código-fonte. Poderá ser redirecionado para o GitHub para iniciar sessão. Em caso afirmativo, insira suas credenciais do GitHub.

4. Selecione o seu repositório. Você pode ser redirecionado para o GitHub para instalar o aplicativo Azure Pipelines. Em caso afirmativo, selecione Aprovar e instalar para continuar.

5. Quando vires o separador Configurar o pipeline, seleciona Maven, Gradle ou Ant, dependendo de como desejas compilar o teu código.

6. Um azure-pipelines.yml arquivo contendo sua definição de pipeline é criado em seu repositório e aberto no editor YAML. Você pode personalizar o pipeline adicionando mais tarefas ou modificando as tarefas existentes. Para obter mais informações sobre as tarefas de compilação, consulte Criar seu código.

7. Quando terminar de editar o azure-pipelines.yml, selecione Salvar e executar.

8. Para confirmar o azure-pipelines.yml arquivo em seu repositório, selecione Salvar e executar novamente.

Selecione Tarefa para ver a sua pipeline em ação.

Agora você tem um pipeline YAML funcional (azure-pipelines.yml) em seu repositório que está pronto para você personalizar! Para fazer alterações no seu pipeline, selecione-o na página Pipelines e, em seguida, edite o azure-pipelines.yml arquivo.

Ambiente de construção

Use o Azure Pipelines para criar aplicativos Java sem configurar a infraestrutura. Crie com base em imagens do Windows, Linux ou macOS. Os agentes hospedados pela Microsoft no Azure Pipelines têm JDKs modernos e outras ferramentas para Java pré-instaladas. Para verificar quais versões do Java estão instaladas, consulte Agentes hospedados pela Microsoft.

Selecione a imagem apropriada atualizando o seguinte trecho em seu azure-pipelines.yml arquivo.

pool:
  vmImage: 'ubuntu-latest' # other options: 'macOS-latest', 'windows-latest'

Consulte Agentes hospedados pela Microsoft para obter uma lista completa de imagens.

Como alternativa aos agentes hospedados pela Microsoft, configure agentes auto-hospedados com o Java instalado. Use agentes auto-hospedados para economizar tempo se você tiver um repositório grande ou executar compilações incrementais.

Crie seu código

Você pode criar seu aplicativo Java com Maven, Gradle, Ant ou um script. As seções a seguir mostram como adicionar uma etapa de compilação ao seu pipeline para cada método.

Maven

Para uma compilação do Maven, adicione as seguintes tarefas ao azure-pipelines.yml arquivo. Substitua os valores para corresponder ao seu projeto. Para obter mais informações sobre as opções de tarefa, consulte a tarefa Maven.

steps:
- task: Maven@4
  inputs:
    mavenPomFile: 'pom.xml'
    mavenOptions: '-Xmx3072m'
    javaHomeOption: 'JDKVersion'
    jdkVersionOption: 'default'
    jdkArchitectureOption: 'x64'
    publishJUnitResults: true
    testResultsFiles: '**/TEST-*.xml'
    goals: 'package'

Para o Spring Boot, também podes usar a tarefa do Maven. Certifique-se de que o valor mavenPomFile reflete o caminho para o ficheiro pom.xml. Por exemplo, se você estiver usando o repositório de exemplo do Spring Boot, seu caminho será complete/pom.xml.

Personalizar o caminho de compilação

Defina o mavenPomFile valor se o pom.xml arquivo não estiver na raiz do repositório. O valor do caminho do arquivo deve ser relativo à raiz do repositório, como IdentityService/pom.xml ou $(system.defaultWorkingDirectory)/IdentityService/pom.xml.

Personalizar objetivos do Maven

Defina o valor das metas para uma lista separada por espaço de metas para o Maven executar, como clean package. Para obter detalhes sobre fases e objetivos comuns do Java, consulte a documentação do Maven do Apache.

Gradle

Para uma compilação Gradle, adicione a seguinte tarefa ao azure-pipelines.yml arquivo. Para obter mais informações sobre essas opções, consulte a tarefa Gradle .

steps:
- task: Gradle@3
  inputs:
    workingDirectory: ''
    gradleWrapperFile: 'gradlew'
    gradleOptions: '-Xmx3072m'
    javaHomeOption: 'JDKVersion'
    jdkVersionOption: 'default'
    jdkArchitectureOption: 'x64'
    publishJUnitResults: true
    testResultsFiles: '**/TEST-*.xml'
    tasks: 'build'

Invólucro Gradle

Verifique se o gradlew arquivo está no repositório. Se não estiver, gere-o executando gradle wrapper no diretório raiz do projeto. Para obter informações sobre como criar um wrapper Gradle, consulte o Gradle.

Escolha a versão do Gradle

A versão do Gradle instalada na máquina do agente é usada, a menos que o arquivo do gradle/wrapper/gradle-wrapper.properties repositório tenha uma distributionUrl propriedade que especifique uma versão diferente do Gradle para baixar e usar durante a compilação.

Ajustar o caminho de compilação

Defina o workingDirectory valor se o gradlew arquivo não estiver na raiz do repositório. O valor do diretório deve ser relativo à raiz do repo, como IdentityService ou $(system.defaultWorkingDirectory)/IdentityService.

Ajuste o gradleWrapperFile valor se o gradlew arquivo não estiver na raiz do repositório. O valor do caminho do arquivo deve ser relativo à raiz do repositório, como IdentityService/gradlew ou $(system.defaultWorkingDirectory)/IdentityService/gradlew.

Ajustar tarefas do Gradle

Ajuste o valor das tarefas para as tarefas que o Gradle deve executar, como build ou check. Para obter mais informações sobre tarefas comuns do Java Plugin para o Gradle, consulte a documentação do Gradle.

Formiga

Com o build Ant, adicione a seguinte tarefa ao seu ficheiro azure-pipelines.yml. Altere valores, como o caminho para o arquivo build.xml, de forma a corresponder à configuração do seu projeto. Para obter mais informações sobre essas opções, consulte a tarefa Ant . Se estiver usando o repositório de exemplo, você precisará fornecer um build.xml arquivo em seu repositório.

steps:
- task: Ant@1
  inputs:
    workingDirectory: ''
    buildFile: 'build.xml'
    javaHomeOption: 'JDKVersion'
    jdkVersionOption: 'default'
    jdkArchitectureOption: 'x64'
    publishJUnitResults: false
    testResultsFiles: '**/TEST-*.xml'

Guião

Para criar com uma linha de comando ou script, adicione um desses trechos ao azure-pipelines.yml arquivo.

Script em linha

A script: etapa executa um script integrado usando Bash no Linux e macOS, e o Prompt de Comando no Windows. Para obter detalhes, consulte a tarefa Bash ou linha de comando .

steps:
- script: |
    echo Starting the build
    mvn package
  displayName: 'Build with Maven'

Arquivo de script

Esta tarefa executa um arquivo de script que está em seu repositório. Para obter detalhes, consulte a tarefa Shell Script, Batch script ou PowerShell .

steps:
- task: ShellScript@2
  inputs:
    scriptPath: 'build.sh'

Próximos passos

Publique sua saída de compilação em seu pipeline. Empacote e publique seu aplicativo em um pacote Maven ou em um arquivo .war/jar para implantá-lo em um aplicativo Web.

Saiba mais sobre como criar um pipeline de CI/CD para seu destino de implantação:

• Serviço de Aplicações do Azure
• Funções do Azure
• Serviço Kubernetes do Azure