Partager via


Accès à un terminal d’instance de calcul dans votre espace de travail

Accédez au terminal d’une instance de calcul dans votre espace de travail pour :

  • Utiliser des fichiers de Git et contrôler la version des fichiers. Ces fichiers sont stockés dans le système de fichiers de votre espace de travail, et ne sont pas limités à une seule instance de calcul.
  • Installer des packages sur l’instance de calcul.
  • Créer des noyaux supplémentaires sur l’instance de calcul.

Prérequis

Accéder à un terminal

Pour accéder au terminal :

  1. Dans Azure Machine Learning Studio, ouvrez votre espace de travail.

  2. Sur le côté gauche, sélectionnez Bloc-notes.

  3. Sélectionnez l’image Ouvrir le terminal.

    Ouvrir la fenêtre de terminal

  4. Quand une instance de calcul est en cours d’exécution, la fenêtre de terminal pour cette instance de calcul s’affiche.

  5. Si aucune instance de calcul n’est en cours d’exécution, utilisez la section Calcul pour démarrer ou créer une instance de calcul. Démarrer ou créer une instance de calcul

Outre les étapes précédentes, vous pouvez également accéder au terminal à partir de :

  • Dans VS Code : sélectionnez Terminal > Nouveau terminal dans le menu. L’entrée peut être masquée derrière ... dans le menu. Pour en savoir plus sur la connexion à votre espace de travail à partir de VS Code, consultez Travailler dans VS Code connecté à distance à une instance de calcul.
  • RStudio ou Posit Workbench (anciennement RStudio Workbench) (voir Ajouter des applications personnalisées, comme RStudio ou Posit Workbench) : sélectionnez l’onglet Terminal en haut à gauche.
  • Jupyter Lab : Sélectionnez la vignette Terminal sous le titre Autre de l’onglet Launcher.
  • Jupyter : Sélectionnez Nouveau>Terminal en haut à droite dans l’onglet Fichiers.
  • Connectez-vous en mode SSH à la machine, si vous avez activé l’accès SSH lors de la création de l’instance de calcul. Si l’instance de calcul se trouve dans un réseau virtuel managé et n’a pas d’adresse IP publique, utilisez la commande az ml compute connect-ssh pour vous connecter à l’instance de calcul.

Opérations Copier et Coller dans le terminal

Dans la section Notebooks, vous pouvez copier et coller du texte entre le terminal et les cellules du notebook.

  • Windows : Ctrl-c pour copier et Ctrl-v ou Ctrl-Shift-v ou Shift-Insert pour coller.
  • Mac OS : Cmd-c pour copier et Cmd-v pour coller.
  • Firefox et Internet Explorer peuvent ne pas prendre en charge correctement les autorisations de Presse-papiers.

Utiliser des fichiers de Git et contrôler la version des fichiers

Accédez à toutes les opérations Git à partir du terminal. Tous les fichiers et dossiers Git sont stockés dans le système de fichiers de votre espace de travail. Ce stockage vous permet d’utiliser ces fichiers à partir de n’importe quelle instance de calcul dans votre espace de travail.

Notes

Ajoutez vos fichiers et dossiers n’importe où dans le dossier ~/cloudfiles/code/Users afin qu’ils soient visibles dans tous vos environnements Jupyter.

Pour intégrer Git à votre espace de travail Azure Machine Learning, consultez Intégration de Git pour Azure Machine Learning.

Installer des packages

Installez des packages à partir d’une fenêtre de terminal. Installez des packages dans le noyau que vous souhaitez utiliser pour exécuter vos notebooks. Le noyau par défaut est python310-sdkv2.

Vous pouvez également installer des packages directement dans Jupyter Notebook, RStudio ou Posit Workbench (anciennement RStudio Workbench) :

Remarque

Pour la gestion des packages dans un notebook Python, utilisez %pip ou %conda fonctions magiques pour installer automatiquement des packages dans le noyau en cours d’exécution, plutôt que !pip ou !conda qui fait référence à tous les packages (y compris les packages en dehors du noyau en cours d’exécution)

Ajouter de nouveaux noyaux

Avertissement

Lors de la personnalisation de l’instance de calcul, veillez à ne pas supprimer les environnements conda ou les noyaux jupyter que vous n’avez pas créés. Cela peut endommager la fonctionnalité Jupyter/JupyterLab.

Pour ajouter un nouveau noyau Jupyter à l’instance de calcul :

  1. Utilisez la fenêtre de terminal pour créer un environnement. Par exemple, la commande suivante crée newenv :

    conda create --name newenv
    
  2. Active l’environnement. Par exemple, après la création de newenv :

    conda activate newenv
    
  3. Installer pip et le package ipykernel dans le nouvel environnement et créer un noyau pour ce conda env

    conda install pip
    conda install ipykernel
    python -m ipykernel install --user --name newenv --display-name "Python (newenv)"
    

Vous pouvez installer n’importe lequel des noyaux Jupyter disponibles.

Pour ajouter un nouveau noyau R à l’instance de calcul :

  1. Utilisez la fenêtre de terminal pour créer un environnement. Par exemple, la commande suivante crée r_env :

    conda create -n r_env r-essentials r-base
    
  2. Active l’environnement. Par exemple, après la création de r_env :

    conda activate r_env
    
  3. Exécutez R dans le nouvel environnement :

    R
    
  4. À l’invite R, exécutez IRkernel :

    IRkernel::installspec(name = 'irenv', displayname = 'New R Env')
    
  5. Quittez la session R.

    q()
    

La préparation à l’utilisation du nouveau noyau R prendra quelques minutes. Si vous recevez une erreur indiquant qu’il n’est pas valide, patientez, puis réessayez.

Si vous souhaitez obtenir plus d’informations sur Conda, consultez Utilisation du langage R avec Anaconda. Si vous souhaitez obtenir plus d’informations sur IRkernel, consultez Noyau R natif pour Jupyter.

Supprimer les noyaux ajoutés

Avertissement

Lors de la personnalisation de l’instance de calcul, veillez à ne pas supprimer les environnements conda ou les noyaux jupyter que vous n’avez pas créés.

Pour supprimer un noyau Jupyter ajouté depuis l’instance de calcul, vous devez supprimer la spécification du noyau et (éventuellement) l’environnement conda. Vous pouvez également choisir de conserver l’environnement conda. Vous devez supprimer le kernelspec ; sinon, votre noyau peut toujours être sélectionné et provoquer un comportement inattendu.

Pour supprimer la spécification du noyau :

  1. Utilisez la fenêtre de terminal pour répertorier et rechercher la spécification du noyau :

    jupyter kernelspec list
    
  2. Supprimez la spécification du noyau, en remplaçant UNWANTED_KERNEL par le noyau que vous souhaitez supprimer :

    jupyter kernelspec uninstall UNWANTED_KERNEL
    

Pour également supprimer l’environnement conda :

  1. Utilisez la fenêtre de terminal pour répertorier et rechercher l’environnement conda :

    conda env list
    
  2. Supprimez l’environnement conda, en remplaçant ENV_NAME par l’environnement conda que vous souhaitez supprimer :

    conda env remove -n ENV_NAME
    

Lors de l’actualisation, la liste des noyaux dans la vue de vos notebooks doit refléter les modifications que vous avez apportées.

Gérer les sessions de terminal

Les sessions de terminal peuvent rester actives si les onglets de terminal ne sont pas fermés correctement. Un trop grand nombre de sessions de terminal actives peut affecter les performances de votre instance de calcul.

Sélectionnez Gérer les sessions actives dans la barre d’outils du terminal pour afficher la liste de l’ensemble des sessions de terminal actives et arrêter celles dont vous n’avez plus besoin.

Pour plus d’informations sur la gestion des sessions s’exécutant sur votre instance de calcul, consultez Gestion des sessions de notebook et de terminal.

Avertissement

Veillez à fermer toutes les sessions dont vous n’avez plus besoin pour préserver les ressources de votre instance de calcul et optimiser vos performances.