

Amazon non CodeCatalyst è più aperta a nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta [Come migrare da CodeCatalyst](migration.md).

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à.

# Risoluzione dei problemi con gli ambienti di sviluppo
<a name="devenvironments-troubleshooting"></a>

Consulta le seguenti sezioni per risolvere i problemi relativi agli ambienti di sviluppo. Per ulteriori informazioni sugli ambienti di sviluppo, vedere. [Scrivi e modifica il codice con Dev Environments in CodeCatalystScrivi e modifica il codice con Dev Environments](devenvironment.md)

**Topics**
+ [La creazione del mio ambiente di sviluppo non è riuscita a causa di un problema con le quote](#troubleshooting-devenvironments-create)
+ [Non riesco a trasferire le modifiche dal mio ambiente di sviluppo a un ramo specifico di un repository](#troubleshooting-devenvironments-branchrules)
+ [Il mio ambiente di sviluppo non è stato ripreso](#troubleshooting-devenvironments-resume)
+ [Il mio ambiente di sviluppo si è disconnesso](#troubleshooting-devenvironments-connection)
+ [Il mio ambiente di sviluppo connesso al VPC non è riuscito](#troubleshooting-devenvironments-vpc)
+ [Non riesco a trovare la cartella in cui si trova il mio progetto](#troubleshooting-devenvironments-projects)
+ [Non riesco a connettermi al mio ambiente di sviluppo tramite SSH](#troubleshooting-devenvironments-connect-ssh)
+ [Non riesco a connettermi al mio ambiente di sviluppo tramite SSH perché manca la mia configurazione SSH locale](#troubleshooting-devenvironments-projects-ssh-config)
+ [Non riesco a connettermi al mio ambiente di sviluppo tramite SSH perché ho problemi con il mio profilo for the AWS Config `codecatalyst`](#troubleshooting-devenvironments-config-profile)
+ [Non riesco a creare un ambiente di sviluppo quando ho effettuato l'accesso CodeCatalyst utilizzando un account Single Sign-on](#troubleshoot-create-dev-env-idprovider)
+ [Risoluzione dei problemi con IDEs](devenvironments-troubleshooting-ides.md)
+ [Risoluzione dei problemi con devfiles](devenvironments-devenvironments-devfile.md)

## La creazione del mio ambiente di sviluppo non è riuscita a causa di un problema con le quote
<a name="troubleshooting-devenvironments-create"></a>

**Problema:** voglio creare un ambiente di sviluppo in CodeCatalyst, ma vedo un errore. Nella console, nella pagina Dev Environments vedo un messaggio che indica che ho raggiunto il limite di spazio di archiviazione per lo spazio.

**Possibili correzioni:** a seconda del ruolo che ricopri nel progetto o nello spazio, puoi eliminare uno o più ambienti di sviluppo personali oppure, se hai il ruolo di amministratore dello spazio, puoi eliminare gli ambienti di sviluppo non utilizzati creati da altri utenti. Puoi anche decidere di modificare il livello di fatturazione con uno che includa più spazio di archiviazione.
+ Per visualizzare i limiti di archiviazione, visualizza la scheda **Fatturazione** CodeCatalyst dello spazio Amazon per verificare se le quote di **utilizzo** hanno raggiunto il massimo consentito. Se le quote hanno raggiunto il massimo, contatta qualcuno con il ruolo di amministratore di Space per rimuovere gli ambienti di sviluppo non necessari o per prendere in considerazione la modifica del livello di fatturazione.
+ Per rimuovere gli ambienti di sviluppo che hai creato e che non ti servono più, consulta. [Eliminazione di un ambiente di sviluppo](devenvironment-delete.md)

Se il problema persiste e ricevi un errore nell'IDE, verifica di avere un CodeCatalyst ruolo che ti consenta di creare un ambiente di sviluppo. Il ruolo di **amministratore dello spazio**, il ruolo di **amministratore del progetto** e il ruolo di **collaboratore** sono tutti autorizzati a creare ambienti di sviluppo. Per ulteriori informazioni, consulta [Concessione dell'accesso con ruoli utente](ipa-roles.md).

## Non riesco a trasferire le modifiche dal mio ambiente di sviluppo a un ramo specifico di un repository
<a name="troubleshooting-devenvironments-branchrules"></a>

**Problema:** voglio eseguire il commit e inviare le modifiche al codice nel mio ambiente di sviluppo a un ramo in un repository di sorgenti, ma vedo un errore. 

**Possibili correzioni:** a seconda del ruolo che ricopri nel progetto o nello spazio, potresti non avere le autorizzazioni per inviare il codice ai repository di sorgenti del progetto. Il ruolo di **amministratore dello spazio**, il ruolo di **amministratore del progetto** e il ruolo di **collaboratore** sono tutti autorizzati a inviare codice ai repository del progetto.

Se hai il ruolo di **Collaboratore** ma non puoi inviare codice a un ramo specifico, potrebbe essere configurata una regola di branch per il ramo specifico che impedisce agli utenti con quel ruolo di inviare codice a quel particolare ramo. Prova a inviare le modifiche a un altro ramo oppure crea un ramo e poi invia il codice a quel ramo. Per ulteriori informazioni, consulta [Gestisci le azioni consentite per una filiale con le regole della filiale](source-branches-branch-rules.md).

## Il mio ambiente di sviluppo non è stato ripreso
<a name="troubleshooting-devenvironments-resume"></a>

**Problema:** il mio ambiente di sviluppo non è ripreso dopo averlo interrotto.

**Possibili correzioni:** per risolvere il problema, visualizza la scheda **Fatturazione** CodeCatalyst dello spazio Amazon per vedere se le quote di **utilizzo** hanno raggiunto i limiti massimi. Se le quote hanno raggiunto il limite massimo, contatta l'amministratore di Space per aumentare il livello di fatturazione.

## Il mio ambiente di sviluppo si è disconnesso
<a name="troubleshooting-devenvironments-connection"></a>

**Problema:** il mio ambiente di sviluppo si è disconnesso mentre lo stavo usando.

**Possibili soluzioni:** per risolvere il problema, controlla la tua connessione Internet. Se non sei connesso a Internet, connettiti e riprendi a lavorare nel tuo ambiente di sviluppo.

## Il mio ambiente di sviluppo connesso al VPC non è riuscito
<a name="troubleshooting-devenvironments-vpc"></a>

**Problema:** ho associato una connessione VPC al mio ambiente di sviluppo e si verificano degli errori.

**Possibili correzioni:** Docker utilizza un dispositivo a livello di collegamento chiamato rete bridge che consente ai contenitori collegati alla stessa rete di bridge di comunicare. Di norma, il bridge di default utilizza la sottorete `172.17.0.0/16` per le reti dei container. Se la sottorete VPC per l'istanza dell'ambiente utilizza lo stesso intervallo di indirizzi già usato da Docker, può verificarsi un conflitto di indirizzi IP. Per risolvere un conflitto di indirizzi IP causato da Amazon VPC e che Docker utilizza lo stesso blocco di indirizzi IPv4 CIDR, configura un blocco CIDR diverso da. `172.17.0.0/16`

**Nota**  
Non è possibile modificare l'intervallo di indirizzi IP di un VPC o di una sottorete esistente.

## Non riesco a trovare la cartella in cui si trova il mio progetto
<a name="troubleshooting-devenvironments-projects"></a>

**Problema:** non riesco a trovare la cartella in cui si trova il mio progetto.

**Possibili correzioni:** per localizzare il progetto, cambia cartella in cui `/projects` si trova. Questa è la cartella in cui puoi trovare i tuoi progetti.

## Non riesco a connettermi al mio ambiente di sviluppo tramite SSH
<a name="troubleshooting-devenvironments-connect-ssh"></a>

Per risolvere i problemi di connessione al tuo ambiente di sviluppo tramite SSH, puoi eseguire il `ssh` comando con l'`-vvv`opzione per mostrare ulteriori informazioni su come risolvere il problema:

```
ssh -vvv codecatalyst-dev-env=<space-name>=<project-name>=<dev-environment-id>
```

## Non riesco a connettermi al mio ambiente di sviluppo tramite SSH perché manca la mia configurazione SSH locale
<a name="troubleshooting-devenvironments-projects-ssh-config"></a>

Se manca la configurazione SSH locale (`~/.ssh/config`) o il contenuto della `Host codecatalyst-dev-env*` sezione non è aggiornato, non potrai connetterti al tuo ambiente di sviluppo tramite SSH. **Per risolvere questo problema, elimina la `Host codecatalyst-dev-env*` sezione ed esegui nuovamente il primo comando dal modale SSH Access.** Per ulteriori informazioni, consulta [Connessione a un ambiente di sviluppo tramite SSH](devenvironment-connect-ssh.md).

## Non riesco a connettermi al mio ambiente di sviluppo tramite SSH perché ho problemi con il mio profilo for the AWS Config `codecatalyst`
<a name="troubleshooting-devenvironments-config-profile"></a>

Assicurati che il tuo AWS Config (`~/.aws/config`) per il `codecatalyst` profilo corrisponda a quello descritto in[Configurazione per l'utilizzo AWS CLI di CodeCatalyst](set-up-cli.md). In caso contrario, elimina il profilo `codecatalyst` ed esegui nuovamente il primo comando dal modale **SSH Access**. Per ulteriori informazioni, consulta [Connessione a un ambiente di sviluppo tramite SSH](devenvironment-connect-ssh.md).

## Non riesco a creare un ambiente di sviluppo quando ho effettuato l'accesso CodeCatalyst utilizzando un account Single Sign-on
<a name="troubleshoot-create-dev-env-idprovider"></a>

**Problema:** quando accedo alla CodeCatalyst console come utente SSO, ricevo un errore di eccezione sconosciuto quando scelgo di creare un ambiente di sviluppo nello spazio. Quando scelgo di creare un ambiente di sviluppo e scelgo l'IDE per l'accesso, ad esempio AWS Cloud9, riscontro problemi simili ai seguenti: 
+ La pagina **Dev Environments** nella CodeCatalyst console mostra l'ambiente di sviluppo nell'elenco con uno `FAILED` stato.
+ Viene visualizzato un messaggio di errore simile al seguente:

  **`An unknown exception happened`**

  `We encountered an unknown exception when launching your Dev Environment. Mention your Dev Environment id error_message_ID if you want to report or need any help.`

**Possibili soluzioni.** 

Gli ambienti di sviluppo non sono disponibili per gli utenti negli spazi in cui Active Directory viene utilizzato come provider di identità. Gli amministratori dello spazio possono utilizzare un provider di identità alternativo per accedere agli ambienti di sviluppo, come IAM Identity Center. Per ulteriori informazioni sulla pianificazione di uno spazio che supporti la federazione delle identità, consulta [Pianificazione dello spazio che supporti la federazione delle identità](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/setting-up-federation.html#setting-up-planning-federation) nella *Guida per l'CodeCatalyst amministratore*.

# Risoluzione dei problemi con IDEs
<a name="devenvironments-troubleshooting-ides"></a>

Consulta le seguenti sezioni per risolvere i problemi relativi a in. IDEs CodeCatalyst Per ulteriori informazioni su IDEs, vedere. [Creazione di un ambiente di sviluppo in un IDE](devenvironment-create.md#devenvironment-using-ide)

**Topics**
+ [Ho versioni di immagini di runtime non corrispondenti in AWS Cloud9](#troubleshooting-devenvironments-c9-runtime)
+ [Non riesco ad accedere ai miei file in `/projects/projects` in AWS Cloud9](#troubleshooting-devenvironments-c9-filesystem)
+ [Non riesco ad avviare il mio ambiente di sviluppo AWS Cloud9 utilizzando un devfile personalizzato](#troubleshooting-devenvironments-c9-image)
+ [Sto riscontrando problemi in AWS Cloud9](#troubleshooting-c9)
+ [Nel JetBrains, non riesco a connettermi ai miei ambienti di sviluppo tramite CodeCatalyst](#troubleshooting-jetbrains-connect)
+ [Non riesco a installarlo Kit di strumenti AWS per il mio IDE](#troubleshooting-ide-toolkit)
+ [Nel mio IDE, non riesco ad avviare i miei ambienti di sviluppo](#troubleshooting-ide-launch)

## Ho versioni di immagini di runtime non corrispondenti in AWS Cloud9
<a name="troubleshooting-devenvironments-c9-runtime"></a>

AWS Cloud9 utilizza versioni diverse della risorsa frontend e dell'immagine di runtime del backend. L'utilizzo di versioni diverse potrebbe causare un funzionamento errato dell'estensione Git. Kit di strumenti AWS Per risolvere il problema, accedi alla dashboard di Dev Environment, interrompi Dev Environment e riavvialo. Per risolvere il problema di utilizzo APIs, utilizza l'`UpdateDevEnvironment`API per aggiornare il runtime. Per ulteriori informazioni, [UpdateDevEnvironment](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_UpdateDevEnvironment.html)consulta il *riferimento alle CodeCatalyst API di Amazon*.

## Non riesco ad accedere ai miei file in `/projects/projects` in AWS Cloud9
<a name="troubleshooting-devenvironments-c9-filesystem"></a>

L' AWS Cloud9 editor non è in grado di accedere ai file nella directory`/projects/projects`. Per risolvere il problema, utilizzate il AWS Cloud9 terminale per accedere ai file o spostateli in un'altra directory.

## Non riesco ad avviare il mio ambiente di sviluppo AWS Cloud9 utilizzando un devfile personalizzato
<a name="troubleshooting-devenvironments-c9-image"></a>

L'immagine del tuo devfile potrebbe non essere compatibile con. AWS Cloud9 Per risolvere il problema, esamina il devfile dal tuo repository e dall'ambiente di sviluppo corrispondente e creane uno nuovo per continuare.

## Sto riscontrando problemi in AWS Cloud9
<a name="troubleshooting-c9"></a>

Per altri problemi, consulta la sezione sulla risoluzione dei problemi nella Guida per l'[AWS Cloud9 utente](https://docs.aws.amazon.com/cloud9/latest/user-guide/troubleshooting.html).

## Nel JetBrains, non riesco a connettermi ai miei ambienti di sviluppo tramite CodeCatalyst
<a name="troubleshooting-jetbrains-connect"></a>

Per risolvere il problema, verifica di avere JetBrains installato solo la versione più recente di. Se disponi di più versioni, disinstalla le versioni precedenti e registra nuovamente il gestore di protocollo chiudendo l'IDE e il browser. Quindi apri JetBrains e registra nuovamente il gestore di protocollo.

## Non riesco a installarlo Kit di strumenti AWS per il mio IDE
<a name="troubleshooting-ide-toolkit"></a>

Per risolvere questo problema per VS Code, installa manualmente AWS Toolkit for Visual Studio Code da [GitHub](https://github.com/aws/aws-toolkit-vscode/releases).

Per risolvere questo problema JetBrains, installa manualmente AWS Toolkit for JetBrains da [GitHub](https://github.com/aws/aws-toolkit-jetbrains/releases).

## Nel mio IDE, non riesco ad avviare i miei ambienti di sviluppo
<a name="troubleshooting-ide-launch"></a>

Per risolvere questo problema per VS Code, verifica di avere l'ultima versione di VS Code e di aver AWS Toolkit for Visual Studio Code installato l'ultima versione di VS Code. Se non disponi della versione più recente, aggiorna e avvia il tuo Dev Environment. Per ulteriori informazioni, consulta [Amazon CodeCatalyst for VS Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/codecatalyst-service.html).

Per risolvere questo problema JetBrains, verifica di avere AWS Toolkit for JetBrains installato la versione più recente JetBrains di. Se non disponi della versione più recente, aggiorna e avvia il tuo Dev Environment. Per ulteriori informazioni, consulta [Amazon CodeCatalyst for JetBrains](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/codecatalyst-overview.html).

# Risoluzione dei problemi con devfiles
<a name="devenvironments-devenvironments-devfile"></a>

Consulta le seguenti sezioni per risolvere i problemi relativi a devfiles in. CodeCatalyst Per ulteriori informazioni su devfiles, vedere. [Configurazione di un devfile per un ambiente di sviluppo](devenvironment-devfile.md)

**Topics**
+ [Il mio ambiente di sviluppo utilizza il devfile universale predefinito anche se ho implementato un'immagine personalizzata in un devfile personalizzato](#troubleshooting-devenvironments-custom-image)
+ [Il mio progetto non è stato creato nel mio ambiente di sviluppo con il devfile universale predefinito](#troubleshooting-devenvironments-default-image)
+ [Voglio spostare un repository devfile per un ambiente di sviluppo](#troubleshooting-devenvironments-devfile-moving)
+ [Ho problemi ad avviare il mio devfile](#troubleshooting-devenvironments-devfile-recovery)
+ [Non so come controllare lo stato del mio devfile](#troubleshooting-devenvironments-devfile-status)
+ [Il mio devfile non è compatibile con gli strumenti forniti nell'ultima immagine](#troubleshooting-devenvironments-devfile-version)

## Il mio ambiente di sviluppo utilizza il devfile universale predefinito anche se ho implementato un'immagine personalizzata in un devfile personalizzato
<a name="troubleshooting-devenvironments-custom-image"></a>

Se si CodeCatalyst verificano errori durante l'avvio di un ambiente di sviluppo che utilizza un devfile personalizzato, l'ambiente di sviluppo utilizza per impostazione predefinita il devfile universale predefinito. Per risolvere il problema, puoi controllare l'errore esatto nei log sottostanti. `/aws/mde/logs/devfile.log` Puoi anche verificare se `postStart` l'esecuzione è andata a buon fine nei tuoi log:. `/aws/mde/logs/devfileCommand.log`

## Il mio progetto non è stato creato nel mio ambiente di sviluppo con il devfile universale predefinito
<a name="troubleshooting-devenvironments-default-image"></a>

Per risolvere il problema, verifica di non utilizzare un devfile personalizzato. Se non state utilizzando un devfile personalizzato, visualizzate il `devfile.yaml` file nell'archivio di origine del progetto per individuare e correggere eventuali errori.

## Voglio spostare un repository devfile per un ambiente di sviluppo
<a name="troubleshooting-devenvironments-devfile-moving"></a>

Puoi spostare il devfile predefinito nel `/projects/devfile.yaml` tuo repository del codice sorgente. Per aggiornare la posizione del devfile, usa il seguente comando:. `/aws/mde/mde start --location repository-name/devfile.yaml`

## Ho problemi ad avviare il mio devfile
<a name="troubleshooting-devenvironments-devfile-recovery"></a>

Se c'è un problema durante l'avvio del tuo devfile, entrerà in modalità di ripristino in modo che tu possa comunque connetterti al tuo ambiente e correggere il tuo devfile. In modalità di ripristino, l'esecuzione `/aws/mde/mde status` non conterrà la posizione del tuo devfile.

```
{
    "status": "STABLE"
}
```

Puoi controllare l'errore nei log sotto`/aws/mde/logs`, correggere il devfile e riprovare a eseguire. `/aws/mde/mde start`

## Non so come controllare lo stato del mio devfile
<a name="troubleshooting-devenvironments-devfile-status"></a>

Puoi controllare lo stato del tuo devfile eseguendo. `/aws/mde/mde status` Dopo aver eseguito questo comando, è possibile che venga visualizzato uno dei seguenti:
+ `{"status": "STABLE", "location": "devfile.yaml" }`

  Ciò indica che il file dev è corretto.
+ `{"status": "STABLE" }`

  Ciò indica che il tuo devfile non può essere avviato ed è entrato in modalità di ripristino.

Puoi controllare l'errore esatto nei log sotto. `/aws/mde/logs/devfile.log`

Puoi anche verificare se `postStart` l'esecuzione è andata a buon fine nei tuoi log:. `/aws/mde/logs/devfileCommand.log`

Per ulteriori informazioni, consulta [Specificare immagini devfile universali per un ambiente di sviluppo](devenvironment-universal-image.md).

## Il mio devfile non è compatibile con gli strumenti forniti nell'ultima immagine
<a name="troubleshooting-devenvironments-devfile-version"></a>

Nel tuo ambiente di sviluppo, `devfile` o `devfile postStart` potrebbe fallire se `latest` gli strumenti non dispongono degli strumenti necessari per un progetto specifico. Per risolvere il problema, procedi come segue:<a name="devenvironment-devfile-version"></a>

1. Vai al tuo devfile.

1. Nel tuo devfile, esegui l'aggiornamento a una versione con immagine granulare anziché. `latest` Potrebbe essere simile al seguente:

   ```
   components:
     - container:
         image: public.ecr.aws/amazonlinux/universal-image:1.0
   ```

1. Crea un nuovo ambiente di sviluppo utilizzando il devfile aggiornato.