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à.

# Integra SOCI-indexed le immagini con l'esempio di Studio
<a name="soci-indexing-example-integrate-studio"></a>

È necessario fare riferimento al tag SOCI-indexed dell'immagine per utilizzare SOCI-indexed le immagini in Studio, anziché al tag dell'immagine del contenitore originale. Utilizzate il tag specificato durante il processo di conversione SOCI (ad esempio, `SOCI_IMAGE_TAG` in[Crea indici SOCI con l'esempio nerdctl e SOCI CLI](soci-indexing-example-create-indexes.md)).

**Esempio di integra SOCI-indexed immagini**

1. Per prima cosa imposta le variabili per i AWS CLI comandi che seguono. Di seguito è riportato un esempio di impostazione delle variabili.

   ```
   ACCOUNT_ID="{{111122223333}}"
   REGION="{{us-east-1}}"
   IMAGE_NAME="{{sagemaker-image-name}}"
   IMAGE_CONFIG_NAME="{{sagemaker-image-config-name}}"
   ROLE_ARN="{{your-role-arn}}"
   DOMAIN_ID="{{domain-id}}"
   SOCI_IMAGE_TAG="{{soci-indexed-image-tag}}"
   ```

   Definizioni delle variabili:
   + `ACCOUNT_ID`è il tuo Account AWS ID
   + `REGION`è il Regione AWS tuo registro privato Amazon ECR
   + `IMAGE_NAME`è il nome della tua immagine SageMaker 
   + `IMAGE_CONFIG_NAME`è il nome della configurazione SageMaker dell'immagine
   + `ROLE_ARN`[è l'ARN del ruolo di esecuzione con le autorizzazioni elencate in Autorizzazioni IAM richieste](soci-indexing-setup.md#soci-indexing-setup-iam-permissions)
   + `DOMAIN_ID`[è l'ID del dominio](https://docs.aws.amazon.com/sagemaker/latest/dg/domain-view.html)
**Nota**  
Se stai allegando l'immagine a un progetto SageMaker Unified Studio e hai bisogno di chiarimenti su quale dominio utilizzare, consulta [Visualizzare i dettagli del dominio SageMaker AI associato al](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/view-project-details.html#view-project-details-smai-domain) tuo progetto.
   + `SOCI_IMAGE_TAG`è il tag della tua immagine SOCI-indexed 

1. Esporta la tua regione:

   ```
   export AWS_REGION=$REGION
   ```

1. Crea un' SageMaker immagine:

   ```
   aws sagemaker create-image \
       --image-name "$IMAGE_NAME" \
       --role-arn "$ROLE_ARN"
   ```

1. Crea una versione SageMaker dell'immagine utilizzando l'URI dell'indice SOCI:

   ```
   IMAGE_INDEX_URI="$ACCOUNT_ID.dkr.ecr.$REGION.amazonaws.com/$IMAGE_NAME:$SOCI_IMAGE_TAG"
   
   aws sagemaker create-image-version \
       --image-name "$IMAGE_NAME" \
       --base-image "$IMAGE_INDEX_URI"
   ```

1. Crea una configurazione dell'immagine dell'applicazione e aggiorna il tuo dominio Amazon SageMaker AI per includere l'immagine personalizzata per la tua app. Puoi farlo per Code Editor, basato su Code-OSS Visual Studio Code - Open Source (Code Editor) e JupyterLab applicazioni. Scegli l'opzione di applicazione qui sotto per visualizzare i passaggi.

------
#### [ Code Editor ]

   Crea una configurazione dell'immagine dell'applicazione per Code Editor:

   ```
   aws sagemaker create-app-image-config \
       --app-image-config-name "$IMAGE_CONFIG_NAME" \
       --code-editor-app-image-config '{ "FileSystemConfig": { "MountPath": "/home/sagemaker-user", "DefaultUid": 1000, "DefaultGid": 100 } }'
   ```

   Aggiorna il tuo dominio Amazon SageMaker AI per includere l'immagine personalizzata per Code Editor:

   ```
   aws sagemaker update-domain \
       --domain-id "$DOMAIN_ID" \
       --default-user-settings '{
           "CodeEditorAppSettings": {
           "CustomImages": [{
               "ImageName": "$IMAGE_NAME", 
               "AppImageConfigName": "$IMAGE_CONFIG_NAME"
           }]
       }
   }'
   ```

------
#### [ JupyterLab ]

   Crea una configurazione dell'immagine dell'applicazione per JupyterLab:

   ```
   aws sagemaker create-app-image-config \
       --app-image-config-name "$IMAGE_CONFIG_NAME" \
       --jupyter-lab-app-image-config '{ "FileSystemConfig": { "MountPath": "/home/sagemaker-user", "DefaultUid": 1000, "DefaultGid": 100 } }'
   ```

   Aggiorna il tuo dominio Amazon SageMaker AI per includere l'immagine personalizzata per JupyterLab:

   ```
   aws sagemaker update-domain \
       --domain-id "$DOMAIN_ID" \
       --default-user-settings '{
           "JupyterLabAppSettings": {
           "CustomImages": [{
               "ImageName": "$IMAGE_NAME", 
               "AppImageConfigName": "$IMAGE_CONFIG_NAME"
           }]
       }
   }'
   ```

------

1. Dopo aver aggiornato il dominio per includere l'immagine personalizzata, puoi creare un'applicazione in Studio utilizzando l'immagine personalizzata. Quando ti [Avvio di un’immagine personalizzata in Studio](studio-updated-byoi-how-to-launch.md) assicuri di utilizzare l'immagine personalizzata.