Asociación de la imagen de SageMaker a un dominio Asociación de la imagen de SageMaker a un espacio compartido Visualización de la imagen asociada

Asociación de una imagen de SageMaker personalizada en Amazon SageMaker Studio Classic

importante

Las políticas de IAM personalizadas que permiten a Amazon SageMaker Studio o Amazon SageMaker Studio Classic crear recursos de Amazon SageMaker también deben conceder permisos para añadir etiquetas a dichos recursos. El permiso para añadir etiquetas a los recursos es necesario porque Studio y Studio Classic etiquetan automáticamente todos los recursos que crean. Si una política de IAM permite a Studio y Studio Classic crear recursos, pero no permite el etiquetado, se pueden producir errores AccessDenied al intentar crear recursos. Para obtener más información, consulte Concesión de permisos para etiquetar recursos de SageMaker AI.

Las Políticas administradas por AWS para Amazon SageMaker AI que conceden permisos para crear recursos de SageMaker ya incluyen permisos para añadir etiquetas al crear esos recursos.

importante

A partir del 30 de noviembre de 2023, la experiencia anterior de Amazon SageMaker Studio pasa a denominarse Amazon SageMaker Studio Classic. La siguiente sección es específica del uso de la aplicación de Studio Classic. Para obtener información sobre el uso de la experiencia de Studio actualizada, consulte Amazon SageMaker Studio.

Para utilizar una imagen de SageMaker personalizada, debe asociar una versión de la imagen a su dominio o espacio compartido. Al asociar una versión de imagen, aparece en el lanzador de SageMaker Studio Classic y está disponible en la lista desplegable Seleccionar imagen, que los usuarios utilizan para inicializar una actividad o cambiar la imagen utilizada por un cuaderno.

Para que una imagen de SageMaker personalizada esté disponible para todos los usuarios de un dominio, debe asociar la imagen al dominio. Para que una imagen esté disponible para todos los usuarios de un espacio compartido, puede asociarla al espacio compartido. Para que una imagen esté disponible para un solo usuario, asocie la imagen al perfil del usuario. Al asociar una imagen, SageMaker AI utiliza la versión más reciente de la imagen de forma predeterminada. También puede asociar una versión de imagen específica. Tras asociar la versión, puede seleccionarla en el lanzador de SageMaker AI o en el selector de imágenes al iniciar un cuaderno.

Existe un límite en el número de versiones de imágenes que se pueden asociar en cualquier momento. Una vez alcanzado el límite, debe desasociar una versión para asociar otra versión de la imagen.

En las siguientes secciones se muestra cómo asociar una imagen de SageMaker personalizada a su dominio mediante la consola de SageMaker AI o la AWS CLI. Solo puede asociar una imagen personalizada a un espacio compartido mediante la AWS CLI.

Asociación de la imagen de SageMaker a un dominio

Asociación de la imagen de SageMaker mediante la consola

En este tema se describe cómo asociar una versión de imagen personalizada existente de SageMaker a su dominio desde el panel de control de SageMaker AI. También puede crear una imagen y una versión de imagen de SageMaker personalizadas y, a continuación, asociar esa versión a su dominio. Para obtener información sobre el procedimiento para crear una imagen y una versión de imagen, consulte Creación de una imagen de SageMaker personalizada en Amazon SageMaker Studio Classic.

Para asociar una imagen existente

Abra la consola de Amazon SageMaker AI en https://console.aws.amazon.com/sagemaker/.
En el panel de navegación izquierdo, seleccione Configuraciones de administración.
En Configuraciones de administración, elija Dominios.
En la página Dominios, seleccione el dominio al que quiera asociar la imagen.
En la página Detalles del dominio, seleccione la pestaña Entorno.
En la pestaña Entorno, bajo Imágenes personalizadas de SageMaker Studio Classic asociadas al dominio, seleccione Asociar imagen.
Para Fuente de imagen, seleccione Imagen existente.
Elija en la lista una imagen existente.
Elija una versión de la imagen en la lista.
Elija Siguiente.
Compruebe los valores para Nombre de la imagen, Nombre para mostrar de la imagen y Descripción.
Elija el rol de IAM. Para obtener más información, consulte Creación de una imagen de SageMaker personalizada en Amazon SageMaker Studio Classic.
(Opcional) Agregar etiquetas para la imagen.
Especifique la ruta de montaje de EFS. Esta es la ruta dentro de la imagen para montar el directorio principal de Amazon Elastic File System (EFS) del usuario.
En Tipo de imagen, seleccione Imagen de SageMaker Studio
Para Nombre del kernel, introduzca el nombre de un kernel existente en la imagen. Para obtener información sobre cómo obtener la información del kernel de la imagen, consulte DEVELOPMENT en el repositorio de muestras de imágenes personalizadas de SageMaker Studio Classic. Para obtener más información, consulte las secciones Descubrimiento de kernel y Datos de usuario de Especificaciones de imágenes de SageMaker personalizadas para Amazon SageMaker Studio Classic.
(Opcional) Para Nombre de visualización del kernel, introduzca el nombre para mostrar del kernel.
Seleccione Añadir kernel.
Elija Enviar.
1. Espere a que la versión de la imagen se asocie al dominio. Cuando se asocia, la versión se muestra en la lista Imágenes personalizadas y aparece resaltada brevemente.

Asociar la imagen de SageMaker mediante la AWS CLI

En las siguientes secciones se muestra cómo asociar una imagen de SageMaker personalizada al crear un dominio nuevo o actualizar el dominio existente mediante la AWS CLI.

Asociar la imagen de SageMaker a un nuevo dominio

En la siguiente sección se muestra cómo crear un nuevo dominio con la versión asociada. Estos pasos requieren que especifique la información y el rol de ejecución de Amazon Virtual Private Cloud (VPC) necesarios para crear el dominio. Lleve a cabo los siguientes pasos para crear el dominio y asociar la imagen personalizada de SageMaker:

Obtenga su ID de VPC predeterminado y los ID de subred.
Cree el archivo de configuración para el dominio, que especifica la imagen.
Creación del dominio con el archivo de configuración.

Para añadir la imagen personalizada de SageMaker al dominio

Obtenga su ID de VPC predeterminado.


aws ec2 describe-vpcs \
    --filters Name=isDefault,Values=true \
    --query "Vpcs[0].VpcId" --output text

El resultado debería ser similar al siguiente.


vpc-xxxxxxxx

Obtenga sus ID de subred predeterminados mediante el ID de VPC del paso anterior.


aws ec2 describe-subnets \
    --filters Name=vpc-id,Values=<vpc-id> \
    --query "Subnets[*].SubnetId" --output json

El resultado debería ser similar al siguiente.


[
    "subnet-b55171dd",
    "subnet-8a5f99c6",
    "subnet-e88d1392"
]

Cree un archivo de configuración llamado create-domain-input.json. Inserte el ID de VPC, los ID de subred, ImageName y AppImageConfigName desde los pasos anteriores. Dado que no se especifica ImageVersionNumber, se utiliza la versión más reciente de la imagen, que es la única versión en este caso.


{
    "DomainName": "domain-with-custom-image",
    "VpcId": "<vpc-id>",
    "SubnetIds": [
        "<subnet-ids>"
    ],
    "DefaultUserSettings": {
        "ExecutionRole": "<execution-role>",
        "KernelGatewayAppSettings": {
            "CustomImages": [
                {
                    "ImageName": "custom-image",
                    "AppImageConfigName": "custom-image-config"
                }
            ]
        }
    },
    "AuthMode": "IAM"
}

Cree el dominio con la imagen de SageMaker personalizada asociada.


aws sagemaker create-domain \
    --cli-input-json file://create-domain-input.json

El resultado debería ser similar al siguiente.


{
    "DomainArn": "arn:aws:sagemaker:us-east-2:acct-id:domain/d-xxxxxxxxxxxx",
    "Url": "https://d-xxxxxxxxxxxx.studio.us-east-2.sagemaker.aws/..."
}

Asociación de la imagen de SageMaker al dominio actual

Si se ha incorporado a un dominio de SageMaker AI, puede asociar la imagen personalizada a su dominio actual. Para obtener más información sobre la incorporación a un dominio de SageMaker AI, consulte Descripción general del dominio de Amazon SageMaker AI. No tiene que especificar la información de VPC y el rol de ejecución al asociar una imagen personalizada a su dominio actual. Después de asociar la versión, debe eliminar todas las aplicaciones de su dominio y volver a abrir Studio Classic. Para obtener información acerca de cómo eliminar un volumen, consulte Eliminación de un dominio de Amazon SageMaker AI.

Lleve a cabo los siguientes pasos para agregar la imagen de SageMaker al dominio actual.

Obtenga su DomainID en el panel de control de SageMaker AI.
Utilice el DomainID para obtener el DefaultUserSettings para el dominio.
Agregue el ImageName y la AppImageConfig como una CustomImage a la DefaultUserSettings.
Actualice el dominio para incluir la imagen personalizada.

Para añadir la imagen personalizada de SageMaker al dominio

Abra la consola de Amazon SageMaker AI en https://console.aws.amazon.com/sagemaker/.
En el panel de navegación izquierdo, seleccione Configuraciones de administración.
En Configuraciones de administración, elija Dominios.
En la página Dominios, seleccione el dominio al que quiera asociar la imagen.
En la página de Detalles del dominio, seleccione la pestaña Configuración del dominio.
En la pestaña Configuración del dominio, en Configuración general, busque el DomainId. El ID tendrá el siguiente formato: d-xxxxxxxxxxxx.

Utilice el ID de dominio para obtener la descripción del dominio.


aws sagemaker describe-domain \
    --domain-id <d-xxxxxxxxxxxx>

El resultado debería ser similar al siguiente.


{
    "DomainId": "d-xxxxxxxxxxxx",
    "DefaultUserSettings": {
      "KernelGatewayAppSettings": {
        "CustomImages": [
        ],
        ...
      }
    }
}

Guarde la sección de configuración de usuario predeterminada de la respuesta en un archivo denominado default-user-settings.json.

Inserte el ImageName y la AppImageConfigName de los pasos anteriores como imagen personalizada. Dado que no se especifica ImageVersionNumber, se utiliza la versión más reciente de la imagen, que es la única versión en este caso.


{
    "DefaultUserSettings": {
        "KernelGatewayAppSettings": { 
           "CustomImages": [ 
              { 
                 "ImageName": "string",
                 "AppImageConfigName": "string"
              }
           ],
           ...
        }
    }
}

Utilice el ID de dominio y el archivo de configuración de usuario predeterminado para actualizar el dominio.


aws sagemaker update-domain \
    --domain-id <d-xxxxxxxxxxxx> \
    --cli-input-json file://default-user-settings.json

El resultado debería ser similar al siguiente.


{
    "DomainArn": "arn:aws:sagemaker:us-east-2:acct-id:domain/d-xxxxxxxxxxxx"
}

Asociación de la imagen de SageMaker a un espacio compartido

Solo puede asociar la imagen de SageMaker a un espacio compartido mediante la AWS CLI. Después de asociar la versión, debe eliminar todas las aplicaciones de su espacio compartido y volver a abrir Studio Classic. Para obtener información acerca de cómo eliminar un volumen, consulte Eliminación de un dominio de Amazon SageMaker AI.

Lleve a cabo los siguientes pasos para agregar la imagen de SageMaker a un espacio compartido.

Obtenga su DomainID en el panel de control de SageMaker AI.
Utilice el DomainID para obtener el DefaultSpaceSettings para el dominio.
Agregue el ImageName y la AppImageConfig como una CustomImage a la DefaultSpaceSettings.
Actualice su dominio para incluir la imagen personalizada para el espacio compartido.

Para añadir la imagen personalizada de SageMaker a su espacio compartido

Abra la consola de Amazon SageMaker AI en https://console.aws.amazon.com/sagemaker/.
En el panel de navegación izquierdo, seleccione Configuraciones de administración.
En Configuraciones de administración, elija Dominios.
En la página Dominios, seleccione el dominio al que quiera asociar la imagen.
En la página de Detalles del dominio, seleccione la pestaña Configuración del dominio.
En la pestaña Configuración del dominio, en Configuración general, busque el DomainId. El ID tendrá el siguiente formato: d-xxxxxxxxxxxx.

Utilice el ID de dominio para obtener la descripción del dominio.


aws sagemaker describe-domain \
    --domain-id <d-xxxxxxxxxxxx>

El resultado debería ser similar al siguiente.


{
    "DomainId": "d-xxxxxxxxxxxx",
    ...
    "DefaultSpaceSettings": {
      "KernelGatewayAppSettings": {
        "CustomImages": [
        ],
        ...
      }
    }
}

Guarde la sección de configuración de espacio predeterminada de la respuesta en un archivo denominado default-space-settings.json.


{
    "DefaultSpaceSettings": {
        "KernelGatewayAppSettings": { 
           "CustomImages": [ 
              { 
                 "ImageName": "string",
                 "AppImageConfigName": "string"
              }
           ],
           ...
        }
    }
}

Utilice el ID de dominio y el archivo de configuración de espacio predeterminado para actualizar el dominio.


aws sagemaker update-domain \
    --domain-id <d-xxxxxxxxxxxx> \
    --cli-input-json file://default-space-settings.json

El resultado debería ser similar al siguiente.


{
    "DomainArn": "arn:aws:sagemaker:us-east-2:acct-id:domain/d-xxxxxxxxxxxx"
}

Visualización de la imagen asociada en SageMaker AI

Tras crear la imagen de SageMaker personalizada y asociarla a su dominio, la imagen aparece en la pestaña Entorno del dominio. Solo puede ver las imágenes asociadas de espacios compartidos con la AWS CLI, mediante el siguiente comando.


aws sagemaker describe-domain \
    --domain-id <d-xxxxxxxxxxxx>

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Creación de una imagen de SageMaker

Inicio de una imagen personalizada