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

Adjunta una SageMaker imagen personalizada

importante

Las políticas de IAM personalizadas que permiten a Amazon SageMaker Studio o Amazon SageMaker Studio Classic crear SageMaker recursos de Amazon también deben conceder permisos para añadir etiquetas a esos recursos. El permiso para añadir etiquetas a los recursos es obligatorio 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 Proporciona permisos para etiquetar SageMaker los recursos.

AWS Políticas gestionadas para Amazon SageMakerque otorgan permisos para crear SageMaker recursos 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 trata específicamente sobre el uso de la aplicación Studio Classic. Para obtener información sobre el uso de la experiencia de Studio actualizada, consulteAmazon SageMaker Studio.

Para usar una SageMaker imagen personalizada, debes adjuntar una versión de la imagen a tu dominio o espacio compartido. Al adjuntar una versión de imagen, aparece en el iniciador de SageMaker Studio Classic y está disponible en la lista desplegable Seleccionar imagen, que los usuarios utilizan para iniciar una actividad o cambiar la imagen utilizada en un bloc de notas.

Para que una SageMaker imagen personalizada esté disponible para todos los usuarios de un dominio, debe adjuntarla 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 adjuntar una imagen, SageMaker utiliza la última versión de la imagen de forma predeterminada. También puede asociar una versión de imagen específica. Después de adjuntar la versión, puede seleccionarla desde el SageMaker lanzador o el selector de imágenes al abrir un bloc de notas.

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 adjuntar una SageMaker imagen personalizada a su dominio mediante la SageMaker consola o el AWS CLI. Solo puede asociar una imagen personalizada a un espacio compartido mediante la AWS CLI.

Adjunta la SageMaker imagen a un dominio

Adjunte la SageMaker imagen mediante la consola

En este tema se describe cómo puede adjuntar una versión de SageMaker imagen personalizada existente a su dominio mediante el panel SageMaker de control. También puedes crear una imagen y una versión de SageMaker imagen personalizadas y, a continuación, adjuntar esa versión a tu dominio. Para obtener información sobre el procedimiento para crear una imagen y una versión de imagen, consulte Cree una SageMaker imagen personalizada.

Para asociar una imagen existente

Abre la SageMaker consola de Amazon en https://console.aws.amazon.com/sagemaker/.
En el panel de navegación izquierdo, seleccione Configuraciones de administración.
En Configuraciones de administración, selecciona dominios.
En la página Dominios, selecciona el dominio al que deseas adjuntar la imagen.
En la página Detalles del dominio, seleccione la pestaña Entorno.
En la pestaña Entorno, en Imágenes personalizadas de SageMaker Studio Classic adjuntas al dominio, selecciona Adjuntar 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 Cree una SageMaker imagen personalizada.
(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, selecciona Imagen de SageMaker estudio
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 núcleo a partir de la imagen, consulte DESARROLLO 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 SageMaker de imagen personalizadas.
(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.

Adjunte la SageMaker imagen mediante el AWS CLI

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

Adjunta la SageMaker imagen a un dominio nuevo

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. Debe realizar los siguientes pasos para crear el dominio y adjuntar la SageMaker imagen personalizada:

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 SageMaker imagen personalizada a tu 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"
}

Crea el dominio con la SageMaker imagen personalizada adjunta.


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/..."
}

Adjunta la SageMaker imagen a tu dominio actual

Si te has incorporado a un SageMaker dominio, puedes adjuntar la imagen personalizada a tu dominio actual. Para obtener más información sobre la incorporación a un SageMaker dominio, consulta. Descripción general SageMaker del dominio de Amazon No tiene que especificar la información de VPC y el rol de ejecución al asociar una imagen personalizada a su dominio actual. Tras adjuntar la versión, debes eliminar todas las aplicaciones de tu dominio y volver a abrir Studio Classic. Para obtener información acerca de cómo eliminar un volumen, consulte Eliminar un SageMaker dominio de Amazon.

Realiza los siguientes pasos para añadir la SageMaker imagen a tu dominio actual.

Obtén la tuya DomainID desde SageMaker el panel de control.
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 SageMaker imagen personalizada a tu dominio

Abre la SageMaker consola de Amazon en https://console.aws.amazon.com/sagemaker/.
En el panel de navegación izquierdo, seleccione Configuraciones de administración.
En Configuraciones de administración, selecciona dominios.
En la página Dominios, selecciona el dominio al que deseas adjuntar 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"
}

Adjunta la SageMaker imagen a un espacio compartido

Solo puede adjuntar la SageMaker imagen a un espacio compartido mediante AWS CLI. Tras adjuntar la versión, debe eliminar todas las aplicaciones del espacio compartido y volver a abrir Studio Classic. Para obtener información acerca de cómo eliminar un volumen, consulte Eliminar un SageMaker dominio de Amazon.

Realice los siguientes pasos para añadir la SageMaker imagen a un espacio compartido.

Obtenga la suya DomainID desde SageMaker el panel de control.
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 SageMaker imagen personalizada a tu espacio compartido

Abre la SageMaker consola de Amazon en https://console.aws.amazon.com/sagemaker/.
En el panel de navegación izquierdo, seleccione Configuraciones de administración.
En Configuraciones de administración, selecciona dominios.
En la página Dominios, selecciona el dominio al que deseas adjuntar 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"
}

Vea la imagen adjunta en SageMaker

Tras crear la SageMaker imagen personalizada y adjuntarla a tu dominio, la imagen aparecerá en la pestaña Entorno del dominio. Solo puede ver las imágenes adjuntas de los espacios compartidos 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

Crea una SageMaker imagen

Iniciar una imagen personalizada