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
-
EnableDockerAccess
Tramite, 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-namedomain-name
\ --vpc-idvpc-id
\ --subnet-idssubnet-ids
\ --auth-mode IAM \ --default-user-settings "ExecutionRole=execution-role
" \ --domain-settings '{"DockerSettings": {"EnableDockerAccess": "ENABLED"}}' \ --query DomainArn \ --output text # update domain aws --regionregion
\ sagemaker update-domain --domain-iddomain-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-iddomain-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.
-
(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. -
Accedere al terminale dell'applicazione Studio in cui si desidera installareDocker.
-
Per ripristinare il sistema operativo dell'applicazione, esegui il seguente comando dal terminale:
cat /etc/os-release
-
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 Engine1.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.
-
-
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.
-
Accedere al terminale dell'applicazione Studio Docker in cui si desidera installare.
-
Eseguite il seguente comando dal terminale per restituire il sistema operativo dell'applicazione:
cat /etc/os-release
-
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 versione
20.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.
-
-
Carica i
.deb
file nel file system Amazon EFS o nel file system Amazon EBS dell'applicazione. -
Installa manualmente i
docker-compose-plugin
.deb
pacchettidocker-ce-cli
and dal terminale dell'applicazione Studio. Per ulteriori informazioni e istruzioni, consulta il passaggio 5 in Installazione da un pacchettosul sito Web dei Docker documenti. -
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