# Amazon CodeCatalyst per JetBrains
## Cos'è Amazon CodeCatalyst?
Amazon CodeCatalyst è uno spazio di collaborazione basato su cloud per i team di sviluppo software. Tramite il Kit di strumenti AWS per JetBrains Gateway, è possibile visualizzare e gestire le proprie risorse CodeCatalyst direttamente da JetBrains Gateway. È inoltre possibile utilizzare il Kit di strumenti per avviare, gestire e modificare gli ambienti di elaborazione virtuali di Ambienti di sviluppo. Per ulteriori informazioni su CodeCatalyst, consulta la Guida per l'utente di [Amazon CodeCatalyst](https://docs.aws.amazon.com/codecatalyst/latest/userguide/welcome.html).
Nei seguenti argomenti viene descritto come connettere il Kit di strumenti AWS per JetBrains Gateway con CodeCatalyst e come lavorare con CodeCatalyst tramite JetBrains Gateway.
**Topics**
+ [
## Cos'è Amazon CodeCatalyst?
](#codecatalyst-intro)
+ [Nozioni di base su CodeCatalyst](codecatalyst-setup.md)
+ [Utilizzo di CodeCatalyst](codecatalyst-overview.md)
# Nozioni di base su CodeCatalyst e il AWS Toolkit for JetBrains
Per iniziare a lavorare con CodeCatalyst da JetBrains Gateway, completa le operazioni seguenti.
**Topics**
+ [
## Installazione di JetBrains Gateway
](#codecatalyst-setup-jbgateway)
+ [
## Installazione del Kit di strumenti AWS per JetBrains Gateway
](#codecatalyst-setup-toolkit)
+ [
## Creazione di un account CodeCatalyst e un ID Builder AWS
](#codecatalyst-setup-id)
+ [
## Connessione di JetBrains Gateway con CodeCatalyst
](#codecatalyst-setup-connect)
## Installazione di JetBrains Gateway
Prima di integrare il Kit di strumenti AWS con i tuoi account CodeCatalyst, assicurati di utilizzare una versione aggiornata di JetBrains Gateway. Per scaricare l'ultima versione di JetBrains Gateway, scegli la distribuzione JetBrains Gateway desiderata dai seguenti link:
+ [JetBrains Gateway per Linux](https://download.jetbrains.com/product?code=GW&latest&distribution=linux)
+ [JetBrains Gateway per Windows]( https://download.jetbrains.com/product?code=GW&latest&distribution=windows)
+ [JetBrains Gateway per macOS](https://download.jetbrains.com/product?code=GW&latest&distribution=mac)
+ [JetBrains Gateway per macOS Apple Silicon](https://download.jetbrains.com/product?code=GW&latest&distribution=macM1)
## Installazione del Kit di strumenti AWS per JetBrains Gateway
Per connettere JetBrains al tuo account CodeCatalyst, devi installare l'ultima versione dell'estensione del kit di strumenti. È possibile trovare la versione più recente e completare l'installazione del kit di strumenti direttamente da **Plugins Marketplace** di JetBrains.
Per installare il plug-in del Kit di strumenti AWS da **Plugins Marketplace** di JetBrains, completa i seguenti passaggi:
1. Dalla schermata principale di JetBrains Gateway, scegli l'icona **Settings/Preferences**, che si trova nell'angolo in basso a sinistra dell'applicazione.
1. Scegli **Settings/Preferences** per aprire la visualizzazione **Settings/Preferences**.
1. Dalla visualizzazione **Settings/Preferences**, scegli **Plugins** per aprire il menu **Plugins**.
**Nota**
La visualizzazione **Plugins** può essere aperta sia nella visualizzazione **Marketplace** sia nella visualizzazione **Installed**.
Se è la prima volta che installi il Kit di strumenti AWS per JetBrains Gateway, seleziona la visualizzazione **Plugins Marketplace** per continuare.
Se disponi di una versione precedente del Kit di strumenti AWS per JetBrains Gateway, esegui l'aggiornamento dalla visualizzazione **Installaed**.
1. Dalla visualizzazione del **Marketplace**, inserisci il testo `AWS Toolkit` e seleziona la voce del plug-in **AWS Toolkit** quando appare.
1. Scegli **Install** per scaricare e installare il **Kit di strumenti AWS per JetBrains Gateway**.
**Nota**
JetBrains Gateway mostra lo stato del download e dell'avanzamento dell'installazione. Dopo aver installato correttamente il kit di strumenti, l'esploratore **Connections** di JetBrains Gateway si aggiorna con l'icona del plug-in di **Amazon CodeCatalyst**.
## Creazione di un account CodeCatalyst e un ID Builder AWS
Oltre a installare la versione più recente del AWS Toolkit for JetBrains, è necessario avere un ID Builder AWS e un account CodeCatalyst per eseguire la connessione con JetBrains Gateway. Se non disponi di un ID Builder AWS o un account CodeCatalyst attivo, consulta la sezione [Setting up CodeCatalyst](https://docs.aws.amazon.com/codecatalyst/latest/userguide/setting-up-topnode.html) della Guida per l'utente di *CodeCatalyst*.
**Nota**
Un ID Builder AWS è diverso dalle credenziali di AWS. AWS La maggior parte dei Servizi AWS che sono accessibili dal Kit di strumenti AWS richiede le credenziali. Un ID Builder AWS è necessario per creare un nuovo account CodeCatalyst e utilizzare un account CodeCatalyst esistente. Ciò include l'utilizzo di tutte le funzionalità di CodeCatalyst disponibili nel Kit di strumenti AWS.
## Connessione di JetBrains Gateway con CodeCatalyst
Per connettere JetBrains Gateway con il tuo account CodeCatalyst, completa i seguenti passaggi.
1. Dall'esploratore **Connections** di JetBrains Gateway, scegli il plug-in **Amazon CodeCatalyst** per aprire la visualizzazione **Amazon CodeCatalyst**.
1. Dalla visualizzazione del plug-in **CodeCatalyst**, scegli **Accedi con ID Builder AWS** per aprire il prompt **È richiesto l'accesso ad AWS**.
1. Dal prompt **È richiesto l'accesso ad AWS**, scegli **Apri il browser** per aprire la schermata di accesso alla console CodeCatalyst nel tuo browser Web preferito.
1. Inserisci l'ID Builder AWS nell'apposito campo e segui le istruzioni per continuare.
1. Quando richiesto, scegli **Consenti** per confermare la connessione tra JetBrains e il tuo account CodeCatalyst. Quando il processo di connessione è completo, CodeCatalyst visualizza una conferma che indica che è possibile chiudere il browser.
1. Da JetBrains Gateway, la visualizzazione del plug-in **CodeCatalyst** viene aggiornata alla visualizzazione **Dev Environments**.
# Utilizzo di Amazon CodeCatalyst in JetBrains Gateway
È possibile avviare un ambiente di elaborazione virtuale, noto come ambiente di sviluppo, da JetBrains. Gli ambienti di sviluppo sono ambienti di sviluppo cloud personalizzabili che puoi copiare e condividere tra i diversi membri del team nel tuo spazio. Per ulteriori informazioni sugli ambienti di sviluppo e su come accedervi da CodeCatalyst, consulta la sezione [Dev Environments](https://docs.aws.amazon.com/codecatalyst/latest/userguide/codecatalyst/latest/userguide/devenvironment.html) della *Guida per l'utente di Amazon CodeCatalyst*.
Nelle sezioni seguenti viene descritto come creare, aprire e utilizzare gli ambienti di sviluppo da JetBrains Gateway.
**Topics**
+ [
## Apertura di un ambiente di sviluppo
](#codecatalyst-overview-open)
+ [
## Creazione di un ambiente di sviluppo
](#codecatalyst-overview-creating)
+ [
## Creazione di un ambiente di sviluppo da un repository di terze parti
](#codecatalyst-overview-creating-source-repo)
+ [
## Configurazione delle impostazioni dell'ambiente di sviluppo
](#codecatalyst-overview-configure)
+ [
## Sospensione di un ambiente di sviluppo
](#codecatalyst-overview-pause)
+ [
## Ripresa del lavoro in un ambiente di sviluppo
](#codecatalyst-overview-resume)
+ [
## Eliminazione di un ambiente di sviluppo
](#codecatalyst-overview-delete)
+ [
## Configurazione delle impostazioni predefinite degli ambienti di sviluppo
](#codecatalyst-overview-default)
## Apertura di un ambiente di sviluppo
Per aprire un ambiente di sviluppo esistente da JetBrains Gateway, completa i seguenti passaggi.
1. Dall'esploratore **Connections**, scegli il plug-in **Amazon CodeCatalyst**.
1. Dal corpo della procedura guidata **Sviluppo remoto**, accedi allo spazio principale e progetta l'ambiente di sviluppo che desideri aprire.
1. Scegli l'ambiente di sviluppo che desideri aprire.
1. Verifica il processo di apertura dell'ambiente di sviluppo per continuare.
**Nota**
JetBrains mostra l'avanzamento in una nuova finestra di stato. Quando il processo di apertura è completo, l'ambiente di sviluppo si apre in una nuova finestra.
## Creazione di un ambiente di sviluppo
Per creare un nuovo ambiente di sviluppo:
1. Dall'esploratore **Connections**, scegli il plug-in **CodeCatalyst**.
1. Dalla sezione **Sviluppo in remoto** dell'intestazione della procedura guidata, seleziona il link **Crea un ambiente di sviluppo** per aprire la visualizzazione **Nuovo ambiente di sviluppo CodeCatalyst**.
1. Dalla visualizzazione **Nuovo ambiente di sviluppo CodeCatalyst**, utilizza i seguenti campi per configurare le preferenze dell'ambiente di sviluppo.
+ **IDE**: seleziona il tuo IDE JetBrains preferito da avviare all'interno dell'ambiente di sviluppo.
+ **Progetto CodeCatalyst**: scegli uno spazio e un progetto CodeCatalyst per l'ambiente di sviluppo.
+ **Alias dell'ambiente di sviluppo**: inserisci un nome alternativo per l'ambiente di sviluppo.
+ **Calcolo**: scegli la configurazione hardware virtuale per l'ambiente di sviluppo.
+ **Archiviazione persistente**: scegli la quantità di archiviazione persistente per l'ambiente di sviluppo.
+ **Timeout per inattività**: scegli il tempo di inattività del sistema che può trascorrere prima che l'ambiente di sviluppo entri in standby.
1. Per creare l'ambiente di sviluppo, scegli **Crea ambiente di sviluppo**.
**Nota**
Quando scegli **Crea ambiente di sviluppo**, la visualizzazione **Nuovo ambiente di sviluppo** si chiude e inizia il processo di creazione dell'ambiente di sviluppo. Il processo può richiedere diversi minuti e non è possibile utilizzare altre funzionalità di JetBrains Gateway finché la creazione dell'ambiente di sviluppo non viene ultimata.
JetBrains mostra l'avanzamento in una nuova finestra di stato. Quando il processo è completo, l'ambiente di sviluppo si apre in una nuova finestra.
## Creazione di un ambiente di sviluppo da un repository di terze parti
È possibile creare ambienti di sviluppo da un repository di terze parti connettendosi al repository come origine.
La connessione a un repository di terze parti come origine viene gestita a livello di progetto in CodeCatalyst. Per istruzioni e dettagli aggiuntivi su come connettere un repository di terze parti a un ambiente di sviluppo, consulta l'argomento [Linking a source repository](https://docs.aws.amazon.com/codecatalyst/latest/userguide/source-repositories-link.html) della *Guida per l'utente di Amazon CodeCatalyst*.
## Configurazione delle impostazioni dell'ambiente di sviluppo
Per modificare le impostazioni per un ambiente di sviluppo esistente da JetBrains Gateway, completa i seguenti passaggi.
**Nota**
Non è possibile modificare la quantità di spazio di archiviazione assegnata all'ambiente di sviluppo dopo averlo creato.
1. Dall'esploratore **Connections**, scegli il plug-in **Amazon CodeCatalyst**.
1. Dal corpo della procedura guidata **Sviluppo remoto**, accedi allo spazio principale e progetta l'ambiente di sviluppo che desideri configurare.
1. Scegli l'icona **Impostazioni** accanto all'ambiente di sviluppo che desideri configurare per aprire le impostazioni **Configura l'ambiente di sviluppo:**.
1. Dal menu delle impostazioni **Configura l'ambiente di sviluppo:**, configura l'ambiente di sviluppo modificando le seguenti opzioni:
+ **Alias dell'ambiente di sviluppo**: campo facoltativo per specificare un nome alternativo per l'ambiente di sviluppo.
+ **IDE:** scegli l'IDE JetBrains che desideri avviare all'interno del tuo ambiente di sviluppo.
+ **Calcolo**: scegli la configurazione hardware virtuale per l'ambiente di sviluppo.
+ **Timeout per inattività**: scegli il tempo di inattività del sistema che può trascorrere prima che l'ambiente di sviluppo entri in standby.
## Sospensione di un ambiente di sviluppo
L'attività nel tuo ambiente di sviluppo viene archiviata in modo persistente. Ciò significa che puoi sospendere l'ambiente di sviluppo e riprendere l'attività in seguito senza perdere il lavoro.
Per sospendere l'ambiente di sviluppo, completa i seguenti passaggi.
1. Dall'esploratore **Connections**, scegli il plug-in **Amazon CodeCatalyst**.
1. Dal corpo della procedura guidata **Sviluppo remoto**, accedi allo spazio principale e al progetto dell'ambiente di sviluppo che desideri sospendere.
1. Scegli l'icona **Sospendi** accanto all'ambiente di sviluppo attivo per aprire la finestra di dialogo **Conferma sospensione**.
1. Scegli **Sì** per chiudere la finestra di dialogo **Conferma sospensione** e avviare il processo di sospensione.
**Nota**
JetBrains mostra l'avanzamento del processo di sospensione in una nuova finestra di stato. Quando l'ambiente di sviluppo è stato arrestato, l'icona **Sospendi** viene rimossa dall'interfaccia utente.
## Ripresa del lavoro in un ambiente di sviluppo
L'attività nel tuo ambiente di sviluppo viene archiviata in modo persistente. Ciò significa che puoi riprendere un ambiente di sviluppo precedentemente sospeso senza perdere il lavoro.
Per riprendere un ambiente di sviluppo sospeso, completa i seguenti passaggi.
1. Dall'esploratore **Connections**, scegli il plug-in **Amazon CodeCatalyst**.
1. Dal corpo della procedura guidata **Sviluppo remoto**, accedi allo spazio principale e progetta l'ambiente di sviluppo che desideri riprendere.
1. Scegli l'ambiente di sviluppo che desideri riprendere.
**Nota**
JetBrains mostra l'avanzamento del processo di ripresa in una nuova finestra di stato. Quando l'ambiente di sviluppo è ripreso, l'icona **Sospendi** viene aggiunta accanto all'icona **Impostazioni** dell'ambiente di sviluppo.
## Eliminazione di un ambiente di sviluppo
Per eliminare l'ambiente di sviluppo, completa i seguenti passaggi:
1. Dall'esploratore **Connections**, scegli il plug-in **Amazon CodeCatalyst**.
1. Dal corpo della procedura guidata **Sviluppo remoto**, accedi allo spazio principale e progetta l'ambiente di sviluppo che desideri eliminare.
1. Seleziona il pulsante icona **X** accanto al tuo ambiente di sviluppo per aprire la finestra di dialogo **Conferma eliminazione**.
1. Scegli **Sì** per chiudere la finestra di dialogo ed eliminare l'ambiente di sviluppo.
**Importante**
Dopo aver scelto **Sì**, l'ambiente di sviluppo viene eliminato e non può essere recuperato. Prima di eliminare un ambiente di sviluppo, assicurati di eseguire il commit e inviare le modifiche al codice nel repository di origine iniziale. In caso contrario, le modifiche non salvate andranno perse definitivamente.
Dopo l'eliminazione di un ambiente di sviluppo, la procedura guidata **Sviluppo in remoto** si aggiorna e l'ambiente di sviluppo non è più elencato nelle tue risorse.
## Configurazione delle impostazioni predefinite degli ambienti di sviluppo
È possibile configurare le impostazioni predefinite dell'ambiente di sviluppo nel `devfile` dell'ambiente di sviluppo. La specifica `devfile` è uno standard aperto che è possibile aggiornare in un documento YAML.
Per ulteriori informazioni su come definire e configurare i `devfile`, consulta la pagina [devfile.io](https://devfile.io/).
Per aprire e modificare un `devfile` da un'istanza dell'ambiente di sviluppo di JetBrains Gateway, completa i seguenti passaggi.
1. Dalla **Barra di navigazione** nell'ambiente di sviluppo JetBrains attivo, espandi il nodo **Ambiente di sviluppo Amazon CodeCatalyst** per aprire il menu **Dettagli sullo stato del back-end**.
1. Scegli la scheda **Configura l'ambiente di sviluppo**, quindi scegli **Apri Devfile** per aprire il `devfile` nell'**Editor** di JetBrains.
1. Dall'**Editor**, apporta modifiche al `devfile` e salva il tuo lavoro.
1. Dopo aver salvato le modifiche, il nodo **Ambiente di sviluppo Amazon CodeCatalyst** visualizza un avviso che indica che l'ambiente di sviluppo richiede la ricostruzione.
1. Espandi il nodo **Ambiente di sviluppo Amazon CodeCatalyst** e scegli il nodo **Ricostruisci l'ambiente di sviluppo** dalla scheda **Configura l'ambiente di sviluppo**.