Criar aplicativos Java

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019 | TFS 2018

Observação

As diretrizes a seguir usam pipelines baseados em YAML disponíveis no Azure Pipelines. Use tarefas que correspondam às usadas no YAML a seguir.

Você pode usar um pipeline para compilar e testar automaticamente seus projetos Java. Depois de compilar e testar seu aplicativo, você pode implantar seu aplicativo em Serviço de Aplicativo do Azure, Azure Functions ou Serviço de Kubernetes do Azure. Se você estiver trabalhando em um projeto android, consulte Compilar, testar e implantar aplicativos Android.

Pré-requisitos

Você deve ter os seguintes itens no Azure DevOps:

Criar um pipeline

  1. Bifurque o seguinte repositório no GitHub:

    https://github.com/MicrosoftDocs/pipelines-java
    
  2. Entre na organização do Azure DevOps e acesse seu projeto.

  3. Acesse Pipelines e selecione Novo pipeline.

  4. Execute as etapas do assistente selecionando primeiro o GitHub como o local do código-fonte. Você pode ser redirecionado para o GitHub para então entrar. Nesse caso, insira suas credenciais do GitHub.

  5. Selecione seu repositório. Você poderá ser redirecionado ao GitHub para instalar o aplicativo do Azure Pipelines. Nesse caso, selecione Aprovar & instalar.

  6. Quando você vir a guia Configurar, selecioneMaven ou Gradle ou Ant , dependendo de como você deseja criar seu código.

  7. Ao final, selecione Salvar e executar.

  8. Confirme um novo arquivo azure-pipelines.yml em seu repositório. Selecione Salvar e executar novamente.

    Se você quiser assistir ao pipeline em ação, selecione o trabalho de build.

    Você acabou de criar e executar um pipeline, pois seu código parecia ser uma boa correspondência para o modelo maven que criamos automaticamente para você.

    Agora você tem um pipeline YAML em funcionamento (azure-pipelines.yml) em seu repositório que está pronto para você personalizar!

  9. Quando estiver pronto para fazer alterações no pipeline, selecione-o na página Pipelines e edite o azure-pipelines.yml arquivo.

  1. Importe o seguinte repositório para o repositório Git no Azure DevOps Server 2019:

    https://github.com/MicrosoftDocs/pipelines-java
    
  2. Salve o pipeline e enfileira um build. Quando a Build #nnnnnnnn.n has been queued mensagem for exibida, selecione o link de número para ver o pipeline em ação. Agora você tem um pipeline de trabalho pronto para personalizar a qualquer momento!

  1. Importe o seguinte repositório para o repositório Git no TFS:

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

    Esse modelo adiciona automaticamente as tarefas necessárias para criar o código no repositório de exemplo.

  2. Salve o pipeline e enfileira um build. Quando a Build #nnnnnnnn.n has been queued mensagem for exibida, selecione o link de número para ver o pipeline em ação. Agora você tem um pipeline de trabalho pronto para personalizar a qualquer momento!

Leia mais para saber mais sobre algumas das maneiras mais comuns de personalizar seu pipeline.

Ambiente de build

Você pode usar o Azure Pipelines para criar aplicativos Java sem a necessidade de configurar qualquer infraestrutura própria. Você pode criar imagens do Windows, Linux ou macOS. Os agentes hospedados pela Microsoft no Azure Pipelines têm JDKs modernos e outras ferramentas para Java pré-instalados. Para saber quais versões do Java estão instaladas, consulte agentes hospedados pela Microsoft.

Atualize o snippet de código a seguir em seu azure-pipelines.yml arquivo para selecionar a imagem apropriada.

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

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

Como alternativa ao uso de agentes hospedados pela Microsoft, você pode configurar agentes auto-hospedados com Java instalado. Você também pode usar agentes auto-hospedados para economizar mais tempo se tiver um repositório grande ou executar builds incrementais.

Seus builds são executados em um agente auto-hospedado. Verifique se você tem o Java instalado no agente.

Compilar o código

Maven

Com o build do Maven, o snippet a seguir é adicionado ao arquivo azure-pipelines.yml . Você pode alterar valores, como o caminho para o pom.xml arquivo, para corresponder à configuração do projeto. Consulte a tarefa Maven para obter mais informações sobre essas opções.

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

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

Personalizar o caminho de build

Ajuste 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 metas do Maven

Defina o valor das metas como uma lista separada por espaço de metas para o Maven executar, como clean package.

Para obter detalhes sobre as fases e metas comuns do Java, consulte a documentação do Maven do Apache.

Gradle

Com o build do Gradle, o snippet a seguir é adicionado ao arquivo azure-pipelines.yml . Para obter mais informações sobre essas opções, consulte a tarefa Gradle .

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

Escolher a versão do Gradle

A versão do Gradle instalada no computador do agente será 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 o build.

Ajustar o caminho de build

Ajuste 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 repositório, 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 Gradle deve executar, como build ou check.

Para obter mais informações sobre tarefas comuns do Plug-in Java para Gradle, consulte a documentação do Gradle.

Formiga

Com o build do Ant, o snippet a seguir é adicionado ao arquivo azure-pipelines.yml . Altere valores, como o caminho para o build.xml arquivo para corresponder à configuração do projeto. Para obter mais informações sobre essas opções, consulte a tarefa Ant .

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

Script

Para compilar com uma linha de comando ou script, adicione um dos snippets a seguir ao arquivo azure-pipelines.yml .

Script embutido

A script: etapa executa um script embutido usando o 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

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

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

Próximas etapas

Depois de criar e testar seu aplicativo, você pode carregar a saída de build no Azure Pipelines, criar e publicar um pacote do Maven ou empacotar a saída de build em um arquivo .war/jar a ser implantado em um aplicativo Web.