Cette page explique comment télécharger des fichiers individuels à partir de dépôts standards et distants Artifact Registry. Le dépôt peut être de n'importe quel format d'artefact.
Le téléchargement de fichiers peut être utile lorsque vous souhaitez importer des fichiers dans votre environnement local sans outils spécifiques au format. Notez que vous devez toujours vous authentifier auprès d'Artifact Registry avant de télécharger des fichiers.
Fichiers téléchargeables
Vous pouvez télécharger n'importe quel fichier de données ou de métadonnées individuel qui se trouve dans votre dépôt. Par exemple, un dépôt Maven stocke des packages Java en tant qu'artefacts. Tous les fichiers d'un package Java, tels que les fichiers JAR et pom.xml, peuvent être téléchargés individuellement.
L'utilisation de cette fonctionnalité n'est pas recommandée pour les artefacts qui dépendent fortement des outils clients pour les opérations de téléchargement, tels que les images Docker.
Avant de commencer
Rôles requis
Pour obtenir les autorisations dont vous avez besoin pour télécharger les fichiers stockés dans un dépôt, demandez à votre administrateur de vous attribuer le rôle IAM Lecteur Artifact Registry (roles/artifactregistry.reader
) pour le dépôt.
Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.
Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.
Répertorier les fichiers
Vous pouvez lister les fichiers d'un dépôt pour voir ceux qui sont disponibles en téléchargement.
Pour toutes les commandes suivantes, vous pouvez définir un nombre maximal de fichiers à renvoyer en ajoutant l'option --limit
à la commande.
Pour répertorier tous les fichiers du projet, du dépôt et de l'emplacement par défaut lorsque les valeurs par défaut sont configurées:
gcloud artifacts files list
Pour répertorier les fichiers dans un projet, un dépôt et un emplacement spécifiés, exécutez la commande suivante:
gcloud artifacts files list \
--project=PROJECT \
--repository=REPOSITORY \
--location=LOCATION
Pour répertorier les fichiers de toutes les versions d’un package spécifique:
gcloud artifacts files list \
--project=PROJECT \
--repository=REPOSITORY \
--location=LOCATION \
--package=PACKAGE
Pour répertorier les fichiers d'une version de package spécifique:
gcloud artifacts files list \
--project=PROJECT \
--repository=REPOSITORY \
--location=LOCATION \
--package=PACKAGE \
--version=VERSION
Remplacez les valeurs suivantes :
LOCATION
: emplacement régional ou multirégional du dépôt.PROJECT
: ID de votre projet Google Cloud. Si l'ID du projet contient le signe deux-points (:
), consultez la section Projets à l'échelle du domaine.REPOSITORY
: nom du dépôt dans lequel l'image est stockée.PACKAGE
: nom du package.VERSION
: version du package.
Pour les dépôts Docker, vous pouvez répertorier les fichiers d'un tag d'image de conteneur spécifique en ajoutant l'option --tag
à la commande.
Pour en savoir plus, consultez la page sur gcloudartifact files list.
Télécharger des fichiers
Pour télécharger des fichiers individuels à partir d'un dépôt, exécutez la commande suivante:
gcloud
Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :
PROJECT
: ID du projet Google Cloud. Si l'ID du projet contient le signe deux-points (:
), consultez la section Projets à l'échelle du domaine.LOCATION
: emplacement régional ou multirégional du dépôt.REPOSITORY
: nom du dépôt dans lequel l'artefact est stocké.DESTINATION
: chemin d'accès au dossier de destination dans votre système de fichiers local. Le dossier de destination doit déjà exister, sinon la commande échouera.FILE
: nom de fichier complet Pour trouver cette valeur, exécutez la commandegcloud artifacts files list
et copiez la valeur deFILE
.
Exécutez la commande suivante:
Linux, macOS ou 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
Avant d'utiliser les données de requête, effectuez les remplacements suivants:
PROJECT
: ID du projet Google Cloud. Si l'ID du projet contient le signe deux-points (:
), consultez la section Projets à l'échelle du domaine.LOCATION
: emplacement régional ou multirégional du dépôt.REPOSITORY
: nom du dépôt dans lequel l'artefact est stocké.DESTINATION
: chemin d'accès au dossier de destination dans votre système de fichiers local. Le dossier de destination doit déjà exister, sinon la commande échouera.FILE
: nom de fichier encodé en URL Pour trouver cette valeur, exécutez la commandegcloud artifacts files list
et copiez la valeur deFILE
. Il doit être converti au format encodé en URL pour cette commande. Par exemple,path/to/file.jar
doit être saisi sous la formepath%2Fto%2Ffile.jar
.
Méthode HTTP et URL :
GET https://artifactregistry.googleapis.com/download/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/files/FILE:download?alt=media
Pour envoyer votre requête, développez l'une des options suivantes :
Le téléchargement devrait commencer immédiatement.