Configurer l'authentification auprès d'Artifact Registry pour les dépôts Conda

Pour permettre à la CLI Conda d'accéder aux dépôts Artifact Registry, vous devez fournir un jeton d'authentification avec les requêtes adressées à Artifact Registry. Cette page explique comment configurer l'authentification avec un dépôt de packages Conda Artifact Registry.

Avant de commencer

  1. Si vous n'avez pas encore de dépôt Conda, créez un dépôt de packages Conda.
  2. Vérifiez que Conda est installé. Si Conda n'est pas installé, exécutez et installez Miniforge.
  3. Vérifiez que le compte utilisateur ou le compte de service que vous utilisez dispose des autorisations requises pour accéder au dépôt.

  4. Installez la Google Cloud CLI. Une fois l'installation terminée, initialisez la Google Cloud CLI en exécutant la commande suivante : 

    gcloud init

    Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

  5. (Facultatif) Configurez les valeurs par défaut des commandes gcloud CLI.

Authentifier un canal avec des jetons oauth

Un canal Conda est l'adresse d'un emplacement où un ou plusieurs packages Conda sont stockés. Avant de pouvoir installer des packages dans votre environnement Conda, vous devez ajouter le canal de ce package à votre fichier de configuration Conda.

Pour autoriser la CLI Conda à appeler directement Artifact Registry, vous devez authentifier votre canal Conda dans Google Cloud en procédant comme suit :

  1. Dans gcloud CLI, exécutez la commande suivante pour stocker l'identité d'un jeton oauth dans une variable TOKEN :

    export TOKEN="oauth2accesstoken:$(gcloud auth print-access-token)"

  2. Ajoutez votre dépôt Conda en tant que canal dans votre fichier de configuration Conda :

    Conda

    conda config --add channels \
https://$TOKEN@LOCATION-conda.pkg.dev/PROJECT/REPOSITORY

    Miniforge

    conda config --add channels \
https://$TOKEN@LOCATION-conda.pkg.dev/PROJECT/REPOSITORY

    Mamba

    mamba config --add channels \
https://$TOKEN@LOCATION-conda.pkg.dev/PROJECT/REPOSITORY

    Micromamba

    micromamba config --add channels \
https://$TOKEN@LOCATION-conda.pkg.dev/PROJECT/REPOSITORY

    Où :

    • TOKEN stocke la valeur du jeton oauth généré en exécutant oauth2accesstoken:$(gcloud auth print-access-token).
    • LOCATION est l'emplacement régional ou multirégional du dépôt.
    • PROJECT est l'ID du projet contenant le dépôt.
    • REPOSITORY est l'ID du dépôt.

Actualiser un jeton oauth arrivé à expiration

Un jeton oauth expire au bout d'une heure. Pour réauthentifier votre chaîne avec un nouveau jeton, procédez comme suit :

  1. Supprimez votre canal de votre fichier de configuration :

    Conda

    conda config --remove channels CHANNEL_NAME

    Miniforge

    conda config --remove channels CHANNEL_NAME

    Mamba

    mamba config --remove channels CHANNEL_NAME

    Micromamba

    micromamba config --remove channels CHANNEL_NAME

  2. Suivez l'étape précédente qui décrit la création d'un jeton oauth.

  3. Ajoutez à nouveau votre dépôt Conda à votre fichier de configuration Conda en utilisant la valeur de votre nouveau jeton.

Étapes suivantes