访问计算实例终端

可以使用 Azure 机器学习工作区中计算实例的终端来执行 Git 操作、安装包以及将内核添加到实例。

先决条件

  • Azure 订阅。 可以在开始之前创建 试用版
  • 一个 Azure 机器学习工作区。 有关详细信息,请参阅创建工作区资源

访问终端

若要从 Azure 机器学习工作室中的工作区访问终端,请执行以下作:

  1. 从左侧菜单中选择 笔记本

  2. 选择屏幕顶部的 终端 图标。

    显示如何打开终端窗口的屏幕截图。

  3. 如果计算实例正在运行,则会打开该实例的终端窗口。 如果未运行计算实例,请选择计算旁边的“开始”或“创建”图标以启动或创建计算实例。

    显示如何启动或创建计算实例的屏幕截图。

访问终端的其他方法

还可以通过以下方式访问计算实例终端:

  • 在 Visual Studio Code 中,从顶部菜单中选择 终端>新终端 。 有关从 Visual Studio Code 连接到工作区的详细信息,请参阅 Visual Studio Code 中远程连接到计算实例的工作
  • 在 RStudio 或 Posit Workbench 中,选择左上角的 “终端 ”选项卡。 有关详细信息,请参阅 添加自定义应用程序,例如 RStudio 或 Posit Workbench
  • 在 JupyterLab 中,选择启动器中“其他”下的“终端”磁贴。
  • 在 Jupyter 中,从顶部菜单中选择 “文件>新建>终端 ”。
  • 如果计算实例启用了安全外壳(SSH)访问,请通过 SSH 连接到该机器。 如果计算位于托管虚拟网络中,并且没有公共 IP 地址,请使用 az ml compute connect-ssh 该命令进行连接。

在终端中复制和粘贴

可以在终端和 Azure 机器学习工作室笔记本单元格之间复制和粘贴文本。 对于 Windows,请使用 Ctrl+ 复制并按 Ctrl+VCtrl+Shift+ 或 Shift+Insert 进行粘贴。 对于 macOS,请使用 Cmd+C 复制和 Cmd+V 粘贴。

访问 Git操作和文件

您可以通过终端进行所有 Git 操作。 所有 Git 文件和文件夹都存储在工作区文件系统中,以便可以从工作区中的任何计算实例使用它们。

注意事项

为了确保文件和文件夹在所有笔记本环境中可见,请在其下 ~/cloudfiles/code/Users/<your_user_name>的任何位置保存它们。

若要将 Git 与 Azure 机器学习工作区集成,请参阅 Azure 机器学习的 Git 集成

安装软件包

可以使用终端窗口将包安装到要用于笔记本的内核中。 默认内核为 python310-sdkv2.

对于 Python,可以在笔记本单元中添加和执行包安装代码。 对于 Python 笔记本中的包管理,请使用 %pip%conda magic 函数将包自动安装到当前正在运行的内核中。 请勿使用 !pip!conda,因为它们引用了所有包,包括当前正在运行的内核之外的所有包。

还可以直接在 Jupyter Notebook、RStudio 或 Posit Workbench 中安装包。 使用右下角的“ ”选项卡或左上角的 “控制台 ”选项卡。 有关详细信息,请参阅 添加自定义应用程序,例如 RStudio 或 Posit Workbench

添加新内核

可以在终端窗口中运行代码,将新内核添加到计算实例。

以下代码示例安装新的 Jupyter 内核。 可以安装任何 可用的 Jupyter 内核

  1. 运行以下命令以创建名为 newenv 的新环境。

    conda create --name newenv
    
  2. 激活该环境。

    conda activate newenv
    
  3. 安装 pipipykernel 打包并为新的 Conda 环境创建内核。

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

若要向计算实例添加新的 R 内核,请执行以下步骤:

  1. 使用终端窗口创建新环境。 以下命令创建 r_env

    conda create -n r_env r-essentials r-base
    
  2. 激活环境。

    conda activate r_env
    
  3. 在新环境中运行 R。

    R
    
  4. 在 R 提示符下,运行 IRkernel 以创建名为 irenv 的新内核。

    IRkernel::installspec(name = 'irenv', displayname = 'New R Env')
    
  5. 退出 R 会话。

    q()
    

新的 R 内核可能需要几分钟才能使用。 如果看到一条错误,指出内核无效,请等待几分钟,然后重试。

移除添加的内核

若要从计算实例中删除添加的 Jupyter 内核,必须删除 kernelspec该内核,并且可以选择删除 Conda 环境。 还可以选择保留 Conda 环境。 必须删除 kernelspec 该参数以防止内核保持可选择性并导致意外行为。

重要

自定义计算实例时,请确保不要删除未创建的 Conda 环境或 Jupyter 内核,这可能会损害 Jupyter 或 JupyterLab 功能。

若要删除 kernelspec

  1. 使用终端窗口列出并查找 kernelspec

    jupyter kernelspec list
    
  2. 删除kernelspec,然后用要删除的内核替换<UNWANTED_KERNEL>

    jupyter kernelspec uninstall <UNWANTED_KERNEL>
    

若要删除 Conda 环境,请执行以下步骤:

  1. 使用终端窗口列出并查找 Conda 环境。

    conda env list
    
  2. 删除 Conda 环境,将其 <ENV_NAME> 替换为要删除的 Conda 环境。

    conda env remove -n ENV_NAME
    

刷新时, 笔记本 视图中的内核列表应反映所做的更改。

管理终端会话

如果无法正确关闭终端选项卡,终端会话可以保持活动状态。 活动终端会话过多可能会影响计算实例的性能。 请确保关闭不再需要保留计算实例资源并优化性能的任何会话。

若要查看所有活动终端会话的列表,请选择终端工具栏最右侧的 “管理活动会话 ”图标。 关闭不再需要的任何会话。

有关如何管理计算上运行的会话的详细信息,请参阅 “管理笔记本和终端会话”。