Gérer les packages Conda

Une fois que vous avez créé un dépôt Conda dans Artifact Registry, vous pouvez installer des packages Conda dans votre nouveau dépôt. Cette page explique comment installer, afficher et supprimer vos packages Conda.

Avant de commencer

  1. Installez et initialisez la Google Cloud CLI.

    La version 354.0.0 ou ultérieure de Google Cloud CLI est requise pour exécuter des commandes pour les dépôts Conda. Vous pouvez vérifier la version à l'aide de la commande suivante :

    gcloud version

  2. Pour utiliser la CLI Conda dans votre environnement Google Cloud , installez l'un des gestionnaires de packages Conda suivants :

  3. Si vous n'avez pas de dépôt Conda dans Artifact Registry, créez-en un.

  4. (Facultatif) Définissez des valeurs par défaut pour les commandes gcloud.

Artifact Registry est compatible avec les dépôts Conda standards et distants. Vous pouvez utiliser l'une des adresses suivantes pour vos dépôts distants.

  • https://repo.anaconda.com/pkgs/main
  • https://repo.anaconda.com/pkgs/r
  • https://repo.anaconda.com/pkgs/msys2
  • https://conda.anaconda.org/conda-forge
  • https://conda.anaconda.org/bioconda

Rôles requis

Pour obtenir les autorisations nécessaires pour gérer les packages Conda, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le dépôt :

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Gérer les packages Conda

Une fois que vous avez ajouté un package Conda à votre dépôt Artifact Registry, vous pouvez l'installer dans votre environnement Conda et afficher des informations le concernant à l'aide de Google Cloud.

Ajouter des packages à un dépôt Artifact Registry

Pour ajouter un package Conda à votre dépôt Artifact Registry, exécutez la commande suivante :

gcloud artifacts files upload \
    --source=PACKAGE_NAME \
    --repository=REPO_NAME\
    --project=PROJECT \
    --location=LOCATION

Où :

  • REPO_NAME est l'ID du dépôt.
  • PROJECT est l'ID du projet contenant le dépôt.
  • LOCATION est l'emplacement régional ou multirégional du dépôt.

Pour ajouter plusieurs packages à la fois :

gcloud artifacts files upload \
    --source-directory=DIRECTORY \
    --repository=REPO_NAME\
    --project=PROJECT \
    --location=LOCATION

Où :

  • DIRECTORY est l'adresse d'un dossier local contenant vos packages Conda.

Installer des packages

Modes de dépôt : standard, distant

Pour installer la dernière version stable d'un package dans votre environnement Conda, exécutez la commande suivante :

Conda

conda install -n ENVIRONMENT_NAME PACKAGE_NAME

Miniforge

conda install -n ENVIRONMENT_NAME PACKAGE_NAME

Mamba

mamba install -n ENVIRONMENT_NAME PACKAGE_NAME

Micromamba

micromamba install -n ENVIRONMENT_NAME PACKAGE_NAME

Où :

  • ENVIRONMENT_NAME est le nom de votre environnement Conda. Si vous avez déjà activé un environnement et que vous installez le package directement dans l'environnement, vous pouvez omettre -n ENVIRONMENT_NAME.

  • PACKAGE_NAME est le nom de votre package Conda.

    Pour installer une version spécifique d'un package dans votre environnement Conda, incluez VERSION après le nom du package.

Pour les dépôts standards, vous téléchargez un package directement à partir du dépôt.

Pour un dépôt distant, vous téléchargez une copie mise en cache du package et de ses dépendances. Si aucune copie mise en cache n'existe, le dépôt distant télécharge le package à partir de la source en amont et le met en cache avant de vous le fournir. Vous pouvez vérifier que le dépôt distant a récupéré les packages à partir de la source en amont en affichant la liste des packages dans le dépôt.

Afficher les packages et les versions

Modes de dépôt : standard, distant

Pour afficher les packages et les versions de package à l'aide de la console Google Cloud ou de gcloud :

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, cliquez sur le dépôt approprié.

    La page Packages répertorie les packages du dépôt.

  3. Cliquez sur un package pour afficher ses versions.

gcloud

Pour répertorier les packages d'un dépôt, exécutez la commande suivante :

gcloud artifacts packages list [--repository=REPOSITORY] [--location=LOCATION]

Remplacez les éléments suivants :

  • REPOSITORY est le nom du dépôt. Si vous avez configuré un dépôt par défaut, vous pouvez omettre cet indicateur pour utiliser le dépôt par défaut.
  • LOCATION est l'emplacement régional ou multirégional du dépôt. Si vous avez configuré un emplacement par défaut, vous pouvez omettre cette option pour utiliser la valeur par défaut.

Pour afficher les versions d'un package, exécutez la commande suivante :

gcloud artifacts versions list --package=PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION]

Remplacez les éléments suivants :

  • PACKAGE est l'ID du package ou l'identifiant complet du package.
  • REPOSITORY est le nom du dépôt. Si vous avez configuré un dépôt par défaut, vous pouvez omettre cet indicateur pour utiliser le dépôt par défaut.
  • LOCATION est l'emplacement régional ou multirégional du dépôt. Utilisez cette option pour afficher les dépôts dans un emplacement spécifique. Si vous avez configuré un emplacement par défaut, vous pouvez omettre cette option pour utiliser la valeur par défaut.

Pour les dépôts distants, la liste renvoyée n'affiche que les packages mis en cache.

Lister les fichiers

Modes de dépôt : standard, distant

Pour les dépôts distants, la liste renvoyée n'affiche que les fichiers d'index et les packages Conda mis en cache.

Vous pouvez lister les fichiers d'un dépôt, les fichiers de toutes les versions d'un package spécifié ou les fichiers d'une version spécifique d'un package.

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 lister les fichiers d'un projet, d'un dépôt et d'un emplacement spécifiques, 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 du projet contient le 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.

Exemples

Tenez compte des informations suivantes sur le package :

  • Projet : my-project
  • Dépôt : my-repo
  • Emplacement du dépôt : us-west1
  • Package : my-app

La commande suivante liste tous les fichiers du dépôt my-repo à l'emplacement us-west1 dans le projet par défaut :

gcloud artifacts files list \
    --location=us-west1 \
    --repository=my-repo
La commande suivante liste les fichiers de la version 1.0 du package.

gcloud artifacts files list \
    --project=my-project \
    --location=us-west1 \
    --repository=my-repo \
    --package=my-app \
    --version=1.0

Supprimer des packages et des versions

Modes de dépôt : standard, distant

Vous pouvez supprimer un package et toutes ses versions, ou supprimer une version spécifique. Les packages supprimés ne peuvent pas être restaurés.

Avant de supprimer un package ou une version de package, vérifiez que vous avez communiqué ou résolu toute dépendance importante associée.

Pour supprimer un package, procédez comme suit :

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, cliquez sur le dépôt approprié.

    La page Packages répertorie les packages du dépôt.

  3. Sélectionnez le forfait que vous souhaitez supprimer.

  4. Cliquez sur SUPPRIMER.

  5. Dans la boîte de dialogue de confirmation, cliquez sur SUPPRIMER.

gcloud

Exécutez la commande ci-dessous.

gcloud artifacts packages delete PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION] [--async]

Remplacez les éléments suivants :

  • PACKAGE est le nom du package dans le dépôt.
  • REPOSITORY est le nom du dépôt. Si vous avez configuré un dépôt par défaut, vous pouvez omettre cet indicateur pour utiliser le dépôt par défaut.
  • LOCATION est l'emplacement régional ou multirégional du dépôt. Utilisez cette option pour afficher les dépôts dans un emplacement spécifique. Si vous avez configuré un emplacement par défaut, vous pouvez omettre cette option pour utiliser la valeur par défaut.

L'option --async permet à la commande de renvoyer immédiatement une réponse, sans attendre la fin de l'opération en cours.

Pour supprimer des versions d'un package, procédez comme suit :

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, cliquez sur le dépôt approprié.

    La page Packages répertorie les packages du dépôt.

  3. Cliquez sur un package pour afficher ses versions.

  4. Sélectionnez les versions que vous souhaitez supprimer.

  5. Cliquez sur SUPPRIMER.

  6. Dans la boîte de dialogue de confirmation, cliquez sur SUPPRIMER.

gcloud

Exécutez la commande ci-dessous.

gcloud artifacts versions delete VERSION \
    --package=PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION] \
    [--async]

Remplacez les éléments suivants :

  • VERSION est le nom de la version à supprimer.
  • PACKAGE est le nom du package dans le dépôt.
  • REPOSITORY est le nom du dépôt. Si vous avez configuré un dépôt par défaut, vous pouvez omettre cet indicateur pour utiliser le dépôt par défaut.
  • LOCATION est l'emplacement régional ou multirégional du dépôt. Utilisez cette option pour afficher les dépôts dans un emplacement spécifique. Si vous avez configuré un emplacement par défaut, vous pouvez omettre cette option pour utiliser la valeur par défaut.

L'option --async permet à la commande de renvoyer immédiatement une réponse, sans attendre la fin de l'opération en cours.

Pour les dépôts distants, Artifact Registry supprime les données de mise en cache des packages sélectionnés, y compris les versions et les fichiers des packages.

Étapes suivantes