Amazon n' CodeCatalyst est plus ouvert aux nouveaux clients. Les clients existants peuvent continuer à utiliser le service normalement. Pour de plus amples informations, veuillez consulter [Comment effectuer une migration depuis CodeCatalyst](migration.md).

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Résolution des problèmes liés aux fichiers de développement
<a name="devenvironments-devenvironments-devfile"></a>

Consultez les sections suivantes pour résoudre les problèmes liés aux fichiers de développement dans. CodeCatalyst Pour plus d'informations sur les fichiers de développement, consultez[Configuration d'un fichier de développement pour un environnement de développement](devenvironment-devfile.md).

**Topics**
+ [Mon environnement de développement utilise le fichier de développement universel par défaut, même si j'ai implémenté une image personnalisée dans un fichier de développement personnalisé.](#troubleshooting-devenvironments-custom-image)
+ [Mon projet ne se construit pas dans mon environnement de développement avec le fichier de développement universel par défaut](#troubleshooting-devenvironments-default-image)
+ [Je souhaite déplacer un fichier de développement de référentiel pour un environnement de développement](#troubleshooting-devenvironments-devfile-moving)
+ [Je ne parviens pas à démarrer mon devfile](#troubleshooting-devenvironments-devfile-recovery)
+ [Je ne sais pas comment vérifier le statut de mon fichier de développement](#troubleshooting-devenvironments-devfile-status)
+ [Mon fichier de développement n'est pas compatible avec les outils fournis dans la dernière image](#troubleshooting-devenvironments-devfile-version)

## Mon environnement de développement utilise le fichier de développement universel par défaut, même si j'ai implémenté une image personnalisée dans un fichier de développement personnalisé.
<a name="troubleshooting-devenvironments-custom-image"></a>

Si vous CodeCatalyst rencontrez des erreurs lors du démarrage d'un environnement de développement utilisant un fichier de développement personnalisé, l'environnement de développement utilise par défaut le fichier de développement universel par défaut. Pour résoudre le problème, vous pouvez vérifier l'erreur exacte dans les journaux ci-dessous`/aws/mde/logs/devfile.log`. Vous pouvez également vérifier si `postStart` l'exécution a été réussie dans vos journaux :`/aws/mde/logs/devfileCommand.log`.

## Mon projet ne se construit pas dans mon environnement de développement avec le fichier de développement universel par défaut
<a name="troubleshooting-devenvironments-default-image"></a>

Pour résoudre le problème, vérifiez que vous n'utilisez pas de fichier de développement personnalisé. Si vous n'utilisez pas de fichier de développement personnalisé, consultez le `devfile.yaml` fichier dans le référentiel source du projet pour localiser et corriger les éventuelles erreurs.

## Je souhaite déplacer un fichier de développement de référentiel pour un environnement de développement
<a name="troubleshooting-devenvironments-devfile-moving"></a>

Vous pouvez déplacer le fichier de développement par défaut dans `/projects/devfile.yaml` votre référentiel de code source. Pour mettre à jour l'emplacement du fichier de développement, utilisez la commande suivante :`/aws/mde/mde start --location repository-name/devfile.yaml`.

## Je ne parviens pas à démarrer mon devfile
<a name="troubleshooting-devenvironments-devfile-recovery"></a>

En cas de problème lors du démarrage de votre fichier de développement, celui-ci passe en mode de restauration afin que vous puissiez toujours vous connecter à votre environnement et corriger votre fichier de développement. En mode de restauration, l'exécution `/aws/mde/mde status` ne contiendra pas l'emplacement de votre fichier de développement.

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

Vous pouvez vérifier l'erreur dans les journaux ci-dessous`/aws/mde/logs`, corriger le fichier de développement et réessayer de l'exécuter`/aws/mde/mde start`.

## Je ne sais pas comment vérifier le statut de mon fichier de développement
<a name="troubleshooting-devenvironments-devfile-status"></a>

Vous pouvez vérifier l'état de votre fichier de développement en exécutant`/aws/mde/mde status`. Après avoir exécuté cette commande, l'un des éléments suivants peut s'afficher :
+ `{"status": "STABLE", "location": "devfile.yaml" }`

  Cela indique que votre fichier de développement est correct.
+ `{"status": "STABLE" }`

  Cela indique que votre fichier de développement n'a pas pu démarrer et qu'il est entré en mode de restauration.

Vous pouvez vérifier l'erreur exacte dans les journaux ci-dessous`/aws/mde/logs/devfile.log`.

Vous pouvez également vérifier si `postStart` l'exécution a été réussie dans vos journaux :`/aws/mde/logs/devfileCommand.log`.

Pour de plus amples informations, veuillez consulter [Spécification d'images de fichier de développement universelles pour un environnement de développement](devenvironment-universal-image.md).

## Mon fichier de développement n'est pas compatible avec les outils fournis dans la dernière image
<a name="troubleshooting-devenvironments-devfile-version"></a>

Dans votre environnement de développement, `devfile` ou `devfile postStart` peut échouer si l'`latest`outillage ne dispose pas de l'outillage requis pour un projet spécifique. Pour résoudre le problème, procédez comme suit :<a name="devenvironment-devfile-version"></a>

1. Accédez à votre devfile.

1. Dans votre fichier de développement, passez à une version d'image granulaire au lieu de. `latest` Cela peut ressembler à ce qui suit :

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

1. Créez un nouvel environnement de développement à l'aide du fichier de développement mis à jour.