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 immagini indicizzate SOC con l'esempio di Studio
<a name="soci-indexing-example-integrate-studio"></a>

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

**Esempio di integrazione di immagini indicizzate SOCI**

1. Per prima cosa imposta le variabili per i comandi che AWS CLI 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 indicizzata SOC

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.