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.
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 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 de tipo AccessDenied «» al intentar crear recursos. Para obtener más información, consulte Proporcione permisos para etiquetar los recursos de SageMaker IA.
AWS políticas gestionadas para Amazon SageMaker AIque 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 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 usar una imagen de SageMaker IA 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 clásico de SageMaker Studio 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 imagen de SageMaker IA personalizada esté disponible para todos los usuarios de un dominio, debe adjuntar 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 adjuntar 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. Después de adjuntar la versión, puedes elegirla en el SageMaker AI Launcher o en 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 imagen de SageMaker IA personalizada a tu dominio mediante la consola de SageMaker IA o el AWS CLI. Solo puede asociar una imagen personalizada a un espacio compartido mediante la AWS CLI.
Adjunta la imagen de SageMaker IA a un dominio
Adjunta la imagen de SageMaker IA mediante la consola
En este tema se describe cómo puedes adjuntar una versión de imagen de SageMaker IA personalizada existente a tu dominio mediante el panel de control de SageMaker IA. También puedes crear una imagen y una versión de imagen de SageMaker IA 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 imagen de SageMaker IA personalizada.
Para asociar una imagen existente
-
Abre la consola 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, 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 Next (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 imagen de SageMaker IA 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 de imagen de SageMaker IA personalizadas. -
(Opcional) Para Nombre de visualización del kernel, introduzca el nombre para mostrar del kernel.
-
Seleccione Añadir kernel.
-
Elija Enviar.
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 imagen de SageMaker IA mediante el AWS CLI
En las siguientes secciones se muestra cómo adjuntar una imagen de SageMaker IA personalizada al crear un nuevo dominio o actualizar el dominio existente mediante el AWS CLI.
Adjunta la imagen de SageMaker IA 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 imagen de SageMaker IA personalizada:
Obtenga su ID de VPC y su subred predeterminados. IDs
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 de SageMaker IA 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 su subred predeterminada IDs con el ID de VPC del paso anterior.
aws ec2 describe-subnets \ --filters Name=vpc-id,Values=
<vpc-id>
\ --query "Subnets[*].SubnetId" --output jsonEl 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, la subred y IDs unoImageName
AppImageConfigName
de los pasos anteriores. Dado que no se especificaImageVersionNumber
, 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 IA 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 imagen de SageMaker IA a tu dominio actual
Si te has incorporado a un dominio de SageMaker IA, puedes adjuntar la imagen personalizada a tu dominio actual. Para obtener más información sobre la incorporación a un dominio de SageMaker IA, consulte. Descripción general del dominio 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 Eliminar un dominio de Amazon SageMaker AI.
Realiza los siguientes pasos para añadir la imagen de SageMaker IA a tu dominio actual.
Obtén la tuya
DomainID
desde el panel de control de SageMaker AI.Utilice el
DomainID
para obtener elDefaultUserSettings
para el dominio.Agregue el
ImageName
y laAppImageConfig
como unaCustomImage
a laDefaultUserSettings
.Actualice el dominio para incluir la imagen personalizada.
Para añadir la imagen de SageMaker IA personalizada a tu dominio
-
Abre la consola 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 laAppImageConfigName
de los pasos anteriores como imagen personalizada. Dado que no se especificaImageVersionNumber
, 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.jsonEl resultado debería ser similar al siguiente.
{ "DomainArn": "arn:aws:sagemaker:us-east-2:acct-id:domain/d-xxxxxxxxxxxx" }
Adjunta la imagen de SageMaker IA a un espacio compartido
Solo puede adjuntar la imagen de SageMaker IA a un espacio compartido mediante 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 Eliminar un dominio de Amazon SageMaker AI.
Realice los siguientes pasos para añadir la imagen de SageMaker IA a un espacio compartido.
Obtenga la suya
DomainID
desde el panel de control de SageMaker AI.Utilice el
DomainID
para obtener elDefaultSpaceSettings
para el dominio.Agregue el
ImageName
y laAppImageConfig
como unaCustomImage
a laDefaultSpaceSettings
.Actualice su dominio para incluir la imagen personalizada para el espacio compartido.
Para añadir la imagen de SageMaker IA personalizada a tu espacio compartido
-
Abre la consola 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
. -
Inserte el
ImageName
y laAppImageConfigName
de los pasos anteriores como imagen personalizada. Dado que no se especificaImageVersionNumber
, se utiliza la versión más reciente de la imagen, que es la única versión en este caso.{ "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.jsonEl 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 AI
Una vez que hayas creado la imagen de SageMaker IA personalizada y la hayas adjuntado a tu dominio, la imagen aparecerá en la pestaña Entorno del dominio. Solo puedes ver las imágenes adjuntas de los espacios compartidos AWS CLI mediante el siguiente comando.
aws sagemaker describe-domain \ --domain-id
<d-xxxxxxxxxxxx>