As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Adicionar compatibilidade com o RStudio a um domínio existente
**Importante**
Políticas personalizadas do IAM que permitem que o Amazon SageMaker SageMaker Studio ou o Amazon Studio Classic criem SageMaker recursos da Amazon também devem conceder permissões para adicionar tags a esses recursos. A permissão para adicionar tags aos recursos é necessária porque o Studio e o Studio Classic marcam automaticamente todos os recursos que eles criam. Se uma política do IAM permitir que o Studio e o Studio Classic criem recursos, mas não permitisse a marcação, erros AccessDenied "" podem ocorrer ao tentar criar recursos. Para obter mais informações, consulte [Forneça permissões para marcar recursos de SageMaker IA](security_iam_id-based-policy-examples.md#grant-tagging-permissions).
[AWS políticas gerenciadas para Amazon SageMaker AI](security-iam-awsmanpol.md)que dão permissões para criar SageMaker recursos já incluem permissões para adicionar tags ao criar esses recursos.
Se você adicionou uma licença do RStudio por meio de AWS License Manager, você pode criar um novo domínio Amazon SageMaker AI com suporte para o RStudio on SageMaker AI. Se você tiver um domínio existente que não oferece apoio ao RStudio, você pode adicionar compatibilidade com o RStudio a esse domínio sem precisar excluir e recriar o domínio.
O tópico a seguir descreve como adicionar essa compatibilidade.
## Pré-requisitos
Você deve concluir as etapas a seguir antes de atualizar seu domínio atual para adicionar suporte ao RStudio on SageMaker AI.
+ Instalar e configurar a [versão 2 do AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html)
+ Configure o [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config)com credenciais do IAM
+ Crie uma função de execução de domínio seguindo as etapas em [Criar um domínio de SageMaker IA com o RStudio usando o. AWS CLI](https://docs.aws.amazon.com/sagemaker/latest/dg/rstudio-create-cli.html#rstudio-create-cli-domainexecution) Essa função do IAM em nível de domínio é exigida pelo aplicativo. RStudioServerPro A função requer acesso AWS License Manager para verificar uma licença válida do Posit Workbench e Amazon CloudWatch Logs para publicar registros do servidor.
+ Traga sua licença do RStudio para AWS License Manager seguir as etapas da licença do [RStudio](https://docs.aws.amazon.com/sagemaker/latest/dg/rstudio-license.html).
+ (Opcional) Se você quiser usar o RStudio no `VPCOnly` modo, conclua as etapas no [RStudio](https://docs.aws.amazon.com/sagemaker/latest/dg/rstudio-network.html) em. VPC-Only
+ Certifique-se de que os grupos de segurança que você configurou para cada um [UserProfile](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateUserProfile.html)em seu domínio atendam às cotas no nível da conta. Ao configurar o perfil de usuário padrão durante a criação do domínio, você pode usar o `DefaultUserSettings` parâmetro da [CreateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateDomain.html)API para adicionar os `SecurityGroups` que são herdados por todos os perfis de usuário criados no domínio. Você também pode fornecer grupos de segurança adicionais para um usuário específico como parte do `UserSettings` parâmetro da [CreateUserProfile](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateUserProfile.html)API. Se você adicionou grupos de segurança dessa forma, deve garantir que o número total de grupos de segurança por perfil de usuário não exceda a cota máxima de 2 no modo `VPCOnly` e 4 no modo `PublicInternetOnly`. Se o resultado do número total de grupos de segurança para qualquer perfil de usuário exceder a cota, você poderá combinar as regras de vários grupos de segurança em um só grupo de segurança.
## Adicionar compatibilidade com o RStudio a um domínio existente
Depois de concluir os pré-requisitos, você pode adicionar compatibilidade com o RStudio ao seu domínio existente. As etapas a seguir descrevem como atualizar seu domínio existente para adicionar compatibilidade com o RStudio.
### Etapa 1: exclua todos as aplicações no domínio
Para adicionar suporte ao RStudio em seu domínio, a SageMaker IA deve atualizar os grupos de segurança subjacentes para todos os perfis de usuário existentes. Para concluir isso, você deve excluir e recriar todos as aplicações existentes no domínio. O procedimento a seguir mostra como excluir todos as aplicações.
1. Liste todos as aplicações no domínio.
```
aws sagemaker \
list-apps \
--domain-id-equals {{}}
```
1. Exclua cada aplicação para cada perfil de usuário no domínio.
```
// JupyterServer apps
aws sagemaker \
delete-app \
--domain-id {{}} \
--user-profile-name {{}} \
--app-type JupyterServer \
--app-name {{}}
// KernelGateway apps
aws sagemaker \
delete-app \
--domain-id {{}} \
--user-profile-name {{}} \
--app-type KernelGateway \
--app-name {{}}
```
### Etapa 2 - Atualize todos os perfis de usuário com a nova lista de grupos de segurança
Esta é uma ação única que você deve concluir para todos os perfis de usuário existentes no seu domínio depois de refatorar seus grupos de segurança existentes. Isto impede que você atinja a cota para o número máximo de grupos de segurança. A chamada `UpdateUserProfile` da API falhará se o usuário tiver algum aplicativo com [InService](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeApp.html#sagemaker-DescribeApp-response-Status)status. Exclua todos as aplicações e chame a API `UpdateUserProfile` para atualizar os grupos de segurança.
**nota**
O seguinte requisito de `VPCOnly` modo descrito em [Connect Amazon SageMaker Studio Classic Notebooks in a VPC to External Resources](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-notebooks-and-internet-access.html#studio-notebooks-and-internet-access-vpc-only) não é mais necessário ao adicionar suporte ao RStudio porque `AppSecurityGroupManagement` é gerenciado pelo serviço de IA: SageMaker
“[Tráfego TCP dentro do grupo de segurança](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/security-group-rules-reference.html#sg-rules-other-instances). Isso é necessário para a conectividade entre o JupyterServer aplicativo e os KernelGateway aplicativos. Você deve permitir o acesso pelo menos às portas no intervalo `8192-65535`.”
```
aws sagemaker \
update-user-profile \
--domain-id {{}}\
--user-profile-name {{}} \
--user-settings "{\"SecurityGroups\": [\"{{}}\", \"{{}}\"]}"
```
### Etapa 3 - Ative o RStudio chamando a API UpdateDomain
1. Chame a [UpdateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateDomain.html)API para adicionar suporte ao RStudio na SageMaker IA. O parâmetro `defaultusersettings` só é necessário se você tiver refatorado os grupos de segurança padrão para seus perfis de usuário.
+ Para o modo `VPCOnly`:
```
aws sagemaker \
update-domain \
--domain-id {{}} \
--app-security-group-management Service \
--domain-settings-for-update RStudioServerProDomainSettingsForUpdate={DomainExecutionRoleArn={{}}} \
--default-user-settings "{\"SecurityGroups\": [\"{{}}\", \"{{}}\"]}"
```
+ Para o modo `PublicInternetOnly`:
```
aws sagemaker \
update-domain \
--domain-id {{}} \
--domain-settings-for-update RStudioServerProDomainSettingsForUpdate={DomainExecutionRoleArn={{}}} \
--default-user-settings "{\"SecurityGroups\": [\"{{}}\", \"{{}}\"]}"
```
1. Verifique se o status do domínio é `InService`. Depois que o status do domínio for`InService`, o suporte para o RStudio na SageMaker IA será adicionado.
```
aws sagemaker \
describe-domain \
--domain-id {{}}
```
1. Verifique se o status do RStudioServerPro aplicativo está `InService` usando o comando a seguir.
```
aws sagemaker list-apps --user-profile-name domain-shared
```
### Etapa 4 - Adicionar acesso ao RStudio para usuários existentes
Como parte da atualização na Etapa 3, a SageMaker IA marca o RStudio [AccessStatus](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_RStudioServerProAppSettings.html#sagemaker-Type-RStudioServerProAppSettings-AccessStatus)de todos os perfis de usuário existentes no domínio como `DISABLED` padrão. Isso evita que você ultrapasse o número de usuários permitido pela sua licença atual. Para adicionar acesso aos usuários existentes, há uma etapa única de ingresso. Execute o opt-in chamando a [UpdateUserProfile](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateUserProfile.html)API com o seguinte: [RStudioServerProAppSettings](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UserSettings.html#sagemaker-Type-UserSettings-RStudioServerProAppSettings)
+ `AccessStatus` = `ENABLED`
+ *Opcional* - `UserGroup` = `R_STUDIO_USER` ou `R_STUDIO_ADMIN`
```
aws sagemaker \
update-user-profile \
--domain-id {{}}\
--user-profile-name {{}} \
--user-settings "{\"RStudioServerProAppSettings\": {\"AccessStatus\": \"ENABLED\"}}"
```
**nota**
Por padrão, o número de usuários que podem ter acesso ao RStudio é 60.
### Etapa 5: Desativar o acesso ao RStudio para novos usuários
A menos que especificado de outra forma durante a chamada`UpdateDomain`, o suporte ao RStudio é adicionado por padrão para todos os novos perfis de usuário criados após a adição do suporte ao RStudio on SageMaker AI. Para desativar o acesso a um novo perfil de usuário, você deve configurar explicitamente o parâmetro `AccessStatus` como `DISABLED`, como parte da chamada da API `CreateUserProfile`. Se o parâmetro `AccessStatus` não for especificado como parte da API `CreateUserProfile`, o status de acesso padrão será `ENABLED`.
```
aws sagemaker \
create-user-profile \
--domain-id {{}}\
--user-profile-name {{}} \
--user-settings "{\"RStudioServerProAppSettings\": {\"AccessStatus\": \"DISABLED\"}}"
```