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 environnements de développement
Consultez les sections suivantes pour résoudre les problèmes liés aux environnements de développement. Pour plus d'informations sur les environnements de développement, consultez[Écrivez et modifiez du code avec les environnements de développement dans CodeCatalystÉcrire et modifier du code avec les environnements de développement](devenvironment.md).
**Topics**
+ [La création de mon environnement de développement n'a pas réussi en raison d'un problème de quotas](#troubleshooting-devenvironments-create)
+ [Je ne peux pas transférer les modifications de mon environnement de développement vers une branche spécifique d'un référentiel](#troubleshooting-devenvironments-branchrules)
+ [Mon environnement de développement n'a pas repris](#troubleshooting-devenvironments-resume)
+ [Mon environnement de développement est déconnecté](#troubleshooting-devenvironments-connection)
+ [Mon environnement de développement connecté au VPC a échoué](#troubleshooting-devenvironments-vpc)
+ [Je ne trouve pas le répertoire dans lequel se trouve mon projet](#troubleshooting-devenvironments-projects)
+ [Je ne parviens pas à me connecter à mon environnement de développement via SSH](#troubleshooting-devenvironments-connect-ssh)
+ [Je ne parviens pas à me connecter à mon environnement de développement via SSH car ma configuration SSH locale est manquante](#troubleshooting-devenvironments-projects-ssh-config)
+ [Je ne parviens pas à me connecter à mon environnement de développement via SSH car je rencontre des problèmes avec mon AWS Config profil `codecatalyst`](#troubleshooting-devenvironments-config-profile)
+ [Je ne parviens pas à créer un environnement de développement lorsque je suis connecté à CodeCatalyst l'aide d'un compte d'authentification unique](#troubleshoot-create-dev-env-idprovider)
+ [Résolution des problèmes liés à IDEs](devenvironments-troubleshooting-ides.md)
+ [Résolution des problèmes liés aux fichiers de développement](devenvironments-devenvironments-devfile.md)
## La création de mon environnement de développement n'a pas réussi en raison d'un problème de quotas
**Problème :** je souhaite créer un environnement de développement dans CodeCatalyst, mais une erreur s'affiche. Dans la console, je vois un message sur la page Dev Environments indiquant que j'ai atteint la limite de stockage pour l'espace.
**Corrections possibles :** selon votre rôle dans le projet ou dans l'espace, vous pouvez soit supprimer un ou plusieurs de vos propres environnements de développement, soit, si vous avez le rôle d'administrateur de l'espace, vous pouvez supprimer les environnements de développement non utilisés créés par d'autres utilisateurs. Vous pouvez également décider de modifier le niveau de facturation pour un niveau qui inclut davantage de stockage.
+ Pour consulter les limites de stockage, consultez l'onglet **Facturation** de l' CodeCatalystespace Amazon pour voir si les quotas **d'utilisation** ont atteint le maximum autorisé. Si les quotas ont atteint le maximum, contactez une personne ayant le rôle d'administrateur de l'espace pour supprimer les environnements de développement inutiles ou pour envisager de modifier le niveau de facturation.
+ Pour supprimer les environnements de développement que vous avez créés et dont vous n'avez plus besoin, consultez[Suppression d'un environnement de développement](devenvironment-delete.md).
Si le problème persiste et qu'une erreur s'affiche dans votre IDE, vérifiez que votre CodeCatalyst rôle vous permet de créer un environnement de développement. Le rôle **d'administrateur d'espace**, le rôle d'**administrateur de projet** et le rôle de **contributeur** sont tous autorisés à créer des environnements de développement. Pour de plus amples informations, veuillez consulter [Octroi d'accès avec des rôles d'utilisateur](ipa-roles.md).
## Je ne peux pas transférer les modifications de mon environnement de développement vers une branche spécifique d'un référentiel
**Problème :** je souhaite valider et transférer les modifications de code de mon environnement de développement vers une branche d'un référentiel source, mais une erreur s'affiche.
**Corrections possibles :** selon votre rôle dans le projet ou dans l'espace, il se peut que vous ne soyez pas autorisé à envoyer du code vers les référentiels sources du projet. Les rôles **d'administrateur d'espace**, d'**administrateur de projet** et de **contributeur** sont tous autorisés à envoyer du code vers les référentiels du projet.
Si vous avez le rôle de **contributeur** mais que vous ne pouvez pas envoyer de code à une branche spécifique, une règle de branche configurée pour cette branche spécifique empêche les utilisateurs ayant ce rôle de transmettre du code à cette branche en particulier. Essayez d'appliquer vos modifications à une autre branche, ou créez une branche, puis transférez votre code vers cette branche. Pour de plus amples informations, veuillez consulter [Gérer les actions autorisées pour une branche à l'aide de règles de branche](source-branches-branch-rules.md).
## Mon environnement de développement n'a pas repris
**Problème :** mon environnement de développement n'a pas repris après son arrêt.
**Solutions possibles :** pour résoudre le problème, consultez l'onglet **Facturation** de l' CodeCatalyst espace Amazon pour voir si les quotas **d'utilisation** ont atteint les limites maximales. Si les quotas ont atteint la limite maximale, contactez l'administrateur de votre espace pour augmenter le niveau de facturation.
## Mon environnement de développement est déconnecté
**Problème :** mon environnement de développement s'est déconnecté pendant que je l'utilisais.
**Solutions possibles :** Pour résoudre le problème, vérifiez votre connexion Internet. Si vous n'êtes pas connecté à Internet, connectez-vous et reprenez le travail dans votre environnement de développement.
## Mon environnement de développement connecté au VPC a échoué
**Problème :** j'ai associé une connexion VPC à mon environnement de développement et des erreurs se produisent.
**Correctifs possibles :** Docker utilise un dispositif de couche de liaison appelé réseau de ponts qui permet aux conteneurs connectés au même réseau de ponts de communiquer. Le pont par défaut utilise généralement le sous-réseau `172.17.0.0/16` pour la mise en réseau des conteneurs. Si le sous-réseau du VPC de l'instance de votre environnement utilise la même plage d'adresses que celle utilisée par Docker, un conflit d'adresse IP peut se produire. Pour résoudre un conflit d'adresses IP provoqué par Amazon VPC et Docker utilisant le même bloc d'adresse IPv4 CIDR, configurez un bloc d'adresse CIDR différent de. `172.17.0.0/16`
**Note**
Vous ne pouvez pas modifier la plage d'adresses IP d'un VPC ou d'un sous-réseau existant.
## Je ne trouve pas le répertoire dans lequel se trouve mon projet
**Problème :** je ne trouve pas le répertoire dans lequel se trouve mon projet.
**Correctifs possibles :** Pour localiser votre projet, remplacez le répertoire par`/projects`. Il s'agit du répertoire dans lequel vous pouvez trouver vos projets.
## Je ne parviens pas à me connecter à mon environnement de développement via SSH
Pour résoudre votre problème de connexion à votre environnement de développement via SSH, vous pouvez exécuter la `ssh` commande avec l'`-vvv`option permettant d'afficher plus d'informations sur la manière de résoudre votre problème :
```
ssh -vvv codecatalyst-dev-env===
```
## Je ne parviens pas à me connecter à mon environnement de développement via SSH car ma configuration SSH locale est manquante
Si votre configuration SSH locale (`~/.ssh/config`) est manquante ou si le contenu de la `Host codecatalyst-dev-env*` section est obsolète, vous ne pourrez pas vous connecter à votre environnement de développement via SSH. Pour résoudre ce problème, supprimez la `Host codecatalyst-dev-env*` section et exécutez à nouveau la première commande depuis le modal **SSH Access**. Pour de plus amples informations, veuillez consulter [Connexion à un environnement de développement à l'aide de SSH](devenvironment-connect-ssh.md).
## Je ne parviens pas à me connecter à mon environnement de développement via SSH car je rencontre des problèmes avec mon AWS Config profil `codecatalyst`
Assurez-vous que votre AWS Config (`~/.aws/config`) pour le `codecatalyst` profil correspond à celui décrit dans[Configuration pour utiliser le AWS CLI avec CodeCatalyst](set-up-cli.md). Si ce n'est pas le cas, supprimez le profil pour `codecatalyst` et exécutez à nouveau la première commande depuis le modal **SSH Access**. Pour de plus amples informations, veuillez consulter [Connexion à un environnement de développement à l'aide de SSH](devenvironment-connect-ssh.md).
## Je ne parviens pas à créer un environnement de développement lorsque je suis connecté à CodeCatalyst l'aide d'un compte d'authentification unique
**Problème :** Lorsque je suis connecté à la CodeCatalyst console en tant qu'utilisateur SSO, je reçois une erreur d'exception inconnue lorsque je choisis de créer un environnement de développement dans cet espace. Lorsque je choisis de créer un environnement de développement et de choisir l'IDE pour y accéder, par exemple AWS Cloud9, je rencontre des problèmes similaires aux suivants :
+ La **page Environnements** de développement de la CodeCatalyst console affiche l'environnement de développement dans la liste avec un `FAILED` état.
+ Un message d'erreur similaire au message suivant s'affiche :
**`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.`
**Correctifs possibles :**
Les environnements de développement ne sont pas disponibles pour les utilisateurs dans les espaces où Active Directory est utilisé comme fournisseur d'identité. Les administrateurs de l'espace peuvent utiliser un autre fournisseur d'identité pour accéder aux environnements de développement, tels que IAM Identity Center. Pour plus d'informations sur la planification d'un espace prenant en charge la fédération des identités, consultez [la section Planification de votre espace prenant en charge la fédération des identités](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/setting-up-federation.html#setting-up-planning-federation) dans le *guide de l'CodeCatalyst administrateur*.
# Résolution des problèmes liés à IDEs
Consultez les sections suivantes pour résoudre les problèmes liés IDEs à CodeCatalyst. Pour plus d'informations sur IDEs, voir[Création d'un environnement de développement dans un IDE](devenvironment-create.md#devenvironment-using-ide).
**Topics**
+ [Les versions des images d'exécution ne correspondent pas dans AWS Cloud9](#troubleshooting-devenvironments-c9-runtime)
+ [Je ne peux pas accéder à mes fichiers `/projects/projects` dans AWS Cloud9](#troubleshooting-devenvironments-c9-filesystem)
+ [Je ne parviens pas à lancer mon environnement de développement en AWS Cloud9 utilisant un fichier de développement personnalisé](#troubleshooting-devenvironments-c9-image)
+ [J'ai des problèmes avec AWS Cloud9](#troubleshooting-c9)
+ [Dans JetBrains, je ne peux pas me connecter à mes environnements de développement via CodeCatalyst](#troubleshooting-jetbrains-connect)
+ [Je ne peux pas installer AWS Toolkit pour mon IDE](#troubleshooting-ide-toolkit)
+ [Dans mon IDE, je ne peux pas lancer mes environnements de développement](#troubleshooting-ide-launch)
## Les versions des images d'exécution ne correspondent pas dans AWS Cloud9
AWS Cloud9 utilise différentes versions de l'actif frontal et de l'image d'exécution du backend. L'utilisation de versions différentes peut entraîner le mauvais fonctionnement de AWS Toolkit l'extension Git. Pour résoudre le problème, accédez au tableau de bord de l'environnement de développement, arrêtez votre environnement de développement, puis redémarrez-le. Pour résoudre le problème en utilisant APIs, utilisez l'`UpdateDevEnvironment`API pour mettre à jour le moteur d'exécution. Pour plus d'informations, consultez [UpdateDevEnvironment](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_UpdateDevEnvironment.html)la *référence des CodeCatalyst API Amazon*.
## Je ne peux pas accéder à mes fichiers `/projects/projects` dans AWS Cloud9
L' AWS Cloud9 éditeur ne peut pas accéder aux fichiers du répertoire`/projects/projects`. Pour résoudre le problème, utilisez le AWS Cloud9 terminal pour accéder à vos fichiers ou déplacez-les vers un autre répertoire.
## Je ne parviens pas à lancer mon environnement de développement en AWS Cloud9 utilisant un fichier de développement personnalisé
L'image de votre fichier de développement n'est peut-être pas compatible avec AWS Cloud9. Pour résoudre le problème, consultez le fichier de développement de votre référentiel et de l'environnement de développement correspondant, puis créez-en un nouveau pour continuer.
## J'ai des problèmes avec AWS Cloud9
Pour les autres problèmes, consultez la section de dépannage du [guide de AWS Cloud9 l'utilisateur](https://docs.aws.amazon.com/cloud9/latest/user-guide/troubleshooting.html).
## Dans JetBrains, je ne peux pas me connecter à mes environnements de développement via CodeCatalyst
Pour résoudre le problème, vérifiez que seule la dernière version de JetBrains est installée. Si vous avez plusieurs versions, désinstallez les anciennes versions et enregistrez à nouveau votre gestionnaire de protocole en fermant l'IDE et le navigateur. Ouvrez JetBrains et enregistrez à nouveau le gestionnaire de protocole.
## Je ne peux pas installer AWS Toolkit pour mon IDE
Pour résoudre ce problème pour VS Code, installez manuellement AWS Toolkit for Visual Studio Code à partir de [GitHub](https://github.com/aws/aws-toolkit-vscode/releases).
Pour résoudre ce problème JetBrains, installez manuellement AWS Toolkit for JetBrains à partir de [GitHub](https://github.com/aws/aws-toolkit-jetbrains/releases).
## Dans mon IDE, je ne peux pas lancer mes environnements de développement
Pour résoudre ce problème pour VS Code, vérifiez que vous disposez de la dernière version de VS Code et que vous l' AWS Toolkit for Visual Studio Code avez installée. Si vous ne disposez pas de la dernière version, mettez à jour et lancez votre environnement de développement. Pour plus d'informations, consultez [Amazon CodeCatalyst pour VS Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/codecatalyst-service.html).
Pour résoudre ce problème JetBrains, vérifiez que vous disposez de la dernière version de JetBrains et que vous l' AWS Toolkit for JetBrains avez installée. Si vous ne disposez pas de la dernière version, mettez à jour et lancez votre environnement de développement. Pour plus d'informations, consultez [Amazon CodeCatalyst pour JetBrains](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/codecatalyst-overview.html).
# Résolution des problèmes liés aux fichiers de développement
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é.
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
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
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
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
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
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 :
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.