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

Allega un'immagine SageMaker AI personalizzata

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 taggano automaticamente tutte le risorse che creano. Se una policy IAM consente a Studio e Studio Classic di creare risorse ma non consente l'aggiunta di tag, si possono verificare errori AccessDenied "" durante il tentativo di creare risorse. Per ulteriori informazioni, consulta Fornisci le autorizzazioni per SageMaker etichettare le risorse AI.

AWS politiche gestite per Amazon SageMaker AIche danno i permessi per creare SageMaker risorse 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 è 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, consultaAmazon SageMaker Studio.

Per utilizzare un'immagine SageMaker AI personalizzata, devi allegare una versione dell'immagine al tuo dominio o spazio condiviso. Quando alleghi 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 un'immagine SageMaker AI personalizzata a tutti gli utenti all'interno di un dominio, allega 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, l' SageMaker IA utilizza la versione più recente dell'immagine per impostazione predefinita. È inoltre possibile collegare una versione specifica dell'immagine. Dopo aver allegato la versione, puoi scegliere la versione 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'immagine SageMaker AI 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'immagine SageMaker AI a un dominio

Allega l'immagine SageMaker AI utilizzando la console

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

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.
Dalla pagina Domini, seleziona il dominio a cui allegare l'immagine.
Dalla pagina Dettagli del dominio, seleziona la scheda Ambiente.
Nella scheda Ambiente, in Immagini Custom 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'immagine SageMaker AI personalizzata.
(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 da 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, vedete SVILUPPO nel repository SageMaker Studio Classic Custom Image Samples. Per ulteriori informazioni, consulta le sezioni Kernel discovery e User data di Specifiche delle immagini SageMaker AI personalizzate.
(Facoltativo) In Nome di visualizzazione del kernel, inserisci il nome visualizzato per il kernel.
Scegli Aggiungi kernel.
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.

Allega l'immagine SageMaker AI usando il AWS CLI

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

Allega l'immagine SageMaker AI 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. Esegui i seguenti passaggi per creare il dominio e allegare l'immagine SageMaker AI personalizzata:

Ottieni l'ID VPC e la sottorete predefiniti. IDs
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 AI 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 la tua sottorete predefinita IDs utilizzando l'ID VPC del passaggio 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 VPC, la sottorete IDs e AppImageConfigName dai passaggi precedenti. ImageName 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'immagine SageMaker AI 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'immagine SageMaker AI al tuo dominio attuale

Se hai effettuato l'onboarding a un dominio SageMaker AI, puoi allegare l'immagine personalizzata al 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 del tuo dominio e riaprire Studio Classic. Per informazioni su come eliminare le app, consulta Eliminare un dominio Amazon SageMaker AI.

Esegui i seguenti passaggi per aggiungere l'immagine SageMaker AI al tuo dominio corrente.

Scaricala 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 AI 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.
Dalla pagina Domini, seleziona il dominio a cui allegare 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'immagine SageMaker AI a uno spazio condiviso

Puoi allegare l'immagine SageMaker AI solo a uno spazio condiviso utilizzando AWS CLI. Dopo aver allegato la versione, è necessario eliminare tutte le applicazioni nello spazio condiviso e riaprire Studio Classic. Per informazioni su come eliminare le app, consulta Eliminare un dominio Amazon SageMaker AI.

Esegui i seguenti passaggi per aggiungere l'immagine SageMaker AI a uno spazio condiviso.

Scaricala 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 AI 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.
Dalla pagina Domini, seleziona il dominio a cui allegare 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'immagine SageMaker AI personalizzata e averla associata al tuo dominio, l'immagine viene visualizzata nella scheda Ambiente del dominio. È possibile visualizzare solo le immagini allegate per gli spazi condivisi AWS CLI utilizzando il comando seguente.


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'immagine SageMaker AI

Avvio di un'immagine personalizzata