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.
En esta guía se muestra cómo adjuntar una RStudio imagen personalizada a tu dominio de Amazon SageMaker AI mediante la consola SageMaker AI o el AWS Command Line Interface (AWS CLI).
Para usar una imagen de SageMaker IA personalizada, debes adjuntar una RStudio imagen personalizada a tu dominio. Al adjuntar una versión de imagen, aparece en el RStudio lanzador y está disponible en la lista desplegable Seleccionar imagen. Utiliza el menú desplegable para cambiar la imagen utilizada por. RStudio
Hay un límite en el número de versiones de la imagen que se pueden asociar. Una vez alcanzado el límite, debe eliminar una versión para asociar otra versión de la imagen.
Temas
Asociación de una versión de la imagen a un dominio mediante la consola
Puedes adjuntar una versión de imagen de SageMaker IA personalizada a tu dominio mediante el panel de control de la consola de SageMaker IA. También puedes crear una imagen de SageMaker IA personalizada y una versión de imagen y, a continuación, adjuntar esa versión a tu dominio.
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.
-
Seleccione el dominio que desee.
-
Seleccione Entorno.
-
En Imágenes de Custom SageMaker Studio Classic adjuntas al dominio, selecciona Adjuntar imagen.
-
Para Fuente de imagen, elija Imagen existente o Nueva imagen.
Si seleccionas Imagen existente, elige una imagen del almacén de imágenes de Amazon SageMaker AI.
Si selecciona Nueva imagen, proporcione la ruta de registro de Amazon ECR para la imagen de Docker. La ruta debe estar en la misma Región de AWS que el dominio. El repositorio de Amazon ECR debe estar en la misma cuenta que su dominio, o bien deben estar habilitados los permisos multicuenta para la SageMaker IA.
-
Elija en la lista una imagen existente.
-
Elija una versión de la imagen en la lista.
-
Elija Siguiente.
-
Introduzca 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 Crear una RStudio imagen personalizada.
-
(Opcional) Agregue etiquetas para la imagen.
-
(Opcional) Elija Añadir nueva etiqueta y, a continuación, agregue una etiqueta de configuración.
-
En Tipo de imagen, selecciona Imagen. RStudio
-
Elija Enviar.
Espere a que la versión de la imagen se asocie al dominio. Cuando se asocie la versión, aparecerá en la lista Imágenes personalizadas y se resaltará brevemente.
Adjunta una versión de imagen existente a tu dominio mediante AWS CLI
Hay dos métodos para asociar la versión de la imagen al dominio mediante la AWS CLI. En el primer método, creará un nuevo dominio con la versión asociada. Este método es más sencillo, pero debe especificar la información y el rol de ejecución de Amazon Virtual Private Cloud (Amazon VPC) necesarios para crear el dominio.
Si ya se ha incorporado al dominio, puede emplear el segundo método para asociar la versión de la imagen al dominio actual. En este caso, no es necesario especificar la información y el rol de ejecución de Amazon VPC. Después de adjuntar la versión, elimina todas las aplicaciones de tu dominio y vuelve a RStudio iniciarlas.
Adjunta la imagen de SageMaker IA a un dominio nuevo
Para usar este método, debe especificar un rol de ejecución que tenga la AmazonSageMakerFullAccess
Siga 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
Respuesta:
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 jsonRespuesta:
[ "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. El rol de ejecución debe cumplir los requisitos de Completar los requisitos previos.{ "DomainName": "domain-with-custom-r-image", "VpcId": "
<vpc-id>
", "SubnetIds": [ "<subnet-ids>
" ], "DomainSettings": { "RStudioServerProDomainSettings": { "DomainExecutionRoleArn": "<execution-role>
" } }, "DefaultUserSettings": { "ExecutionRole": "<execution-role>
", "RSessionAppSettings": { "CustomImages": [ { "AppImageConfigName": "rstudio-custom-config", "ImageName": "rstudio-custom-image" } ] } }, "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
Respuesta:
{ "DomainArn": "arn:aws:sagemaker:
region
:acct-id:domain/domain-id
", "Url": "https://domain-id
.studio.region
.sagemaker.aws/..." }
Adjunta la imagen de SageMaker IA a un dominio existente
En este método se da por sentado que ya se ha incorporado al dominio. Para obtener más información, consulte Descripción general del dominio Amazon SageMaker AI.
nota
Debe eliminar todas las aplicaciones del dominio antes de actualizarlo con la nueva versión de la imagen. Para obtener información acerca de cómo eliminar estas aplicaciones, consulteEliminar un dominio de Amazon SageMaker AI.
Sigue los siguientes pasos para añadir la imagen de SageMaker IA a tu dominio actual.
Obtén la tuya
DomainID
desde la consola de SageMaker IA.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.
-
Seleccione el dominio que desee.
-
Seleccione Configuración del dominio.
-
En Configuración general, busque el ID del dominio. 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>
Respuesta:
{ "DomainId": "
d-xxxxxxxxxxxx
", "DefaultUserSettings": { "KernelGatewayAppSettings": { "CustomImages": [ ], ... } } } -
Guardar la sección
DefaultUserSettings
de la respuesta en un archivo denominadoupdate-domain-input.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": { "RSessionAppSettings": { "CustomImages": [ { "ImageName": "rstudio-custom-image", "AppImageConfigName": "rstudio-custom-config" } ] } } }
-
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://update-domain-input.jsonRespuesta:
{ "DomainArn": "arn:aws:sagemaker:
region
:acct-id:domain/domain-id
" } -
Elimine la aplicación
RStudioServerPro
. Debe reiniciar la aplicación deRStudioServerPro
dominio compartido para que la interfaz de usuario del RStudio Launcher recoja los cambios más recientes.aws sagemaker delete-app \ --domain-id
<d-xxxxxxxxxxxx>
--user-profile-name domain-shared \ --app-type RStudioServerPro --app-name default -
Cree una nueva aplicación
RStudioServerPro
. Debe crear esta aplicación mediante AWS CLI.aws sagemaker create-app \ --domain-id
<d-xxxxxxxxxxxx>
--user-profile-name domain-shared \ --app-type RStudioServerPro --app-name default