Auf dieser Seite wird beschrieben, wie Sie einzelne Dateien aus Standard- und Remote-Repositories der Artifact Registry 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 aufnehmen möchten. Sie müssen sich jedoch weiterhin bei Artifact Registry authentifizieren, bevor Sie Dateien herunterladen können.
Herunterladbare Dateien
Sie können jede einzelne Daten- oder Metadatendatei herunterladen, die sich in Ihrem Repository befindet. 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, die stark von Client-Tools für Downloadvorgänge abhängen, wie z. B. Docker-Images, nicht empfohlen.
Hinweis
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Artifact Registry Reader (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 Download verfügbar ist.
Console
Öffnen Sie in der Cloud Console die Seite Repositories.
Wählen Sie in der Repository-Liste das Repository aus.
Klicken Sie auf den Namen des Pakets.
Wenn Sie herunterladbare Dateien für alle Paketversionen aufrufen möchten, klicken Sie auf den Tab Dateien.
Wenn Sie die herunterladbaren Dateien für eine bestimmte Version Ihres Pakets aufrufen möchten, klicken Sie auf den Versionsnamen und dann auf den Tab Dateien.
gcloud
Bei allen folgenden Befehlen können Sie eine maximale Anzahl von Dateien festlegen, die zurückgegeben werden sollen. Dazu fügen Sie 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 bestimmten Projekt, Repository und an einem bestimmten 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 Speicherort des Repositories.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
ist 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 Speicherort des Repositories.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, da der Befehl sonst fehlschlägt.FILE
: der vollständige Dateiname. Sie können diesen Wert ermitteln, indem Sie den Befehlgcloud artifacts files list
ausführen und den Wert fürFILE
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
API
Ersetzen Sie diese Werte in den folgenden 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 Speicherort des Repositories.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, da der Befehl sonst fehlschlägt.FILE
: der URL-codierte Dateiname. Sie können diesen Wert ermitteln, indem Sie den Befehlgcloud artifacts files list
ausführen und den Wert fürFILE
kopieren. Für diesen Befehl muss es in das URL-codierte Format umgewandelt werden. Beispiel:path/to/file.jar
muss alspath%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.