View a markdown version of this page

在 Studio 中创建和自动装载 Amazon EFS - 亚马逊 SageMaker AI

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

在 Studio 中创建和自动装载 Amazon EFS

Amazon SageMaker AI 支持为域创建 Amazon EFS 卷并为每个用户自动挂载主目录文件夹。使用该文件夹，用户可以在自己的专用空间之间共享数据。不过，用户不能与域中的其他用户共享数据。用户只能访问自己的文件夹。

重要

对于 2026 年 6 月 1 日之后创建的域，默认情况下不会在创建域时创建 EFS（用于快速设置）。必须先启用 EFS 创建，然后才能启用自动装载。

EFS 创建和自动装载设置

Amazon SageMaker Studio 中的 EFS 涉及两个协同工作的设置：

  • HomeEFSCreation— 控制是否由 SageMaker AI 为域创建和管理 EFS 文件系统。

    通过快速设置创建的新域名的默认值：已禁用

    启用后：为该域创建由 SageMaker AI 管理的新 EFS 文件系统。

  • AutoMountHomeEFS— 控制是否为用户自动装载 EFS 存储。

    默认：启用（HomeEFSCreation启用时）

    描述： Auto-mounts 每个用户的主目录，用于在其私人空间中共享笔记本、数据和代码。

    此设置只有在启用后HomeEFSCreation才可编辑。

    在用户配置文件级别，此值默认为 DefaultAsDomain（继承域级设置）。

关键行为：

  • 如果未设置任何值AutoMountHomeEFS，则默认情况下会启用自动装载 EFS。

  • 如果您有现有空间，请重新启动该空间以挂载 EFS。

  • Auto-mount EFS 仅适用于私有空间。

启用 EFS 创建和自动装载

创建域名后（快速设置）：

  1. 打开 A SageMaker I 控制台。

  2. 在左侧导航窗格的管理员配置下，选择域。

  3. 选择您的域名，然后选择域名设置选项卡。

  4. 在存储配置部分，选择编辑。

  5. 在 EFS 存储和加密下，切换HomeEFSCreation到开启。这将为该域创建由 SageMaker AI 管理的新 EFS 文件系统。

  6. 确保AutoMountHomeEFS已开启（开启时默认为启HomeEFSCreation用）。这会自动为每个用户挂载一个主目录，以便在他们的私人空间中共享笔记本、数据和代码。

  7. 选择提交。

  8. 如果您有现有空间，请重启这些空间以访问 EFS 数据。

对于自定义设置，默认情况下启用 EFS 创建和自动挂载。

用户文件夹可通过名为 user-default-efs 的文件夹访问。该文件夹位于 Studio 应用程序的 $HOME 目录中。

有关退出 Amazon EFS 自动挂载的信息，请参阅 选择退出 Amazon EFS 自动挂载。

Amazon EFS 自动挂载还有助于将数据从 Studio Classic 迁移到 Studio。有关更多信息，请参阅 （可选）将数据从 Studio Classic 迁移到 Studio。

接入点信息

激活自动挂载后， SageMaker AI 会使用 Amazon EFS 接入点来方便访问 Amazon EFS 卷中的数据。有关接入点的更多信息，请参阅使用 Amazon EFS 接入点 SageMaker Amazon EFS 接入点 AI 在创建用户配置文件期间或在为现有用户配置文件创建应用程序期间，为域中的每个用户配置文件创建唯一的访问点。接入点的 POSIX 用户值与 SageMaker AI 为其创建接入点的用户配置文件的HomeEfsFileSystemUid值相匹配。要获取用户的价值，请参阅DescribeUserProfile。根目录路径也被设置为与 POSIX 用户值相同的值。 

SageMaker AI 将新目录的权限设置为以下值：

  • 所有者用户 ID：POSIX user value

  • 所有者组 ID：0

  • 权限 700

访问 Amazon EFS 卷需要接入点。因此，删除或更新接入点会导致 Amazon EFS 卷无法访问。

错误解决

如果 SageMaker AI 在创建应用程序期间自动挂载 Amazon EFS 用户文件夹时遇到问题，则仍会创建应用程序。但是，在本例中， SageMaker AI 会创建一个名为的文件，error.txt而不是挂载 Amazon EFS 文件夹。此文件描述了遇到的错误以及解决该错误的步骤。 SageMaker AI 在应用程序$HOME目录下的user-default-efs文件夹中创建该error.txt文件。