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.

Questa guida mostra come allegare un' RStudio immagine personalizzata al tuo dominio Amazon SageMaker AI utilizzando la console SageMaker AI o il AWS Command Line Interface (AWS CLI).

Per utilizzare un'immagine SageMaker AI personalizzata, devi allegare un' RStudio immagine personalizzata al tuo dominio. Quando alleghi una versione dell'immagine, questa appare nel RStudio Launcher ed è disponibile nell'elenco a discesa Seleziona immagine. È possibile utilizzare il menu a discesa per modificare l'immagine utilizzata da. RStudio

Esiste un limite al numero di versioni immagine che possono essere collegate. Una volta raggiunto il limite, devi prima scollegare una versione in modo da poter collegare una versione diversa dell'immagine.

Allega una versione dell'immagine al tuo dominio utilizzando la console

Puoi allegare una versione di immagine SageMaker AI personalizzata al tuo dominio utilizzando il pannello di controllo della console SageMaker AI. Puoi anche creare un'immagine SageMaker AI personalizzata e una versione dell'immagine, quindi allegare quella versione al tuo dominio.

Per collegare un'immagine esistente

1. Apri la console 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. Seleziona il dominio desiderato.

5. Scegliere Environment (Ambiente).

6. In Immagini Custom SageMaker Studio Classic allegate al dominio, scegli Allega immagine.

7. Per Origine immagine, scegliere Immagine esistente o Nuova immagine.

   Se selezioni Immagine esistente, scegli un'immagine dall'archivio di immagini Amazon SageMaker AI.

   Se selezioni Nuova immagine, fornisci il percorso del registro Amazon ECR per la tua immagine Docker. Il percorso deve essere nello Regione AWS stesso del dominio. Il repository Amazon ECR deve trovarsi nello stesso account del tuo dominio oppure devono essere abilitate le autorizzazioni multiaccount per l' SageMaker IA.

8. Seleziona un’immagine esistente dall'elenco.

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

10. Scegli Next (Successivo).

11. Inserisci i valori per Nome immagine, Nome immagine visualizzato e Descrizione.

12. Seleziona il ruolo IAM. Per ulteriori informazioni, consulta Crea un' RStudio immagine personalizzata.

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

14. (Facoltativo) Scegli Aggiungi nuovo tag, quindi aggiungi un tag di configurazione.

15. Per Tipo di immagine, seleziona Immagine. RStudio

16. Scegli Invia.

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 una versione dell'immagine esistente al tuo dominio utilizzando il AWS CLI

Vengono presentati due metodi per allegare la versione dell'immagine al dominio utilizzando il AWS CLI. Nel primo metodo, si crea un nuovo dominio con la versione allegata. Questo metodo è più semplice, ma è necessario specificare le informazioni e il ruolo di esecuzione di Amazon Virtual Private Cloud (Amazon VPC) necessari per creare il dominio.

Se hai già effettuato l'onboarding al dominio, puoi utilizzare il secondo metodo per allegare la versione dell'immagine al dominio corrente. In questo caso, non devi specificare le informazioni e il ruolo di esecuzione di Amazon VPC. Dopo aver collegato la versione, elimina tutte le applicazioni del dominio e riavvia. RStudio

Allega l'immagine SageMaker AI a un nuovo dominio

Per utilizzare questo metodo, è necessario specificare un ruolo di esecuzione a cui è associata la AmazonSageMakerFullAccesspolicy.

Utilizza 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

1. Ottieni l’ID del tuo VPC predefinito.

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

   Risposta:

   vpc-xxxxxxxx

2. 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

   Risposta:

   [
       "subnet-b55171dd",
       "subnet-8a5f99c6",
       "subnet-e88d1392"
   ]

3. 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. Il ruolo di esecuzione deve soddisfare i requisiti di Completamento dei prerequisiti.

   {
     "DomainName": "domain-with-custom-r-image",
     "VpcId": "<vpc-id>",
     "SubnetIds": [
       "<subnet-ids>"
     ],
     "DomainSettings": {
       "RStudioServerProDomainSettings": {
         "DomainExecutionRoleArn": "<execution-role>"
       }
     },
     "DefaultUserSettings": {
       "ExecutionRole": "<execution-role>",
       "RSessionAppSettings": {
         "CustomImages": [
           {
            "AppImageConfigName": "rstudio-custom-config",
            "ImageName": "rstudio-custom-image"
           }
         ]
        }
     },
     "AuthMode": "IAM"
   }

4. Crea il dominio con l'immagine SageMaker AI personalizzata allegata.

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

   Risposta:

   {
       "DomainArn": "arn:aws:sagemaker:region:acct-id:domain/domain-id",
       "Url": "https://domain-id.studio.region.sagemaker.aws/..."
   }

Allega l'immagine SageMaker AI a un dominio esistente

Questo metodo presuppone che tu abbia già effettuato l'onboarding al dominio. Per ulteriori informazioni, consulta Panoramica del dominio Amazon SageMaker AI.

Nota

Devi eliminare tutte le applicazioni del tuo dominio per aggiornare il dominio con la nuova versione dell'immagine. Per informazioni sull'eliminazione di queste applicazioni, consulta Eliminare un dominio Amazon SageMaker AI.

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

• Scarica il tuo DomainID dalla console 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

1. Apri la console 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. Seleziona il dominio desiderato.

5. Scegli le impostazioni del dominio.

6. In Impostazioni generali, trova l'ID del dominio. 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>

   Risposta:

   {
       "DomainId": "d-xxxxxxxxxxxx",
       "DefaultUserSettings": {
         "KernelGatewayAppSettings": {
           "CustomImages": [
           ],
           ...
         }
       }
   }

8. Salva la sezione DefaultUserSettings della risposta in un file denominato update-domain-input.json.

9. Inserisci ImageName e AppImageConfigName delle 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": {
           "RSessionAppSettings": { 
              "CustomImages": [ 
                 { 
                    "ImageName": "rstudio-custom-image",
                    "AppImageConfigName": "rstudio-custom-config"
                 }
              ]
           }
       }
   }

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://update-domain-input.json

    Risposta:

    {
        "DomainArn": "arn:aws:sagemaker:region:acct-id:domain/domain-id"
    }

11. Elimina l'applicazione RStudioServerPro. È necessario riavviare l'applicazione RStudioServerPro condivisa dal dominio affinché l'interfaccia utente RStudio Launcher rilevi le ultime modifiche.

    aws sagemaker delete-app \
        --domain-id <d-xxxxxxxxxxxx> --user-profile-name domain-shared \
        --app-type RStudioServerPro --app-name default

12. Crea una nuova applicazione RStudioServerPro. È necessario creare questa applicazione utilizzando AWS CLI.

    aws sagemaker create-app \
        --domain-id <d-xxxxxxxxxxxx> --user-profile-name domain-shared \
        --app-type RStudioServerPro --app-name default