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