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à.
# Allega un' SageMaker immagine personalizzata
**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.
Questa guida mostra come allegare un' RStudio immagine personalizzata al tuo dominio Amazon SageMaker AI utilizzando la console SageMaker AI o il AWS Command Line Interface (AWS CLI).
Per utilizzare un' SageMaker immagine personalizzata, devi allegare un' RStudio immagine personalizzata al tuo dominio. Quando alleghi una versione dell'immagine, questa appare nel RStudio Launcher ed è disponibile nell'elenco a discesa **Seleziona immagine**. È possibile utilizzare il menu a discesa per modificare l'immagine utilizzata da. RStudio
Esiste un limite al numero di versioni immagine che possono essere collegate. Una volta raggiunto il limite, devi prima scollegare una versione in modo da poter collegare una versione diversa dell'immagine.
**Topics**
+ [Collegamento di una versione dell’immagine al tuo dominio utilizzando la console](#rstudio-byoi-attach-console)
+ [Allega una versione dell'immagine esistente al tuo dominio utilizzando il AWS CLI](#rstudio-byoi-attach-cli)
## Collegamento di una versione dell’immagine al tuo dominio utilizzando la console
Puoi allegare una versione SageMaker dell'immagine personalizzata al tuo dominio utilizzando il pannello di controllo della console SageMaker AI. Puoi anche creare un' SageMaker immagine personalizzata e una versione dell'immagine e quindi allegare quella versione al tuo dominio.
**Per collegare un'immagine esistente**
1. Apri la console Amazon SageMaker AI all'indirizzo [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Nel riquadro di navigazione a sinistra, scegli **Configurazioni admin**.
1. In **Configurazioni di amministrazione**, scegli **Domini**.
1. Seleziona il dominio desiderato.
1. Scegliere **Environment** (Ambiente).
1. In **Immagini Custom SageMaker Studio Classic allegate al dominio**, scegli **Allega immagine**.
1. Per **Origine immagine**, scegliere **Immagine esistente** o **Nuova immagine**.
Se selezioni **Immagine esistente**, scegli un'immagine dall'Amazon SageMaker image store.
Se selezioni **Nuova immagine**, fornisci il percorso del registro Amazon ECR per la tua immagine Docker. Il percorso deve essere nella stessa Regione AWS del dominio. Il repository Amazon ECR deve trovarsi nello stesso account del tuo dominio oppure devono essere abilitate le autorizzazioni multiaccount per l' SageMaker IA.
1. Seleziona un’immagine esistente dall'elenco.
1. Seleziona una versione dell'immagine dall'elenco.
1. Scegli **Next (Successivo)**.
1. Inserisci i valori per **Nome immagine**, **Nome immagine visualizzato** e **Descrizione**.
1. Seleziona il ruolo IAM. Per ulteriori informazioni, consulta [Crea un'immagine personalizzata RStudio](rstudio-byoi-create.md).
1. (Facoltativo) Aggiunta di tag all'immagine.
1. (Facoltativo) Scegli **Aggiungi nuovo tag**, quindi aggiungi un tag di configurazione.
1. **Per **Tipo di immagine**, seleziona Immagine. RStudio**
1. Seleziona **Invia**.
Attendi che la versione dell'immagine venga collegata al dominio. Una volta collegata, la versione viene visualizzata nella lista **Immagini personalizzate** ed evidenziata per qualche secondo.
## Allega una versione dell'immagine esistente al tuo dominio utilizzando il AWS CLI
Vengono presentati due metodi per collegare la versione dell’immagine al dominio utilizzando la AWS CLI. Con il primo metodo, crei un nuovo dominio con la versione collegata. Questo metodo è più semplice, ma è necessario specificare le informazioni e il ruolo di esecuzione di Amazon Virtual Private Cloud (Amazon VPC) necessari per creare il dominio.
Se hai già effettuato l’onboarding nel dominio, puoi utilizzare il secondo metodo per collegare la versione dell’immagine al dominio corrente. In questo caso, non devi specificare le informazioni e il ruolo di esecuzione di Amazon VPC. Dopo aver collegato la versione, elimina tutte le applicazioni del dominio e riavvia RStudio.
### Allega l' SageMaker immagine a un nuovo dominio
Per utilizzare questo metodo, è necessario specificare un ruolo di esecuzione a cui è associata la [AmazonSageMakerFullAccess](https://console.aws.amazon.com/iam/home?#/policies/arn:aws:iam::aws:policy/AmazonSageMakerFullAccess)policy.
Utilizza i seguenti passaggi per creare il dominio e allegare l'immagine SageMaker AI personalizzata:
+ Ottieni l'ID VPC e la sottorete predefiniti. IDs
+ Crea il file di configurazione per il dominio, il quale specifica l'immagine.
+ Crea il dominio con il file di configurazione.
**Per aggiungere l' SageMaker immagine personalizzata al tuo dominio**
1. Ottieni l’ID del tuo VPC predefinito.
```
aws ec2 describe-vpcs \
--filters Name=isDefault,Values=true \
--query "Vpcs[0].VpcId" --output text
```
Risposta:
```
vpc-xxxxxxxx
```
1. Ottieni la tua sottorete predefinita IDs utilizzando l'ID VPC del passaggio precedente.
```
aws ec2 describe-subnets \
--filters Name=vpc-id,Values= \
--query "Subnets[*].SubnetId" --output json
```
Risposta:
```
[
"subnet-b55171dd",
"subnet-8a5f99c6",
"subnet-e88d1392"
]
```
1. Crea un file di configurazione denominato `create-domain-input.json`. Inserisci l'ID VPC, la sottorete IDs e `AppImageConfigName` dai passaggi precedenti. `ImageName` Poiché `ImageVersionNumber` non è specificato, si usa la versione più recente dell'immagine, che, in questo caso, è anche l'unica. Il ruolo di esecuzione deve soddisfare i requisiti di [Completamento dei prerequisiti](rstudio-byoi-prerequisites.md).
```
{
"DomainName": "domain-with-custom-r-image",
"VpcId": "",
"SubnetIds": [
""
],
"DomainSettings": {
"RStudioServerProDomainSettings": {
"DomainExecutionRoleArn": ""
}
},
"DefaultUserSettings": {
"ExecutionRole": "",
"RSessionAppSettings": {
"CustomImages": [
{
"AppImageConfigName": "rstudio-custom-config",
"ImageName": "rstudio-custom-image"
}
]
}
},
"AuthMode": "IAM"
}
```
1. Crea il dominio con l'immagine personalizzata SageMaker allegata.
```
aws sagemaker create-domain \
--cli-input-json file://create-domain-input.json
```
Risposta:
```
{
"DomainArn": "arn:aws:sagemaker:region:acct-id:domain/domain-id",
"Url": "https://domain-id.studio.region.sagemaker.aws/..."
}
```
### Allega l' SageMaker immagine a un dominio esistente
Questo metodo si basa sul presupposto che sia già stato effettuato l’onboarding in un dominio. Per ulteriori informazioni, consulta [Panoramica del dominio Amazon SageMaker AI](gs-studio-onboard.md).
**Nota**
Devi eliminare tutte le applicazioni nel tuo dominio per aggiornarlo con la nuova versione dell’immagine. Per informazioni sull'eliminazione di queste applicazioni, consulta [Eliminare un dominio Amazon SageMaker AI](gs-studio-delete-domain.md).
Segui i passaggi seguenti per aggiungere l' SageMaker immagine al tuo dominio corrente.
+ Scarica il tuo `DomainID` dalla console SageMaker AI.
+ Usa il `DomainID` per ottenere `DefaultUserSettings` per il dominio.
+ Aggiungi `ImageName` e `AppImageConfig` come `CustomImage` a `DefaultUserSettings`.
+ Aggiornamento del tuo dominio per includere l'immagine personalizzata.
**Per aggiungere l' SageMaker immagine personalizzata al tuo dominio**
1. Apri la console Amazon SageMaker AI all'indirizzo [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Nel riquadro di navigazione a sinistra, scegli **Configurazioni admin**.
1. In **Configurazioni di amministrazione**, scegli **Domini**.
1. Seleziona il dominio desiderato.
1. Scegli **Impostazioni del dominio**.
1. In **Impostazioni generali**, trova l’**ID dominio**. L'ID è nel formato seguente: `d-xxxxxxxxxxxx`.
1. Utilizza l'ID del dominio per generare la descrizione del dominio.
```
aws sagemaker describe-domain \
--domain-id
```
Risposta:
```
{
"DomainId": "d-xxxxxxxxxxxx",
"DefaultUserSettings": {
"KernelGatewayAppSettings": {
"CustomImages": [
],
...
}
}
}
```
1. Salva la sezione `DefaultUserSettings` della risposta in un file denominato `update-domain-input.json`.
1. Inserisci `ImageName` e `AppImageConfigName` delle fasi precedenti come immagine personalizzata. Poiché `ImageVersionNumber` non è specificato, si usa la versione più recente dell'immagine, che, in questo caso, è anche l'unica.
```
{
"DefaultUserSettings": {
"RSessionAppSettings": {
"CustomImages": [
{
"ImageName": "rstudio-custom-image",
"AppImageConfigName": "rstudio-custom-config"
}
]
}
}
}
```
1. Utilizza l'ID del dominio e il file delle impostazioni utente predefinite per aggiornare il dominio.
```
aws sagemaker update-domain \
--domain-id \
--cli-input-json file://update-domain-input.json
```
Risposta:
```
{
"DomainArn": "arn:aws:sagemaker:region:acct-id:domain/domain-id"
}
```
1. Elimina l'applicazione `RStudioServerPro`. È necessario riavviare l'applicazione `RStudioServerPro` condivisa dal dominio per consentire all'interfaccia utente di RStudio Launcher di rilevare le ultime modifiche.
```
aws sagemaker delete-app \
--domain-id --user-profile-name domain-shared \
--app-type RStudioServerPro --app-name default
```
1. Crea una nuova applicazione `RStudioServerPro`. È necessario creare questa applicazione utilizzando AWS CLI.
```
aws sagemaker create-app \
--domain-id --user-profile-name domain-shared \
--app-type RStudioServerPro --app-name default
```