Télécharger des fichiers

Cette page explique comment télécharger des fichiers individuels à partir des dépôts standards et distants d'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 trouvé dans votre dépôt. Par exemple, un dépôt Maven stocke les packages Java en tant qu'artefacts. Tous les fichiers d'un package Java, tels que les fichiers JAR et les fichiers pom.xml, sont disponibles au téléchargement individuellement.

L'utilisation de cette fonctionnalité n'est pas recommandée pour les artefacts qui dépendent fortement des outils client pour les opérations de téléchargement, comme les images Docker.

Avant de commencer

Rôles requis

Pour obtenir les autorisations nécessaires pour télécharger des fichiers stockés dans un dépôt, demandez à votre administrateur de vous accorder le rôle IAM Lecteur du registre des artefacts (roles/artifactregistry.reader) sur le dépôt. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

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 ce qui est disponible à télécharger.

Console

  1. Ouvrez la page Dépôts dans la console Google Cloud .

    Ouvrir la page "Dépôts"

  2. Dans la liste des dépôts, sélectionnez le dépôt.

  3. Cliquez sur le nom du package.

  4. Pour afficher les fichiers téléchargeables pour toutes les versions du package, cliquez sur l'onglet Fichiers.

  5. Pour afficher les fichiers téléchargeables d'une version spécifique de votre package, cliquez sur le nom de la version, puis sur l'onglet Fichiers.

gcloud

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 dans le projet, le dépôt et l'emplacement par défaut lorsque les valeurs par défaut sont configurées:

gcloud artifacts files list

Pour répertorier les fichiers d'un projet, d'un dépôt et d'un emplacement spécifiés, exécutez la commande suivante:

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

Pour lister les fichiers de toutes les versions d'un package spécifique:

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

Pour lister 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 de votre projet contient un signe deux-points (:), consultez la section Projets à l'échelle du domaine.
  • REPOSITORY: nom du dépôt où l'image est stockée.
  • PACKAGE: nom du package.
  • VERSION: version du package.

Pour les dépôts Docker, vous pouvez lister les fichiers d'une balise d'image de conteneur spécifique en ajoutant l'option --tag à la commande.

Pour en savoir plus, consultez la section Liste des fichiers d'artefacts gcloud.

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 de votre projet Google Cloud. Si l'ID de votre projet contient un 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 complet du fichier. Pour trouver cette valeur, exécutez la commande gcloud artifacts files list et copiez la valeur de FILE.

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
Le téléchargement devrait commencer immédiatement.

API

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • PROJECT: ID de votre projet Google Cloud. Si l'ID de votre projet contient un 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é au format URL. Pour trouver cette valeur, exécutez la commande gcloud artifacts files list et copiez la valeur de FILE. Pour cette commande, il doit être converti au format encodé en URL. Par exemple, path/to/file.jar doit être saisi sous la forme path%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.

Étape suivante