View a markdown version of this page

Creación y montaje automático de Amazon EFS en Studio - Amazon SageMaker AI

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Creación y montaje automático de Amazon EFS en Studio

Amazon SageMaker AI admite la creación de un volumen de Amazon EFS para un dominio y el montaje automático de una carpeta de directorio principal para cada usuario. Con esta carpeta, los usuarios pueden compartir datos entre sus propios espacios privados. Sin embargo, los usuarios no pueden compartir datos con otros usuarios del dominio. Los usuarios solo tienen acceso a su propia carpeta.

importante

Para los dominios creados después del 1 de junio de 2026, EFS no se crea de forma predeterminada durante la creación del dominio (para una configuración rápida). Debe habilitar la creación de EFS antes de poder habilitar el montaje automático.

Configuración de creación y montaje automático de EFS

EFS en Amazon SageMaker Studio incluye dos configuraciones que funcionan juntas:

  • HomeEFSCreation— Controla si SageMaker AI crea y administra un sistema de archivos EFS para el dominio.

    Predeterminado para los nuevos dominios creados mediante una configuración rápida: desactivado

    Cuando está activado: crea un nuevo sistema de archivos EFS gestionado por SageMaker IA para este dominio.

  • AutoMountHomeEFS— Controla si el almacenamiento EFS se monta automáticamente para los usuarios.

    Predeterminado: activado (cuando HomeEFSCreation está activado)

    Descripción: Auto-mounts un directorio principal para que cada usuario comparta libretas, datos y códigos en sus espacios privados.

    Esta configuración solo se puede editar cuando HomeEFSCreation está habilitada.

    En el nivel del perfil de usuario, este valor predeterminado es DefaultAsDomain(hereda la configuración a nivel de dominio).

Comportamientos clave:

  • Si no se establece ningún valorAutoMountHomeEFS, el montaje automático de EFS está activado de forma predeterminada.

  • Si ya tiene un espacio, reinícielo para montar EFS.

  • Auto-mount EFS solo está disponible para espacios privados.

Habilite la creación y el montaje automático de EFS

Tras la creación del dominio (configuración rápida):

  1. Abre la consola de SageMaker IA.

  2. En el panel de navegación izquierdo, en Configuraciones de administración, selecciona Dominios.

  3. Selecciona tu dominio y, a continuación, selecciona la pestaña Configuración del dominio.

  4. En la sección de configuraciones de almacenamiento, selecciona Editar.

  5. En Almacenamiento y cifrado EFS, activeHomeEFSCreation. Esto crea un nuevo sistema de archivos EFS administrado por SageMaker AI para este dominio.

  6. Asegúrese de que AutoMountHomeEFS esté activado (activado de forma predeterminada cuando HomeEFSCreation está activado). Esto monta automáticamente un directorio principal para que cada usuario comparta libretas, datos y código en sus espacios privados.

  7. Seleccione Enviar.

  8. Si ya tiene espacios, reinícielo para acceder a los datos de EFS.

Para una configuración personalizada, la creación y el montaje automático de EFS están habilitados de forma predeterminada.

Se puede acceder a la carpeta del usuario a través de una carpeta denominada user-default-efs. Esta carpeta está presente en el directorio $HOME de la aplicación de Studio.

Para obtener información sobre cómo dar de baja el montaje automático de Amazon EFS, consulte Exclusión del montaje automático de Amazon EFS.

El montaje automático de Amazon EFS también facilita la migración de datos de Studio Classic a Studio. Para obtener más información, consulte (Opcional) Migración de datos de Studio Classic a Studio.

Información sobre puntos de acceso

Cuando se activa el montaje automático, la SageMaker IA utiliza un punto de acceso de Amazon EFS para facilitar el acceso a los datos del volumen de Amazon EFS. Para obtener más información sobre los puntos de acceso, consulte Trabajar con puntos de acceso de Amazon EFS La SageMaker IA crea un punto de acceso único para cada perfil de usuario del dominio durante la creación del perfil de usuario o durante la creación de la aplicación para un perfil de usuario existente. El valor de usuario POSIX del punto de acceso coincide con el HomeEfsFileSystemUid valor del perfil de usuario para el que SageMaker AI crea el punto de acceso. Para obtener el valor del usuario, consulte DescribeUserProfile. La ruta del directorio raíz también se establece en el mismo valor que el valor del usuario de POSIX. 

SageMaker AI establece los permisos del nuevo directorio en los siguientes valores:

  • ID de usuario del propietario: POSIX user value

  • ID de grupo del propietario: 0

  • Permisos: 700

El punto de acceso es necesario para acceder al volumen de Amazon EFS. A consecuencia de ello, no puede eliminar ni actualizar el punto de acceso sin perder el acceso al volumen de Amazon EFS.

Resolución de errores

Si SageMaker AI encuentra un problema al montar automáticamente la carpeta de usuario de Amazon EFS durante la creación de la aplicación, la aplicación seguirá creándose. Sin embargo, en este caso, SageMaker AI crea un archivo denominado error.txt en lugar de montar la carpeta Amazon EFS. Este archivo describe el error detectado, así como los pasos para resolverlo. SageMaker AI crea el error.txt archivo en la user-default-efs carpeta ubicada en el $HOME directorio de la aplicación.