Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Aggiungi RStudio supporto a un dominio esistente
**Importante**
Le politiche IAM personalizzate che consentono ad Amazon SageMaker Studio o Amazon SageMaker Studio Classic di creare SageMaker risorse Amazon devono inoltre concedere le autorizzazioni per aggiungere tag a tali risorse. L’autorizzazione per aggiungere tag alle risorse è necessaria perché Studio e Studio Classic applicano automaticamente tag a tutte le risorse che creano. Se una policy IAM consente a Studio e Studio Classic di creare risorse ma non consente l'etichettatura, possono verificarsi errori AccessDenied "" durante il tentativo di creare risorse. Per ulteriori informazioni, consulta [Fornisci le autorizzazioni per etichettare SageMaker le risorse AI](security_iam_id-based-policy-examples.md#grant-tagging-permissions).
[AWS politiche gestite per Amazon SageMaker AI](security-iam-awsmanpol.md)che danno i permessi per creare SageMaker risorse includono già le autorizzazioni per aggiungere tag durante la creazione di tali risorse.
Se hai aggiunto una RStudio licenza tramite AWS License Manager, puoi creare un nuovo dominio Amazon SageMaker AI con supporto per RStudio on SageMaker AI. Se disponi di un dominio esistente che non supporta RStudio, puoi aggiungere il RStudio supporto a quel dominio senza dover eliminare e ricreare il dominio.
L'argomento seguente descrive come aggiungere questo supporto.
## Prerequisiti
È necessario completare i seguenti passaggi prima di aggiornare il dominio corrente per aggiungere il supporto per RStudio on SageMaker AI.
+ Installazione e configurazione [AWS CLI versione 2](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html)
+ Configurazione di [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config) con credenziali IAM
+ Crea un ruolo di esecuzione del dominio seguendo i passaggi descritti in [Creare un dominio SageMaker AI RStudio utilizzando AWS CLI](https://docs.aws.amazon.com/sagemaker/latest/dg/rstudio-create-cli.html#rstudio-create-cli-domainexecution). Questo ruolo IAM a livello di dominio è richiesto dall'app. RStudio ServerPro Il ruolo richiede l'accesso AWS License Manager per la verifica di una licenza Posit Workbench valida e Amazon CloudWatch Logs per la pubblicazione dei log del server.
+ [Implementa la tua RStudio licenza AWS License Manager seguendo i passaggi indicati nella licenza. RStudio](https://docs.aws.amazon.com/sagemaker/latest/dg/rstudio-license.html)
+ (Facoltativo) Se desideri utilizzare RStudio in `VPCOnly` modalità, completa i passaggi [RStudio in Solo VPC](https://docs.aws.amazon.com/sagemaker/latest/dg/rstudio-network.html).
+ Assicurati che i gruppi di sicurezza che hai configurato per ciascuno del tuo dominio soddisfino le quote [UserProfile](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateUserProfile.html)a livello di account. Quando configuri il profilo utente predefinito durante la creazione del dominio, puoi utilizzare il `DefaultUserSettings` parametro dell'[CreateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateDomain.html)API per aggiungere i profili utente `SecurityGroups` ereditati da tutti i profili utente creati nel dominio. Puoi anche fornire gruppi di sicurezza aggiuntivi per un utente specifico come parte del `UserSettings` parametro dell'[CreateUserProfile](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateUserProfile.html)API. Se hai aggiunto gruppi di sicurezza in questo modo, devi assicurarti che il numero totale di gruppi di sicurezza per profilo utente non superi la quota massima di 2 in modalità `VPCOnly` e 4 in modalità `PublicInternetOnly`. Se il numero totale di gruppi di sicurezza risultante per ogni profilo utente supera la quota, puoi combinare le regole di più gruppi di sicurezza in un unico gruppo di sicurezza.
## Aggiungi RStudio supporto a un dominio esistente
Dopo aver completato i prerequisiti, puoi aggiungere il RStudio supporto al tuo dominio esistente. I passaggi seguenti descrivono come aggiornare il dominio esistente per cui aggiungere il supporto. RStudio
### Fase 1. Elimina tutte le app nel dominio
Per aggiungere il supporto per RStudio il tuo dominio, SageMaker AI deve aggiornare i gruppi di sicurezza sottostanti per tutti i profili utente esistenti. Per completare questa operazione, devi eliminare tutte le app esistenti nel dominio e crearle di nuovo. Di seguito viene mostrato come eliminare tutte le app.
1. Elenca tutte le app del dominio.
```
aws sagemaker \
list-apps \
--domain-id-equals
```
1. Elimina tutte le app per ogni profilo utente nel dominio.
```
// 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
```
### Fase 2: aggiornare tutti i profili utente con il nuovo elenco di gruppi di sicurezza
Questa è un’azione una tantum che devi completare per tutti i profili utente esistenti nel tuo dominio dopo aver rifattorizzato i gruppi di sicurezza esistenti. Ciò impedisce di raggiungere la quota per il numero massimo di gruppi di sicurezza. La chiamata `UpdateUserProfile` API fallisce se l'utente ha delle app con [InService](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeApp.html#sagemaker-DescribeApp-response-Status)stato impostato. Elimina tutte le app, quindi chiama l'API `UpdateUserProfile` per aggiornare i gruppi di sicurezza.
**Nota**
Il seguente requisito per la `VPCOnly` modalità delineato in [Connect Amazon SageMaker Studio Classic Notebooks in un VPC a risorse esterne](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-notebooks-and-internet-access.html#studio-notebooks-and-internet-access-vpc-only) non è più necessario quando si aggiunge il RStudio supporto perché `AppSecurityGroupManagement` è gestito dal servizio AI: SageMaker
“[Traffico TCP all'interno del gruppo di sicurezza](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/security-group-rules-reference.html#sg-rules-other-instances). È necessario per la connettività tra l'app e le JupyterServer app. KernelGateway È necessario consentire l'accesso ad almeno le porte dell'intervallo `8192-65535`.”
```
aws sagemaker \
update-user-profile \
--domain-id \
--user-profile-name \
--user-settings "{\"SecurityGroups\": [\"\", \"\"]}"
```
### Fase 3 - Attivazione RStudio chiamando l' UpdateDomain API
1. Chiama l'[UpdateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateDomain.html)API per aggiungere il supporto per RStudio on SageMaker AI. Il parametro `defaultusersettings` è necessario solo se hai rifattorizzato i gruppi di sicurezza predefiniti per i tuoi profili utente.
+ Per la modalità `VPCOnly`:
```
aws sagemaker \
update-domain \
--domain-id \
--app-security-group-management Service \
--domain-settings-for-update RStudioServerProDomainSettingsForUpdate={DomainExecutionRoleArn=} \
--default-user-settings "{\"SecurityGroups\": [\"\", \"\"]}"
```
+ Per la modalità `PublicInternetOnly`:
```
aws sagemaker \
update-domain \
--domain-id \
--domain-settings-for-update RStudioServerProDomainSettingsForUpdate={DomainExecutionRoleArn=} \
--default-user-settings "{\"SecurityGroups\": [\"\", \"\"]}"
```
1. Verifica che lo stato del dominio sia `InService`. Dopo lo stato del dominio`InService`, viene aggiunto il supporto per RStudio on SageMaker AI.
```
aws sagemaker \
describe-domain \
--domain-id
```
1. Verifica che lo stato dell' RStudioServerPro app `InService` utilizzi il seguente comando.
```
aws sagemaker list-apps --user-profile-name domain-shared
```
### Passaggio 4: aggiungere RStudio l'accesso per gli utenti esistenti
Come parte dell'aggiornamento nella Fase 3, SageMaker AI contrassegna come impostazione `DISABLED` predefinita tutti i profili utente esistenti nel dominio. RStudio [AccessStatus](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_RStudioServerProAppSettings.html#sagemaker-Type-RStudioServerProAppSettings-AccessStatus) Ciò impedisce il superamento del numero di utenti consentito dalla licenza corrente. Per aggiungere l'accesso per gli utenti esistenti, è disponibile una sola fase di attivazione. Esegui l'opt-in chiamando l'[UpdateUserProfile](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateUserProfile.html)API con quanto segue: [RStudioServerProAppSettings](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UserSettings.html#sagemaker-Type-UserSettings-RStudioServerProAppSettings)
+ `AccessStatus` = `ENABLED`
+ *Facoltativo* - `UserGroup` = `R_STUDIO_USER` o `R_STUDIO_ADMIN`
```
aws sagemaker \
update-user-profile \
--domain-id \
--user-profile-name \
--user-settings "{\"RStudioServerProAppSettings\": {\"AccessStatus\": \"ENABLED\"}}"
```
**Nota**
Per impostazione predefinita, il numero di utenti a cui è possibile accedere RStudio è 60.
### Passaggio 5: disattiva RStudio l'accesso per i nuovi utenti
Se non diversamente specificato durante la chiamata`UpdateDomain`, RStudio il supporto viene aggiunto per impostazione predefinita per tutti i nuovi profili utente creati dopo aver aggiunto il supporto per RStudio on SageMaker AI. Per disattivare l'accesso per un nuovo profilo utente, è necessario impostare esplicitamente il parametro `AccessStatus` su `DISABLED` come parte della chiamata API `CreateUserProfile`. Se il parametro `AccessStatus` non è specificato come parte dell'API `CreateUserProfile`, lo stato di accesso predefinito è `ENABLED`.
```
aws sagemaker \
create-user-profile \
--domain-id \
--user-profile-name \
--user-settings "{\"RStudioServerProAppSettings\": {\"AccessStatus\": \"DISABLED\"}}"
```