Crea e testa le applicazioni Java

Questa pagina spiega come utilizzare Cloud Build per compilare e testare applicazioni basate su Java, archiviare gli artefatti compilati in un repository Maven in Artifact Registry e generare informazioni sull'origine della compilazione.

Prima di iniziare

Utilizzo dell'immagine maven

Puoi configurare Cloud Build per creare applicazioni Java utilizzando l'immagine maven di Docker Hub.

Per eseguire le attività nell'immagine maven, aggiungi un passaggio alla configurazione di compilazione con i seguenti campi:

  • name: imposta il valore di questo campo su maven o maven:<tag>, dove il tag rappresenta la versione. Se non specifichi il tag immagine, Cloud Build utilizza per impostazione predefinita l'immagine latest.
  • entrypoint: l'impostazione di questo campo sostituisce il punto di contatto predefinito dell'immagine a cui si fa riferimento in name. Imposta il valore di questo campo su mvn per invocare mvn come punto di contatto del passaggio di compilazione ed eseguire i comandi mvn.
  • args: il campo args di un passaggio di compilazione prende un elenco di argomenti e li passa all'immagine a cui fa riferimento il campo name.

Il seguente passaggio di compilazione specifica il entrypoint per l'immagine maven taggata come 3.3-jdk-8 e stampa la versione dello strumento di compilazione:

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

Configurazione delle build di Java

  1. Nella directory principale del progetto, crea un file di configurazione della build denominato cloudbuild.yaml.

  2. Esegui test: maven fornisce maven test, che scarica le dipendenze, compila le applicazioni ed esegue tutti i test specificati nel codice sorgente. Il campo args di un passaggio di compilazione prende un elenco di argomenti e li passa all'immagine a cui fa riferimento il campo name.

    Nel file di configurazione del build, aggiungi test al campo args per richiamare test all'interno di maven:

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

  3. Pacchettizza l'applicazione: per pacchettizzare l'applicazione in un file JAR per l'immagine maven, specifica il comando package nel campo args. Il comando package crea un file JAR in /workspace/target/.

    Il seguente passaggio di compilazione esegue il pacchettizzazione dell'applicazione Java:

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

  4. Carica in Artifact Registry:

    Nel file di configurazione della build, utilizza il campo mavenArtifacts per specificare il percorso dell'applicazione e il repository Maven in 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'

    Sostituisci i seguenti valori:

    • location: la posizione del tuo repository in Artifact Registry.
    • project-id: l'ID del progetto che contiene il repository Artifact Registry. Google Cloud
    • repository-name: il nome del repository Maven in Artifact Registry.
    • app-path: il percorso dell'applicazione pacchettizzata.
    • build-artifact: il nome del file del pacchetto creato dal passaggio di compilazione.
    • group-id: identifica in modo univoco il tuo progetto in tutti i progetti Maven, nel formato com.mycompany.app. Per ulteriori informazioni, consulta la guida di Maven alle convenzioni di denominazione.
    • version: il numero di versione dell'applicazione, formattato in numeri e puntini come 1.0.1.

  5. (Facoltativo) Attivare la generazione della provenienza

    Cloud Build può generare metadati verificabili per l'origine della compilazione Supply Chain Levels for Software Artifacts (SLSA) per contribuire a proteggere la pipeline di integrazione continua.

    Per attivare la generazione dell'origine, aggiungi requestedVerifyOption: VERIFIED alla sezione options del file di configurazione.

  6. Avvia la build: manualmente o utilizzando gli trigger di build.

    Al termine della build, puoi visualizzare i dettagli del repository in Artifact Registry.

    Puoi anche visualizzare i metadati dell'origine della compilazione e convalidare l'origine.

Passaggi successivi