Java-Pakete in Artifact Registry speichern
In dieser Kurzanleitung erfahren Sie, wie Sie ein privates Maven-Repository für Artifact Registry einrichten und ein Paket in dieses hochladen.
Klicken Sie auf Anleitung, um die Schritt-für-Schritt-Anleitung für diese Aufgabe direkt in der Google Cloud Console auszuführen:
Hinweise
- Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Artifact Registry API aktivieren.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Artifact Registry API aktivieren.
Cloud Shell starten
In dieser Kurzanleitung verwenden Sie Cloud Shell, eine Shell-Umgebung zum Verwalten von Ressourcen, die in Google Cloud gehostet werden.Die Google Cloud CLI und Java sind in Cloud Shell vorinstalliert. Die gcloud CLI bietet die primäre Befehlszeile für Google Cloud.
Cloud Shell aufrufen
Rufen Sie die Google Cloud Console auf.
Klicken Sie in der Symbolleiste der Google Cloud Console auf Cloud Shell aktivieren:
In einem Frame im unteren Teil der Console wird eine Cloud Shell-Sitzung geöffnet.
Mit dieser Shell führen Sie gcloud
-Befehle aus.
Package Repository für Java erstellen
Erstellen Sie das Repository für Ihre Java-Artefakte.- Im Folgenden wird gezeigt, wie Sie das Repository anlegen.
Console
Öffnen Sie in der Cloud Console die Seite Repositories.
Klicken Sie auf Repository erstellen.
Geben Sie
quickstart-java-repo
als Repository-Namen an.Wählen Sie Maven als Format und Standard als Modus aus.
Wählen Sie unter Standorttyp die Option Region und dann den Standort
us-central1
aus.Klicken Sie auf Erstellen.
Das Repository wird der Repository-Liste hinzugefügt.
gcloud
Führen Sie den folgenden Befehl aus, um ein neues Package Repository für Java im aktuellen Projekt
quickstart-java-repo
am Standortus-central1
zu erstellen.gcloud artifacts repositories create quickstart-java-repo --repository-format=maven \ --location=us-central1 --description="Java package repository"
Führen Sie den folgenden Befehl aus, um zu prüfen, ob Ihr Repository erstellt wurde:
gcloud artifacts repositories list
Weitere Informationen zu Artifact Registry-Befehlen erhalten Sie mit dem Befehl
gcloud artifacts
.
Maven konfigurieren
Wählen Sie ein einfaches Maven-Projekt aus, das Sie verwenden möchten.
Wenn Sie kein einfaches Projekt haben, können Sie das Projekt Maven in 5 Minuten erstellen.
In dieser Kurzanleitung wird davon ausgegangen, dass in Ihrem einfachen Projekt keine zusätzlichen übergeordneten oder Plug-in-Abhängigkeiten in Artifact Registry gespeichert sind. Weitere Informationen zum Konfigurieren eines Maven-Projekts mit Abhängigkeiten in Artifact Registry finden Sie unter Mit Credential Helper authentifizieren.
Um die
gcloud
-Befehle zu vereinfachen, legen Sie für das Standard-Repository den Wertquickstart-java-repo
und für den Standard-Speicherortus-central1
fest. Nachdem Sie die Werte festgelegt haben, müssen Sie diese nicht mehr ingcloud
-Befehlen angeben, für die ein Repository oder Speicherort erforderlich ist.Um das Repository festzulegen, führen Sie folgenden Befehl aus:
gcloud config set artifacts/repository quickstart-java-repo
Führen Sie den folgenden Befehl aus, um den Standort festzulegen:
gcloud config set artifacts/location us-central1
Weitere Informationen zu diesen Befehlen finden Sie in der Dokumentation zu gcloud config set.
Führen Sie den folgenden Befehl aus, um die Einstellungen für das Standard-Repository
quickstart-java-repo
auszugeben.gcloud artifacts print-settings mvn
Die Ausgabe des Befehls
gcloud
entspricht dem folgenden Snippet, wobei PROJECT Ihre Projekt-ID ist.<distributionManagement> <snapshotRepository> <id>artifact-registry</id> <url>artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-java-repo</url> </snapshotRepository> <repository> <id>artifact-registry</id> <url>artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-java-repo</url> </repository> </distributionManagement> <repositories> <repository> <id>artifact-registry</id> <url>artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-java-repo</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </repository> </repositories> <build> <extensions> <extension> <groupId>com.google.cloud.artifactregistry</groupId> <artifactId>artifactregistry-maven-wagon</artifactId> <version>2.2.1</version> </extension> </extensions> </build>
Fügen Sie die Einstellungen in die Datei
pom.xml
für Ihr Maven-Projekt ein. Die folgende Übersicht zeigt die relative Platzierung der einzelnen Hauptelemente. Weitere Informationen zur Struktur der Datei finden Sie in der POM-Referenz zu Maven.<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <!-- Build Settings --> <build> ... <extensions>...</extensions> </build> <!-- Environment Settings --> <repositories>...</repositories> <distributionManagement>...</distributionManagement> </project>
Ihr Maven-Projekt kann jetzt Pakete in Ihr Repository hochladen.
Gradle konfigurieren
Erstellen Sie ein einfaches Gradle-Projekt, um ein Paket im von Ihnen erstellten Artifact Registry-Repository bereitzustellen. Wenn Sie keinen Gradle-Test-Build haben, können Sie der einführenden Gradle-Anleitung folgen, um einen einfachen Gradle-Build zu erstellen.Um die gcloud
-Befehle zu vereinfachen, legen Sie für das Standard-Repository den Wert quickstart-java-repo
und für den Standard-Speicherort us-central1
fest.
Nachdem Sie die Werte festgelegt haben, müssen Sie diese nicht mehr in gcloud
-Befehlen angeben, für die ein Repository oder Speicherort erforderlich ist.
Um das Repository festzulegen, führen Sie folgenden Befehl aus:
gcloud config set artifacts/repository quickstart-java-repo
Führen Sie den folgenden Befehl aus, um den Standort festzulegen:
gcloud config set artifacts/location us-central1
Weitere Informationen zu diesen Befehlen finden Sie in der Dokumentation zu gcloud config set.
Fügen Sie Einstellungen hinzu, um das Repository mit der Datei
build.gradle
zu verbinden. Mit dem folgenden Befehl werden die Einstellungen ausgegeben, die für das Standard-Repositoryquickstart-java-repo
hinzuzufügen sind.gcloud artifacts print-settings gradle
Die Ausgabe des Befehls
gcloud
sieht in etwa wie im folgenden Beispiel aus, wobei PROJECT Ihre Projekt-ID ist:plugins { id "maven-publish" id "com.google.cloud.artifactregistry.gradle-plugin" version "2.2.1" } publishing { repositories { maven { url "artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-java-repo" } } } repositories { maven { url "artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-java-repo" } }
Prüfen Sie, ob die Datei
build.gradle
den Abschnitt publications enthält. Falls nicht, fügen Sie ihn der Dateibuild.gradle
hinzu.Der Abschnitt
publications
ist ein untergeordnetes Element vonpublishing
, wie im folgenden Beispiel gezeigt:publishing { publications { mavenJava(MavenPublication) { groupId 'maven.example.id' from components.java } } repositories { maven { url "artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-java-repo" } } }
Sie können die Repository-Konfiguration auch zu Ihrer
init.gradle
- odersettings
-Datei hinzufügen. Weitere Informationen zu diesen Optionen finden Sie unter Authentifizierung einrichten.Paket in das Repository hochladen
Für Maven können Sie mit
mvn deploy
undmvn release
Pakete zum Repository hinzufügen.Für Gradle verwenden Sie den Befehl
gradle publish
, um ein Paket in das Repository hochzuladen.Paket im Repository aufrufen
So prüfen Sie, ob das Paket dem Repository hinzugefügt wurde:Console
Öffnen Sie in der Cloud Console die Seite Repositories.
Klicken Sie in der Repository-Liste auf das Repository
quickstart-java-repo
.Auf der Seite Pakete sind die Pakete des Repositorys aufgeführt.
gcloud
Führen Sie den folgenden Befehl aus, um die Pakete im Repository
quickstart-java-repo
aufzulisten:gcloud artifacts packages list --repository=quickstart-java-repo
Die Ausgabe sollte in etwa so aussehen:
Listing items under project <project-id>, location us-central1,\ repository quickstart-java-repo. PACKAGE: maven.example.id:gradle-demo CREATE_TIME: 2022-01-20T22:46:07 UPDATE_TIME: 2022-01-20T22:46:07
Dabei ist
maven.example.id:gradle-demo
die Paket-ID.Um die Versionen für ein Paket aufzurufen, führen Sie folgenden Befehl aus:
gcloud artifacts versions list --package=PACKAGE
Dabei ist PACKAGE die Paket-ID.
Bereinigen
Mit den folgenden Schritten vermeiden Sie, dass Ihrem Google Cloud-Konto die auf dieser Seite verwendeten Ressourcen in Rechnung gestellt werden:
Prüfen Sie vor dem Entfernen des Repositorys, ob alle Pakete, die Sie beibehalten möchten, an einem anderen Speicherort verfügbar sind.
So löschen Sie das Repository:
Console
Öffnen Sie in der Cloud Console die Seite Repositories.
Wählen Sie in der Repository-Liste das Repository
quickstart-java-repo
aus.Klicken Sie auf Löschen.
gcloud
Um das Repository
quickstart-java-repo
zu löschen, führen Sie folgenden Befehl aus:gcloud artifacts repositories delete quickstart-java-repo
Wenn Sie die Einstellungen für das Standard-Repository und den Standard-Speicherort entfernen möchten, die Sie für die aktive
gcloud
-Konfiguration festgelegt haben, führen Sie die folgenden Befehle aus:gcloud config unset artifacts/repository gcloud config unset artifacts/location
Nächste Schritte
- Authentifizierung konfigurieren
- Repositories verwalten
- Pakete verwalten
- Lesen Sie unser Infomaterial zu DevOps und informieren Sie sich über unser Forschungsprogramm.