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à.
Aggiunta del supporto per RStudio 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.
AWS politiche gestite per Amazon SageMaker AIche danno i permessi per creare SageMaker risorse includono già le autorizzazioni per aggiungere tag durante la creazione di tali risorse.
Se hai aggiunto una licenza RStudio tramite AWS License Manager, puoi creare un nuovo dominio Amazon SageMaker AI con supporto per RStudio on SageMaker AI. Se un dominio esistente non supporta RStudio, puoi aggiungere il supporto per RStudio 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 AI. SageMaker
-
Installazione e configurazione AWS CLI versione 2
-
Configurazione di AWS CLI con credenziali IAM
-
Crea un ruolo di esecuzione del dominio seguendo i passaggi descritti in Creare un dominio SageMaker AI con RStudio utilizzando il. AWS CLI Questo ruolo IAM a livello di dominio è richiesto dall'app. RStudioServerPro 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 licenza RStudio a AWS License Manager seguire i passaggi della licenza RStudio.
-
Assicurati che i gruppi di sicurezza che hai configurato per ciascuno del tuo dominio soddisfino le quote UserProfilea livello di account. Quando configuri il profilo utente predefinito durante la creazione del dominio, puoi utilizzare il
DefaultUserSettingsparametro dell'CreateDomainAPI per aggiungere i profili utenteSecurityGroupsereditati da tutti i profili utente creati nel dominio. Puoi anche fornire gruppi di sicurezza aggiuntivi per un utente specifico come parte delUserSettingsparametro dell'CreateUserProfileAPI. 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àVPCOnlye 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.
Aggiunta del supporto per RStudio a un dominio esistente
Dopo aver completato i prerequisiti, puoi aggiungere il supporto per RStudio al tuo dominio esistente. Nelle fasi seguenti viene descritto come aggiornare il dominio esistente per aggiungere il supporto per RStudio.
Fase 1. Elimina tutte le app nel dominio
Per aggiungere il supporto per RStudio nel 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.
-
Elenca tutte le app del dominio.
aws sagemaker \ list-apps \ --domain-id-equals<DOMAIN_ID> -
Elimina tutte le app per ogni profilo utente nel 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>
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 InServicestato 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 non è più necessario quando si aggiunge il supporto RStudio perché AppSecurityGroupManagement è gestito dal servizio AI: SageMaker
“Traffico TCP all'interno del gruppo di sicurezza. È necessario per la connettività tra l'app e le app. JupyterServer KernelGateway È necessario consentire l'accesso ad almeno le porte dell'intervallo 8192-65535.”
aws sagemaker \ update-user-profile \ --domain-id<DOMAIN_ID>\ --user-profile-name<USER_PROFILE>\ --user-settings "{\"SecurityGroups\": [\"<SECURITY_GROUP>\", \"<SECURITY_GROUP>\"]}"
Fase 3 - Attiva RStudio chiamando l'API UpdateDomain
-
Chiama l'UpdateDomainAPI 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<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>\"]}" -
Per la modalità
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>\"]}"
-
-
Verifica che lo stato del dominio sia
InService. Dopo lo stato del dominioInService, viene aggiunto il supporto per RStudio on SageMaker AI.aws sagemaker \ describe-domain \ --domain-id<DOMAIN_ID> -
Verifica che lo stato dell' RStudioServerPro app
InServiceutilizzi il seguente comando.aws sagemaker list-apps --user-profile-name domain-shared
Fase 4: aggiungere l'accesso a RStudio per gli utenti esistenti
Come parte dell'aggiornamento dello Step 3, SageMaker AI contrassegna come DISABLED predefinito RStudio AccessStatusdi tutti i profili utente esistenti nel dominio. 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'UpdateUserProfileAPI con quanto segue: RStudioServerProAppSettings
-
AccessStatus=ENABLED -
Facoltativo -
UserGroup=R_STUDIO_USERoR_STUDIO_ADMIN
aws sagemaker \ update-user-profile \ --domain-id<DOMAIN_ID>\ --user-profile-name<USER_PROFILE>\ --user-settings "{\"RStudioServerProAppSettings\": {\"AccessStatus\": \"ENABLED\"}}"
Nota
Per impostazione predefinita, il numero di utenti che possono accedere a RStudio è 60.
Fase 5: disattivare l'accesso a RStudio per i nuovi utenti
Se non diversamente specificato durante la chiamataUpdateDomain, il supporto RStudio viene aggiunto per impostazione predefinita per tutti i nuovi profili utente creati dopo aver aggiunto il supporto per RStudio on AI. SageMaker 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<DOMAIN_ID>\ --user-profile-name<USER_PROFILE>\ --user-settings "{\"RStudioServerProAppSettings\": {\"AccessStatus\": \"DISABLED\"}}"
