Allega un' SageMaker immagine 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 etichettare le risorse SageMaker.

AWS Policy gestite per Amazon SageMakerche 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'immagine RStudio personalizzata al tuo SageMaker dominio Amazon utilizzando la SageMaker console o il AWS Command Line Interface (AWS CLI).

Per utilizzare un' SageMaker immagine personalizzata, devi allegare un'immagine RStudio personalizzata al tuo dominio. Quando colleghi una versione dell'immagine, questa appare in 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 SageMaker dell'immagine personalizzata al tuo dominio utilizzando il pannello di controllo della SageMaker console. Puoi anche creare un' SageMaker immagine personalizzata e una versione dell'immagine e quindi allegare quella versione al tuo dominio.

Per collegare un'immagine esistente

1. Apri la SageMaker console Amazon 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'Amazon SageMaker image store.

   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 per SageMaker più account.

8. Seleziona un’immagine esistente dall'elenco.

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

10. Seleziona Successivo.

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

12. Seleziona il ruolo IAM. Per ulteriori informazioni, consulta Crea un'immagine RStudio 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 RStudio Image.

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' SageMaker immagine 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' SageMakerimmagine personalizzata:

• 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

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

   Risposta:

   [
       "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. 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' SageMaker immagine 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' SageMaker immagine a un dominio esistente

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

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 SageMaker dominio Amazon.

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

• Scarica il tuo DomainID dalla SageMaker console.

• 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

1. Apri la SageMaker console Amazon 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 per l'interfaccia utente di RStudio Launcher per raccogliere 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