Adjuntar un sistema de archivos personalizado a un dominio o perfil de usuario - Amazon SageMaker
Requisitos previosAdjuntar con el AWS CLI

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.

Adjuntar un sistema de archivos personalizado a un dominio o perfil de usuario

Cuando creas un dominio, Amazon lo asocia SageMaker automáticamente a un volumen Amazon Elastic File System (de AmazonEFS) que SageMaker crea para ti. También tienes la opción de asociar el dominio a un sistema de EFS archivos de Amazon personalizado que hayas creado en tu Cuenta de AWS. Este sistema de archivos está disponible para todos los usuarios que pertenezcan al dominio cuando utilicen Amazon SageMaker Studio. Los usuarios pueden adjuntar el sistema de archivos a cualquier espacio que creen para las aplicaciones compatibles: JupyterLab y al editor de código. A continuación, tras ejecutar el espacio e iniciar la aplicación, pueden acceder a cualquier dato, código u otro elemento que contenga el sistema de archivos.

Si no desea permitir que todos los usuarios de un dominio accedan al sistema de archivos, puede adjuntarlo a un perfil de usuario específico. Si lo hace, el sistema de archivos solo estará disponible en los espacios que cree el usuario asociado.

Puede adjuntar un sistema de archivos personalizado utilizando Amazon SageMaker API AWS SDKs, el o el AWS CLI. No puede adjuntar un sistema de archivos personalizado mediante la SageMaker consola.

Requisitos previos

Para poder adjuntar un sistema de EFS archivos de Amazon personalizado a un dominio, debes cumplir los siguientes requisitos:

  • Tienes un sistema de EFS archivos de Amazon en tu Cuenta de AWS. Para conocer los pasos necesarios para crear uno, consulte Create your Amazon EFS file system en la Guía del usuario de Amazon Elastic File System.

  • Para que Studio pueda acceder a tu sistema de archivos, debe tener un destino de montaje en cada una de las subredes que asocies al dominio. Para obtener más información sobre la asignación de destinos de montaje a subredes, consulte Creación y administración de objetivos de montaje y grupos de seguridad en la Guía del usuario de Amazon Elastic File System.

  • Para cada destino de montaje, debes añadir el grupo de seguridad que Amazon SageMaker creó en ti Cuenta de AWS cuando creaste el dominio. El nombre del grupo de seguridad tiene el formatosecurity-group-for-inbound-nfs-domain-id.

  • Sus IAM permisos deben permitirle usar la elasticfilesystem:DescribeMountTargets acción. Para obtener más información sobre esta acción, consulte Acciones, recursos y claves de condición de Amazon Elastic File System en la Referencia de autorización de servicios.

Adjuntar un sistema de archivos personalizado con el AWS CLI

Para adjuntar un sistema de archivos personalizado a un dominio o perfil de usuario con el AWS CLI, se pasa una CustomFileSystemConfigs definición al utilizar cualquiera de los siguientes comandos:

ejemplo comando create-domain con un sistema de archivos personalizado

En el siguiente ejemplo, se adjunta un sistema de archivos a un dominio nuevo.

aws sagemaker create-domain --domain-name domain-name \
--vpc-id vpc-id --subnet-ids subnet-ids --auth-mode IAM \
--default-user-settings file://default-user-settings.json \
--default-space-settings "ExecutionRole=execution-role-arn"

En este ejemplo, el archivo default-user-settings.json tiene la siguiente configuración, que incluye las CustomFileSystemConfigs claves CustomPosixUserConfig y.

{
    "ExecutionRole": "execution-role-arn",
    "CustomPosixUserConfig":
    {
        "Uid": UID,
        "Gid": GID
    },
    "CustomFileSystemConfigs":
    [
        {
            "EFSFileSystemConfig":
            {
                "FileSystemId": "file-system-id",
                "FileSystemPath": "/"
            }
        }
    ]
}

Este ejemplo de configuración tiene las siguientes claves:

ExecutionRole

La función de ejecución predeterminada para los usuarios del dominio.

CustomPosixUserConfig

Las POSIX identidades predeterminadas que se utilizan para las operaciones del sistema de archivos. Puede utilizar esta configuración para aplicar la estructura de POSIX permisos existente a los perfiles de usuario que acceden al sistema de archivos personalizado. A nivel de POSIX permisos, puede controlar qué usuarios pueden acceder al sistema de archivos y a qué archivos o datos pueden acceder.

También puede aplicar CustomPosixUserConfig la configuración al crear un perfil de usuario mediante el create-user-profile comando. La configuración que se aplica a un perfil de usuario anula la que se aplica al dominio asociado.

nota

Puede aplicar CustomPosixUserConfig la configuración cuando utiliza los create-user-profile comandos create-domain y. Sin embargo, no puede aplicar esta configuración si hace lo siguiente:

  • Utilice el update-domain comando para un dominio que ya esté asociado a algún perfil de usuario. Puede aplicar esta configuración solo a los dominios que no tienen perfiles de usuario.

  • Utilice el comando update-user-profile. Para aplicar esta configuración a un perfil que ya ha creado, elimine el perfil y cree uno nuevo que tenga la configuración actualizada.

Uid

El POSIX seudónimo. El valor predeterminado es 200001.

Gid

El ID POSIX del grupo. El valor predeterminado es 1001.

CustomFileSystemConfigs

Configuración para sistemas de archivos personalizados (solo se admiten los sistemas de EFS archivos de Amazon).

También puede aplicar la CustomFileSystemConfigs configuración a un perfil de usuario cuando utiliza los update-user-profile comandos create-user-profile o. El perfil de usuario tendrá acceso a esos sistemas de archivos, así como a todos los que adjunte a su dominio.

EFSFileSystemConfig

Configuración de los sistemas de EFS archivos personalizados de Amazon.

FileSystemId

El ID de tu sistema de EFS archivos de Amazon.

FileSystemPath

La ruta al directorio del sistema de archivos al que pueden acceder los usuarios del dominio en sus espacios de Studio. Los usuarios autorizados solo pueden acceder a este directorio y a los siguientes. La ruta predeterminada es la raíz del sistema de archivos:/.

SageMaker crea un enlace simbólico en la siguiente ruta:/home/sagemaker-user/custom-file-systems/file-system-type/file-system-id. Con esto, los usuarios del dominio pueden navegar hasta el sistema de archivos personalizado desde su directorio principal,/home/sagemaker-user.

Tras adjuntar un sistema de archivos personalizado a un dominio, los usuarios del dominio pueden adjuntar el sistema de archivos a un espacio mediante el comando create-space.

ejemplo comando create-space con un sistema de archivos personalizado

En el siguiente ejemplo, se adjunta un sistema de archivos a un espacio nuevo.

aws sagemaker create-space \
--space-name space-name \
--domain-id domain-id \
--ownership-settings "OwnerUserProfileName=user-profile-name" \
--space-sharing-settings "SharingType=Private" \
--space-settings file://space-settings.json

En este ejemplo, el archivo space-settings.json tiene los siguientes parámetros, que incluyen la CustomFileSystems configuración con la FileSystemId clave.

{
    "AppType": "JupyterLab",
    "JupyterLabAppSettings":
    {
        "DefaultResourceSpec":
        {
            "InstanceType": "ml.t3.xlarge"
        }
    },
    "CustomFileSystems":
    [
        {
            "EFSFileSystem":
            {
                "FileSystemId": "file-system-id"
            }
        }
    ]
}