Collegamento di un’immagine SageMaker personalizzata in Amazon SageMaker Studio Classic - Amazon SageMaker AI

Collegamento di un’immagine SageMaker personalizzata in Amazon SageMaker Studio Classic

Importante

Le policy IAM personalizzate che consentono ad Amazon SageMaker Studio o Amazon SageMaker Studio Classic di creare risorse Amazon SageMaker 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 il tagging, possono verificarsi errori di tipo “AccessDenied” quando provi a creare le risorse. Per ulteriori informazioni, consulta Concessione delle autorizzazioni per il tagging delle risorse SageMaker AI.

Policy gestite da AWS per Amazon SageMaker AI, che forniscono autorizzazioni per creare risorse SageMaker, includono già le autorizzazioni per aggiungere tag durante la creazione di tali risorse.

Importante

A partire dal 30 novembre 2023, la precedente esperienza Amazon SageMaker Studio ha cambiato nome in Amazon SageMaker Studio Classic. La sezione seguente è specifica per l’utilizzo dell’applicazione Studio Classic. Per informazioni sull’utilizzo dell’esperienza Studio aggiornata, consulta Amazon SageMaker Studio.

Per utilizzare un'immagine SageMaker personalizzata, è necessario collegare una versione dell'immagine al dominio o allo spazio condiviso. Quando colleghi una versione dell’immagine, questa viene visualizzata nell’utilità di avvio di SageMaker Studio Classic ed è disponibile nell’elenco a discesa Seleziona immagine, che gli utenti utilizzano per avviare un’attività o modificare l’immagine utilizzata da un notebook.

Collegando un’immagine Sagemaker personalizzata a un dominio, la si rende disponibile a tutti gli utenti all'interno di quel dominio. Collegando un’immagine a uno spazio condiviso, la si rende disponibile a tutti gli utenti all'interno di quello spazio condiviso. Collegando un’immagine a un profilo utente, la si rende disponibile a quel singolo utente. Quando colleghi un’immagine, per impostazione predefinita SageMaker AI utilizza la versione più recente dell’immagine. È inoltre possibile collegare una versione specifica dell'immagine. Dopo aver collegato la versione, puoi selezionarla dall’utilità di avvio di SageMaker AI o dal selettore di immagini quando avvii un notebook.

Il numero di versioni dell’immagine che si possono collegare in un dato momento è limitato. Una volta raggiunto il limite, dovrai scollegare una versione per collegare un'altra versione dell'immagine.

Le sezioni seguenti mostrano come collegare un’immagine SageMaker personalizzata al dominio utilizzando la console SageMaker AI o la AWS CLI. Puoi collegare un’immagine personalizzata a uno spazio condiviso solo utilizzando la AWS CLI.

Collegamento dell’immagine SageMaker a un dominio

Collegamento dell'immagine SageMaker utilizzando la console

Questo argomento descrive come collegare una versione dell’immagine SageMaker personalizzata esistente al dominio utilizzando il pannello di controllo SageMaker AI. Puoi anche creare un'immagine SageMaker personalizzata e una versione dell'immagine, quindi collegare quella versione al tuo dominio. Per conoscere la procedura per creare un'immagine e una versione dell'immagine, consulta Creazione di un’immagine SageMaker personalizzata in Amazon SageMaker Studio Classic.

Per collegare un'immagine esistente
  1. Apri la console di Amazon SageMaker AI all’indirizzo https://console.aws.amazon.com/sagemaker/.

  2. Nel riquadro di navigazione a sinistra, scegli Configurazioni admin.

  3. In Configurazioni di amministrazione, scegli Domini.

  4. Nella pagina Domini, seleziona il dominio a cui collegare l’immagine.

  5. Dalla pagina Dettagli del dominio, seleziona la scheda Ambiente.

  6. Nella scheda Ambiente, in Immagini SageMaker Studio Classic personalizzate collegate al dominio, scegli Collega immagine.

  7. In Origine dell’immagine, scegli Immagine esistente.

  8. Seleziona un’immagine esistente dall'elenco.

  9. Seleziona una versione dell'immagine dall'elenco.

  10. Seleziona Successivo.

  11. Verifica i valori per Nome dell’immagine, Nome visualizzato dell’immagine e Descrizione.

  12. Seleziona il ruolo IAM. Per ulteriori informazioni, consulta Creazione di un’immagine SageMaker personalizzata in Amazon SageMaker Studio Classic.

  13. (Facoltativo) Aggiunta di tag all'immagine.

  14. Specifica il percorso di montaggio EFS. Si tratta del percorso all'interno dell'immagine dove montare la directory principale Amazon Elastic File System (EFS) dell'utente.

  15. In tipo di immagine, seleziona Immagine SageMaker Studio

  16. In Nome kernel, inserisci nell’immagine il nome di un kernel esistente. Per sapere come recuperare le informazioni sul kernel dall’immagine, consulta DEVELOPMENT nel repository SageMaker Studio Classic Custom Image Samples. Per ulteriori informazioni, consulta le sezioni Kernel discovery e User data di Specifiche dell’immagine SageMaker personalizzata per Amazon SageMaker Studio Classic.

  17. (Facoltativo) In Nome di visualizzazione del kernel, inserisci il nome visualizzato per il kernel.

  18. Scegli Aggiungi kernel.

  19. Scegli Invia.

    1. Attendi che la versione dell'immagine venga collegata al dominio. Una volta collegata, la versione viene visualizzata nella lista Immagini personalizzate ed evidenziata per qualche secondo.

Collegamento dell'immagine SageMaker utilizzando AWS CLI

Le sezioni seguenti mostrano come collegare un'immagine SageMaker personalizzata quando si crea un nuovo dominio o si aggiorna il dominio esistente utilizzando la AWS CLI.

Collegamento dell'immagine SageMaker a un nuovo dominio

La sezione seguente mostra come creare un nuovo dominio collegandovi la versione dell’immagine. Queste fasi richiedono di specificare le informazioni sul cloud privato virtuale (VPC) di Amazon e sul ruolo di esecuzione, necessarie per creare il dominio. Per creare il dominio e collegare l'immagine SageMaker personalizzata segui queste fasi:

  • Ottieni l'ID del VPC e gli ID di sottorete predefiniti.

  • Crea il file di configurazione per il dominio, il quale specifica l'immagine.

  • Crea il dominio con il file di configurazione.

Per aggiungere l'immagine SageMaker personalizzata al tuo dominio
  1. Ottieni l’ID del tuo VPC predefinito.

    aws ec2 describe-vpcs \ --filters Name=isDefault,Values=true \ --query "Vpcs[0].VpcId" --output text

    Il risultato dovrebbe essere simile al seguente.

    vpc-xxxxxxxx
  2. Ottieni i tuoi ID di sottorete predefiniti utilizzando l'ID del VPC ottenuto nella fase precedente.

    aws ec2 describe-subnets \ --filters Name=vpc-id,Values=<vpc-id> \ --query "Subnets[*].SubnetId" --output json

    Il risultato dovrebbe essere simile al seguente.

    [ "subnet-b55171dd", "subnet-8a5f99c6", "subnet-e88d1392" ]
  3. Crea un file di configurazione denominato create-domain-input.json. Inserisci l'ID del VPC, gli ID di sottorete, ImageName, e AppImageConfigName ottenuti dai passaggi precedenti. Poiché ImageVersionNumber non è specificato, si usa la versione più recente dell'immagine, che, in questo caso, è anche l'unica.

    { "DomainName": "domain-with-custom-image", "VpcId": "<vpc-id>", "SubnetIds": [ "<subnet-ids>" ], "DefaultUserSettings": { "ExecutionRole": "<execution-role>", "KernelGatewayAppSettings": { "CustomImages": [ { "ImageName": "custom-image", "AppImageConfigName": "custom-image-config" } ] } }, "AuthMode": "IAM" }
  4. Crea il dominio con l'immagine SageMaker personalizzata collegata.

    aws sagemaker create-domain \ --cli-input-json file://create-domain-input.json

    Il risultato dovrebbe essere simile al seguente.

    { "DomainArn": "arn:aws:sagemaker:us-east-2:acct-id:domain/d-xxxxxxxxxxxx", "Url": "https://d-xxxxxxxxxxxx.studio.us-east-2.sagemaker.aws/..." }

Collegamento dell'immagine SageMaker al tuo dominio corrente

Se hai effettuato l’onboarding in un dominio SageMaker AI, puoi collegare l’immagine personalizzata al tuo dominio corrente. Per ulteriori informazioni sull’onboarding in un dominio SageMaker AI, consulta Panoramica del dominio Amazon SageMaker AI. Non è necessario specificare le informazioni sul VPC e sul ruolo di esecuzione per collegare un'immagine personalizzata al tuo dominio corrente. Dopo aver collegato la versione, devi eliminare tutte le app all’interno del dominio e riaprire Studio Classic. Per informazioni sul come eliminare le app, consulta Eliminazione di un dominio Amazon SageMaker AI.

Per aggiungere l’immagine SageMaker al tuo dominio corrente segui queste fasi.

  • Recupera DomainID dal pannello di controllo SageMaker AI.

  • Usa il DomainID per ottenere DefaultUserSettings per il dominio.

  • Aggiungi ImageName e AppImageConfig come CustomImage a DefaultUserSettings.

  • Aggiornamento del tuo dominio per includere l'immagine personalizzata.

Per aggiungere l'immagine SageMaker personalizzata al tuo dominio
  1. Apri la console di Amazon SageMaker AI all’indirizzo https://console.aws.amazon.com/sagemaker/.

  2. Nel riquadro di navigazione a sinistra, scegli Configurazioni admin.

  3. In Configurazioni di amministrazione, scegli Domini.

  4. Nella pagina Domini, seleziona il dominio a cui collegare l’immagine.

  5. Dalla pagina Dettagli del dominio, seleziona la scheda Impostazioni del dominio.

  6. Nella scheda Impostazioni del dominio, in Impostazioni generali, trova DomainId. L'ID è nel formato seguente: d-xxxxxxxxxxxx.

  7. Utilizza l'ID del dominio per generare la descrizione del dominio.

    aws sagemaker describe-domain \ --domain-id <d-xxxxxxxxxxxx>

    Il risultato dovrebbe essere simile al seguente.

    { "DomainId": "d-xxxxxxxxxxxx", "DefaultUserSettings": { "KernelGatewayAppSettings": { "CustomImages": [ ], ... } } }
  8. Salva la sezione delle impostazioni utente predefinite del risultato in un file denominato default-user-settings.json.

  9. Inserisci ImageName e AppImageConfigName dalle fasi precedenti come immagine personalizzata. Poiché ImageVersionNumber non è specificato, si usa la versione più recente dell'immagine, che, in questo caso, è anche l'unica.

    { "DefaultUserSettings": { "KernelGatewayAppSettings": { "CustomImages": [ { "ImageName": "string", "AppImageConfigName": "string" } ], ... } } }
  10. Utilizza l'ID del dominio e il file delle impostazioni utente predefinite per aggiornare il dominio.

    aws sagemaker update-domain \ --domain-id <d-xxxxxxxxxxxx> \ --cli-input-json file://default-user-settings.json

    Il risultato dovrebbe essere simile al seguente.

    { "DomainArn": "arn:aws:sagemaker:us-east-2:acct-id:domain/d-xxxxxxxxxxxx" }

Collegamento dell'immagine SageMaker a uno spazio condiviso

Puoi collegare l’immagine SageMaker a uno spazio condiviso solo utilizzando la AWS CLI. Dopo aver collegato la versione, devi eliminare tutte le applicazioni all’interno del tuo spazio condiviso e riaprire Studio Classic. Per informazioni su come eliminare le app, consulta Eliminazione di un dominio Amazon SageMaker AI.

Per aggiungere l’immagine SageMaker a uno spazio condiviso segui queste fasi.

  • Recupera DomainID dal pannello di controllo SageMaker AI.

  • Usa il DomainID per ottenere DefaultSpaceSettings per il dominio.

  • Aggiungi ImageName e AppImageConfig come CustomImage a DefaultSpaceSettings.

  • Aggiornamento del tuo dominio per includere l'immagine personalizzata per lo spazio condiviso.

Per aggiungere l'immagine SageMaker personalizzata al tuo spazio condiviso
  1. Apri la console di Amazon SageMaker AI all’indirizzo https://console.aws.amazon.com/sagemaker/.

  2. Nel riquadro di navigazione a sinistra, scegli Configurazioni admin.

  3. In Configurazioni di amministrazione, scegli Domini.

  4. Nella pagina Domini, seleziona il dominio a cui collegare l’immagine.

  5. Dalla pagina Dettagli del dominio, seleziona la scheda Impostazioni del dominio.

  6. Nella scheda Impostazioni del dominio, in Impostazioni generali, trova DomainId. L'ID è nel formato seguente: d-xxxxxxxxxxxx.

  7. Utilizza l'ID del dominio per generare la descrizione del dominio.

    aws sagemaker describe-domain \ --domain-id <d-xxxxxxxxxxxx>

    Il risultato dovrebbe essere simile al seguente.

    { "DomainId": "d-xxxxxxxxxxxx", ... "DefaultSpaceSettings": { "KernelGatewayAppSettings": { "CustomImages": [ ], ... } } }
  8. Salva la sezione delle impostazioni spazio predefinite che visualizzi nel risultato in un file denominato default-space-settings.json.

  9. Inserisci ImageName e AppImageConfigName dalle fasi precedenti come immagine personalizzata. Poiché ImageVersionNumber non è specificato, si usa la versione più recente dell'immagine, che, in questo caso, è anche l'unica.

    { "DefaultSpaceSettings": { "KernelGatewayAppSettings": { "CustomImages": [ { "ImageName": "string", "AppImageConfigName": "string" } ], ... } } }
  10. Utilizza l'ID del dominio e il file delle impostazioni spazio predefinite per aggiornare il dominio.

    aws sagemaker update-domain \ --domain-id <d-xxxxxxxxxxxx> \ --cli-input-json file://default-space-settings.json

    Il risultato dovrebbe essere simile al seguente.

    { "DomainArn": "arn:aws:sagemaker:us-east-2:acct-id:domain/d-xxxxxxxxxxxx" }

Visualizzazione dell’immagine collegata in SageMaker AI

Dopo aver creato l’immagine SageMaker personalizzata e averla collegata al dominio, l’immagine viene visualizzata nella scheda Ambiente del dominio. Puoi visualizzare le immagini collegate per gli spazi condivisi solo utilizzando la AWS CLI con il comando seguente.

aws sagemaker describe-domain \ --domain-id <d-xxxxxxxxxxxx>