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.
Si has añadido una RStudio licencia mediante AWS License Manager, puedes crear un nuevo dominio de Amazon SageMaker AI compatible con SageMaker IA. RStudio Si ya tienes un dominio que no es compatible RStudio, puedes añadir RStudio soporte a ese dominio sin tener que eliminarlo ni volver a crearlo.
En el siguiente tema se explica cómo añadir esta compatibilidad.
Requisitos previos
Debes completar los siguientes pasos antes de actualizar tu dominio actual para añadir compatibilidad con SageMaker IA. RStudio
-
Instalar y configurar AWS CLI versión 2
-
Configurar AWS CLI con las credenciales de IAM
-
Cree una función de ejecución de dominio siguiendo los pasos que se indican en Crear un dominio de SageMaker IA RStudio con el AWS CLI. La aplicación requiere este rol de IAM a nivel de dominio. RStudio ServerPro El rol requiere acceso a AWS License Manager para verificar una licencia válida de Posit Workbench y a Amazon CloudWatch Logs para publicar los registros del servidor.
-
(Opcional) Si quieres usarlo RStudio en
VPCOnly
modo, completa los pasos que se indican solo RStudio en VPC. -
Asegúrese de que los grupos de seguridad que ha configurado para cada uno UserProfilede sus dominios cumplan con las cuotas a nivel de cuenta. Al configurar el perfil de usuario predeterminado durante la creación del dominio, puede utilizar el
DefaultUserSettings
parámetro de la CreateDomainAPI para añadir losSecurityGroups
que hereden todos los perfiles de usuario creados en el dominio. También puede proporcionar grupos de seguridad adicionales para un usuario específico como parte delUserSettings
parámetro de la CreateUserProfileAPI. Si ha añadido grupos de seguridad de esta manera, debe asegurarse de que el número total de grupos de seguridad por perfil de usuario no supera la cuota máxima de 2 en modoVPCOnly
y 4 en modoPublicInternetOnly
. Si el número total resultante de grupos de seguridad para cualquier perfil de usuario supera la cuota, puede combinar las reglas de varios grupos de seguridad en un solo grupo de seguridad.
Agregue RStudio soporte a un dominio existente
Una vez que hayas completado los requisitos previos, puedes añadir RStudio soporte a tu dominio actual. En los siguientes pasos se describe cómo actualizar tu dominio existente para añadirlo a él. RStudio
Paso 1: eliminar todas las aplicaciones del dominio
Para añadir compatibilidad a tu dominio, SageMaker AI debe actualizar los grupos de seguridad subyacentes de todos los perfiles de usuario existentes. RStudio Para ello, tendrá que eliminar y volver a crear todas las aplicaciones existentes en el dominio. El siguiente procedimiento muestra cómo eliminar todas las aplicaciones.
-
Enumere todas las aplicaciones del dominio.
aws sagemaker \ list-apps \ --domain-id-equals
<DOMAIN_ID>
-
Elimine todas las aplicaciones de todos los perfiles de usuario del dominio.
// JupyterServer apps aws sagemaker \ delete-app \ --domain-id
<DOMAIN_ID>
\ --user-profile-name<USER_PROFILE>
\ --app-type JupyterServer \ --app-name<APP_NAME>
// KernelGateway apps aws sagemaker \ delete-app \ --domain-id<DOMAIN_ID>
\ --user-profile-name<USER_PROFILE>
\ --app-type KernelGateway \ --app-name<APP_NAME>
Paso 2: Actualice todos los perfiles de usuario con la nueva lista de grupos de seguridad
Se trata de una acción única que debe realizar para todos los perfiles de usuario existentes en el dominio una vez que se hayan refactorizado los grupos de seguridad existentes. Esto evita llegar a la cuota del número máximo de grupos de seguridad. La llamada a la UpdateUserProfile
API falla si el usuario tiene alguna aplicación en InServiceestado. Elimine todas las aplicaciones y, a continuación, llame a la API UpdateUserProfile
para actualizar los grupos de seguridad.
nota
El siguiente requisito para el VPCOnly
modo descrito en Connect Amazon SageMaker Studio Classic Notebooks in a VPC to External Resources ya no es necesario al RStudio añadir soporteAppSecurityGroupManagement
, ya que lo gestiona SageMaker el servicio de IA:
"Tráfico TCP en el grupo de seguridad. Esto es necesario para la conectividad entre la JupyterServer aplicación y las KernelGateway aplicaciones. Debe permitir el acceso al menos a los puertos del rango 8192-65535
”.
aws sagemaker \
update-user-profile \
--domain-id <DOMAIN_ID>
\
--user-profile-name <USER_PROFILE>
\
--user-settings "{\"SecurityGroups\": [\"<SECURITY_GROUP>
\", \"<SECURITY_GROUP>
\"]}"
Paso 3: Actívala RStudio llamando a la UpdateDomain API
-
Llama a la UpdateDomainAPI para añadir compatibilidad RStudio con la SageMaker IA. El parámetro
defaultusersettings
solo es necesario si han refactorizado los grupos de seguridad predeterminados para los perfiles de usuario.-
Para el modo
VPCOnly
:aws sagemaker \ update-domain \ --domain-id
<DOMAIN_ID>
\ --app-security-group-management Service \ --domain-settings-for-update RStudioServerProDomainSettingsForUpdate={DomainExecutionRoleArn=<DOMAIN_EXECUTION_ROLE_ARN>
} \ --default-user-settings "{\"SecurityGroups\": [\"<SECURITY_GROUP>
\", \"<SECURITY_GROUP>
\"]}" -
Para el modo
PublicInternetOnly
:aws sagemaker \ update-domain \ --domain-id
<DOMAIN_ID>
\ --domain-settings-for-update RStudioServerProDomainSettingsForUpdate={DomainExecutionRoleArn=<DOMAIN_EXECUTION_ROLE_ARN>
} \ --default-user-settings "{\"SecurityGroups\": [\"<SECURITY_GROUP>
\", \"<SECURITY_GROUP>
\"]}"
-
-
Compruebe que el estado del dominio sea
InService
. Una vez que el estado del dominio seaInService
, se añadirá RStudio la compatibilidad con SageMaker IA.aws sagemaker \ describe-domain \ --domain-id
<DOMAIN_ID>
-
Comprueba que el estado de la RStudio ServerPro aplicación esté
InService
utilizando el siguiente comando.aws sagemaker list-apps --user-profile-name domain-shared
Paso 4: Añadir RStudio acceso para los usuarios existentes
Como parte de la actualización del paso 3, la SageMaker IA marca todos los perfiles RStudio AccessStatusde usuario existentes en el dominio como DISABLED
predeterminados. Esto evita superar el número de usuarios que permite su licencia actual. Para añadir acceso a usuarios existentes deberá seguir un paso de suscripción único. Para realizar la suscripción, llama a la UpdateUserProfileAPI con lo siguiente: RStudioServerProAppSettings
-
AccessStatus
=ENABLED
-
Opcional -
UserGroup
=R_STUDIO_USER
oR_STUDIO_ADMIN
aws sagemaker \
update-user-profile \
--domain-id <DOMAIN_ID>
\
--user-profile-name <USER_PROFILE>
\
--user-settings "{\"RStudioServerProAppSettings\": {\"AccessStatus\": \"ENABLED\"}}"
nota
De forma predeterminada, el número de usuarios a los que se puede acceder RStudio es de 60.
Paso 5: Desactivar el RStudio acceso para los nuevos usuarios
A menos que se especifique lo contrario al llamarUpdateDomain
, la RStudio asistencia se añade de forma predeterminada a todos los nuevos perfiles de usuario que se creen después de añadir la compatibilidad RStudio con SageMaker IA. Para desactivar el acceso en un perfil de usuario nuevo debe establecer explícitamente el parámetro AccessStatus
en DISABLED
como parte de la llamada a la API CreateUserProfile
. Si no se especifica el parámetro AccessStatus
como parte de la API CreateUserProfile
, el estado de acceso predeterminado es ENABLED
.
aws sagemaker \
create-user-profile \
--domain-id <DOMAIN_ID>
\
--user-profile-name <USER_PROFILE>
\
--user-settings "{\"RStudioServerProAppSettings\": {\"AccessStatus\": \"DISABLED\"}}"