Diese Seite wurde von der Cloud Translation API übersetzt.

Java-Pakete in Artifact Registry speichern

In dieser Kurzanleitung wird gezeigt, wie Sie ein privates Maven-Repository von Artifact Registry einrichten und ein Paket in dieses Repository hochladen.

Eine detaillierte Anleitung dazu finden Sie direkt in der Google Cloud Console. Klicken Sie dazu einfach auf Anleitung:

Anleitung

Hinweise

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Artifact Registry API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Artifact Registry API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Cloud Shell starten

In dieser Kurzanleitung verwenden Sie Cloud Shell, eine Shell-Umgebung für die Verwaltung von Ressourcen, die inGoogle Cloudgehostet 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.

Google Cloud Console
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 Google Cloud Console die Seite Repositories.

Zur 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 Standort us-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 zur Verfügung haben, können Sie das Maven-Projekt in 5 Minuten erstellen.

In dieser Kurzanleitung wird davon ausgegangen, dass Ihr einfaches Projekt keine zusätzlichen übergeordneten oder Plugin-Abhängigkeiten hat, die in Artifact Registry gespeichert sind. Weitere Informationen zum Konfigurieren eines Maven-Projekts mit Abhängigkeiten in Artifact Registry finden Sie unter Mit einem Credential Helper authentifizieren.
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ü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.5</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 angelegten Artifact Registry-Repository bereitzustellen. Wenn Sie keinen Test-Gradle-Build zur Verfügung haben, können Sie mit der einführenden Gradle-Anleitung einen einfachen Gradle-Build 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-Repository quickstart-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.5"
      }

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 Datei build.gradle hinzu.

Der Abschnitt publications ist ein untergeordnetes Element von publishing, 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- oder settings-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 und mvn release Pakete zum Repository hinzufügen.
Hinweis: Der Befehl mvn archetype wird nicht unterstützt, wenn er ausschließlich aus dem Artifact Registry-Repository verwendet wird.
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
1. Öffnen Sie in der Google Cloud Console die Seite Repositories.
  
  Zur Seite „Repositories“
2. Klicken Sie in der Repository-Liste auf das Repository quickstart-java-repo.
  
  Auf der Seite Pakete sind die Pakete des Repositorys aufgeführt.
gcloud
1. 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.
  
  Führen Sie den folgenden Befehl aus, um Versionen für ein Paket anzusehen:
  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 Google Cloud Console die Seite Repositories.

Zur 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.

Java-Pakete in Artifact Registry speichern

Hinweise

Cloud Shell starten

Package Repository für Java erstellen

Console

gcloud

Maven konfigurieren

Gradle konfigurieren

Paket in das Repository hochladen

Paket im Repository aufrufen

Console

gcloud

Bereinigen

Console

gcloud

Nächste Schritte