Criar e testar aplicativos Java (original) (raw)

Nesta página, explicamos como usar o Cloud Build para criar e testar aplicativos baseados em Java, armazenar artefatos criados em um repositório do Maven no Artifact Registry e gerar informações de procedência do build.

Antes de começar

• Familiarize-se com a criação de aplicativos baseados em Java.
• Conhecer o Maven
• Prepare seu projeto Java.
• Familiarize-se com a gravação de um arquivo de configuração do Cloud Build.
• Ter um repositório Maven no Artifact Registry. Se você não tiver um, crie um repositório.
• Para executar os comandos gcloud nesta página, instale aGoogle Cloud CLI.

Como usar a imagem maven

É possível configurar o Cloud Build para criar aplicativos Java usando aimagem maven do Docker Hub.

Para executar suas tarefas na imagem maven, adicione uma etapa à configuração de build com os seguintes campos:

• name: defina o valor desse campo como maven ou maven:<tag>, em que a tag representa a versão. Se você não especificar a tag de imagem, o Cloud Build usará a imagem latest por padrão.
• entrypoint: a definição desse campo substitui o ponto de entrada padrão da imagem referenciada em name. Defina o valor desse campo como mvn para invocarmvn como o ponto de entrada da etapa de build e execute comandos mvn.
• args: o campo args de uma etapa de criação recebe uma lista de argumentos e os passa para a imagem referenciada pelo campo name.

A etapa de build a seguir especifica o entrypoint para a imagem mavenmarcada como 3.3-jdk-8 e imprime a versão da ferramenta de build:

          steps:
          - name: maven:3.3-jdk-8
            entrypoint: mvn
            args: ['--version']

Como configurar builds Java

1. No diretório raiz do projeto, crie um arquivo de configuração de build chamado cloudbuild.yaml.
2. Executar testes: maven fornece maven test, que faz o download de dependências, cria os aplicativos e executa todos os testes especificados no código-fonte. O campo args de uma etapa de build recebe uma lista de argumentos e os transmite para a imagem referenciada pelo campo name.
   No arquivo de configuração de build, adicione test ao campo args para invocar testem maven:

     steps:  
     - name: maven:3.3-jdk-8  
       entrypoint: mvn  
       args: ['test']  

1. Empacote o aplicativo: para empacotar o aplicativo em um arquivo JAR para a imagem maven, especifique o comando package no campo args. O comando package cria um arquivo JAR em /workspace/target/.
   A etapa de criação a seguir empacota seu aplicativo Java:

     steps:  
     - name: maven:3.3-jdk-8  
       entrypoint: mvn  
       args: ['package','-Dmaven.test.skip=true']  

1. Fazer upload no Artifact Registry:
   No arquivo de configuração do build, use o campo mavenArtifacts para especificar o caminho do aplicativo e o repositório do Maven no Artifact Registry:

artifacts:  
  mavenArtifacts:  
  - repository: 'https://location-maven.pkg.dev/project-id/repository-name'  
    path: 'app-path'  
    artifactId: 'build-artifact'  
    groupId: 'group-id'  
    version: 'version'  

Substitua os seguintes valores:

• location: o local do repositório no Artifact Registry.
• project-id: o ID do projeto Google Cloud que contém o repositório do Artifact Registry.
• repository-name: o nome do repositório do Maven no Artifact Registry.
• app-path: o caminho para o aplicativo empacotado.
• build-artifact: o nome do arquivo de pacote criado na etapa de build.
• group-id: identifica de forma exclusiva seu projeto em todos os projetos do Maven, no formato com.mycompany.app. Para mais informações, consulte o guia do Maven sobre convenções de nomenclatura.
• version: o número da versão do aplicativo, formatado com números e pontos, como 1.0.1.

1. Opcional: ativar a geração de origem
   O Cloud Build pode gerar metadados de procedência verificáveis de Níveis da cadeia de suprimentos para artefatos de software (SLSA)para ajudar a proteger seu pipeline de integração contínua.
   Para ativar a geração de procedência, adicionerequestedVerifyOption: VERIFIEDà seção options no arquivo de configuração.
2. Iniciar o build: manualmente ouusando gatilhos de build.
   Depois que o build for concluído, você poderá acessar os detalhes do repositóriono Artifact Registry.
   Também é possível acessar os metadados de procedência do build e validar a procedência.

A seguir

• Saiba como ver os resultados da build.
• Saiba como proteger builds.
• Saiba como realizar implantações azul-verde no Compute Engine.
• Saiba como criar e conteinerizar aplicativos Java.
• Saiba como implantar um aplicativo no Cloud Run.
• Saiba como implantar um aplicativo no GKE.
• Saiba como resolver erros de build.