Télécharger des fichiers

Cette page explique comment télécharger des fichiers individuels depuis Artifact Registry des dépôts standards et des dépôts distants. Le dépôt peut être dans n'importe quel format d'artefact.

Il peut être utile de télécharger des fichiers pour les transférer sans outils spécifiques au format. Notez que vous devez quand même s'authentifier auprès d'Artifact Registry avant de télécharger des fichiers.

Fichiers téléchargeables

Vous pouvez télécharger tout fichier de données ou de métadonnées présent dans votre référentiel. Par exemple, un dépôt Maven stocke les packages Java en tant qu'artefacts. Tous les fichiers d'un package Java, comme les fichiers JAR et pom.xml, sont disponibles en téléchargement.

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

Avant de commencer

• (Facultatif) Définir des valeurs par défaut pour la gcloud CLI commandes.

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 accorder le Rôle IAM Lecteur Artifact Registry (roles/artifactregistry.reader) sur 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 répertorier les fichiers d'un dépôt pour voir ceux disponibles au téléchargement.

Console

1. Ouvrez la page Dépôts de 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 de toutes les versions du package, cliquez sur le bouton Files (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 cliquez 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 du projet, du dépôt et 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 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: le régional ou multirégional emplacement 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 sont stockées.
• PACKAGE: nom du package.
• VERSION: version du package.

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

Pour en savoir plus, consultez gcloud artefacts files list (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: votre compte Google Cloud ID du projet. Si l'ID du projet contient le signe deux-points (:), consultez la section Projets à l'échelle du domaine.
• LOCATION: l'emplacement régional ou multirégional emplacement du dépôt.
• REPOSITORY: nom du dépôt où l'artefact est stocké.
• DESTINATION: chemin d'accès à dossier de destination dans votre système de fichiers local. Le dossier de destination doit déjà exister. l'exécution de la commande échoue.
• FILE: nom de fichier complet Vous trouverez en exécutant la commande gcloud artifacts files list et en copiant la valeur de FILE.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

Remarque : Assurez-vous d'avoir initialisé Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou gcloud auth login et gcloud config set project.

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

Windows (PowerShell)

Remarque : Assurez-vous d'avoir initialisé Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou gcloud auth login et gcloud config set project.

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

Windows (cmd.exe)

Remarque : Assurez-vous d'avoir initialisé Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou gcloud auth login et gcloud config set project.

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: votre compte Google Cloud ID du projet. Si l'ID du projet contient le signe deux-points (:), consultez la section Projets à l'échelle du domaine.
• LOCATION: l'emplacement régional ou multirégional emplacement du dépôt.
• REPOSITORY: nom du dépôt où l'artefact est stocké.
• DESTINATION: chemin d'accès à dossier de destination dans votre système de fichiers local. Le dossier de destination doit déjà exister. l'exécution de la commande échoue.
• FILE: nom de fichier encodé au format URL. Vous pouvez Trouvez cette valeur en exécutant la commande gcloud artifacts files list et en copiant la valeur de FILE. Il doit s'agir convertie au format encodé en URL pour cette commande (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 :

curl (Linux, macOS ou Cloud Shell)

Exécutez la commande suivante :

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)

Exécutez la commande suivante :

$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"

Le téléchargement devrait commencer immédiatement.

Étape suivante

• Afficher et répertorier les dépôts
• Ajouter des étiquettes aux dépôts
• Dépôts de tags
• Supprimer des dépôts