Publication d'un environnement Conda dans un seau de stockage d'objets dans une location

Publier des environnements Conda dans le stockage d'objets pour utiliser des sessions de carnet.

Pour publier un environnement Conda ou en installer un publié, vous devez configurer odsc conda pour utiliser un seau de stockage d'objets à l'aide de cette commande :

odsc conda init -b <your-bucket-name> -n <your-tenancy-namespace> -a <api_key or resource_principal>
Modifiez ces valeurs dans la commande :
  • <your-bucket-name>: is the name of the Object Storage bucket in a tenancy containing Published Conda Environments.

  • <your-tenancy-namespace>: is the namespace of the tenancy.

  • <api_key or resource_principal> : Indiquez une clé d'API ou un principal de ressource. Si vous utilisez l'option de clé d'API, vous devez disposer d'une configuration de clés d'API valide. Le répertoire par défaut de la clé est /home/datascience/.oci. Si vous voulez utiliser un autre répertoire pour la clé d'API, exécutez la commande odsc conda init -a et spécifiez un nom pour api_key ou resource_principal.

    Vous pouvez exécuter odsc conda init -h pour plus d'informations sur les options.

Il vous suffit d'exécuter la commande odsc conda init une fois par session de carnet. Les valeurs de seau et d'espace de noms sont conservées après la désactivation et l'activation d'une session de carnet.

Vous pouvez publier un environnement Conda que vous avez installé dans une session de carnet. La publication d'un environnement Conda consiste à créer un ensemble contenant tous les éléments d'un environnement Conda et à le charger dans un stockage d'objets spécifié. Les environnements Conda peuvent ensuite être partagés entre collègues ou conservés entre des sessions de carnet. Nous vous recommandons de publier des environnements Conda pour vous assurer qu'un environnement d'entraînement de modèle peut être reproduit.

Vous pouvez publier un environnement Conda en cliquant sur Publier dans la carte d'un environnement installé. Copiez l'extrait de code, puis exécutez-le dans un onglet de fenêtre de terminal :

odsc conda publish -s <slug>

<slug> est la ligne-bulle de l'environnement à publier.

Listez toutes les options d'installation prises en charge avec odsc conda install -h.

Les environnements Conda peuvent être publiés directement dans un seau de stockage d'objets en spécifiant l'option --uri. Le type d'authentification est spécifié avec l'option -a. Voici quelques exemples de publication :

Publication de l'environnement Conda onnx110_p38_cpu_v2 après la configuration avec odsc conda by odsc conda init :
odsc conda publish -s onnx110_p38_cpu_v2
Publication de l'environnement Conda database_p37_cpu_v2 dans un seau :
odsc conda publish -s database_p37_cpu_v2 --uri oci://<my-bucket>@<my-namespace>/prefix/

L'environnement est enregistré dans oci://<my-bucket>@<my-namespace>/prefix/ à l'aide d'un principal de ressource par défaut.

Publication de l'environnement Conda onnx110_p38_cpu_v2 dans un seau à l'aide de l'authentification api_key :
odsc conda publish -s onnx110_p38_cpu_v2 --uri oci://<my-bucket>@<my-namespace>/ -a api_key

Lorsqu'aucun préfixe n'est spécifié pour --uri, conda_environment est spécifié en tant que préfixe par défaut. Dans cet exemple, onnx110_p38_cpu_v2 est enregistré dans oci://<my-bucket>@<my-namespace>/conda_environment.

Important

ADS vous avertit lorsque vous créez l'artefact de modèle pour publier un environnement Conda avant d'enregistrer le modèle dans le catalogue de modèles. Si vous avez déjà publié l'environnement Conda, vous pouvez fournir à ADS le chemin du stockage d'objets vers cet environnement lorsque vous enregistrez le modèle. Les références aux environnements d'entraînement sont stockées dans le fichier runtime.yaml qui fait partie de l'artefact du modèle. Voir Gestion des modèles.