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
- Machen Sie sich mit der Erstellung von Java-basierten Anwendungen vertraut.
- Machen Sie sich mit Maven vertraut.
- Halten Sie Ihr Java-Projekt bereit.
- Machen Sie sich damit vertraut, wie eine Cloud Build-Konfigurationsdatei geschrieben wird.
- Sie müssen ein Maven-Repository in Artifact Registry haben. Erstellen Sie ein neues Repository, falls Sie noch keines haben.
- Zum Ausführen der
gcloud
-Befehle auf dieser Seite installieren Sie den Google Cloud CLI
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
Erstellen Sie im Stammverzeichnis des Projekts eine Build-Konfigurationsdatei mit dem Namen
cloudbuild.yaml
.Tests ausführen:
maven
stelltmaven test
bereit. Damit werden Abhängigkeiten heruntergeladen, die Anwendungen erstellt und alle im Quellcode angegebenen Tests ausgeführt. Im Feldargs
eines Build-Schritts wird eine Liste von Argumenten abgerufen und an das Image übergeben, auf das im Feldname
verwiesen wird.Fügen Sie in der Build-Konfigurationsdatei
test
in das Feldargs
ein, umtest
aufzurufen. innerhalb vonmaven
:steps: - name: maven:3.3-jdk-8 entrypoint: mvn args: ['test']
Anwendung verpacken: Geben Sie im Feld
args
den Befehlpackage
an, um Ihre Anwendung in einer JAR-Datei für dasmaven
-Image zu verpacken. Mit dem Befehlpackage
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']
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 in der Maven-Anleitung zu Namenskonventionen. - version: Die Versionsnummer für Ihre Anwendung, formatiert in Zahlen und Punkten wie
1.0.1
.
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 Abschnittoptions
Ihrer Konfigurationsdatei hinzu.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
- Build-Ergebnisse aufrufen
- Builds schützen
- Blau/Grün-Bereitstellungen in Compute Engine ausführen
- Java-Anwendungen erstellen und containerisieren
- Mehr zum Bereitstellen einer Anwendung in Cloud Run
- Mehr zum Bereitstellen einer Anwendung in GKE
- Build-Fehler beheben