Allega l' SageMaker immagine a un dominio Allega l' SageMaker immagine a uno spazio condiviso Visualizzazione dell'immagine collegata

Allega un' SageMaker immagine personalizzata in Amazon SageMaker Studio Classic

Importante

Le politiche IAM personalizzate che consentono ad Amazon SageMaker Studio o Amazon SageMaker Studio Classic di creare SageMaker risorse Amazon 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 l'etichettatura, possono verificarsi errori durante il tentativo di creare risorse. AccessDenied Per ulteriori informazioni, consulta Fornisci le autorizzazioni per etichettare SageMaker le risorse AI.

AWS politiche gestite per Amazon AI SageMakerche forniscono le autorizzazioni per creare SageMaker risorse includono già le autorizzazioni per aggiungere tag durante la creazione di tali risorse.

Nota

Al 30 novembre 2023, la precedente esperienza con Amazon SageMaker Studio è ora denominata 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 Studio SageMaker.

Studio Classic è ancora gestito per i carichi di lavoro esistenti ma non è più disponibile per l'onboarding. È possibile interrompere o eliminare solo le applicazioni Studio Classic esistenti e non è possibile crearne di nuove. Ti consigliamo di migrare il carico di lavoro alla nuova esperienza di Studio.

Per utilizzare un' SageMaker immagine personalizzata, devi allegare una versione dell'immagine al tuo dominio o allo spazio condiviso. Quando si allega una versione dell'immagine, questa viene visualizzata in SageMaker Studio Classic Launcher ed è disponibile nell'elenco a discesa Seleziona immagine, che gli utenti utilizzano per avviare un'attività o modificare l'immagine utilizzata da un taccuino.

Per rendere disponibile SageMaker un'immagine personalizzata a tutti gli utenti all'interno di un dominio, è necessario allegare l'immagine al 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 alleghi un'immagine, SageMaker AI utilizza la versione più recente dell'immagine per impostazione predefinita. È inoltre possibile collegare una versione specifica dell'immagine. Dopo aver allegato la versione, puoi sceglierla da SageMaker AI Launcher 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 allegare un' SageMaker immagine personalizzata al tuo dominio utilizzando la console SageMaker AI o il. AWS CLI Puoi collegare un’immagine personalizzata a uno spazio condiviso solo utilizzando la AWS CLI.

Allega l' SageMaker immagine a un dominio

Allega l' SageMaker immagine usando la console

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

Per collegare un'immagine esistente

Apri la console Amazon SageMaker AI all'indirizzo https://console.aws.amazon.com/sagemaker/.
Nel riquadro di navigazione a sinistra, scegli Configurazioni admin.
In Configurazioni di amministrazione, scegli Domini.
Nella pagina Domini, seleziona il dominio a cui collegare l’immagine.
Dalla pagina Dettagli del dominio, seleziona la scheda Ambiente.
Nella scheda Ambiente, in Immagini personalizzate SageMaker Studio Classic allegate al dominio, scegli Allega immagine.
In Origine dell’immagine, scegli Immagine esistente.
Seleziona un’immagine esistente dall'elenco.
Seleziona una versione dell'immagine dall'elenco.
Seleziona Successivo.
Verifica i valori per Nome dell’immagine, Nome visualizzato dell’immagine e Descrizione.
Seleziona il ruolo IAM. Per ulteriori informazioni, consulta Crea un' SageMaker immagine personalizzata per Amazon Studio Classic SageMaker.
(Facoltativo) Aggiunta di tag all'immagine.
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.
Per Tipo di immagine, seleziona Immagine SageMaker Studio
In Nome kernel, inserisci nell’immagine il nome di un kernel esistente. Per informazioni su come ottenere le informazioni sul kernel dall'immagine, vedere SVILUPPO nel repository SageMaker Studio Classic Custom Image Samples. Per ulteriori informazioni, consulta le sezioni Kernel discovery e User data di Specifiche SageMaker delle immagini personalizzate per Amazon Studio Classic SageMaker.
(Facoltativo) In Nome di visualizzazione del kernel, inserisci il nome visualizzato per il kernel.
Scegli Aggiungi kernel.
Seleziona 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.

Allega l' SageMaker immagine usando AWS CLI

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

Allega l' SageMaker immagine 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 allegare l' SageMaker immagine personalizzata, procedi nel seguente modo:

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' SageMaker immagine personalizzata al tuo dominio

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

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"
]

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"
}

Crea il dominio con l' SageMaker immagine personalizzata allegata.


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/..."
}

Allega l' SageMaker immagine al tuo dominio attuale

Se hai effettuato l'onboarding su un dominio SageMaker AI, puoi allegare l'immagine personalizzata al tuo dominio attuale. 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 su come eliminare le app, consulta Elimina un dominio Amazon SageMaker AI.

Per aggiungere l' SageMaker immagine al dominio corrente, procedi nel seguente modo.

Scarica la tua 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' SageMaker immagine personalizzata al tuo dominio

Apri la console Amazon SageMaker AI all'indirizzo https://console.aws.amazon.com/sagemaker/.
Nel riquadro di navigazione a sinistra, scegli Configurazioni admin.
In Configurazioni di amministrazione, scegli Domini.
Nella pagina Domini, seleziona il dominio a cui collegare l’immagine.
Dalla pagina Dettagli del dominio, seleziona la scheda Impostazioni del dominio.
Nella scheda Impostazioni del dominio, in Impostazioni generali, trova DomainId. L'ID è nel formato seguente: d-xxxxxxxxxxxx.

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": [
        ],
        ...
      }
    }
}

Salva la sezione delle impostazioni utente predefinite del risultato in un file denominato default-user-settings.json.

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"
              }
           ],
           ...
        }
    }
}

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"
}

Allega l' SageMaker immagine a uno spazio condiviso

È possibile allegare l' SageMaker immagine a uno spazio condiviso solo utilizzando 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 Elimina un dominio Amazon SageMaker AI.

Per aggiungere l' SageMaker immagine a uno spazio condiviso, procedi nel seguente modo.

Scarica il tuo 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' SageMaker immagine personalizzata al tuo spazio condiviso

Apri la console Amazon SageMaker AI all'indirizzo https://console.aws.amazon.com/sagemaker/.
Nel riquadro di navigazione a sinistra, scegli Configurazioni admin.
In Configurazioni di amministrazione, scegli Domini.
Nella pagina Domini, seleziona il dominio a cui collegare l’immagine.
Dalla pagina Dettagli del dominio, seleziona la scheda Impostazioni del dominio.
Nella scheda Impostazioni del dominio, in Impostazioni generali, trova DomainId. L'ID è nel formato seguente: d-xxxxxxxxxxxx.

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": [
        ],
        ...
      }
    }
}

Salva la sezione delle impostazioni spazio predefinite che visualizzi nel risultato in un file denominato default-space-settings.json.


{
    "DefaultSpaceSettings": {
        "KernelGatewayAppSettings": { 
           "CustomImages": [ 
              { 
                 "ImageName": "string",
                 "AppImageConfigName": "string"
              }
           ],
           ...
        }
    }
}

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"
}

Visualizza l'immagine allegata in SageMaker AI

Dopo aver creato l' SageMaker immagine personalizzata e averla allegata al dominio, l'immagine viene visualizzata nella scheda Ambiente del dominio. È possibile visualizzare le immagini allegate per gli spazi condivisi solo AWS CLI utilizzando il seguente comando.


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

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Crea un' SageMaker immagine

Avvio di un’immagine personalizzata