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à.
# Editor di codice in Amazon SageMaker Studio
L’Editor di codice, basato su [Code-OSS, Visual Studio Code - Open Source](https://github.com/microsoft/vscode#visual-studio-code---open-source-code---oss), ti aiuta a scrivere, testare, eseguire il debug ed eseguire il codice di analisi e machine learning. Code Editor si estende ed è completamente integrato con Amazon SageMaker Studio. Supporta anche le estensioni dell’ambiente di sviluppo integrato (IDE) disponibili in [Open VSX Registry](https://open-vsx.org/). La pagina seguente fornisce informazioni sull’Editor di codice e dettagli importanti per utilizzarlo.
Code Editor ha l'estensione [AWS Toolkit for VS](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/welcome.html) Code preinstallata, che consente connessioni Servizi AWS a un generatore di codice generico basato sull'apprendimento automatico che fornisce consigli sul codice in tempo reale. [Amazon CodeWhisperer](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/codewhisperer.html) Per ulteriori informazioni sulle estensioni consulta [Connessioni ed estensioni dell’Editor di codice](code-editor-use-connections-and-extensions.md).
**Importante**
A partire dal 30 novembre 2023, la precedente esperienza Amazon SageMaker Studio è ora denominata Amazon SageMaker Studio Classic. La sezione seguente è specifica per l’utilizzo dell’esperienza Studio aggiornata. Per informazioni sull’utilizzo dell’applicazione Studio Classic, consulta [Amazon SageMaker Studio Classic](studio.md).
Per avviare l’Editor di codice, crea uno spazio privato per l’Editor di codice. Lo spazio dell’Editor di codice utilizza una singola istanza Amazon Elastic Compute Cloud (Amazon EC2) per il calcolo e un singolo volume Amazon Elastic Block Store (Amazon EBS) per l’archiviazione. Tutti gli elementi presenti nel tuo spazio, ad esempio il codice, il profilo Git e le variabili di ambiente, vengono archiviati nello stesso volume Amazon EBS. Il volume ha 3000 IOPS e un throughput di 125. MBps L’amministratore configura le impostazioni predefinite di archiviazione Amazon EBS per il tuo spazio.
La dimensione dell’archiviazione predefinita è di 5 GB, ma l’amministratore può aumentare la quantità di spazio disponibile. Per ulteriori informazioni, consulta [Modifica della dimensione dell’archiviazione predefinita](code-editor-admin-storage-size.md).
La directory di lavoro degli utenti all’interno del volume di archiviazione è `/home/sagemaker-user`. Se si specifica la propria AWS KMS chiave per crittografare il volume, tutto ciò che si trova nella directory di lavoro viene crittografato utilizzando la chiave gestita dal cliente. Se non si specifica alcuna AWS KMS chiave, i dati all'interno `/home/sagemaker-user` vengono crittografati con una chiave AWS gestita. Indipendentemente dal fatto che venga specificata una AWS KMS chiave, tutti i dati al di fuori della directory di lavoro vengono crittografati con una chiave AWS gestita.
Puoi aumentare o ridurre verticalmente il calcolo modificando il tipo di istanza Amazon EC2 che esegue l’applicazione Editor di codice. Prima di modificare il tipo di istanza associato, è necessario arrestare lo spazio dell’Editor di codice. Per ulteriori informazioni, consulta [Istanze e immagini dell’applicazione Editor di codice](code-editor-use-instances.md).
L’amministratore potrebbe fornire una configurazione del ciclo di vita per personalizzare l’ambiente. Puoi specificare la configurazione del ciclo di vita quando crei lo spazio. Per ulteriori informazioni, consulta [Configurazioni del ciclo di vita dell’Editor di codice](code-editor-use-lifecycle-configurations.md).
Puoi anche portare il tuo sistema di archiviazione dei file se hai un volume Amazon EFS.
![\[La pagina di benvenuto dell’interfaccia utente dell’applicazione Editor di codice.\]](http://docs.aws.amazon.com/it_it/sagemaker/latest/dg/images/code-editor/code-editor-home.png)
**Topics**
+ [
# Utilizzo dell’Editor di codice
](code-editor-use.md)
+ [
# Guida per l’amministratore dell’Editor di codice
](code-editor-admin.md)
# Utilizzo dell’Editor di codice
Gli argomenti di questa sezione forniscono guide per l'uso di Code Editor, tra cui come avviare, aggiungere connessioni Servizi AWS, chiudere le risorse e altro ancora. Dopo aver creato uno spazio dell’Editor di codice, puoi accedere alla sessione dell’Editor di codice direttamente tramite il browser.
Nell’ambiente dell’Editor di codice, puoi:
+ Accedere a tutti gli artefatti presenti nella tua home directory
+ Clona i tuoi GitHub repository e conferma le modifiche
+ Accedi all'SDK SageMaker Python
Puoi tornare a Studio per esaminare tutte gli asset creati nell’ambiente dell’Editor di codice, ad esempio esperimenti, pipeline o job di addestramento.
**Topics**
+ [
# Controllo della versione dell’Editor di codice
](code-editor-use-version.md)
+ [
# Istanze e immagini dell’applicazione Editor di codice
](code-editor-use-instances.md)
+ [
# Avvio di un’applicazione Editor di codice in Studio
](code-editor-use-studio.md)
+ [
# Avvia un'applicazione Code Editor utilizzando il AWS CLI
](code-editor-launch-cli.md)
+ [
# Clonazione di un repository nell’Editor di codice
](code-editor-use-clone-a-repository.md)
+ [
# Connessioni ed estensioni dell’Editor di codice
](code-editor-use-connections-and-extensions.md)
+ [
# Chiusura delle risorse dell’Editor di codice
](code-editor-use-log-out.md)
# Controllo della versione dell’Editor di codice
Nella procedura seguente viene illustrato come controllare la versione della tua applicazione Editor di codice.
**Per controllare la versione dell’applicazione Editor di codice**
1. Avvia ed esegui uno spazio dell’Editor di codice e accedi all’interfaccia utente dell’applicazione Editor di codice. Per ulteriori informazioni, consulta [Avvio di un’applicazione Editor di codice in Studio](code-editor-use-studio.md).
1. Nell’angolo in alto a sinistra dell’interfaccia utente dell’Editor di codice, scegli il pulsante menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/sagemaker/latest/dg/images/code-editor/code-editor-menu-icon.png)). Quindi, scegli **Aiuto** e **Informazioni**.
# Istanze e immagini dell’applicazione Editor di codice
Solo alcune istanze sono compatibili con le applicazioni Editor di codice. Puoi scegliere il tipo di istanza compatibile con il tuo caso d’uso dal menu a discesa **Istanza**.
Le istanze con la funzionalità di **avvio rapido** si avviano più velocemente delle altre istanze. Per ulteriori informazioni sui tipi di istanze con avvio rapido in Studio, consulta [Tipi di istanze disponibili per l'uso con i notebook Amazon SageMaker Studio Classic](notebooks-available-instance-types.md).
**Nota**
Se utilizzi un tipo di istanza GPU per configurare l’applicazione Editor di codice, devi utilizzare anche un’immagine basata su GPU. L’interfaccia utente dello spazio dell’Editor di codice seleziona automaticamente un’immagine compatibile quando selezioni il tipo di istanza.
All’interno di uno spazio, i dati vengono archiviati in un volume Amazon EBS che persiste indipendentemente dalla durata dell’istanza. Non perderai i tuoi dati quando cambi istanza. Se lo spazio dell’Editor di codice è in stato `Running`, è necessario arrestarlo prima di modificare i tipi di istanze.
La tabella seguente elenca le immagini CPU e GPU ARNs di Code Editor disponibili per ogni regione.
| Region | CPU | GPU |
| --- | --- | --- |
| us-east-1 | arn:aws:sagemaker:us-east-1:885854791233:image/sagemaker-distribution-cpu | arn:aws:sagemaker:us-east-1:885854791233:image/sagemaker-distribution-gpu |
| us-east-2 | arn:aws:sagemaker:us-east-2:37914896644:image/sagemaker-distribution-cpu | arn:aws:sagemaker:us-east-2:37914896644:image/sagemaker-distribution-gpu |
| us-west-1 | arn:aws:sagemaker:us-west-1:053634841547:image/sagemaker-distribution-cpu | arn:aws:sagemaker:us-west-1:053634841547:image/sagemaker-distribution-gpu |
| us-west-2 | arn:aws:sagemaker:us-west-2:542918446943:image/sagemaker-distribution-cpu | arn:aws:sagemaker:us-west-2:542918446943:image/sagemaker-distribution-gpu |
| af-south-1 | arn:aws:sagemaker:af-south-1:238384257742:image/sagemaker-distribution-cpu | arn:aws:sagemaker:af-south-1:238384257742:image/sagemaker-distribution-gpu |
| ap-east-1 | arn:aws:sagemaker:ap-east-1:523751269255:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-east-1:523751269255:image/sagemaker-distribution-gpu |
| ap-south-1 | arn:aws:sagemaker:ap-south-1:245090515133:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-south-1:245090515133:image/sagemaker-distribution-gpu |
| ap-northeast-2 | arn:aws:sagemaker:ap-northeast-2:064688005998:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-northeast-2:064688005998:image/sagemaker-distribution-gpu |
| ap-southeast-1 | arn:aws:sagemaker:ap-southeast-1:022667117163:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-southeast-1:022667117163:image/sagemaker-distribution-gpu |
| ap-southeast-2 | arn:aws:sagemaker:ap-southeast-2:648430277019:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-southeast-2:648430277019:image/sagemaker-distribution-gpu |
| ap-northeast-1 | arn:aws:sagemaker:ap-northeast-1:010972774902:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-northeast-1:010972774902:image/sagemaker-distribution-gpu |
| ca-central-1 | arn:aws:sagemaker:ca-central-1:481561238223:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ca-central-1:481561238223:image/sagemaker-distribution-gpu |
| eu-central-1 | arn:aws:sagemaker:eu-central-1:545423591354:image/sagemaker-distribution-cpu | arn:aws:sagemaker:eu-central-1:545423591354:image/sagemaker-distribution-gpu |
| eu-west-1 | arn:aws:sagemaker:eu-west-1:819792524951:image/sagemaker-distribution-cpu | arn:aws:sagemaker:eu-west-1:819792524951:image/sagemaker-distribution-gpu |
| eu-west-2 | arn:aws:sagemaker:eu-west-2:021081402939:image/sagemaker-distribution-cpu | arn:aws:sagemaker:eu-west-2:021081402939:image/sagemaker-distribution-gpu |
| eu-west-3 | arn:aws:sagemaker:eu-west-3:856416204555:image/sagemaker-distribution-cpu | arn:aws:sagemaker:eu-west-3:856416204555:image/sagemaker-distribution-gpu |
| eu-north-1 | arn:aws:sagemaker:eu-north-1:175620155138:image/sagemaker-distribution-cpu | arn:aws:sagemaker:eu-north-1:175620155138:image/sagemaker-distribution-gpu |
| eu-south-1 | arn:aws:sagemaker:eu-south-1:810671768855:image/sagemaker-distribution-cpu | arn:aws:sagemaker:eu-south-1:810671768855:image/sagemaker-distribution-gpu |
| sa-east-1 | arn:aws:sagemaker:sa-east-1:567556641782:image/sagemaker-distribution-cpu | arn:aws:sagemaker:sa-east-1:567556641782:image/sagemaker-distribution-gpu |
| ap-northeast-3 | arn:aws:sagemaker:ap-northeast-3:564864627153:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-northeast-3:564864627153:image/sagemaker-distribution-gpu |
| ap-southeast-3 | arn:aws:sagemaker:ap-southeast-3:370607712162:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-southeast-3:370607712162:image/sagemaker-distribution-gpu |
| me-south-1 | arn:aws:sagemaker:me-south-1:523774347010:image/sagemaker-distribution-cpu | arn:aws:sagemaker:me-south-1:523774347010:image/sagemaker-distribution-gpu |
| me-central-1 | arn:aws:sagemaker:me-central-1:358593528301:image/sagemaker-distribution-cpu | arn:aws:sagemaker:me-central-1:358593528301:image/sagemaker-distribution-gpu |
| il-central-1 | arn:aws:sagemaker:il-central-1:080319125002:image/sagemaker-distribution-cpu | arn:aws:sagemaker:il-central-1:080319125002:image/sagemaker-distribution-gpu |
| cn-north-1 | arn:aws:sagemaker:cn-north-1:674439102856:image/sagemaker-distribution-cpu | arn:aws:sagemaker:cn-north-1:674439102856:image/sagemaker-distribution-gpu |
| cn-northwest-1 | arn:aws:sagemaker:cn-northwest-1:651871951035:image/sagemaker-distribution-cpu | arn:aws:sagemaker:cn-northwest-1:651871951035:image/sagemaker-distribution-gpu |
| us-gov-west-1 | arn:aws:sagemaker:us-gov-west-1:300992924816:image/sagemaker-distribution-cpu | arn:aws:sagemaker:us-gov-west-1:300992924816:image/sagemaker-distribution-gpu |
| us-gov-east-1 | arn:aws:sagemaker:us-gov-east-1:300993876623:image/sagemaker-distribution-cpu | arn:aws:sagemaker:us-gov-east-1:300993876623:image/sagemaker-distribution-gpu |
Se si verificano limitazioni dell’istanza, contatta l’amministratore. Per ottenere più spazio di archiviazione e calcolo per un utente, gli amministratori possono richiedere un aumento delle quote di AWS un utente. Per ulteriori informazioni sulla richiesta di un aumento delle quote, consulta [Endpoint e quote Amazon SageMaker AI](https://docs.aws.amazon.com/general/latest/gr/sagemaker.html).
# Avvio di un’applicazione Editor di codice in Studio
Per configurare e accedere all’ambiente di sviluppo integrato dell’Editor di codice tramite Studio, è necessario creare uno spazio dell’Editor di codice. Per ulteriori informazioni sugli spazi in Studio, consulta [Spazi Amazon SageMaker Studio](studio-updated-spaces.md).
![\[Il pulsante dell’applicazione Editor di codice e il riquadro della panoramica nell’interfaccia utente di Studio.\]](http://docs.aws.amazon.com/it_it/sagemaker/latest/dg/images/code-editor/code-editor-studio-home.png)
La procedura seguente descrive come creare ed eseguire uno spazio dell’Editor di codice.
**Per creare ed eseguire uno spazio dell’Editor di codice**
1. Avvia l’esperienza Studio aggiornata. Per ulteriori informazioni, consulta [Launch Amazon SageMaker Studio](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-updated-launch.html).
1. Esegui una delle seguenti operazioni:
+ All'interno dell'interfaccia utente di Amazon SageMaker Studio aggiornata, seleziona **Code Editor** dal menu **Applicazioni**.
+ All'interno dell'interfaccia utente aggiornata di Amazon SageMaker Studio, scegli **Visualizza gli spazi di Code Editor** nella sezione **Panoramica** della home page di Studio.
1. Nell’angolo in alto a destra della pagina di destinazione dell’Editor di codice, scegli **Crea spazio dell’Editor di codice**.
1. Immetti un nome per lo spazio dell’Editor di codice. Il nome deve contenere da 1 a 62 caratteri e deve includere solo lettere, numeri e trattini.
1. Scegli **Crea spazio**.
1. Dopo aver creato lo spazio, puoi impostare alcune opzioni prima utilizzarlo:
+ Puoi modificare le impostazioni **Archiviazione (GB)**, **Configurazione del ciclo di vita** o **Collega file system EFS personalizzato**. Le opzioni per queste impostazioni sono disponibili in base alle specifiche dell’amministratore.
+ Dal menu a discesa **Istanza**, puoi scegliere il tipo di istanza più compatibile con il tuo caso d’uso. Dal menu a discesa **Immagine**, puoi scegliere un'immagine di SageMaker distribuzione o un'immagine personalizzata fornita dal tuo amministratore.
**Nota**
Il passaggio da un’immagine di distribuzione di SageMaker all’altra modifica la versione sottostante dell’Editor di codice che viene utilizzata, il che può causare incompatibilità dovute al caching del browser. È necessario cancellare la cache del browser quando si passa da un’immagine all’altra.
Se utilizzi un tipo di istanza GPU per configurare l’applicazione Editor di codice, devi utilizzare anche un’immagine basata su GPU. All’interno di uno spazio, i dati vengono archiviati in un volume Amazon EBS che persiste indipendentemente dalla durata dell’istanza. Non perderai i tuoi dati quando cambi istanza.
**Importante**
Le policy IAM personalizzate che consentono agli utenti di Studio di creare spazi devono concedere anche le autorizzazioni per elencare le immagini (`sagemaker: ListImage`) per poter visualizzare le immagini personalizzate. Per aggiungere l’autorizzazione, consulta [Add or remove identity permissions](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) in *AWS Identity and Access Management* User Guide.
[AWS politiche gestite per Amazon SageMaker AI](security-iam-awsmanpol.md)che concedono le autorizzazioni per creare risorse SageMaker AI includono già le autorizzazioni per elencare le immagini durante la creazione di tali risorse.
**Nota**
Per aggiornare le impostazioni dello spazio, devi prima arrestarlo. Se il Code Editor utilizza un'istanza con archivi di NVMe istanze, tutti i dati archiviati nell' NVMe archivio vengono eliminati quando lo spazio viene interrotto.
1. Dopo aver aggiornato le impostazioni, scegli **Esegui spazio** nella pagina dei dettagli dello spazio.
1. Quando lo stato dello spazio è `Running`, scegli **Apri Editor di codice** per accedere alla sessione dell’Editor di codice.
![\[La pagina dei dettagli dello spazio per un’applicazione Editor di codice nell’interfaccia utente di Studio.\]](http://docs.aws.amazon.com/it_it/sagemaker/latest/dg/images/code-editor/code-editor-open.png)
# Avvia un'applicazione Code Editor utilizzando il AWS CLI
Per configurare e accedere all’ambiente di sviluppo integrato dell’Editor di codice tramite la AWS Command Line Interface (AWS CLI), è necessario creare uno spazio dell’Editor di codice. Assicurati di seguire le istruzioni in [Completamento dei prerequisiti](code-editor-admin-prerequisites.md) prima di procedere. Utilizza la procedura seguente per creare ed eseguire uno spazio dell’Editor di codice.
**Per creare ed eseguire uno spazio dell’Editor di codice**
1. Accedi a uno spazio utilizzando AWS Identity and Access Management (IAM) o AWS IAM Identity Center l'autenticazione. Per ulteriori informazioni sull'accesso agli spazi utilizzando il AWS CLI, consulta *Accedere agli spazi utilizzando l' AWS Command Line Interface*in[Spazi Amazon SageMaker Studio](studio-updated-spaces.md).
1. Crea un’applicazione e specifica `CodeEditor` come `app-type` utilizzando il comando seguente.
Se utilizzi un tipo di istanza GPU per creare l’applicazione Editor di codice, devi utilizzare anche un’immagine basata su GPU.
```
aws sagemaker create-app \
--domain-id domain-id \
--space-name space-name \
--app-type CodeEditor \
--app-name default \
--resource-spec "SageMakerImageArn=arn:aws:sagemaker:region:account-id:image/sagemaker-distribution-cpu"
```
Per ulteriori informazioni sull'immagine disponibile nell'editor di codice ARNs, vedere[Istanze e immagini dell’applicazione Editor di codice](code-editor-use-instances.md).
1. Una volta che l’applicazione Editor di codice è in servizio, avvia l’applicazione con un URL prefirmato. Puoi utilizzare l’API `describe-app` per verificare se l’applicazione è in servizio. Utilizza l’API `create-presigned-domain-url` per creare un URL prefirmato:
```
aws sagemaker create-presigned-domain-url \
--domain-id domain-id \
--space-name space-name \
--user-profile-name user-profile-name \
--session-expiration-duration-in-seconds 43200 \
--landing-uri app:CodeEditor:
```
1. Apri l’URL generato per iniziare a lavorare nella tua applicazione Editor di codice.
# Clonazione di un repository nell’Editor di codice
Puoi navigare tra le cartelle e clonare un repository nella finestra **Esploratore** dell’interfaccia utente dell’applicazione Editor di codice.
Per clonare un repository, procedi come descritto di seguito:
**Per clonare un repository**
1. Apri l’applicazione Editor di codice nel browser e scegli il pulsante **Esplorazione** (![\[Icon representing multiple documents or pages stacked on top of each other.\]](http://docs.aws.amazon.com/it_it/sagemaker/latest/dg/images/code-editor/code-editor-exploration-icon.png)) nel riquadro di navigazione a sinistra.
1. Scegli **Clona repository** nella finestra **Esploratore**. Quindi, fornisci un URL del repository o scegli un’origine del repository nel prompt.
1. Scegli una cartella in cui clonare il repository. La cartella predefinita dell’Editor di codice è `/home/sagemaker-user/`. La clonazione del repository potrebbe richiedere del tempo.
1. Per aprire il repository clonato, scegli **Apri in una nuova finestra** o **Apri**.
1. Per tornare alla home page dell’interfaccia utente dell’applicazione Editor di codice, scegli **Annulla**.
1. All’interno del repository viene visualizzato un messaggio che chiede se ritenere attendibili gli autori dei file nel nuovo repository. Sono disponibili due opzioni:
1. Per considerare attendibile la cartella e abilitare tutte le funzionalità, scegli **Sì, mi fido degli autori**.
1. Per sfogliare il contenuto del repository in *modalità limitata*, scegli **No, non mi fido degli autori**.
In modalità limitata, le attività non possono essere eseguite, il debug è disabilitato, le impostazioni dello spazio di lavoro non vengono applicate e le estensioni hanno funzionalità limitate.
Per uscire dalla modalità con limitazioni, imposta come attendibili gli autori di tutti i file nella cartella corrente o nella cartella principale e abilita tutte le funzionalità, scegli **Gestisci** nel banner della **modalità con limitazioni**.
# Connessioni ed estensioni dell’Editor di codice
Code Editor supporta connessioni IDE e Servizi AWS le estensioni disponibili nel registro [Open VSX](https://open-vsx.org/).
## Connessioni a AWS
Gli ambienti dell’Editor di codice sono integrati con il [Kit di strumenti AWS per VS Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/welcome.html) per aggiungere connessioni ai Servizi AWS. Per iniziare con le connessioni a Servizi AWS, devi disporre di credenziali AWS Identity and Access Management (IAM) valide. Per altre informazioni, vedi [Autenticazione e accesso per il AWS Toolkit for Visual Studio Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/establish-credentials.html).
All’interno dell’ambiente dell’Editor di codice, puoi aggiungere connessioni a:
+ [AWS Explorer](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/aws-explorer.html): visualizza, modifica e distribuisci AWS risorse in Amazon S3 e altro CloudWatch ancora.
L'accesso a determinate funzionalità all'interno di AWS Explorer richiede determinate AWS autorizzazioni. Per altre informazioni, vedi [Autenticazione e accesso per il AWS Toolkit for Visual Studio Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/establish-credentials.html).
+ [Amazon CodeWhisperer](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/codewhisperer.html): crea applicazioni più velocemente con i suggerimenti di codice basati sull’IA.
Per utilizzarlo Amazon CodeWhisperer con Code Editor, devi aggiungere le seguenti autorizzazioni al tuo ruolo di esecuzione SageMaker AI.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "CodeWhispererPermissions",
"Effect": "Allow",
"Action": ["codewhisperer:GenerateRecommendations"],
"Resource": "*"
}
]
}
```
------
Per ulteriori informazioni, consulta [Creating IAM policies](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) e [Adding and removing IAM identity permissions](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) nella *Guida per l’utente di IAM*.
## Estensioni
Editor di codice supporta le estensioni IDE disponibili in [Open VSX Registry](https://open-vsx.org/).
Per iniziare a utilizzare le estensioni nel tuo ambiente dell’Editor di codice, scegli l’icona **Estensioni** (![\[Icon showing two overlapping squares representing multiple windows or instances.\]](http://docs.aws.amazon.com/it_it/sagemaker/latest/dg/images/code-editor/code-editor-extensions-icon.png)) nel riquadro di navigazione a sinistra. Qui puoi configurare le connessioni ad AWS installando Kit di strumenti AWS. Per ulteriori informazioni, consultare [Installing the AWS Toolkit for Visual Studio Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/setup-toolkit.html).
Nella barra di ricerca, puoi cercare direttamente estensioni aggiuntive tramite [Open VSX Registry](https://open-vsx.org/), come Kit di strumenti AWS, Jupyter, Python e altre.
# Chiusura delle risorse dell’Editor di codice
Quando hai finito di utilizzare uno spazio dell’Editor di codice, puoi arrestarlo con Studio. In questo modo, interrompi gli addebiti per lo spazio.
In alternativa, puoi eliminare le risorse inutilizzate dell’Editor di codice con la AWS CLI.
## Arresto dello spazio dell’Editor di codice con Studio
Per arrestare lo spazio dell’Editor di codice in Studio, procedi come descritto di seguito:
**Per arrestare lo spazio dell’Editor di codice in Studio**
1. Torna alla pagina di destinazione dell’Editor di codice con uno dei metodi seguenti:
1. Nella barra di navigazione nell’angolo in alto a sinistra, scegli **Editor di codice**.
1. In alternativa, nel riquadro di navigazione a sinistra, scegli **Editor di codice** nel menu **Applicazioni**.
1. Trova il nome dello spazio dell’Editor di codice che hai creato. Se lo stato del tuo spazio è **In esecuzione**, scegli **Arresta** nella colonna **Azione**. Puoi anche arrestare lo spazio direttamente nella pagina dei dettagli dello spazio scegliendo **Interrompi spazio**. L’arresto dello spazio potrebbe richiedere del tempo.
![\[Una pagina dei dettagli dello spazio nell’interfaccia utente dell’applicazione Editor di codice.\]](http://docs.aws.amazon.com/it_it/sagemaker/latest/dg/images/code-editor/code-editor-stop-space.png)
Le risorse aggiuntive come endpoint SageMaker AI, cluster Amazon EMR (Amazon EMR) e Amazon Simple Storage Service (Amazon S3) Simple Storage Service (Amazon S3) creati da Studio non vengono eliminate automaticamente alla chiusura dell'istanza spaziale. Per evitare che vengano addebitati costi relativi alle risorse, elimina le eventuali risorse aggiuntive. Per ulteriori informazioni, consulta [Eliminazione delle risorse inutilizzate](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-updated-jl-admin-guide-clean-up.html).
## Elimina le risorse di Code Editor utilizzando AWS CLI
È possibile eliminare l'applicazione e lo spazio di Code Editor utilizzando AWS Command Line Interface (AWS CLI).
+ [DeleteApp](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DeleteApp.html)
+ [DeleteSpace](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DeleteSpace.html)
# Guida per l’amministratore dell’Editor di codice
Puoi utilizzare l’Editor di codice con un’istanza on demand per tempi di avvio più rapidi e un’archiviazione configurabile. Puoi avviare un'applicazione Code Editor tramite Amazon SageMaker Studio o tramite AWS CLI. Puoi anche modificare le impostazioni predefinite dell’Editor di codice all’interno della console del dominio. Per ulteriori informazioni, consulta [Modifica delle impostazioni del dominio](domain-edit.md). Gli argomenti seguenti illustrano in che modo gli amministratori possono configurare l’Editor di codice, basato su Code-OSS, Visual Studio Code - Open Source, modificando le opzioni di archiviazione, personalizzando gli ambienti e gestendo l’accesso degli utenti. Inoltre, forniscono informazioni sui prerequisiti necessari per utilizzare l’Editor di codice.
**Topics**
+ [
# Completamento dei prerequisiti
](code-editor-admin-prerequisites.md)
+ [
# Concessione dell’accesso a spazi privati per i tuoi utenti
](code-editor-admin-user-access.md)
+ [
# Modifica della dimensione dell’archiviazione predefinita
](code-editor-admin-storage-size.md)
+ [
# Configurazioni del ciclo di vita dell’Editor di codice
](code-editor-use-lifecycle-configurations.md)
+ [
# Immagini personalizzate
](code-editor-custom-images.md)
# Completamento dei prerequisiti
Per utilizzare l’Editor di codice, basato su Code-OSS, Visual Studio Code - Open Source, è necessario completare i prerequisiti seguenti.
1. Devi prima effettuare l'onboarding nel dominio Amazon SageMaker AI e creare un profilo utente. Per ulteriori informazioni, consulta [Panoramica del dominio Amazon SageMaker AI](gs-studio-onboard.md).
1. Se interagisci con la tua applicazione Code Editor utilizzando il AWS CLI, devi inoltre completare i seguenti prerequisiti.
1. AWS CLI Aggiornate il file seguendo la procedura descritta in [Installazione della versione corrente AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv1.html#install-tool-bundled).
1. Dal computer locale, esegui `aws configure` e inserisci le tue credenziali AWS . Per informazioni sulle AWS credenziali, consulta [Comprendere e ottenere le AWS credenziali](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html).
1. (Facoltativo) Per ottenere più spazio di archiviazione ed elaborazione per la tua applicazione, puoi richiedere un aumento delle quote. AWS Per ulteriori informazioni sulla richiesta di un aumento delle quote, consulta [Endpoint e quote Amazon SageMaker AI](https://docs.aws.amazon.com/general/latest/gr/sagemaker.html).
# Concessione dell’accesso a spazi privati per i tuoi utenti
**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 applicano automaticamente tag a tutte le risorse che creano. Se una policy IAM consente a Studio e Studio Classic di creare risorse ma non consente l'etichettatura, possono verificarsi errori AccessDenied "" durante il tentativo di creare risorse. Per ulteriori informazioni, consulta [Fornisci le autorizzazioni per etichettare SageMaker le risorse AI](security_iam_id-based-policy-examples.md#grant-tagging-permissions).
[AWS politiche gestite per Amazon SageMaker AI](security-iam-awsmanpol.md)che danno i permessi per creare SageMaker risorse includono già le autorizzazioni per aggiungere tag durante la creazione di tali risorse.
Questa sezione fornisce una policy che concede agli utenti l’accesso a spazi privati. È anche possibile utilizzare la policy per limitare gli spazi privati e le relative applicazioni per il proprietario associato al profilo utente.
Devi fornire ai tuoi utenti le autorizzazioni per quanto segue:
+ Spazi privati
+ Il profilo utente richiesto per l’accesso agli spazi privati
Per fornire le autorizzazioni, collega la policy seguente ai ruoli IAM dei tuoi utenti.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"sagemaker:CreateApp",
"sagemaker:DeleteApp"
],
"Resource": "arn:aws:sagemaker:us-east-1:111122223333:app/*",
"Condition": {
"Null": {
"sagemaker:OwnerUserProfileArn": "true"
}
}
},
{
"Sid": "SMStudioCreatePresignedDomainUrlForUserProfile",
"Effect": "Allow",
"Action": [
"sagemaker:CreatePresignedDomainUrl"
],
"Resource": "arn:aws:sagemaker:us-east-1:111122223333:user-profile/domain-id/user-profile-name"
},
{
"Sid": "SMStudioAppPermissionsListAndDescribe",
"Effect": "Allow",
"Action": [
"sagemaker:ListApps",
"sagemaker:ListDomains",
"sagemaker:ListUserProfiles",
"sagemaker:ListSpaces",
"sagemaker:DescribeApp",
"sagemaker:DescribeDomain",
"sagemaker:DescribeUserProfile",
"sagemaker:DescribeSpace"
],
"Resource": "*"
},
{
"Sid": "SMStudioAppPermissionsTagOnCreate",
"Effect": "Allow",
"Action": [
"sagemaker:AddTags"
],
"Resource": "arn:aws:sagemaker:us-east-1:111122223333:*/*",
"Condition": {
"Null": {
"sagemaker:TaggingAction": "false"
}
}
},
{
"Sid": "SMStudioRestrictSharedSpacesWithoutOwners",
"Effect": "Allow",
"Action": [
"sagemaker:CreateSpace",
"sagemaker:UpdateSpace",
"sagemaker:DeleteSpace"
],
"Resource": "arn:aws:sagemaker:us-east-1:111122223333:space/domain-id/*",
"Condition": {
"Null": {
"sagemaker:OwnerUserProfileArn": "true"
}
}
},
{
"Sid": "SMStudioRestrictSpacesToOwnerUserProfile",
"Effect": "Allow",
"Action": [
"sagemaker:CreateSpace",
"sagemaker:UpdateSpace",
"sagemaker:DeleteSpace"
],
"Resource": "arn:aws:sagemaker:us-east-1:111122223333:space/domain-id/*",
"Condition": {
"ArnLike": {
"sagemaker:OwnerUserProfileArn": "arn:aws:sagemaker:us-east-1:111122223333:user-profile/domain-id/user-profile-name"
},
"StringEquals": {
"sagemaker:SpaceSharingType": [
"Private",
"Shared"
]
}
}
},
{
"Sid": "SMStudioRestrictCreatePrivateSpaceAppsToOwnerUserProfile",
"Effect": "Allow",
"Action": [
"sagemaker:CreateApp",
"sagemaker:DeleteApp"
],
"Resource": "arn:aws:sagemaker:us-east-1:111122223333:app/domain-id/*",
"Condition": {
"ArnLike": {
"sagemaker:OwnerUserProfileArn": "arn:aws:sagemaker:us-east-1:111122223333:user-profile/domain-id/user-profile-name"
},
"StringEquals": {
"sagemaker:SpaceSharingType": [
"Private"
]
}
}
}
]
}
```
------
# Modifica della dimensione dell’archiviazione predefinita
Puoi modificare le impostazioni di archiviazione predefinite dei tuoi utenti. Puoi anche modificare le impostazioni di archiviazione predefinite in base ai requisiti organizzativi e alle esigenze degli utenti.
Per modificare la dimensione dell’archiviazione per gli utenti, procedi come descritto di seguito:
1. Aggiorna le impostazioni di archiviazione di Amazon EBS nel dominio.
1. Creare un profilo utente e specificare le impostazioni di archiviazione al suo interno.
Utilizzate il seguente comando AWS Command Line Interface (AWS CLI) per aggiornare il dominio.
```
aws --region $REGION sagemaker update-domain \
--domain-id $DOMAIN_ID \
--default-user-settings '{
"SpaceStorageSettings": {
"DefaultEbsStorageSettings":{
"DefaultEbsVolumeSizeInGb":5,
"MaximumEbsVolumeSizeInGb":100
}
}
}'
```
Utilizzate il AWS CLI comando seguente per creare il profilo utente e specificare le impostazioni di archiviazione predefinite.
```
aws --region $REGION sagemaker create-user-profile \
--domain-id $DOMAIN_ID \
--user-profile-name $USER_PROFILE_NAME \
--user-settings '{
"SpaceStorageSettings": {
"DefaultEbsStorageSettings":{
"DefaultEbsVolumeSizeInGb":5,
"MaximumEbsVolumeSizeInGb":100
}
}
}'
```
Utilizzare i seguenti AWS CLI comandi per aggiornare le impostazioni di archiviazione predefinite nel profilo utente.
```
aws --region $REGION sagemaker update-user-profile \
--domain-id $DOMAIN_ID \
--user-profile-name $USER_PROFILE_NAME \
--user-settings '{
"SpaceStorageSettings": {
"DefaultEbsStorageSettings":{
"DefaultEbsVolumeSizeInGb":25,
"MaximumEbsVolumeSizeInGb":200
}
}
}'
```
# Configurazioni del ciclo di vita dell’Editor di codice
Puoi utilizzare le configurazioni del ciclo di vita dell’Editor di codice per automatizzare la personalizzazione del tuo ambiente Studio. Questa personalizzazione include l’installazione di pacchetti personalizzati, la configurazione delle estensioni, il precaricamento di set di dati e la configurazione di repository di codice sorgente.
Le seguenti istruzioni utilizzano il AWS Command Line Interface (AWS CLI) per creare, collegare, eseguire il debug e scollegare configurazioni del ciclo di vita per il tipo di applicazione: `CodeEditor`
+ [Creazione e collegamento delle configurazioni del ciclo di vita in Studio](code-editor-use-lifecycle-configurations-studio-create.md)
+ [Esecuzione del debug delle configurazioni del ciclo di vita in Studio](code-editor-use-lifecycle-configurations-studio-debug.md)
+ [Scollegamento delle configurazioni del ciclo di vita in Studio](code-editor-use-lifecycle-configurations-studio-detach.md)
# Creazione e collegamento delle configurazioni del ciclo di vita in Studio
La sezione seguente fornisce AWS CLI i comandi per creare una configurazione del ciclo di vita, allegare una configurazione del ciclo di vita quando si crea un nuovo profilo utente e allegare una configurazione del ciclo di vita durante l'aggiornamento di un profilo utente. Per i prerequisiti e le fasi generali sulla creazione e il collegamento di configurazioni del ciclo di vita in Studio, consulta [Errore di configurazione del ciclo di vita](jl-lcc-create.md).
Quando crei la configurazione del ciclo di vita di Studio con il comando `create-studio-lifecycle-config`, assicurati di specificare che `studio-lifecycle-config-app-type` è `CodeEditor`. L’esempio seguente mostra come creare una nuova configurazione del ciclo di vita di Studio per la tua applicazione Editor di codice.
```
aws sagemaker create-studio-lifecycle-config \
--studio-lifecycle-config-name my-code-editor-lcc \
--studio-lifecycle-config-content $LCC_CONTENT \
--studio-lifecycle-config-app-type CodeEditor
```
Prendi nota dell’ARN (nome della risorsa Amazon) della configurazione del ciclo di vita appena creata che viene restitutio. Quando colleghi una configurazione del ciclo di vita, inserisci questo ARN nell’elenco di `LifecycleConfigArns` di `CodeEditorAppSettings`.
Puoi collegare una configurazione del ciclo di vita quando crei un profilo utente o un dominio. Nell'esempio seguente viene illustrato come creare un nuovo profilo utente con la configurazione del ciclo di vita collegata. Puoi anche creare un nuovo dominio con una configurazione del ciclo di vita collegata utilizzando il comando [create-domain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/opensearch/create-domain.html).
```
# Create a new UserProfile
aws sagemaker create-user-profile \
--domain-id domain-id \
--user-profile-name user-profile-name \
--user-settings '{
"CodeEditorAppSettings": {
"LifecycleConfigArns":
[lifecycle-configuration-arn-list]
}
}'
```
In alternativa, puoi collegare una configurazione del ciclo di vita quando aggiorni un profilo utente o un dominio. Nell’esempio seguente viene illustrato come aggiornare un profilo utente con la configurazione del ciclo di vita collegata. Puoi anche aggiornare un nuovo dominio con una configurazione del ciclo di vita collegata utilizzando il comando [update-domain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/update-domain.html).
```
# Update a UserProfile
aws sagemaker update-user-profile \
--domain-id domain-id \
--user-profile-name user-profile-name \
--user-settings '{
"CodeEditorAppSettings": {
"LifecycleConfigArns":
[lifecycle-configuration-arn-list]
}
}'
```
# Esecuzione del debug delle configurazioni del ciclo di vita in Studio
Per eseguire il debug degli script di configurazione del ciclo di vita per l’Editor di codice, è necessario utilizzare Studio. Per istruzioni sul debug delle configurazioni del ciclo di vita in Studio, consulta [Esecuzione del debug delle configurazioni del ciclo di vita](jl-lcc-debug.md). Per trovare i log di un’applicazione specifica, cerca nei flussi di log utilizzando il seguente formato:
```
domain-id/space-name/CodeEditor/default/LifecycleConfigOnStart
```
# Scollegamento delle configurazioni del ciclo di vita in Studio
Per scollegare le configurazioni del ciclo di vita per l’Editor di codice, puoi utilizzare la console o la AWS CLI. Per le fasi su come scollegare le configurazioni del ciclo di vita dalla console Studio, consulta [Scollegamento delle configurazioni del ciclo di vita](jl-lcc-delete.md).
Per scollegare una configurazione del ciclo di vita utilizzando il AWS CLI, rimuovi la configurazione del ciclo di vita desiderata dall'elenco delle configurazioni del ciclo di vita collegate alla risorsa. Quindi, passa l’elenco come parte del comando:
+ [update-user-profile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/update-user-profile.html)
+ [update-domain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/update-domain.html)
Ad esempio, il comando seguente rimuove tutte le configurazioni del ciclo di vita per l’applicazione Editor di codice collegate al dominio.
```
aws sagemaker update-domain --domain-id domain-id \
--default-user-settings '{
"CodeEditorAppSettings": {
"LifecycleConfigArns":
[]
}
}'
```
# Creazione di una configurazione del ciclo di vita per clonare i repository in un’applicazione Editor di codice
Questa sezione mostra come clonare un repository e creare un’applicazione Editor di codice con la configurazione del ciclo di vita collegata.
1. Dal computer locale, crea un file denominato `my-script.sh` con il contenuto seguente:
```
#!/bin/bash
set -eux
```
1. Clona il repository desiderato nello script di configurazione del ciclo di vita.
```
export REPOSITORY_URL="https://github.com/aws-samples/sagemaker-studio-lifecycle-config-examples.git"
git -C /home/sagemaker-user clone $REPOSITORY_URL
```
1. Dopo aver finalizzato lo script, crea e collega la configurazione del ciclo di vita. Per ulteriori informazioni, consulta [Creazione e collegamento delle configurazioni del ciclo di vita in Studio](code-editor-use-lifecycle-configurations-studio-create.md).
1. Crea la tua applicazione Editor di codice con la configurazione del ciclo di vita collegata.
```
aws sagemaker create-app \
--domain-id domain-id \
--space-name space-name \
--app-type CodeEditor \
--app-name default \
--resource-spec "SageMakerImageArn=arn:aws:sagemaker:region:image-account-id:image/sagemaker-distribution-cpu,LifecycleConfigArn=arn:aws:sagemaker:region:user-account-id:studio-lifecycle-config/my-code-editor-lcc,InstanceType=ml.t3.large"
```
Per ulteriori informazioni sull'immagine disponibile del Code Editor, vedere. ARNs [Istanze e immagini dell’applicazione Editor di codice](code-editor-use-instances.md)
# Creazione di una configurazione del ciclo di vita per installare le estensioni dell’Editor di codice
Questa sezione mostra come creare una configurazione del ciclo di vita per installare le estensioni da [Open VSX Registry](https://open-vsx.org/) nell’ambiente dell’Editor di codice.
1. Dal computer locale, crea un file denominato `my-script.sh` con il contenuto seguente:
```
#!/bin/bash
set -eux
```
1. All’interno dello script, installa l’estensione [Open VSX Registry](https://open-vsx.org/) di tua scelta:
```
sagemaker-code-editor --install-extension AmazonEMR.emr-tools --extensions-dir /opt/amazon/sagemaker/sagemaker-code-editor-server-data/extensions
```
Puoi recuperare il nome dell’estensione dall’URL dell’estensione in [Open VSX Registry](https://open-vsx.org/). Il nome dell’estensione da utilizzare nel comando `sagemaker-code-editor` deve contenere tutto il testo che segue `https://open-vsx.org/extension/` nell’URL. Sostituisci tutte le istanze di una barra (`/`) con un punto (`.`). Ad esempio, `AmazonEMR/emr-tools` dovrebbe essere `AmazonEMR.emr-tools`.
![\[La pagina delle estensioni di Amazon EMR in Open VSX Registry.\]](http://docs.aws.amazon.com/it_it/sagemaker/latest/dg/images/code-editor/code-editor-emr-extension.png)
1. Dopo aver finalizzato lo script, crea e collega la configurazione del ciclo di vita. Per ulteriori informazioni, consulta [Creazione e collegamento delle configurazioni del ciclo di vita in Studio](code-editor-use-lifecycle-configurations-studio-create.md).
1. Crea la tua applicazione Editor di codice con la configurazione del ciclo di vita collegata:
```
aws sagemaker create-app \
--domain-id domain-id \
--space-name space-name \
--app-type CodeEditor \
--app-name default \
--resource-spec "SageMakerImageArn=arn:aws:sagemaker:region:image-account-id:image/sagemaker-distribution-cpu,LifecycleConfigArn=arn:aws:sagemaker:region:user-account-id:studio-lifecycle-config/my-code-editor-lcc,InstanceType=ml.t3.large"
```
Per ulteriori informazioni sull'immagine disponibile nell'editor di codice ARNs, vedere[Istanze e immagini dell’applicazione Editor di codice](code-editor-use-instances.md). Per ulteriori informazioni su connessioni ed estensioni, consulta [Connessioni ed estensioni dell’Editor di codice](code-editor-use-connections-and-extensions.md).
# Immagini personalizzate
Se hai bisogno di funzionalità diverse da quelle fornite dalla SageMaker distribuzione, puoi aggiungere la tua immagine con le estensioni e i pacchetti personalizzati. Puoi anche utilizzarla per personalizzare l’interfaccia utente dell’Editor di codice in base alle tue esigenze di branding o conformità.
La pagina seguente fornirà informazioni e modelli specifici di Code Editor per creare immagini SageMaker AI personalizzate. Questo ha lo scopo di integrare le informazioni e le istruzioni di Amazon SageMaker Studio su come creare la propria immagine SageMaker AI e portare la propria immagine in Studio. Per informazioni sulle immagini Amazon SageMaker AI personalizzate e su come portare la tua immagine in Studio, consulta[Bring Your Own Image (BYOI)](studio-updated-byoi.md).
**Topics**
+ [
## Controllo dell’integrità e URL per le applicazioni
](#code-editor-custom-images-app-healthcheck)
+ [
## Esempi di Dockerfile
](#code-editor-custom-images-dockerfile-templates)
## Controllo dell’integrità e URL per le applicazioni
+ `Base URL`: l’URL di base per l’applicazione BYOI deve essere `CodeEditor/default`. È possibile avere una sola applicazione e deve avere sempre il nome `default`.
+ Endpoint Health check: è necessario ospitare il server Code Editor sulla porta 0.0.0.0 8888 affinché SageMaker AI lo rilevi.
+ Autenticazione: è necessario eseguire l'autenticazione `sagemaker-code-editor` all'`--without-connection-token`apertura per consentire all' SageMaker IA di autenticare gli utenti.
**Nota**
Se utilizzi Amazon SageMaker Distribution come immagine di base, questi requisiti sono già soddisfatti come parte dello `entrypoint-code-editor` script incluso.
## Esempi di Dockerfile
Gli esempi seguenti sono `Dockerfile` che soddisfano le informazioni descritte sopra e quelle in [Specifiche dell’immagine personalizzata](studio-updated-byoi-specs.md).
**Nota**
Se stai trasferendo la tua immagine in SageMaker Unified Studio, dovrai seguire le [specifiche di Dockerfile nella Guida](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html) per l'utente di *Amazon SageMaker Unified* Studio.
`Dockerfile`alcuni esempi di SageMaker Unified Studio sono disponibili nell'[esempio di Dockerfile](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html#byoi-specifications-example) nella *Amazon SageMaker Unified* Studio User Guide.
------
#### [ Example micromamba Dockerfile ]
Di seguito è riportato un esempio di Dockerfile per creare un’immagine da zero utilizzando un ambiente di base [https://mamba.readthedocs.io/en/latest/user_guide/micromamba.html](https://mamba.readthedocs.io/en/latest/user_guide/micromamba.html):
```
FROM mambaorg/micromamba:latest
ARG NB_USER="sagemaker-user"
ARG NB_UID=1000
ARG NB_GID=100
USER root
RUN micromamba install -y --name base -c conda-forge sagemaker-code-editor
USER $NB_UID
CMD eval "$(micromamba shell hook --shell=bash)"; \
micromamba activate base; \
sagemaker-code-editor --host 0.0.0.0 --port 8888 \
--without-connection-token \
--base-path "/CodeEditor/default"
```
------
#### [ Example SageMaker AI Distribution Dockerfile ]
Di seguito è riportato un esempio di Dockerfile per creare un'immagine basata su [Amazon SageMaker AI](https://github.com/aws/sagemaker-distribution/tree/main) Distribution:
```
FROM public.ecr.aws/sagemaker/sagemaker-distribution:latest-cpu
ARG NB_USER="sagemaker-user"
ARG NB_UID=1000
ARG NB_GID=100
ENV MAMBA_USER=$NB_USER
USER root
# install scrapy in the base environment
RUN micromamba install -y --name base -c conda-forge scrapy
# download VSCodeVim
RUN \
wget https://github.com/VSCodeVim/Vim/releases/download/v1.27.2/vim-1.27.2.vsix \
-P /tmp/exts/ --no-check-certificate
# Install the extension
RUN \
extensionloc=/opt/amazon/sagemaker/sagemaker-code-editor-server-data/extensions \
&& sagemaker-code-editor \
--install-extension "/tmp/exts/vim-1.27.2.vsix" \
--extensions-dir "${extensionloc}"
USER $MAMBA_USER
ENTRYPOINT ["entrypoint-code-editor"]
```
------