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à.
# Come utilizzare la tua immagine
Le pagine seguenti descrivono come utilizzare la tua immagine personalizzata. Verifica che i prerequisiti seguenti siano soddisfatti prima di continuare.
## Prerequisiti
Dovrai completare i seguenti prerequisiti per portare la tua immagine su Amazon SageMaker AI.
+ Configura l’applicazione Docker. Per ulteriori informazioni, consulta la sezione [Get started](https://docs.docker.com/get-started/) nella *documentazione Docker*.
+ Installa la versione più recente AWS CLI seguendo la procedura [descritta AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) nella *Guida per l'AWS Command Line Interface utente della versione 2*.
+ Autorizzazioni per accedere al servizio Amazon Elastic Container Registry (Amazon ECR). Per ulteriori informazioni, consulta [Amazon ECR Managed Policies](https://docs.aws.amazon.com/AmazonECR/latest/userguide/ecr_managed_policies.html) in *Amazon ECR User Guide*.
+ Un AWS Identity and Access Management ruolo a cui è allegata la [AmazonSageMakerFullAccess](https://console.aws.amazon.com/iam/home?#/policies/arn:aws:iam::aws:policy/AmazonSageMakerFullAccess)politica.
**Topics**
+ [Prerequisiti](#studio-updated-byoi-how-to-prerequisites)
+ [Creazione di un’immagine personalizzata e invio ad Amazon ECR](studio-updated-byoi-how-to-prepare-image.md)
+ [Collegamento dell’immagine personalizzata al dominio](studio-updated-byoi-how-to-attach-to-domain.md)
+ [Aggiornamento della configurazione del container](studio-updated-byoi-how-to-container-configuration.md)
# Creazione di un’immagine personalizzata e invio ad Amazon ECR
Questa pagina fornisce istruzioni su come creare un Dockerfile locale, elaborare l’immagine del container e aggiungere l’immagine ad Amazon Elastic Container Registry (Amazon ECR).
**Nota**
Negli esempi seguenti, i tag non sono specificati, quindi il tag `latest` viene applicato per impostazione predefinita. Se desideri specificare un tag, dovrai aggiungere `:tag` alla fine dei nomi delle immagini. Per ulteriori informazioni, consulta [docker image tag](https://docs.docker.com/reference/cli/docker/image/tag/) nella *documentazione Docker*.
**Topics**
+ [Creazione di un Dockerfile e di un’immagine del container](#studio-updated-byoi-how-to-create-local-dockerfile)
+ [Aggiunta di un’immagine Docker ad Amazon ECR](#studio-updated-byoi-add-container-image)
## Creazione di un Dockerfile e di un’immagine del container
Utilizza le istruzioni seguenti per creare un Dockerfile con il software e le dipendenze desiderati.
**Per creare il tuo Dockerfile**
1. Imposta innanzitutto le variabili per i AWS CLI comandi che seguono.
```
LOCAL_IMAGE_NAME=local-image-name
```
`local-image-name` è il nome dell’immagine del container sul dispositivo locale, che viene definito in questa sede.
1. Crea un documento basato su testo, denominato `Dockerfile`, che soddisfi le specifiche descritte in [Specifiche dell’immagine personalizzata](studio-updated-byoi-specs.md).
Gli esempi di `Dockerfile` per le applicazioni supportate sono disponibili in [Esempi di Dockerfile](studio-updated-byoi-specs.md#studio-updated-byoi-specs-dockerfile-templates).
**Nota**
Se stai trasferendo la tua immagine in SageMaker Unified Studio, dovrai seguire le [specifiche di Dockerfile nella Guida](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html) per l'utente di *Amazon SageMaker Unified* Studio.
`Dockerfile`alcuni esempi di SageMaker Unified Studio sono disponibili nell'[esempio di Dockerfile](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html#byoi-specifications-example) nella *Amazon SageMaker Unified* Studio User Guide.
1. Nella directory che contiene `Dockerfile`, crea l’immagine Docker con il comando seguente. Il punto (`.`) specifica che `Dockerfile` deve trovarsi nel contesto del comando build.
```
docker build -t ${LOCAL_IMAGE_NAME} .
```
Una volta completata l’operazione build, puoi elencare le informazioni sull’immagine del container con il comando seguente.
```
docker images
```
1. (Facoltativo) Puoi testare l’immagine con il comando seguente.
```
docker run -it ${LOCAL_IMAGE_NAME}
```
Nell’output vedrai che il tuo server è in esecuzione su un URL, ad esempio `http://127.0.0.1:8888/...`. Puoi testare l’immagine copiando l’URL nel browser.
Se non funziona, potrebbe essere necessario includere `-p port:port` nel comando docker run. L’opzione mappa la porta esposta sul container alla porta sul sistema host. Per ulteriori informazioni su docker run, consulta la sezione [Running container](https://docs.docker.com/engine/containers/run/) nella *documentazione Docker*.
Dopo aver verificato il funzionamento del server, puoi arrestarlo e chiudere tutti i kernel prima di continuare. Le istruzioni sono disponibili nell’output.
## Aggiunta di un’immagine Docker ad Amazon ECR
Per aggiungere un’immagine del container ad Amazon ECR, procedi come segue.
+ Crea un repository Amazon ECR.
+ Accedi al registro predefinito.
+ Inserisci l'immagine nel repository Amazon ECR.
**Nota**
L'archivio Amazon ECR deve trovarsi nello Regione AWS stesso dominio a cui alleghi l'immagine.
**Per creare e inviare un’immagine del container ad Amazon ECR**
1. Per prima cosa imposta le variabili per i AWS CLI comandi che seguono.
```
ACCOUNT_ID=account-id
REGION=aws-region
ECR_REPO_NAME=ecr-repository-name
```
+ `account-id` è l’ID del tuo account. Puoi trovarlo in alto a destra in qualsiasi pagina della AWS console. Ad esempio, la [console SageMaker AI](https://console.aws.amazon.com/sagemaker).
+ `aws-region`è il dominio Amazon SageMaker AI Regione AWS del tuo dominio Amazon. Puoi trovarlo in alto a destra in qualsiasi pagina della AWS console.
+ `ecr-repository-name` è il nome del tuo repository Amazon Elastic Container Registry, che viene definito in questa sede. Per visualizzare i tuoi repository Amazon ECR, passa alla [console di Amazon ECR](https://console.aws.amazon.com/ecr).
1. Accedi ad Amazon ECR, quindi a Docker.
```
aws ecr get-login-password \
--region ${REGION} | \
docker login \
--username AWS \
--password-stdin ${ACCOUNT_ID}.dkr.ecr.${REGION}.amazonaws.com
```
Una volta completata l’autenticazione, riceverai un messaggio di conferma dell’accesso.
**Importante**
Se ricevi un errore, potresti dover installare la AWS CLI o aggiornarla alla versione più recente. Per ulteriori informazioni, consulta [Installazione dell’ AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) nella *Guida per l’utente dell’AWS Command Line Interface *.
1. Tagga l’immagine in un formato compatibile con Amazon ECR per inviarla al tuo repository.
```
docker tag \
${LOCAL_IMAGE_NAME} \
${ACCOUNT_ID}.dkr.ecr.${REGION}.amazonaws.com/${ECR_REPO_NAME}
```
1. Crea un repository in Amazon ECR tramite la AWS CLI. Per creare il repository utilizzando la console di Amazon ECR, consulta [Creating an Amazon ECR private repository to store images](https://docs.aws.amazon.com/AmazonECR/latest/userguide/repository-create.html).
```
aws ecr create-repository \
--region ${REGION} \
--repository-name ${ECR_REPO_NAME}
```
1. Invia l’immagine al tuo repository Amazon ECR. Puoi anche taggare l’immagine Docker.
```
docker push ${ACCOUNT_ID}.dkr.ecr.${REGION}.amazonaws.com/${ECR_REPO_NAME}
```
Una volta aggiunta correttamente l’immagine al repository Amazon ECR, puoi visualizzarla nella [console di Amazon ECR](https://console.aws.amazon.com/ecr).
# Collegamento dell’immagine personalizzata al dominio
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*.
# Aggiornamento della configurazione del container
Puoi utilizzare immagini Docker personalizzate nei tuoi flussi di lavoro di machine learning. Un aspetto chiave della personalizzazione di queste immagini è la configurazione del container, o [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ContainerConfig.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ContainerConfig.html). La pagina seguente fornisce un esempio di come configurare `ContainerConfig`.
Un punto di ingresso corrisponde al comando o allo script eseguito all’avvio del container. I punti di ingresso personalizzati consentono di configurare l’ambiente, inizializzare i servizi o completare le configurazioni necessarie prima dell’avvio dell’applicazione.
Questo esempio fornisce istruzioni su come configurare un punto di ingresso personalizzato, per la tua JupyterLab applicazione, utilizzando il. AWS CLI Questo esempio presuppone che tu abbia già creato un’immagine personalizzata e un dominio. Per istruzioni, consulta [Collegamento dell’immagine personalizzata al dominio](studio-updated-byoi-how-to-attach-to-domain.md).
1. Imposta innanzitutto le variabili per i AWS CLI comandi che seguono.
```
APP_IMAGE_CONFIG_NAME=app-image-config-name
ENTRYPOINT_FILE=entrypoint-file-name
ENV_KEY=environment-key
ENV_VALUE=environment-value
REGION=aws-region
DOMAIN_ID=domain-id
IMAGE_NAME=custom-image-name
IMAGE_VERSION=custom-image-version
```
+ `app-image-config-name` è il nome della configurazione dell’immagine dell’applicazione.
+ `entrypoint-file-name` è il nome dello script del punto di ingresso del container. Ad esempio, `entrypoint.sh`.
+ `environment-key` è il nome di una variabile di ambiente.
+ `environment-value` è il valore assegnato alla variabile di ambiente.
+ `aws-region`è il dominio Amazon SageMaker AI Regione AWS del tuo dominio Amazon. Puoi trovarlo in alto a destra in qualsiasi pagina della AWS console.
+ `domain-id` è il tuo ID dominio. Per visualizzare i tuoi domini, consulta [Visualizzazione dei domini](domain-view.md).
+ `custom-image-name` è il nome dell’immagine personalizzata. Per visualizzare i dettagli dell’immagine personalizzata, consulta [Visualizzazione dei dettagli dell’immagine personalizzata (console)](studio-updated-byoi-view-images.md#studio-updated-byoi-view-images-console).
Se hai seguito le istruzioni riportate in [Collegamento dell’immagine personalizzata al dominio](studio-updated-byoi-how-to-attach-to-domain.md), potresti voler utilizzare lo stesso nome dell’immagine indicato nella procedura.
+ `custom-image-version` è il numero della versione dell’immagine personalizzata. Dovrebbe essere un numero intero, che rappresenta la versione dell’immagine. Per visualizzare i dettagli dell’immagine personalizzata, consulta [Visualizzazione dei dettagli dell’immagine personalizzata (console)](studio-updated-byoi-view-images.md#studio-updated-byoi-view-images-console).
1. Utilizza l’API [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateAppImageConfig.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateAppImageConfig.html) per creare una configurazione dell’immagine.
```
aws sagemaker create-app-image-config \
--region ${REGION} \
--app-image-config-name "${APP_IMAGE_CONFIG_NAME}" \
--jupyter-lab-app-image-config "ContainerConfig = {
ContainerEntrypoint = "${ENTRYPOINT_FILE}",
ContainerEnvironmentVariables = {
"${ENV_KEY}"="${ENV_VALUE}"
}
}"
```
1. Utilizza l’API [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateDomain.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateDomain.html) per aggiornare le impostazioni predefinite per il tuo dominio. In questo modo, verranno collegate sia l’immagine personalizzata che la configurazione dell’immagine dell’applicazione.
```
aws sagemaker update-domain \
--region ${REGION} \
--domain-id "${DOMAIN_ID}" \
--default-user-settings "{
\"JupyterLabAppSettings\": {
\"CustomImages\": [
{
\"ImageName\": \"${IMAGE_NAME}\",
\"ImageVersionNumber\": ${IMAGE_VERSION},
\"AppImageConfigName\": \"${APP_IMAGE_CONFIG_NAME}\"
}
]
}
}"
```