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à. # 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 il 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)