AI Workbench 挂载#

您可以为您AI Workbench 项目所需的外部数据定义挂载。

除了每个挂载在容器内的目标路径之外,您还可以传递以逗号分隔的挂载选项列表。每个挂载目标都必须是以正斜杠 (/) 开头的绝对路径,并且在容器内是唯一的。

如果在项目容器运行时创建了新的挂载,您必须重启项目容器才能使更改生效。

注意

在项目容器运行时,可能无法删除挂载

挂载类型#

可以定义四种类型的挂载:projecthostvolumetemp

项目 (Project)

此挂载类型定义了项目仓库目录在项目容器内的挂载位置。当创建 AI Workbench 项目时,默认会添加项目挂载类型,其中 /project/ 作为项目目录在容器内的目标路径。在一个项目中只能有一个项目挂载类型。

主机 (Host)

此挂载类型允许用户将主机上的目录挂载到项目容器中。

注意

主机挂载类型的目标目录必须存在于项目容器中。这是为了避免权限/所有权错误,因为如果目录不存在,Docker 可能会将目录创建为 root 拥有。有关更多详细信息,请参见下文。

卷 (Volume)

此挂载类型创建一个持久卷,用于存储在项目容器停止或重建时不会擦除的数据。但是,删除挂载或项目也会导致持久卷被删除。对于命名卷挂载,卷名称应作为挂载选项传递,例如 volumeName=abc

临时 (Temp)

此挂载类型在项目容器中创建一个临时文件,该文件在每次容器启动时都会重置。

桌面 (Desktop)#

创建挂载

  • 打开 AI Workbench 窗口并选择位置

  • 选择现有项目

  • 选择左侧的 Environment 选项卡

  • 导航到 Mounts 部分,然后单击添加按钮

  • 填写表格,然后单击添加按钮以创建挂载

删除挂载

  • 打开 AI Workbench 窗口并选择位置

  • 选择现有项目

  • 选择左侧的 Environment 选项卡

  • 导航到 Mounts 部分,然后单击 3 个点并选择 删除主机/卷/临时挂载

  • 单击删除以删除挂载

CLI#

注意

通过 CLI 创建挂载仅创建其定义。挂载必须通过运行 nvwb configure mounts 进行配置后才能使用。

创建挂载

  • 打开终端并激活所需上下文(位置)

  • 运行 nvwb open 以打开现有项目

  • 运行 nvwb create mount

  • 选择挂载类型

  • 输入挂载的目标目录

  • 输入可选描述

  • 输入挂载选项(如果有)

  • 运行 nvwb configure mounts。选择要配置的挂载。输入 主机 类型挂载的挂载源。

删除挂载

  • 打开终端并激活所需上下文(位置)

  • 运行 nvwb open 以打开现有项目

  • 运行 nvwb delete mount

  • 选择要删除的挂载。系统不会提示您确认

主机挂载注意事项#

在 macOS、Windows 和 Linux 上,Podman 和 Docker 对主机挂载的处理方式存在一些差异。为了确保您的主机挂载始终按预期工作,请始终确保在创建主机挂载之前,目标目录已存在于项目容器中。

最简单的方法是使用 postInstall.bash 脚本并添加类似如下内容

1sudo mkdir -p /mnt/my-host-mount
2sudo chmod workbench:workbench /mnt/my-host-mount

如果您使用的容器使用的用户不是 workbench,您可能需要调整此命令。

下一步#