Java-Anwendungen erstellen und testen

Auf dieser Seite wird erläutert, wie Sie mit Cloud Build erstellen und testen Java-basierte Anwendungen, speichern Sie erstellte Artefakte in einem Maven-Repository in Artifact Registry verwenden und Informationen zur Build-Herkunft generieren

Hinweise

maven-Image verwenden

Sie können Cloud Build so konfigurieren, dass Java-Anwendungen mithilfe der maven-Image von Docker Hub.

Geben Sie zum Ausführen der Aufgaben im maven-Image die URL der Image und die getaggte Version des Images im Feld name Ihres Builds Konfigurationsdatei. Wenn Sie das Image-Tag nicht angeben, verwendet standardmäßig das latest-Image. Cloud Build startet das Image wird in name durch Verwendung des Standardeinstiegspunkts des Images angegeben. Um den Parameter Standardeinstiegspunkt und zum Aufrufen von maven als Einstiegspunkt Folgendes angeben: mvn im Feld entrypoint

Die folgende Build-Konfigurationsdatei gibt die entrypoint für das maven-Image an und gibt die Build-Tool-Version aus:

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

Java-Builds konfigurieren

  1. Erstellen Sie im Stammverzeichnis des Projekts eine Build-Konfigurationsdatei mit dem Namen cloudbuild.yaml.

  2. Tests ausführen: maven stellt maven test bereit. Damit werden Abhängigkeiten heruntergeladen, die Anwendungen erstellt und alle im Quellcode angegebenen Tests ausgeführt. Im Feld args eines Build-Schritts wird eine Liste von Argumenten abgerufen und an das Image übergeben, auf das im Feld name verwiesen wird.

    Fügen Sie in der Build-Konfigurationsdatei test in das Feld args ein, um test aufzurufen. innerhalb von maven:

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

  3. Anwendung verpacken: Geben Sie im Feld args den Befehl package an, um Ihre Anwendung in einer JAR-Datei für das maven-Image zu verpacken. Mit dem Befehl package wird in /workspace/target/ eine JAR-Datei erstellt.

    Mit dem folgenden Build-Schritt wird Ihre Java-Anwendung verpackt:

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

  4. In Artifact Registry hochladen:

    Verwenden Sie in der Build-Konfigurationsdatei das Feld mavenArtifacts, um die Anwendungspfad und Ihr Maven-Repository 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'

    Ersetzen Sie die folgenden Werte:

    • location: der Speicherort für Ihr Repository in Artifact Registry.
    • project-id: die ID des Google Cloud-Projekts, das Ihr Artifact Registry-Repository enthält.
    • repository-name: der Name Ihres Maven-Repositorys in Artifact Registry.
    • app-path: der Pfad zum Anwendungspaket.
    • build-artifact ist der Name der Paketdatei, die im Build-Schritt erstellt wurde.
    • group-id: Identifiziert Ihr Projekt in allen Maven-Projekten eindeutig im Format com.mycompany.app. Weitere Informationen finden Sie im Maven-Leitfaden zu Namenskonventionen.
    • version: Die Versionsnummer für Ihre Anwendung, formatiert in Zahlen und Punkten wie 1.0.1.

  5. Optional: Provenance-Generierung aktivieren

    Cloud Build kann überprüfbare SLSA-Build (Supply Chain Levels for Software Artifacts) Herkunftsmetadaten, um Ihre CI-Pipeline zu sichern.

    Um das Generieren von Herkunft zu ermöglichen, fügen Sie requestedVerifyOption: VERIFIED zum Abschnitt options Ihrer Konfigurationsdatei hinzu.

  6. Build starten: manuell oder Build-Trigger verwenden

    Sobald der Build abgeschlossen ist, können Sie Repository-Details ansehen. in Artifact Registry.

    Sie können sich auch Build-Herkunftsmetadaten ansehen und Herkunft prüfen.

Nächste Schritte