Retourner à la version anglaise de la documentationPersonnalisation des modèles d'environnement
Personnalisation des modèles d'environnement
Dernière mise à jour : 28 nov. 2024
Vous pouvez modifier le nom, la description et la configuration matérielle d'un modèle d'environnement que vous avez créé. Vous pouvez personnaliser la configuration logicielle des modèles d'environnement de bloc-notes Jupyter via des canaux conda ou à l'aide de pip. Vous pouvez fournir une liste de packages conda, une liste de packages pip ou une combinaison des deux. Lorsque vous utilisez des packages conda, vous pouvez fournir une liste d'emplacements de canal conda supplémentaires via lesquels les packages peuvent être obtenus.
- Autorisations requises
- Vous devez disposer du rôle Admin ou Editeur dans le projet pour personnaliser un modèle d'environnement.
- Restrictions
- Vous ne pouvez pas modifier le langage d'un modèle d'environnement existant.
- Vous ne pouvez pas personnaliser la configuration logicielle d'un modèle d'environnement Spark que vous avez créé.
Pour personnaliser un modèle d'environnement que vous avez créé:
- Sous l'onglet Gérer de votre projet, cliquez sur la page Environnements.
- Dans la section Runtimes actives, vérifiez qu'aucune runtime n'est active pour le modèle d'environnement que vous souhaitez modifier.
- Dans la section Modèles d'environnement, cliquez sur le modèle d'environnement que vous souhaitez personnaliser.
- Pour les modèles Python, si vous souhaitez ajouter des éléments interactifs tels que des curseurs, des boutons, des listes déroulantes et des zones de texte à votre bloc-notes en utilisant la bibliothèque IPyWidgets, cochez la case IPyWidgets.
- Pour les modèles d'environnement Juypter notebook, si vous souhaitez ajouter des paquets, cliquez sur Créer et indiquez les bibliothèques à ajouter aux paquets standard disponibles par défaut. Vous pouvez également utiliser la personnalisation pour mettre à niveau ou rétromigrer les packages qui font partie de la configuration logicielle standard.
- Si vous n'avez pas ajouté de personnalisation du paquet, fermez la fenêtre pour appliquer vos modifications. Si vous avez ajouté de nouveaux paquets, vous devez cliquer sur Appliquer.
Important pour la personnalisation des paquets:
- Les bibliothèques que vous ajoutez à un modèle d'environnement par le biais de la personnalisation sont automatiquement installées à chaque fois que le moteur d'exécution de l'environnement est démarré. Les autres membres du projet qui utilisent ce modèle peuvent également utiliser ce paquet. Notez que les personnalisations ajoutées dans une cellule d'un carnet déjà en cours d'exécution ne sont pas partagées avec d'autres.
- Avant de personnaliser un paquet, vérifiez que les modifications que vous prévoyez ont l'effet escompté.
conda
peut signaler les modifications requises pour l'installation d'un module donné, sans l'installer. Vous pouvez vérifier les modifications à partir de votre bloc-notes. Par exemple, pour la bibliothèque Plotly :- Dans un bloc-notes Python, entrez :
!conda install --dry-run plotly
- Dans un bloc-notes R, entrez :
print(system2("conda", args=c("install","--dry-run","r-plotly"), stdout=TRUE))
- Dans un bloc-notes Python, entrez :
pip
installe le package. Toutefois, si l'environnement d'exécution est redémarré après la vérification, le package est retiré. Là encore, vous pouvez vérifier les modifications à partir de votre bloc-notes. Par exemple, pour la bibliothèque Plotly :- Dans un bloc-notes Python, entrez :
!pip install plotly
- Dans un bloc-notes R, entrez :
print(system2("pip", args="install plotly", stdout=TRUE))
- Dans un bloc-notes Python, entrez :
- Si vous pouvez obtenir un module via
conda
à partir des canaux par défaut et viapip
à partir de PyPI, la méthode préférée est viaconda
à partir des canaux par défaut. - Conda effectue une vérification des dépendances lors de l'installation de packages, qui peut s'avérer intensive en termes de mémoire si vous ajoutez de nombreux packages à la personnalisation. Veillez à sélectionner un environnement avec suffisamment de RAM pour permettre la vérification des dépendances au démarrage de l'environnement d'exécution.
- Pour éviter une vérification de dépendance inutile si vous ne souhaitez que des modules à partir d'un canal Conda, excluez les canaux par défaut en supprimant
defaults
de la liste des canaux du modèle et en ajoutantnodefaults
. - En plus du canal principal Anaconda, de nombreux modules de R peuvent être trouvés dans le canal R d'Anaconda. Dans les environnements R, ce canal fait déjà partie des canaux par défaut, d'où il n'a pas besoin d'être ajouté séparément.
- Si vous ajoutez des packages uniquement via pip ou uniquement via conda au modèle de personnalisation, vous devez vous assurer que
dependencies
n'est pas mis en commentaire dans le modèle. - Lorsque vous spécifiez une version de module, utilisez un seul module
=
pour les modulesconda
et==
pour les modulespip
. Dans la mesure du possible, spécifiez un numéro de version car cela réduit considérablement la durée d'installation et la consommation de mémoire. Si vous ne spécifiez pas de version, le gestionnaire de module peut choisir la dernière version disponible ou conserver la version disponible dans le module. - Vous ne pouvez pas ajouter d'extensions de bloc-notes arbitraires en tant que personnalisation car les extensions de bloc-notes doivent être préinstallées.
En savoir plus
Rubrique parent : Gestion des ressources de traitement