Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Kurzanleitung für Maven und Gradle

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

Die Paketverwaltung befindet sich in der Alphaphase. Sie ist nur für Alphanutzer verfügbar und umfasst möglicherweise nicht alle Features der Containerverwaltung. Wenn Sie sich für die Alphaversion anmelden möchten, füllen Sie das Anmeldeformular aus. Weitere Informationen finden Sie unter Voraussetzungen für den Zugriff auf Alphafunktionen.

Hinweis

  1. 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.
  2. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Zur Projektauswahl

  3. Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für Ihr Projekt aktiviert ist.

  4. Aktivieren Sie die Artifact Registry API.

    Aktivieren Sie die API

  5. Installieren und initialisieren Sie das Cloud SDK.

Maven-Repository erstellen

Erstellen Sie das Repository für Ihre Java-Artefakte.

  1. Im Folgenden wird gezeigt, wie Sie das Repository anlegen.

    Console

    1. Öffnen Sie in der Cloud Console die Seite Repositories.

      Zur Seite „Repositories“

    2. Klicken Sie auf Repository erstellen.

    3. Geben Sie quickstart-maven-repo als Repository-Namen an.

    4. Wählen Sie Maven als Format aus.

    5. Wählen Sie unter Standorttyp die Option Region und dann den Standort us-central1 aus.

    6. Klicken Sie auf Erstellen.

    Das Repository wird der Repository-Liste hinzugefügt.

    gcloud

    1. Führen Sie den folgenden Befehl aus, um ein neues Maven-Repository im aktuellen Projekt mit dem Namen quickstart-maven-repo am Speicherort us-central1 zu erstellen.

      gcloud artifacts repositories create quickstart-maven-repo --repository-format=maven \
      --location=us-central1 [--description="Maven repository"]
      
    2. Führen Sie den folgenden Befehl aus, um zu prüfen, ob Ihr Repository erstellt wurde:

      Liste der Repositories für gcloud-Artefakte

    Weitere Informationen zu Artifact Registry-Befehlen erhalten Sie mit dem Befehl gcloud artifacts.

  2. Um die gcloud-Befehle zu vereinfachen, legen Sie für das Standard-Repository den Wert quickstart-maven-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-maven-repo
    

    Um den Speicherort festzulegen, führen Sie folgenden Befehl aus:

    gcloud config set artifacts/location us-central1
    

    Weitere Informationen zu diesen Befehlen finden Sie in der Dokumentation zu gcloud config set.

Dienstkonto für Ihren Client einrichten

  1. Erstellen Sie ein Dienstkonto, das im Namen Ihrer Anwendung agieren soll, oder wählen Sie ein vorhandenes Dienstkonto für die Automatisierung aus.

    Sie benötigen den Speicherort der Dienstkonto-Schlüsseldatei, um damit die Authentifizierung bei Artifact Registry einzurichten. Auf der Seite „Dienstkonten“ können Sie die Schlüssel vorhandener Konten aufrufen und neue Schlüssel erstellen.

    Zur Seite „Dienstkonten“

  2. Gewähren Sie dem Dienstkonto Lese- und Schreibzugriff auf Ihr Repository.

    gcloud artifacts repositories add-iam-policy-binding \
    quickstart-maven-repo --location=us-central1 --member='serviceAccount:ACCOUNT' --role='roles/artifactregistry.writer'
    

    Dabei ist ACCOUNT die ID Ihres Dienstkontos im Format USERNAME@PROJECT-ID.iam.gserviceaccount.com.

  3. Weisen Sie der Variablen GOOGLE_APPLICATION_CREDENTIALS den Speicherort des Dienstkontoschlüssels zu, damit die Artifact Registry-Credential Helper Ihren Schlüssel beim Herstellen einer Verbindung zu Repositories abrufen können.

    export GOOGLE_APPLICATION_CREDENTIALS=KEY-FILE
    

    Dabei ist KEY-FILE der Pfad zur Schlüsseldatei des Dienstkontos.

    Informationen zur alternativen Einrichtung der Passwortauthentifizierung mit der Dienstkonto-Schlüsseldatei erhalten Sie in der Dokumentation zu authentication#auth-password.

Maven konfigurieren

  1. Wählen Sie das 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.

  2. Führen Sie den folgenden Befehl aus, um die Einstellungen für das Standard-Repository quickstart-maven-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-maven-repo</url>
      </snapshotRepository>
      <repository>
        <id>artifact-registry</id>
        <url>artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-maven-repo</url>
      </repository>
    </distributionManagement>
    
    <repositories>
      <repository>
        <id>artifact-registry</id>
        <url>artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-maven-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.1.1</version>
        </extension>
      </extensions>
    </build>
    
  3. 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 nun Pakete in Ihr Repository hochladen. Weitere Informationen zum Konfigurieren von Maven, einschließlich der Konfiguration von Abhängigkeiten für übergeordnete Artefakte, die im Repository gespeichert sind, finden Sie unter Mit Credential Helper authentifizieren.

Gradle konfigurieren

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

  2. Um die gcloud-Befehle zu vereinfachen, legen Sie für das Standard-Repository den Wert quickstart-maven-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-maven-repo
    

    Um den Speicherort festzulegen, führen Sie folgenden Befehl aus:

    gcloud config set artifacts/location us-central1
    

    Weitere Informationen zu diesen Befehlen finden Sie in der Dokumentation zu gcloud config set.

  3. Fügen Sie Einstellungen hinzu, um eine Verbindung zur Datei build.gradle im Repository herzustellen. Mit dem folgenden Befehl werden die Einstellungen für das Standard-Repository quickstart-maven-repo ausgegeben.

    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.1.1"
    }
    
    publishing {
      repositories {
        maven {
          url "artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-maven-repo"
        }
      }
    }
    
    repositories {
      maven {
        url "artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-maven-repo"
      }
    }
    
  4. Prüfen Sie, ob die Datei build.gradle einen Abschnitt publications enthält. 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-maven-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.

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

    Zur Seite „Repositories“

  2. Klicken Sie in der Repository-Liste auf das Repository quickstart-maven-repo.

    Auf der Seite Pakete sind die Pakete des Repositorys aufgeführt.

gcloud

Um die Pakete im Repository quickstart-maven-repo aufzulisten, führen Sie folgenden Befehl aus:

 gcloud artifacts packages list --repository=quickstart-maven-repo

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 in dieser Kurzanleitung 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

  1. Öffnen Sie in der Cloud Console die Seite Repositories.

    Zur Seite „Repositories“

  2. Wählen Sie in der Repository-Liste das Repository quickstart-maven-repo aus.

  3. Klicken Sie auf Löschen.

gcloud

  1. Um das Repository quickstart-maven-repo zu löschen, führen Sie folgenden Befehl aus:

    gcloud artifacts repositories delete quickstart-maven-repo
    
  2. 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