

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

# Collegamento dell’immagine personalizzata al dominio
<a name="studio-updated-byoi-how-to-attach-to-domain"></a>

Questa pagina fornisce istruzioni su come collegare l’immagine personalizzata al dominio. Utilizza la seguente procedura per utilizzare la console Amazon SageMaker AI per accedere al tuo dominio e avviare il processo di **collegamento dell'immagine**.

Le seguenti istruzioni presuppongono che tu abbia inviato un'immagine a un repository Amazon ECR nello Regione AWS stesso del tuo dominio. Se non l’hai ancora fatto, consulta [Creazione di un’immagine personalizzata e invio ad Amazon ECR](studio-updated-byoi-how-to-prepare-image.md).

Quando scegli di collegare un’immagine, hai due opzioni:
+ Allega una **nuova immagine**: questa opzione creerà un'immagine e una versione dell'immagine nel tuo archivio di immagini SageMaker AI e quindi le allegherà al tuo dominio.
**Nota**  
Se stai continuando il processo BYOI, utilizza l’opzione **Nuova immagine** da [Creazione di un’immagine personalizzata e invio ad Amazon ECR](studio-updated-byoi-how-to-prepare-image.md).
+ Allega un'**immagine esistente**: se hai già creato l'immagine personalizzata desiderata nell'archivio di immagini SageMaker AI, usa questa opzione. Questa opzione collega un’immagine personalizzata esistente al tuo dominio. Per visualizzare le immagini personalizzate nell'archivio di immagini SageMaker AI, consulta[Visualizzazione dei dettagli dell’immagine personalizzata (console)](studio-updated-byoi-view-images.md#studio-updated-byoi-view-images-console).

------
#### [ New image ]

**Per collegare una nuova immagine al dominio**

1. Apri la [console SageMaker AI](https://console.aws.amazon.com/sagemaker).

1. Espandi la sezione **Configurazioni di amministrazione**, se non l’hai già fatto.

1. In **Configurazioni admin**, scegli **Domini**.

1. Dall’elenco di **domini**, seleziona il dominio a cui collegare l’immagine.
**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.

1. Apri la scheda **Ambiente**.

1. Nella sezione **Immagini personalizzate per app Studio personali**, scegli **Collega immagine**.

1. In **Origine dell’immagine**, scegli **Nuova immagine**.

1. Includi l’URI dell’immagine Amazon ECR. Il formato è il seguente:

   ```
   account-id.dkr.ecr.aws-region.amazonaws.com/repository-name:tag
   ```

   1. Per ottenere l’URI dell’immagine Amazon ECR, accedi alla pagina [Repository privati di Amazon ECR](https://console.aws.amazon.com/ecr/private-registry/repositories).

   1. Scegli il link con il nome del repository.

   1. Scegli l’icona **Copia URI** che corrisponde alla versione dell’immagine (**Tag immagine**).

1. Segui le altre istruzioni per collegare l’immagine personalizzata.
**Nota**  
Assicurati di utilizzare un tipo di applicazione compatibile con il `Dockerfile`. Per ulteriori informazioni, consulta [Esempi di Dockerfile](studio-updated-byoi-specs.md#studio-updated-byoi-specs-dockerfile-templates).

Una volta che l’immagine è stata collegata correttamente al dominio, potrai visualizzarla nella scheda **Ambiente**.

------
#### [ Existing image ]

**Per collegare un’immagine esistente al dominio**

1. [Apri la console AI. SageMaker ](https://console.aws.amazon.com/sagemaker)

1. Espandi la sezione **Configurazioni di amministrazione**, se non l’hai già fatto.

1. In **Configurazioni admin**, scegli **Domini**.

1. Dall’elenco di **domini**, seleziona il dominio a cui collegare l’immagine.
**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.

1. Apri la scheda **Ambiente**.

1. Nella sezione **Immagini personalizzate per app Studio personali**, scegli **Collega immagine**.

1. In **Origine dell’immagine**, scegli **Immagine esistente**.

1. Scegli un'immagine e una versione dell'immagine esistenti dall'archivio di immagini SageMaker AI.

   Se non visualizzi la versione dell’immagine, potresti doverla creare. Per ulteriori informazioni, consulta [Visualizzazione dei dettagli dell’immagine personalizzata (console)](studio-updated-byoi-view-images.md#studio-updated-byoi-view-images-console).

1. Segui le altre istruzioni per collegare l’immagine personalizzata.
**Nota**  
Assicurati di utilizzare un tipo di applicazione compatibile con il `Dockerfile`. Per ulteriori informazioni, consulta [Esempi di Dockerfile](studio-updated-byoi-specs.md#studio-updated-byoi-specs-dockerfile-templates).

Una volta che l’immagine è stata collegata correttamente al dominio, potrai visualizzarla nella scheda **Ambiente**.

------

Una volta che l’immagine è stata collegata correttamente al dominio, gli utenti del dominio possono scegliere l’immagine per la propria applicazione. Per ulteriori informazioni, consulta [Avvio di un’immagine personalizzata in Studio](studio-updated-byoi-how-to-launch.md).

**Nota**  
Se hai allegato un'immagine personalizzata al tuo progetto SageMaker Unified Studio, dovrai avviare l'applicazione da SageMaker Unified Studio. Per ulteriori informazioni, consulta [Launch your custom image](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-launch-custom-image.html) nella *Amazon SageMaker Unified Studio User Guide*.