Dateien herunterladen

Auf dieser Seite wird beschrieben, wie Sie einzelne Dateien aus Artifact Registry herunterladen Standard-Repositories und Remote-Repositories Das Repository kann ein beliebiges Artefaktformat haben.

Das Herunterladen von Dateien kann nützlich sein, wenn Sie Dateien ohne formatspezifische Tools. Beachten Sie, dass Sie immer noch müssen Sie sich bei Artifact Registry authentifizieren, bevor Sie Dateien herunterladen.

Herunterladbare Dateien

Sie können jede einzelne Daten- oder Metadatendatei aus Ihrem Repository herunterladen. Ein Maven-Repository speichert beispielsweise Java-Pakete als Artefakte. Beliebige Dateien in einem Java-Paket, wie z. B. JAR-Dateien und pom.xml-Dateien, einzeln zum Download verfügbar.

Die Verwendung dieser Funktion wird nicht für Artefakte empfohlen, die stark von Clienttools für Downloadvorgänge wie Docker-Images.

Hinweise

Erforderliche Rollen

Um die Berechtigungen zum Herunterladen von Dateien zu erhalten, die in einem Repository gespeichert sind, bitten Sie Ihren Administrator, Ihnen IAM-Rolle Artifact Registry-Leser (roles/artifactregistry.reader) für das Repository. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Dateien auflisten

Sie können Dateien in einem Repository auflisten, um zu sehen, welche Dateien zum Download verfügbar sind.

Console

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

    Zur Seite „Repositories“

  2. Wählen Sie das Repository aus der Repository-Liste aus.

  3. Klicke auf den Namen des Pakets.

  4. Um herunterladbare Dateien für alle Paketversionen anzusehen, klicken Sie auf den Tab Dateien. .

  5. Um herunterladbare Dateien für eine bestimmte Version Ihres Pakets anzuzeigen, klicken Sie auf den Versionsnamen und klicken Sie dann auf den Tab Dateien.

gcloud

Für alle folgenden Befehle können Sie eine maximale Anzahl von Dateien festlegen, die zurückgegeben werden sollen indem Sie dem Befehl das Flag --limit hinzufügen.

Zum Auflisten aller Dateien im Standardprojekt, Repository und Standort, wenn die Standardwerte konfiguriert sind:

gcloud artifacts files list

Führen Sie den folgenden Befehl aus, um Dateien in einem bestimmten Projekt, Repository und Speicherort aufzulisten:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION

So listen Sie Dateien für alle Versionen eines bestimmten Pakets auf:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE

So listen Sie Dateien für eine bestimmte Paketversion auf:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE \
    --version=VERSION

Ersetzen Sie die folgenden Werte:

  • LOCATION: die regional oder multiregional Speicherort des Repositorys.
  • PROJECT: Ihre Google Cloud-Projekt-ID. Wenn die Projekt-ID einen Doppelpunkt (`:`) enthält, finden Sie weitere Informationen unter Auf Domains beschränkte Projekte.
  • REPOSITORY: der Name des Repositorys, in dem sich das Image befindet gespeichert ist.
  • PACKAGE: der Name des Pakets.
  • VERSION: die Version des Pakets.

Für Docker-Repositories können Sie Dateien für ein bestimmtes Container-Image-Tag auflisten indem Sie dem Befehl das Flag --tag hinzufügen.

Weitere Informationen finden Sie unter gcloud tools file list (Dateiliste für gcloud-Artefakte)

Dateien herunterladen

Führen Sie den folgenden Befehl aus, um einzelne Dateien aus einem Repository herunterzuladen:

gcloud

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

  • PROJECT: Ihr Google Cloud-Team Projekt-ID. Wenn die Projekt-ID einen Doppelpunkt (:) enthält, finden Sie weitere Informationen unter Auf Domains beschränkte Projekte.
  • LOCATION: der regionale oder multiregionale Speicherort des Repositorys.
  • REPOSITORY: der Name des Repositorys wo das Artefakt gespeichert ist.
  • DESTINATION: der Pfad zum Zielordner in Ihrem lokalen Dateisystem. Der Zielordner muss bereits vorhanden sein oder der schlägt fehl.
  • FILE: der vollständige Dateiname. Hier finden Sie indem Sie den Befehl gcloud artifacts files list ausführen und den Wert für FILE kopieren.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

gcloud artifacts files download \
    --project=PROJECT \
    --location=LOCATION \
    --repository=REPOSITORY \
    --destination=DESTINATION \
    FILE

Windows (PowerShell)

gcloud artifacts files download `
    --project=PROJECT `
    --location=LOCATION `
    --repository=REPOSITORY `
    --destination=DESTINATION `
    FILE

Windows (cmd.exe)

gcloud artifacts files download ^
    --project=PROJECT ^
    --location=LOCATION ^
    --repository=REPOSITORY ^
    --destination=DESTINATION ^
    FILE
Der Download sollte sofort beginnen.

API

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT: Ihr Google Cloud-Team Projekt-ID. Wenn die Projekt-ID einen Doppelpunkt (:) enthält, finden Sie weitere Informationen unter Auf Domains beschränkte Projekte.
  • LOCATION: der regionale oder multiregionale Speicherort des Repositorys.
  • REPOSITORY: der Name des Repositorys wo das Artefakt gespeichert ist.
  • DESTINATION: der Pfad zum Zielordner in Ihrem lokalen Dateisystem. Der Zielordner muss bereits vorhanden sein oder der schlägt fehl.
  • FILE: der URL-codierte Dateiname. Sie können Ermitteln Sie diesen Wert, indem Sie den Befehl gcloud artifacts files list ausführen und den Wert für FILE kopieren. Das muss für diesen Befehl in ein URL-codiertes Format konvertiert, z. B. path/to/file.jar muss als path%2Fto%2Ffile.jar eingegeben werden.

HTTP-Methode und URL:

GET https://artifactregistry.googleapis.com/download/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/files/FILE:download?alt=media

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Der Download sollte sofort beginnen.

Nächste Schritte