Dateien herunterladen

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

Das Herunterladen von Dateien kann nützlich sein, wenn Sie Dateien ohne formatspezifische Tools in Ihre lokale Umgebung übertragen möchten. Sie müssen sich jedoch weiterhin bei Artifact Registry authentifizieren, bevor Sie Dateien herunterladen.

**Hinweis**: Dateien können nicht aus virtuellen Repositories heruntergeladen werden.

Herunterladbare Dateien

Sie können einzelne Daten- oder Metadatendateien herunterladen, die sich in Ihrem Repository befinden. In einem Maven-Repository werden beispielsweise Java-Pakete als Artefakte gespeichert. Alle Dateien in einem Java-Paket, z. B. JAR-Dateien und pom.xml-Dateien, können einzeln heruntergeladen werden.

Die Verwendung dieser Funktion wird für Artefakte nicht empfohlen, bei denen für Downloadvorgänge stark auf Client-Tools angewiesen sind, z. B. Docker-Images.

Hinweis

• (Optional) Standardwerte für gcloud CLI Befehle festlegen.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Artifact Registry-Leser (roles/artifactregistry.reader) für das Repository zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Herunterladen von Dateien benötigen, die in einem Repository gespeichert sind. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen 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, was zum Herunterladen verfügbar ist.

Console

1. Öffnen Sie in der Google Cloud console die Seite Repositories.

   Zur Seite „Repositories“

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

3. Klicken Sie auf den Namen des Pakets.

4. Wenn Sie herunterladbare Dateien für alle Paketversionen aufrufen möchten, klicken Sie auf den Tab Dateien.

5. Wenn Sie herunterladbare Dateien für eine bestimmte Version Ihres Pakets aufrufen möchten, klicken Sie auf den Namen der Version und 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. Fügen Sie dazu dem Befehl das Flag --limit hinzu.

So listen Sie alle Dateien im Standardprojekt, im Standard-Repository und am Standard-Speicherort auf, wenn die Standardwerte konfiguriert sind:

gcloud artifacts files list

Führen Sie den folgenden Befehl aus, um Dateien in einem angegebenen 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: der regionale oder multiregionale Standort 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 das Image gespeichert ist.
• PACKAGE: der Name des Pakets.
• VERSION: die Version des Pakets.

Bei 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 artifacts files list.

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: Ihre Google Cloud 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 Standort des Repositorys.
• REPOSITORY: der Name des Repositorys in dem das Artefakt gespeichert ist.
• DESTINATION: der Pfad zum Zielordner in Ihrem lokalen Dateisystem. Der Zielordner muss bereits vorhanden sein, andernfalls schlägt der Befehl fehl.
• FILE: der vollständige Dateiname. Sie finden diesen Wert, indem Sie den gcloud artifacts files list Befehl ausführen und den Wert für FILE kopieren.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu entweder gcloud init; oder gcloud auth login und gcloud config set project aus.

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

Der Download sollte sofort beginnen.

API

Ersetzen Sie folgende Werte in den Anfragedaten:

• PROJECT: Ihre Google Cloud 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 Standort des Repositorys.
• REPOSITORY: der Name des Repositorys in dem das Artefakt gespeichert ist.
• DESTINATION: der Pfad zum Zielordner in Ihrem lokalen Dateisystem. Der Zielordner muss bereits vorhanden sein, andernfalls schlägt der Befehl fehl.
• FILE: der URL-codierte Dateiname. Sie können diesen Wert finden, indem Sie den Befehl gcloud artifacts files list ausführen und den Wert für FILE kopieren. Für diesen Befehl muss er in das URL-codierte Format konvertiert werden. path/to/file.jar muss beispielsweise 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:

curl (Linux, macOS oder Cloud Shell)

Führen Sie folgenden Befehl aus:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     --output DESTINATION \
     "https://artifactregistry.googleapis.com/download/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/files/FILE:download?alt=media"

PowerShell (Windows)

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -OutFile DESTINATION `
    -Uri "https://artifactregistry.googleapis.com/download/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/files/FILE:download?alt=media"

Der Download sollte sofort beginnen.

Nächste Schritte

• Repositories ansehen und auflisten
• Repositories mit Labels versehen
• Repositories mit Tags versehen
• Repositories löschen