Guida introduttiva alla modalità locale - Amazon SageMaker AI
PrerequisitiImpostazione di EnableDockerAccessInstallazione di Docker

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

  • Installazione di Docker

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'immagine Amazon ECR deve fornire l'autorizzazione di accesso per il ruolo di esecuzione dell'utente. Il ruolo di esecuzione del dominio deve inoltre consentire l'accesso ad Amazon ECR.

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

    pip install -U sagemaker

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

    EnableDockerAccess : ENABLED

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

  • Installa la Docker CLI nell'applicazione Studio seguendo la procedura riportata di seguito. Installazione di Docker

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à, le richieste push e pull di Docker immagini vengono instradate tramite il VPC di servizio anziché il VPC configurato dal cliente. Grazie a questa funzionalità, gli amministratori possono configurare un elenco di utenti affidabili a Account AWS cui gli utenti possono inviare richieste di operazioni Docker pull and push di Amazon ECR.

Se viene effettuata una richiesta push o pull di un'Dockerimmagine a un utente Account AWS che non è nell'elenco delle immagini attendibili Account AWS, la richiesta ha esito negativo. DockerLe operazioni pull and push al di fuori di Amazon Elastic Container Registry (Amazon ECR) non sono supportate in modalità. VPC-only

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 SageMaker immagini:

    • immagini del framework DLC

    • Sklearn, elaborazione delle Spark immagini XGBoost

Per configurare un elenco di altri affidabili Account AWS, specifica 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"]}}'

Installazione di Docker

Per utilizzarloDocker, è necessario installarlo 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'installazioneDocker.

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

  2. Accedere al terminale dell'applicazione Studio in cui si desidera installareDocker.

  3. Per ripristinare 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, esegui l'installazione Docker 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 la Docker versione 20.10.X. e la versione Docker Engine 1.41 dell'API.

    • I seguenti pacchetti non sono necessari per utilizzare la Docker CLI in Studio e la loro installazione può essere ignorata:

      • containerd.io

      • docker-ce

      • docker-buildx-plugin

    Nota

    Non è necessario avviare il Docker servizio nelle applicazioni. L'istanza che ospita l'applicazione Studio esegue il Docker servizio per impostazione predefinita. Tutte le chiamate Docker API vengono instradate automaticamente tramite il Docker servizio.

  5. Utilizza il Docker socket esposto per Docker le 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'installazioneDocker.

  1. Accedere al terminale dell'applicazione Studio Docker in cui si desidera installare.

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

    cat /etc/os-release

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

    Ad esempio, esegui l'installazione Docker da un pacchetto su Ubuntu seguendo i passaggi da 1 a 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 alla Docker versione20.10.X.

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

      • containerd.io

      • docker-ce

      • docker-buildx-plugin

    Nota

    Non è necessario avviare il Docker servizio nelle applicazioni. L'istanza che ospita l'applicazione Studio esegue il Docker servizio per impostazione predefinita. Tutte le chiamate Docker API vengono instradate automaticamente tramite il Docker servizio.

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

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

  6. Utilizzate il Docker socket esposto per Docker le 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