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à.
# Crea un'immagine personalizzata RStudio
**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.
Questo argomento descrive come creare un' RStudio immagine personalizzata utilizzando la console SageMaker AI e il. AWS CLI Se si utilizza il AWS CLI, è necessario eseguire la procedura dal computer locale. I seguenti passaggi non funzionano in Amazon SageMaker Studio Classic.
Quando crei un'immagine, l' SageMaker intelligenza artificiale crea anche una versione iniziale dell'immagine. Ogni versione dell’immagine rappresenta un'immagine del container presente in [Amazon Elastic Container Registry (ECR)](https://console.aws.amazon.com/ecr/). L'immagine del contenitore deve soddisfare i requisiti per essere utilizzata in RStudio. Per ulteriori informazioni, consulta [Specifiche personalizzate RStudio dell'immagine](rstudio-byoi-specs.md).
Per informazioni su come testare l'immagine localmente e risolvere i problemi più comuni, consultate il repository [SageMaker Studio Custom Image Samples](https://github.com/aws-samples/sagemaker-studio-custom-image-samples/blob/main/DEVELOPMENT.md).
**Topics**
+ [Aggiungi un'immagine di SageMaker contenitore RStudio Docker compatibile con l'intelligenza artificiale ad Amazon ECR](#rstudio-byoi-sdk-add-container-image)
+ [Creare un' SageMaker immagine dalla console](#rstudio-byoi-create-console)
+ [Crea un'immagine da AWS CLI](#rstudio-byoi-create-cli)
## Aggiungi un'immagine di SageMaker contenitore RStudio Docker compatibile con l'intelligenza artificiale ad Amazon ECR
Esegui le fasi seguenti per aggiungere un'immagine del container Docker ad Amazon ECR:
+ Crea un repository Amazon ECR.
+ Effettua l'autenticazione su Amazon ECR.
+ Crea un'immagine Docker compatibile con l'intelligenza SageMaker artificiale. RStudio
+ Inserisci l'immagine nel repository Amazon ECR.
**Nota**
L'archivio Amazon ECR deve trovarsi nello Regione AWS stesso dominio.
**Per creare e aggiungere un'immagine Docker da un container ad Amazon ECR**
1. Crea un repository in Amazon ECR tramite la AWS CLI. Per creare il repository utilizzando la console Amazon ECR, consulta la sezione [Creating a repository](https://docs.aws.amazon.com/AmazonECR/latest/userguide/repository-create.html).
```
aws ecr create-repository \
--repository-name rstudio-custom \
--image-scanning-configuration scanOnPush=true
```
Risposta:
```
{
"repository": {
"repositoryArn": "arn:aws:ecr:us-east-2:acct-id:repository/rstudio-custom",
"registryId": "acct-id",
"repositoryName": "rstudio-custom",
"repositoryUri": "acct-id.dkr.ecr.us-east-2.amazonaws.com/rstudio-custom",
...
}
}
```
1. Effettua l'autenticazione su Amazon ECR utilizzando l'URI del repository restituito come risposta dal comando `create-repository`. Assicurarsi che l'applicazione Docker sia in esecuzione. Per ulteriori informazioni, consultare [Autenticazione dei registri](https://docs.aws.amazon.com/AmazonECR/latest/userguide/Registries.html#registry_auth).
```
aws ecr get-login-password | \
docker login --username AWS --password-stdin
```
Risposta:
```
Login Succeeded
```
1. Creazione dell'immagine Docker. Esegui il comando seguente dalla directory che include il tuo Dockerfile.
```
docker build .
```
1. Etichetta l'immagine creata con un tag unico.
```
docker tag ":"
```
1. Inserisci l'immagine del container nel repository Amazon ECR. Per ulteriori informazioni, consulta la sezione [ImagePush](https://docs.docker.com/engine/api/v1.40/#operation/ImagePush)[Pushing an image.](https://docs.aws.amazon.com/AmazonECR/latest/userguide/docker-push-ecr-image.html)
```
docker push :
```
Risposta:
```
The push refers to repository [.dkr.ecr.us-east-2.amazonaws.com/rstudio-custom]
r: digest: size: 3066
```
## Creare un' SageMaker immagine dalla console
**Come creare un’immagine**
1. Apri la console Amazon SageMaker AI all'indirizzo [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Nel pannello di navigazione sinistro scegli **Configurazioni admin**.
1. In **Configurazioni admin**, scegli **Immagini**.
1. Nella pagina **Immagini personalizzate**, scegli **Crea immagine**.
1. In **Origine dell’immagine**, inserisci il percorso di registrazione dell'immagine del container in Amazon ECR. Il percorso si presenta nel formato seguente:
` acct-id.dkr.ecr.region.amazonaws.com/repo-name[:tag] or [@digest] `
1. Seleziona **Successivo**.
1. In **Proprietà dell’immagine**, inserisci quanto segue:
+ Nome immagine: il nome deve essere univoco per il tuo account nella Regione AWS corrente.
+ (Facoltativo) Nome visualizzato dell'immagine – il nome visualizzato nell'interfaccia utente di dominio. Se non fornito, viene visualizzato `Image name`.
+ (Facoltativo) Descrizione: descrizione dell’immagine.
+ Ruolo IAM: al ruolo deve essere associata la [AmazonSageMakerFullAccess](https://console.aws.amazon.com/iam/home?#/policies/arn:aws:iam::aws:policy/AmazonSageMakerFullAccess)policy. Usa il menu a discesa per selezionare una delle seguenti opzioni:
+ Crea un nuovo ruolo – specifica eventuali bucket Amazon Simple Storage Service (Amazon S3) a cui desideri che i tuoi notebook abbiano accesso. Se preferisci non consentire l'accesso ad altri bucket, scegli **Nessuno**.
SageMaker L'intelligenza artificiale associa la `AmazonSageMakerFullAccess` policy al ruolo. Il ruolo consente agli utenti dei notebook di accedere ai bucket Amazon S3 elencati accanto ai segni di spunta.
+ Inserisci un ARN personalizzato per il ruolo IAM: inserisci il nome della risorsa Amazon (ARN) del ruolo IAM.
+ Usa un ruolo esistente: scegli dell’elenco uno dei tuoi ruoli già esistenti.
+ (Facoltativo) Tagga l’immagine: scegli **Aggiungi nuovo tag**. Puoi aggiungere fino a 50 tag. I tag sono ricercabili utilizzando la console SageMaker AI o l'`Search`API SageMaker AI.
1. In **Tipo di immagine**, seleziona RStudio immagine.
1. Seleziona **Invia**.
La nuova immagine viene visualizzata nell'elenco **Immagini personalizzate** ed evidenziata per qualche secondo. Una volta che l'immagine è stata creata con successo, puoi scegliere il nome dell'immagine per visualizzarne le proprietà o scegliere **Crea versione** per crearne un'altra versione.
**Per creare un'altra versione dell'immagine**
1. Scegli **Crea versione** sulla stessa riga dell'immagine.
1. In **Origine immagine**, inserisci il percorso di registrazione dell'immagine Amazon ECR. L'immagine non deve essere la stessa utilizzata in una versione precedente dell'immagine SageMaker AI.
Per utilizzare l'immagine personalizzata in RStudio, devi allegarla al tuo dominio. Per ulteriori informazioni, consulta [Allega un' SageMaker immagine personalizzata](rstudio-byoi-attach.md).
## Crea un'immagine da AWS CLI
Questa sezione mostra come creare un' SageMaker immagine Amazon personalizzata utilizzando AWS CLI.
Utilizza i seguenti passaggi per creare un' SageMaker immagine:
+ Creazione di `Image`.
+ Creazione di `ImageVersion`.
+ Creazione di un file di configurazione.
+ Creazione di `AppImageConfig`.
**Per creare le entità SageMaker dell'immagine**
1. Crea un' SageMaker immagine. Il ruolo ARN deve avere almeno la policy collegata `AmazonSageMakerFullAccessPolicy`.
```
aws sagemaker create-image \
--image-name rstudio-custom-image \
--role-arn arn:aws:iam:::role/service-role/
```
Risposta:
```
{
"ImageArn": "arn:aws:sagemaker:us-east-2:acct-id:image/rstudio-custom-image"
}
```
1. Crea una versione SageMaker dell'immagine dall'immagine. Passa il valore di tag univoco che hai scelto quando hai inviato l'immagine ad Amazon ECR.
```
aws sagemaker create-image-version \
--image-name rstudio-custom-image \
--base-image :
```
Risposta:
```
{
"ImageVersionArn": "arn:aws:sagemaker:us-east-2:acct-id:image-version/rstudio-image/1"
}
```
1. Verifica che la versione dell'immagine sia stata creata correttamente.
```
aws sagemaker describe-image-version \
--image-name rstudio-custom-image \
--version 1
```
Risposta:
```
{
"ImageVersionArn": "arn:aws:sagemaker:us-east-2:acct-id:image-version/rstudio-custom-image/1",
"ImageVersionStatus": "CREATED"
}
```
**Nota**
Se l’esito è `"ImageVersionStatus": "CREATED_FAILED"`, l’esito include anche il motivo dell'errore. Un problema di autorizzazioni è una causa di errore comune. Puoi anche controllare i tuoi Amazon CloudWatch Logs. Il nome del gruppo di log è `/aws/sagemaker/studio`. Il nome del flusso di log è `$domainID/$userProfileName/KernelGateway/$appName`.
1. Creazione di un file di configurazione denominato `app-image-config-input.json`. L'app image config viene utilizzata per la configurazione dell'esecuzione di un' SageMaker immagine come applicazione Kernel Gateway.
```
{
"AppImageConfigName": "rstudio-custom-config"
}
```
1. Crea il file AppImageConfig utilizzando il file creato nel passaggio precedente.
```
aws sagemaker create-app-image-config \
--cli-input-json file://app-image-config-input.json
```
Risposta:
```
{
"AppImageConfigArn": "arn:aws:sagemaker:us-east-2:acct-id:app-image-config/r-image-config"
}
```