Guida introduttiva alla modalità locale - Amazon SageMaker AI
PrerequisitiImpostazione di EnableDockerAccessDocker installazione

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

Guida introduttiva alla modalità locale

Le seguenti sezioni descrivono i passaggi necessari per iniziare a utilizzare la modalità locale in Amazon SageMaker Studio, tra cui:

  • Completamento dei prerequisiti

  • Impostazione di EnableDockerAccess

  • Docker installazione

Prerequisiti

Completa i seguenti prerequisiti per utilizzare la modalità locale nelle applicazioni Studio:

  • Per estrarre immagini da un repository Amazon Elastic Container Registry, l'account che ospita l'ECRimmagine Amazon deve fornire l'autorizzazione di accesso per il ruolo di esecuzione dell'utente. Il ruolo di esecuzione del dominio deve inoltre consentire ECR l'accesso ad Amazon.

  • Verifica di utilizzare la versione più recente di Studio Python SDK utilizzando il seguente comando:  

    pip install -U sagemaker

  • Per utilizzare la modalità locale e Docker funzionalità, imposta il seguente parametro del dominio DockerSettings utilizzando AWS Command Line Interface (AWS CLI):  

    EnableDockerAccess : ENABLED

  • UtilizzandoEnableDockerAccess, puoi anche controllare se gli utenti del dominio possono utilizzare la modalità locale. Per impostazione predefinita, la modalità locale e Docker le funzionalità non sono consentite nelle applicazioni Studio. Per ulteriori informazioni, consulta Impostazione di EnableDockerAccess.

  • Installa Docker CLInell'applicazione Studio seguendo la procedura descritta inDocker installazione.

Impostazione di EnableDockerAccess

Nelle sezioni seguenti viene illustrato come impostare EnableDockerAccess quando il dominio dispone di un accesso pubblico a Internet o è in VPC-only modalità.

Nota

Le modifiche si applicano EnableDockerAccess solo alle applicazioni create dopo l'aggiornamento del dominio. È necessario creare una nuova applicazione dopo aver aggiornato il dominio.

Accesso pubblico a Internet

I seguenti comandi di esempio mostrano come impostare EnableDockerAccess quando si crea un nuovo dominio o si aggiorna un dominio esistente con accesso pubblico a Internet:

# create new domain
aws --region region \
    sagemaker create-domain --domain-name domain-name \
    --vpc-id vpc-id \
    --subnet-ids subnet-ids \
    --auth-mode IAM \
    --default-user-settings "ExecutionRole=execution-role" \
    --domain-settings '{"DockerSettings": {"EnableDockerAccess": "ENABLED"}}' \
    --query DomainArn \
    --output text

# update domain
aws --region region \
    sagemaker update-domain --domain-id domain-id \
    --domain-settings-for-update '{"DockerSettings": {"EnableDockerAccess": "ENABLED"}}'

Modalità VPC-only

Quando si utilizza un dominio in VPC-only modalità, Docker le richieste push e pull di immagini vengono inoltrate tramite il servizio VPC anziché tramite quelle VPC configurate dal cliente. Grazie a questa funzionalità, gli amministratori possono configurare un elenco di utenti affidabili Account AWS che gli utenti possono creare su Amazon ECR Docker richiedi operative pull and push a.

Se un Docker La richiesta push o pull di un'immagine viene inviata a un utente Account AWS che non è nell'elenco dei trusted Account AWS, la richiesta ha esito negativo. Docker Le operazioni pull and push al di fuori di Amazon Elastic Container Registry (AmazonECR) non sono supportate in VPC-only modalità.

Le seguenti Account AWS sono considerate affidabili per impostazione predefinita:

  • L'account che ospita il dominio SageMaker AI.

  • SageMaker Account AI che ospitano le seguenti immagini SageMaker AI:

    • DLCimmagini del framework

    • Impara, Spark, XGBoost elaborazione di immagini

Per configurare un elenco di dati affidabili aggiuntivi Account AWS, specificare il VpcOnlyTrustedAccounts valore come segue: 

aws --region region \
    sagemaker update-domain --domain-id domain-id \
    --domain-settings-for-update '{"DockerSettings": {"EnableDockerAccess": "ENABLED", "VpcOnlyTrustedAccounts": ["account-list"]}}'

Docker installazione

Per utilizzare Docker, è necessario installare manualmente Docker dal terminale dell'applicazione Studio. I passaggi per l'installazione Docker sono diversi se il dominio ha accesso a Internet o meno.

Accesso a Internet

Se il dominio viene creato con accesso pubblico a Internet o in VPC-only modalità con accesso limitato a Internet, utilizza i seguenti passaggi per l'installazione Docker.

  1. (Facoltativo) Se il dominio è stato creato in VPC-only modalità con accesso limitato a Internet, crea un NAT gateway pubblico con accesso a Docker sito web. Per istruzioni, consulta i NATgateway.

  2. Vai al terminale dell'applicazione Studio che desideri installare Docker nel.

  3. Per restituire il sistema operativo dell'applicazione, esegui il seguente comando dal terminale:

    cat /etc/os-release

  4. Installa Docker seguendo le istruzioni per il sistema operativo dell'applicazione nel repository Amazon SageMaker AI Local Mode Examples.

    Ad esempio, installa Docker on Ubuntu seguendo lo script in https://github.com/aws-samples/amazon-sagemaker-local-mode/blob/main/sagemaker_studio_docker_cli_install/sagemaker- ubuntu-focal-docker-cli -install.sh con le seguenti considerazioni:

    • Se i comandi concatenati falliscono, esegui i comandi uno alla volta.

    • Studio supporta solo Docker versione 20.10.X. e Docker Engine API versione 1.41.

    • I seguenti pacchetti non sono necessari per utilizzare il Docker CLIin Studio e la loro installazione può essere saltata:

      • containerd.io

      • docker-ce

      • docker-buildx-plugin

    Nota

    Non è necessario avviare il Docker servizio nelle tue applicazioni. Viene eseguita l'istanza che ospita l'applicazione Studio Docker servizio per impostazione predefinita. Tutti Docker APIle chiamate vengono instradate tramite Docker servizio automaticamente.

  5. Usa l'esposto Docker presa per Docker interazioni all'interno delle applicazioni Studio. Per impostazione predefinita, è esposto il seguente socket:

    unix:///docker/proxy.sock

    La seguente variabile di ambiente dell'applicazione Studio per impostazione predefinita USER utilizza questo socket esposto:

    DOCKER_HOST

Nessun accesso a Internet

Se il dominio viene creato in VPC-only modalità senza accesso a Internet, utilizza i seguenti passaggi per l'installazione Docker.

  1. Vai al terminale dell'applicazione Studio che desideri installare Docker nel.

  2. Eseguite il seguente comando dal terminale per restituire il sistema operativo dell'applicazione:

    cat /etc/os-release

  3. Scarica il file richiesto Docker .debfile sul computer locale. Per istruzioni su come scaricare i file richiesti per il sistema operativo dell'applicazione Studio, consulta Installa Docker Engine.

    Ad esempio, installa Docker da un pacchetto su Ubuntu seguendo i passaggi 1—4 in Installazione da un pacchetto con le seguenti considerazioni:

    • Installa Docker da un pacchetto. L'utilizzo di altri metodi per installare Docker fallirà.

    • Installa i pacchetti più recenti corrispondenti a Docker versione20.10.X.

    • I seguenti pacchetti non sono necessari per utilizzare Docker CLIin Studio. Non è necessario installare quanto segue:

      • containerd.io

      • docker-ce

      • docker-buildx-plugin

    Nota

    Non è necessario avviare Docker servizio nelle tue applicazioni. Viene eseguita l'istanza che ospita l'applicazione Studio Docker servizio per impostazione predefinita. Tutti Docker APIle chiamate vengono instradate tramite Docker servizio automaticamente.

  4. Carica i .deb file nel EFS file system Amazon o nel EBS file system Amazon dell'applicazione.

  5. Installa manualmente docker-compose-plugin .deb i pacchetti docker-ce-cli and dal terminale dell'applicazione Studio. Per ulteriori informazioni e istruzioni, consultate il passaggio 5 in Installazione da un pacchetto sul Docker sito web docs.

  6. Usa l'esposto Docker presa per Docker interazioni all'interno delle applicazioni Studio. Per impostazione predefinita, è esposto il seguente socket:

    unix:///docker/proxy.sock

    La seguente variabile di ambiente dell'applicazione Studio per impostazione predefinita USER utilizza questo socket esposto:

    DOCKER_HOST