Documentation Oracle Cloud Infrastructure

Publication d'un environnement conda sur un bucket Object Storage dans une location

Publiez des environnements conda vers Object Storage pour utiliser des sessions de bloc-notes.

Pour pouvoir publier un environnement conda ou installer un environnement conda publié, vous devez configurer odsc conda afin d'utiliser un bucket Object Storage à l'aide de la commande suivante :

odsc conda init -b <your-bucket-name> -n <your-tenancy-namespace> -a <api_key or resource_principal>
Modifiez les valeurs suivantes dans la commande :

  • <your-bucket-name> : nom du bucket Object Storage dans une location contenant les environnements conda publiés.

  • <your-tenancy-namespace> : espace de noms de la location.

  • <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. Afin d'utiliser un autre répertoire pour la clé d'API, exécutez la commande odsc conda init -a, et indiquez un nom api_key ou resource_principal.

    Pour plus d'informations sur les options, vous pouvez exécuter odsc conda init -h.

Vous devez exécuter la commande odsc conda init une seule fois par session de bloc-notes. Les valeurs de bucket et d'espace de noms persistent après la désactivation et l'activation d'une session de bloc-notes.

Vous pouvez publier un environnement conda que vous avez installé dans une session de bloc-notes. La publication d'un environnement conda consiste à créer un pack pour un environnement conda et à le télécharger vers un stockage d'objet spécifié. Cela permet de partager des environnements conda entre collègues ou de les rendre persistants dans les sessions de bloc-notes. Nous vous recommandons de publier les environnements conda afin de vous assurer de la reproductibilité d'un environnement d'entraînement de modèle.

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

odsc conda publish -s <slug>

<slug> est le slug de l'environnement à publier.

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

Les environnements conda peuvent être publiés directement vers un bucket Object Storage en indiquant 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 vers un bucket :
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 vers un bucket à l'aide de l'authentification api_key :
odsc conda publish -s onnx110_p38_cpu_v2 --uri oci://<my-bucket>@<my-namespace>/ -a api_key

Si aucun préfixe n'est indiqué pour --uri, conda_environment est indiqué comme 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 d'accès Object Storage à cet environnement conda lorsque vous enregistrez le modèle. Les références aux environnements d'entraînement sont stockées dans le fichier runtime.yaml de l'artefact de modèle. Reportez-vous à Gestion des modèles.