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

Allega un' SageMaker immagine personalizzata

Importante

IAMLe politiche 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 IAM politica 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 etichettare le risorse SageMaker.

AWS Policy gestite per Amazon SageMakerche concedono le autorizzazioni 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' SageMaker immagine 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' SageMaker 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, per impostazione predefinita SageMaker utilizza la versione più recente dell'immagine. È inoltre possibile collegare una versione specifica dell'immagine. Dopo aver allegato la versione, è possibile scegliere la versione dal SageMaker Launcher o dal selettore di immagini quando si avvia 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 dominio utilizzando la SageMaker console 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 utilizzando la console

Questo argomento descrive come allegare una versione di SageMaker immagine personalizzata esistente al dominio utilizzando il pannello SageMaker di controllo. Puoi anche creare un' SageMaker immagine 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 personalizzata SageMaker .

Per collegare un'immagine esistente

Apri la SageMaker console Amazon 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.
Scegli il IAM ruolo. Per ulteriori informazioni, consulta Crea un'immagine personalizzata SageMaker .
(Facoltativo) Aggiunta di tag all'immagine.
Specificate il percorso di EFS montaggio. Questo è il percorso all'interno dell'immagine per montare la home directory 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, DEVELOPMENTconsultate l'archivio SageMaker Studio Classic Custom Image Samples. Per ulteriori informazioni, consulta le sezioni Kernel discovery e User data di Specifiche SageMaker dell'immagine 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' SageMaker immagine usando il AWS CLI

Nelle sezioni seguenti viene illustrato 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. Questi passaggi richiedono di specificare le informazioni di Amazon Virtual Private Cloud (VPC) e il ruolo di esecuzione necessari per creare il dominio. Esegui i seguenti passaggi per creare il dominio e allegare l' SageMaker immagine personalizzata:

Ottieni l'VPCID e la sottorete IDs 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 il tuo VPC ID 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'VPCID 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'VPCID, la sottorete IDs e AppImageConfigName i 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' 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 a un SageMaker dominio, puoi allegare l'immagine personalizzata al dominio corrente. Per ulteriori informazioni sull'onboarding di un SageMaker dominio, consulta. Panoramica SageMaker del dominio Amazon Non è necessario specificare le VPC informazioni e il ruolo di esecuzione quando si allega un'immagine personalizzata al 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 SageMaker dominio Amazon.

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

Scaricala DomainID dal pannello SageMaker di controllo.
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 SageMaker console Amazon 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' SageMaker immagine a uno spazio condiviso

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

Per aggiungere l' SageMaker immagine a uno spazio condiviso, effettuate le seguenti operazioni.

Scaricala DomainID dal pannello SageMaker di controllo.
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 SageMaker console Amazon 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

Dopo aver creato l' SageMaker immagine personalizzata e averla associata al 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

Creare un' SageMaker immagine

Avvio di un'immagine personalizzata