Fornisci agli utenti l'accesso a immagini personalizzate - Amazon SageMaker
Passaggio 1: crea il DockerfilePassaggio 2: crea il DockerfileFase 3: invia l'immagine al repository di Amazon Elastic Container RegistryFase 4: Allega l'immagine al SageMaker dominio Amazon dei tuoi utentiPassaggio 5: Consenti ai tuoi utenti di accedere all'immagine dal loro spazio Code Editor

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Fornisci agli utenti l'accesso a immagini personalizzate

Questa documentazione fornisce step-by-step istruzioni per fornire agli utenti l'accesso a immagini personalizzate per i loro ambienti di Code Editor. Puoi utilizzare le informazioni in questa pagina per creare ambienti personalizzati per i flussi di lavoro degli utenti. Il processo prevede l'utilizzo di:

  • Docker

  • AWS Command Line Interface

  • Amazon Elastic Container Registry

  • Amazon SageMaker AWS Management Console

Dopo aver seguito le indicazioni riportate in questa pagina, gli utenti di Code Editor del SageMaker dominio Amazon avranno accesso all'immagine e all'ambiente personalizzati dai propri spazi di Code Editor per potenziare i flussi di lavoro di machine learning.

Importante

Questa pagina presuppone che tu disponga del e AWS Command Line Interface Docker installato sul computer locale.

Per fare in modo che gli utenti eseguano correttamente la loro immagine in Code Editor, devi fare quanto segue:

Affinché gli utenti eseguano correttamente l'immagine

  1. Crea il Dockerfile

  2. Crea l'immagine dal Dockerfile

  3. Carica l'immagine su Amazon Elastic Container Registry

  4. Allega l'immagine al tuo SageMaker dominio Amazon

  5. Consenti ai tuoi utenti di accedere all'immagine dal loro spazio Code Editor

Passaggio 1: crea il Dockerfile

Crea un Dockerfile per definire i passaggi necessari per creare l'ambiente necessario per eseguire l'applicazione nel contenitore dell'utente.

Importante

Il tuo Dockerfile deve soddisfare le specifiche fornite in. Specifiche dei file Dockerfile

Per esempi di Dockerfile nel formato corretto, vedi. Esempi di file Dockerfile

Passaggio 2: crea il Dockerfile

Nella stessa directory del tuo Dockerfile, crea la tua immagine usando il seguente comando:

docker build -t username/imagename:tag your-account-id.dkr.ecr.Regione AWS.amazonaws.com/your-repository-name:tag
Importante

La tua immagine deve essere taggata nel seguente formato: 123456789012.dkr.ecr.your-region.amazonaws.com/your-repository-name:tag

Altrimenti non potrai inviarlo a un repository Amazon Elastic Container Registry.

Fase 3: invia l'immagine al repository di Amazon Elastic Container Registry

Dopo aver creato l'immagine, accedi al tuo ECR repository Amazon utilizzando il seguente comando:

aws ecr get-login-password --region Regione AWS | docker login --username AWS --password-stdin 123456789012.dkr.ecr.Regione AWS.amazonaws.com

Dopo aver effettuato l'accesso, invia il tuo Dockerfile usando il seguente comando:

docker push 123456789012.dkr.ecr.Regione AWS.amazonaws.com/your-repository-name:tag

Fase 4: Allega l'immagine al SageMaker dominio Amazon dei tuoi utenti

Dopo aver inviato l'immagine, devi accedervi dal tuo SageMaker dominio Amazon utilizzando la SageMaker console o il AWS CLI.

Allega l'immagine utilizzando la console SageMaker

Utilizza la seguente procedura per allegare l'immagine a un SageMaker dominio tramite la SageMaker console:

  1. Aprire la SageMaker console.

  2. In Configurazioni admin, scegli Domini.

  3. Dall'elenco dei domini, seleziona un dominio.

  4. Apri la scheda Ambiente.

  5. Per immagini personalizzate per app Studio personali, scegli Allega immagine.

  6. Specificate la fonte dell'immagine. È possibile creare una nuova immagine o scegliere un'immagine esistente.

  7. Scegli Next (Successivo).

  8. Scegliete Code Editor come tipo di applicazione.

  9. Scegli Invia.

Allega l'immagine usando il AWS CLI

Utilizzate la seguente procedura per allegare l'immagine a un SageMaker dominio tramite AWS CLI :

  1. Creare un' SageMaker immagine. Al ruolo ARN deve essere allegata la AmazonSageMakerFullAccess politica.

    aws sagemaker create-image \
    --image-name code-editor-custom-image \
    --role-arn arn:aws:iam::account-id:role/service-role/execution-role

  2. Crea una versione SageMaker dell'immagine dall'immagine. Passa il valore di tag univoco che hai scelto quando hai inviato l'immagine ad AmazonECR.

    aws sagemaker create-image-version \
    --image-name code-editor-custom-image \
    --base-image repository-uri:tag

  3. Crea un file di configurazione chiamatoapp-image-config-input.json. La configurazione dell'immagine dell'applicazione viene utilizzata come configurazione per l'esecuzione di un' SageMaker immagine come applicazione Code Editor. Puoi anche specificare i tuoi ContainerConfigargomenti qui. 

    {
    "AppImageConfigName": "code-editor-app-image-config",
    "CodeEditorAppImageConfig":
    {
        "ContainerConfig":
        {}
    }
}

  4. Createlo AppImageConfig utilizzando il file di configurazione dell'immagine dell'applicazione che avete creato.

    aws sagemaker create-app-image-config \
    --cli-input-json file://app-image-config-input.json

  5. Creazione di un file di configurazione denominato updateDomain.json. Assicurati di specificare l'ID del tuo dominio.

    {
    "DomainId": "domain-id",
    "DefaultUserSettings": {
        "CodeEditorAppSettings": {
            "CustomImages": [
                {
                    "ImageName": "code-editor-custom-image",
                    "AppImageConfigName": "code-editor-app-image-config"
                }
            ]
        }
    }
}

  6. Chiama il UpdateDomain comando con il file di configurazione come input.

    Nota

    È necessario eliminare tutte le applicazioni del dominio prima di aggiornare il dominio con la nuova immagine. Tieni presente che devi solo eliminare le applicazioni; non devi eliminare i profili utente o gli spazi condivisi. Per istruzioni sull'eliminazione delle applicazioni, scegliete una delle seguenti opzioni.

    aws sagemaker update-domain --cli-input-json file://updateDomain.json

Passaggio 5: Consenti ai tuoi utenti di accedere all'immagine dal loro spazio Code Editor

I tuoi utenti possono ora selezionare l'immagine che hai allegato al loro dominio dal loro spazio Code Editor.

Per ulteriori informazioni sulla selezione di un'immagine personalizzata, consultaAvvia un'applicazione Code Editor in Studio.