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 à Amazon CodeCatalyst
Les informations suivantes peuvent vous aider à résoudre les problèmes courants dans CodeCatalyst. Vous pouvez également utiliser le rapport de CodeCatalyst santé d'Amazon pour déterminer s'il existe des problèmes de service susceptibles d'avoir un impact sur votre expérience.
**Topics**
+ [Résolution des problèmes d'accès généraux](#troubleshooting-general)
+ [Résolution des problèmes de support](#troubleshoot-support)
+ [Amazon CodeCatalyst n'est pas disponible en totalité ou en partie](#service-unavailable)
+ [Je ne parviens pas à créer un projet dans CodeCatalyst](#troubleshoot-create-project)
+ [Je ne peux pas accéder à mon espace BID en tant que nouvel utilisateur ou je ne peux pas être ajouté en tant que nouvel utilisateur SSO en raison d'un nom d'utilisateur tronqué](#troubleshoot-username-truncated)
+ [L'ajout d'un utilisateur SSO à mon espace fédéré en tant que nouvel utilisateur a créé un utilisateur dupliqué](#troubleshoot-username-duplicated-SSO)
+ [Je souhaite envoyer des commentaires dans CodeCatalyst](#troubleshoot-create-feedback)
+ [Résolution des problèmes liés aux référentiels sources](troubleshooting-source.md)
+ [Projets et plans de résolution des problèmes](projects-troubleshooting.md)
+ [Résolution des problèmes liés aux environnements de développement](devenvironments-troubleshooting.md)
+ [Résolution des problèmes liés aux flux de travail](troubleshooting-workflows.md)
+ [Résolution des problèmes liés aux problèmes](troubleshooting-issues.md)
+ [Résolution des problèmes liés à la recherche dans CodeCatalyst](troubleshooting-search.md)
+ [Résolution des problèmes liés aux extensions](troubleshooting-extensions.md)
+ [Résolution des problèmes liés aux comptes associés à votre espace](troubleshooting-connections.md)
+ [Résolution des problèmes entre Amazon CodeCatalyst et le AWS SDKs ou le AWS CLI](troubleshooting-cli-sdk.md)
## Résolution des problèmes d'accès généraux
### J'ai oublié mon mot de passe
**Problème :** j'ai oublié le mot de passe que j'utilise pour mon AWS Builder ID et Amazon CodeCatalyst.
**Solutions possibles :** le moyen le plus simple de résoudre ce problème est de réinitialiser votre mot de passe.
1. Ouvrez [Amazon CodeCatalyst](https://codecatalyst.aws/) et saisissez votre **adresse e-mail**. Choisissez ensuite **Continue** (Continuer).
1. Choisissez **Mot de passe oublié ?**
1. Nous vous enverrons un e-mail contenant un lien vous permettant de modifier votre mot de passe. Si vous ne voyez pas l'e-mail dans votre boîte de réception, vérifiez votre dossier de courrier indésirable.
### Amazon CodeCatalyst n'est pas disponible en totalité ou en partie
**Problème :** j'ai accédé à la CodeCatalyst console ou j'ai suivi un lien vers celle-ci, mais un message d'erreur s'affiche.
**Solutions possibles :** les raisons les plus courantes à l'origine de ce problème sont soit que vous avez suivi un lien vers un projet ou un espace auquel vous n'avez pas été invité, soit que le service présente un problème général de disponibilité. Consultez le [rapport Health](health-dashboard.md) pour voir s'il existe des problèmes connus liés au service. Sinon, contactez la personne qui vous a invité au projet ou à l'espace et demandez une autre invitation. Si vous n'avez été invité à aucun projet ou espace, vous pouvez vous inscrire et [créer votre propre espace et vos propres projets](sign-up-create-resources.md).
### Je ne parviens pas à créer un projet dans CodeCatalyst
**Problème :** je souhaite créer un projet, mais le bouton **Créer un projet** s'affiche comme non disponible ou je reçois un message d'erreur.
**Correctifs possibles :** les raisons les plus courantes à l'origine de ce problème sont que vous êtes connecté à la console avec un AWS Builder ID qui ne possède pas le rôle d'**administrateur de l'espace**. Vous devez avoir ce rôle pour créer des projets dans un espace.
Si vous détenez ce rôle et que le bouton n'apparaît pas comme disponible, il se peut qu'il y ait un problème temporaire avec le service. Actualisez votre navigateur et réessayez.
## Résolution des problèmes de support
### Je reçois un message d'erreur lorsque j' Support accède à Amazon CodeCatalyst
**Problème :** Lorsque je choisis l' CodeCatalyst option Support pour Amazon, je reçois le message d'erreur suivant :
**`Unable to assume role`**
`To access support cases, you must add the role AWSRoleForCodeCatalystSupport to the Compte AWS that is the billing account for the space.`
**Corrections possibles :** Ajoutez le Compte AWS rôle requis au compte de facturation de l'espace. Le compte désigné comme compte de facturation pour l'espace utilise le `AWSRoleForCodeCatalystSupport` rôle et la politique `AmazonCodeCatalystSupportAccess` gérée. Pour de plus amples informations, veuillez consulter [Création du **AWSRoleForCodeCatalystSupport**rôle pour votre compte et votre espace](ipa-iam-roles.md#ipa-iam-roles-support-create).
**Note**
Un AWS Builder ID ne peut être pris en charge que pour l'alias avec lequel il est authentifié et uniquement pour les ressources basées sur des CodeCatalyst autorisations. L'assistance relative aux comptes et à la facturation est disponible pour tous les utilisateurs de l'espace. Cependant, les constructeurs ne peuvent obtenir de l'aide que pour les ressources et les informations pour lesquelles ils sont autorisés à accéder CodeCatalyst.
### Je ne peux pas créer de dossiers de support technique pour mon espace
**Problème :** je n'arrive pas à créer de dossiers de support technique pour mon espace.
**Corrections :** un plan Business Support ou Enterprise Support doit être ajouté au compte de facturation de l'espace afin que les utilisateurs de l'espace puissent créer des dossiers de support technique. Demandez à votre administrateur d'espace d'ajouter un Support forfait à votre compte de facturation d'espace ou rendez-vous sur https://repost.aws/ pour demander à la AWS communauté.
### Mon compte pour les demandes d'assistance n'est plus connecté à mon espace dans CodeCatalyst
**Problème :** Mon compte pour les demandes d'assistance n'est plus connecté à mon espace dans CodeCatalyst.
**Corrections :** Si un utilisateur ayant le rôle d'**administrateur** de l'espace change de compte de facturation de l'espace, cela déconnectera le Support plan et tous les dossiers associés de l'espace. Les Support dossiers associés à l'ancien compte de facturation des espaces ne seront plus visibles Support pour Amazon CodeCatalyst. L'utilisateur root de ce compte de facturation peut consulter et résoudre les anciens dossiers à partir du AWS Management Console et peut configurer des autorisations IAM Support permettant aux autres utilisateurs de consulter et de résoudre les anciens dossiers. Vous ne pourrez pas continuer à bénéficier d'une assistance technique CodeCatalyst depuis l'ancien compte de facturation des espaces via le AWS Management Console, mais vous pouvez bénéficier d'une assistance technique pour d'autres services jusqu'à ce que votre Support plan soit annulé.
Pour plus d'informations, voir [Mettre à jour, résoudre et rouvrir votre dossier](https://docs.aws.amazon.com//awssupport/latest/user/monitoring-your-case.html) dans le *Guide de l'Support utilisateur*.
### Je ne parviens pas à ouvrir un dossier d'assistance pour un autre Service AWS Support utilisateur sur Amazon CodeCatalyst
**Problème :** je n'arrive pas à ouvrir un dossier de support pour un autre Service AWS dans Support for CodeCatalyst.
**Corrections possibles :** vous ne pouvez ouvrir des dossiers d' CodeCatalyst assistance qu'à partir de Support pour CodeCatalyst. Si vous avez besoin d'assistance pour des services ou des ressources CodeCatalyst déployés depuis un autre service AWS, Amazon ou un autre service tiers, vous devrez créer un dossier par le biais du canal d'assistance du service tiers AWS Management Console ou de celui-ci. Pour plus d'informations, consultez les sections [Création de dossiers de support et gestion de dossiers](https://docs.aws.amazon.com//awssupport/latest/user/case-management.html) dans le *Guide de Support l'utilisateur*.
## Amazon CodeCatalyst n'est pas disponible en totalité ou en partie
**Problème :** j'ai accédé à la CodeCatalyst console ou j'ai suivi un lien vers celle-ci, mais un message d'erreur s'affiche.
**Solutions possibles :** les raisons les plus courantes à l'origine de ce problème sont soit que vous avez suivi un lien vers un projet ou un espace auquel vous n'avez pas été invité, soit que le service présente un problème général de disponibilité. Consultez le [rapport Health](health-dashboard.md) pour voir s'il existe des problèmes connus liés au service. Sinon, contactez la personne qui vous a invité au projet ou à l'espace et demandez une autre invitation. Si vous n'avez été invité à aucun projet ou espace, vous pouvez vous inscrire et [créer votre propre espace et vos propres projets](sign-up-create-resources.md).
## Je ne parviens pas à créer un projet dans CodeCatalyst
**Problème :** je souhaite créer un projet, mais le bouton **Créer un projet** s'affiche comme non disponible ou je reçois un message d'erreur.
**Correctifs possibles :** les raisons les plus courantes à l'origine de ce problème sont que vous êtes connecté à la console avec un AWS Builder ID qui ne possède pas le rôle d'**administrateur de l'espace**. Vous devez avoir ce rôle pour créer des projets dans un espace.
Si vous détenez ce rôle et que le bouton n'apparaît pas comme disponible, il se peut qu'il y ait un problème temporaire avec le service. Actualisez votre navigateur et réessayez.
## Je ne peux pas accéder à mon espace BID en tant que nouvel utilisateur ou je ne peux pas être ajouté en tant que nouvel utilisateur SSO en raison d'un nom d'utilisateur tronqué
**Problème :** CodeCatalyst tronque les noms d'utilisateur au-delà de 100 caractères, certains noms d'utilisateur peuvent apparaître identiques. En tant que nouvel utilisateur accédant à un CodeCatalyst espace, je rencontre ce problème en fonction du type d'espace, comme suit :
+ J'ai un identifiant AWS Builder que je souhaite utiliser pour me connecter CodeCatalyst. Lorsque j'essaie de me connecter à l'espace, je reçois un message m'indiquant que mon nom d'utilisateur n'est pas valide.
+ Je suis administrateur d'identité fédéré pour un CodeCatalyst espace qui prend en charge la fédération d'identités. Lorsque j'ajoute un nouvel utilisateur aux utilisateurs et groupes SSO dans IAM Identity Center, je reçois un message m'indiquant que l'utilisateur n'est pas valide.
**Corrections possibles :** le premier utilisateur à se connecter CodeCatalyst ou à être ajouté à l'espace en tant qu'utilisateur SSO avec un nom d'utilisateur tronqué donné réussira. Les utilisateurs qui s'inscrivent avec un AWS Builder ID ou qui sont ajoutés à IAM Identity Center par la suite ne pourront pas se connecter car le nom apparaîtra comme un doublon. Selon le type d'espace, effectuez l'une des opérations suivantes :
+ Pour pouvoir vous connecter à l'espace AWS Builder ID, inscrivez-vous avec un autre nom d'utilisateur.
+ Pour pouvoir ajouter le nouvel utilisateur dans IAM Identity Center, ajoutez-le avec un autre nom d'utilisateur.
**Note**
Même si le nom d'utilisateur semble tronqué, il est CodeCatalyst mappé à l'identité d'une manière qui n'est pas affectée par les noms d'utilisateur tronqués. Toutefois, si un nom d'utilisateur identique à un nom d'utilisateur tronqué est créé, ce nom d'utilisateur ne sera pas disponible si un autre utilisateur associé (au même espace ou à l'application IAM Identity Center) s'est déjà inscrit CodeCatalyst avec ce nom d'utilisateur tronqué.
## L'ajout d'un utilisateur SSO à mon espace fédéré en tant que nouvel utilisateur a créé un utilisateur dupliqué
**Problème :** les utilisateurs CodeCatalyst SSO ajoutés à un CodeCatalyst espace puis supprimés peuvent rencontrer un problème lorsque le nom d'utilisateur tente de le réutiliser. Cela peut entraîner une erreur similaire à la suivante, dans laquelle l'utilisateur n'est pas autorisé à être dupliqué même s'il a été recréé.
**`Unable to assume role`**
`To access support cases, you must add the role AWSRoleForCodeCatalystSupport to the Compte AWS that is the billing account for the space.`
**Corrections possibles :** si un utilisateur IDC existant est supprimé puis qu'un nouvel utilisateur est recréé avec le même nom d'utilisateur, le nouvel utilisateur ne pourra pas se connecter car le nom d'utilisateur est en conflit avec l'ancien utilisateur. Une fois qu'un nom d'utilisateur a été ajouté à un espace en tant qu'utilisateur SSO, il ne peut pas être réutilisé. Les utilisateurs qui s'inscrivent avec un AWS Builder ID ou qui sont ajoutés à IAM Identity Center par la suite ne pourront pas se connecter car le nom apparaîtra comme un doublon.
Selon le type d'espace, effectuez l'une des opérations suivantes :
+ Pour pouvoir vous connecter à l'espace AWS Builder ID, inscrivez-vous avec un autre nom d'utilisateur.
+ Pour pouvoir ajouter le nouvel utilisateur dans IAM Identity Center, ajoutez-le avec un autre nom d'utilisateur.
## Je souhaite envoyer des commentaires dans CodeCatalyst
**Problème :** j'ai trouvé un bogue CodeCatalyst et je souhaite envoyer un commentaire.
**Corrections possibles :** vous pouvez envoyer des commentaires directement dans CodeCatalyst.
1. Ouvrez la CodeCatalyst console à l'[adresse https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Dans le volet de navigation, choisissez **Envoyer des commentaires**.
1. Choisissez le type de commentaire dans le menu déroulant et saisissez votre commentaire.
# Résolution des problèmes liés aux référentiels sources
Les informations suivantes peuvent vous aider à résoudre les problèmes courants liés aux référentiels sources dans. CodeCatalyst
**Topics**
+ [J'ai atteint la capacité de stockage maximale pour mon espace et je reçois des avertissements ou des erreurs](#source-troubleshoot-storage)
+ [Je reçois un message d'erreur lorsque j'essaie de cloner ou de transférer vers un référentiel CodeCatalyst source Amazon](#source-troubleshoot-clone)
+ [Je reçois un message d'erreur lorsque j'essaie de valider ou de transférer vers un référentiel CodeCatalyst source Amazon](#source-troubleshoot-commit-code)
+ [J'ai besoin d'un référentiel source pour mon projet](#source-troubleshoot-need-repository)
+ [Mon dépôt source est tout neuf mais contient un commit](#source-troubleshoot-initial-commit)
+ [Je veux une branche différente comme branche par défaut](#source-troubleshoot-default-branch)
+ [Je reçois des e-mails concernant l'activité des pull requests](#source-troubleshoot-repository-emails)
+ [J'ai oublié mon jeton d'accès personnel (PAT)](#source-troubleshoot-forgot-pat)
+ [Une pull request n'affiche pas les modifications que j'attends](#source-troubleshoot-pull-request-diff)
+ [Une pull request indique le statut Non fusionnable](#source-troubleshoot-pull-request-not-mergeable)
## J'ai atteint la capacité de stockage maximale pour mon espace et je reçois des avertissements ou des erreurs
**Problème :** je souhaite valider du code dans un ou plusieurs référentiels sources CodeCatalyst, mais une erreur s'affiche. Dans la console, je vois un message sur la page du référentiel source indiquant que j'ai atteint la limite de stockage pour l'espace.
**Corrections possibles :** en fonction de votre rôle dans le projet ou dans l'espace, vous pouvez réduire la taille d'un ou de plusieurs de vos référentiels sources, supprimer les référentiels sources inutilisés ou modifier votre niveau de facturation pour un niveau offrant plus d'espace de stockage.
+ Pour réduire la taille d'un référentiel source dans un projet, vous pouvez supprimer les branches inutilisées. Pour plus d’informations, consultez [Supprimer une branche](source-branches-delete.md) et [Rôle du contributeur](ipa-role-types.md#ipa-role-contributor).
+ Pour réduire l'espace de stockage global d'un espace, vous pouvez supprimer les référentiels sources inutilisés. Pour plus d’informations, consultez [Supprimer un référentiel source](source-repositories-delete.md) et [Rôle d'administrateur de projet](ipa-role-types.md#ipa-role-project-admin).
+ Pour augmenter la quantité de stockage disponible pour votre espace, vous pouvez modifier votre niveau de facturation pour un niveau offrant plus d'espace de stockage. Pour plus d'informations, consultez [Modifier votre niveau CodeCatalyst de facturation](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing-change-plan.html) dans le manuel Amazon CodeCatalyst Administrator Guide.
## Je reçois un message d'erreur lorsque j'essaie de cloner ou de transférer vers un référentiel CodeCatalyst source Amazon
**Problème :** Lorsque j'essaie de cloner un référentiel source sur un ordinateur local ou dans un environnement de développement intégré (IDE), je reçois une erreur d'autorisation.
**Correctifs possibles :** vous n'avez peut-être pas de jeton d'accès personnel (PAT) pour votre identifiant AWS Builder, vous n'avez peut-être pas configuré votre système de gestion des informations d'identification avec votre PAT ou votre PAT a peut-être expiré. Essayez une ou plusieurs des solutions suivantes :
+ Créez un jeton d'accès personnel (PAT). Pour de plus amples informations, veuillez consulter [Accorder aux utilisateurs l'accès au référentiel avec des jetons d'accès personnels](ipa-tokens-keys.md).
+ Assurez-vous d'avoir accepté une invitation à participer au projet qui contient le référentiel source et que vous êtes toujours membre de ce projet. Vous ne pouvez pas cloner un dépôt source si vous n'êtes pas un membre actif de ce projet. Connectez-vous à la console et essayez d'accéder à l'espace et au projet dans lesquels vous essayez de cloner un référentiel source. Si le projet ne figure pas dans la liste des projets de l'espace, cela signifie soit que vous n'êtes pas membre de ce projet, soit que vous n'avez pas accepté d'invitation à participer à ce projet. Pour de plus amples informations, veuillez consulter [Acceptation d'une invitation et création d'un identifiant AWS Builder](sign-up-sign-in.md).
+ Assurez-vous que votre commande de clonage est correctement formatée et inclut votre identifiant AWS Builder. Par exemple :
```
https://LiJuan@git.us-west-2.codecatalyst.aws/v1/ExampleCorp/MyExampleProject/MyExampleRepo
```
+ Utilisez le AWS CLI pour vous assurer qu'un PAT est associé à votre identifiant AWS Builder et qu'il n'est pas expiré. Si vous n'en avez pas ou si le PAT a expiré, créez-en un. Pour de plus amples informations, veuillez consulter [Accorder aux utilisateurs l'accès au référentiel avec des jetons d'accès personnels](ipa-tokens-keys.md).
+ Essayez de créer un environnement de développement pour travailler avec le code du référentiel source au lieu de le cloner dans un dépôt local ou un IDE. Pour de plus amples informations, veuillez consulter [Création d’un environnement de développement](devenvironment-create.md).
## Je reçois un message d'erreur lorsque j'essaie de valider ou de transférer vers un référentiel CodeCatalyst source Amazon
**Problème :** Lorsque j'essaie d'envoyer un message push vers un dépôt source, je reçois une erreur d'autorisation.
**Corrections possibles :** il se peut que vous n'ayez aucun rôle dans le projet qui vous permette de valider et d'appliquer des modifications de code au projet. Affichez votre rôle dans le projet dans lequel vous essayez d'appliquer des modifications à un référentiel source. Pour plus d’informations, consultez [Obtenir une liste des membres et leurs rôles dans le projet](projects-members.md#projects-members-view) et [Octroi d'accès avec des rôles d'utilisateur](ipa-roles.md).
Si vous avez un rôle qui permet de valider et de transférer des modifications, la branche dans laquelle vous essayez de valider les modifications peut avoir une règle de branche configurée pour elle qui vous empêche d'appliquer des modifications de code à cette branche. Essayez plutôt de créer une branche et de transférer 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).
## J'ai besoin d'un référentiel source pour mon projet
**Problème :** mon projet n'a pas de référentiel source ou j'ai besoin d'un autre référentiel source pour mon projet.
**Corrections possibles :** Certains projets sont créés sans aucune ressource. Si vous êtes membre du projet, vous pouvez créer des référentiels sources pour ce projet dans CodeCatalyst. Si une personne ayant le rôle d'**administrateur de l'espace** installe les **GitHub référentiels et les** connecte à un GitHub compte, vous pouvez créer un lien vers les GitHub référentiels disponibles pour les ajouter à votre projet si vous détenez le rôle d'administrateur de **projet**. Pour plus d'informations, consultez les [sections Création d'un référentiel source](source-repositories-create.md) et [Liaison d'un référentiel source](source-repositories-link.md).
## Mon dépôt source est tout neuf mais contient un commit
**Problème :** je viens de créer un dépôt de sources. Il doit être vide, mais il contient un commit, une branche et un `README.md` fichier.
**Corrections possibles :** ce comportement est attendu. Tous les référentiels sources CodeCatalyst incluent un commit initial qui définit la branche par défaut sur `main` et inclut soit un exemple de code (si le référentiel a été créé pour un projet à l'aide d'un plan incluant un exemple de code), soit un modèle de fichier de balisage pour un fichier README du référentiel. Vous pouvez créer des branches supplémentaires dans la console et dans les clients Git. Vous pouvez créer et modifier des fichiers dans la console, et supprimer des fichiers dans les environnements de développement et les clients Git.
## Je veux une branche différente comme branche par défaut
**Problème :** mon dépôt source contient une branche par défaut nommée`main`, mais je veux une branche différente comme branche par défaut.
**Correctifs possibles :** vous ne pouvez pas modifier ou supprimer la branche par défaut dans les référentiels sources dans CodeCatalyst. Vous pouvez créer des branches supplémentaires et les utiliser dans les actions source des flux de travail. Vous pouvez également choisir de lier GitHub des référentiels et de les utiliser comme référentiels pour votre projet.
## Je reçois des e-mails concernant l'activité des pull requests
**Problème :** je ne me suis pas inscrit ni configuré de notifications par e-mail concernant l'activité des pull requests, mais je les reçois quand même.
**Corrections possibles :** des notifications par e-mail sont envoyées automatiquement concernant l'activité des pull requests. Pour de plus amples informations, veuillez consulter [Révision du code à l'aide de pull requests sur Amazon CodeCatalyst](source-pull-requests.md).
## J'ai oublié mon jeton d'accès personnel (PAT)
**Problème :** j'utilise un PAT pour cloner, transférer et extraire du code pour les référentiels sources, mais j'ai perdu la valeur de mon jeton et je ne le trouve pas dans la CodeCatalyst console.
**Corrections possibles :** le moyen le plus rapide de résoudre ce problème est de créer un autre PAT et de configurer votre gestionnaire d'informations d'identification ou votre IDE pour utiliser ce nouveau PAT. Nous n'affichons la valeur d'un PAT que lorsque vous le créez. Si vous perdez cette valeur, elle ne peut pas être récupérée. Pour de plus amples informations, veuillez consulter [Accorder aux utilisateurs l'accès au référentiel avec des jetons d'accès personnels](ipa-tokens-keys.md).
## Une pull request n'affiche pas les modifications que j'attends
**Problème :** j'ai créé une pull request, mais je ne vois pas les modifications que je m'attends à voir entre les branches source et destination.
**Correctifs possibles :** Cela peut être dû à un certain nombre de problèmes. Essayez une ou plusieurs des solutions suivantes :
+ Il se peut que vous examiniez les modifications entre les anciennes révisions ou que vous ne visualisiez pas les dernières modifications. Actualisez votre navigateur et assurez-vous d'avoir choisi la comparaison entre les révisions que vous souhaitez consulter.
+ Les modifications apportées à une pull request ne peuvent pas toutes être affichées dans la console. Par exemple, vous ne pouvez pas afficher les sous-modules Git dans la console. Vous ne pouvez donc pas voir les différences entre les sous-modules dans une pull request. Certaines différences sont peut-être trop importantes pour être affichées. Pour plus d’informations, consultez [Quotas pour les référentiels sources dans CodeCatalyst](source-quotas.md) et [Affichage d'un fichierAfficher l'historique des modifications apportées à un fichier](source-files-view.md).
+ Les pull requests affichent les différences entre la base de fusion et la révision que vous choisissez. Lorsque vous créez une pull request, la différence qui s'affiche pour vous est la différence entre l'extrémité de la branche source et la pointe de la branche de destination. Une fois la pull request créée, la différence affichée se situe entre la révision et sa base de fusion. La base de fusion est le commit qui se trouvait à l'extrémité de la branche de destination lorsque la révision a été créée. La base de fusion peut changer entre les révisions. Pour plus d'informations sur les différences et les bases de fusion dans Git, consultez [git-merge-base](https://git-scm.com/docs/git-merge-base)la documentation Git.
## Une pull request indique le statut Non fusionnable
**Problème :** je souhaite fusionner une pull request, mais son statut indique « **Non fusionnable** ».
**Corrections possibles :** Cela peut être dû à un ou plusieurs problèmes :
+ Tous les réviseurs requis pour votre pull request doivent approuver une pull request avant qu'elle ne puisse être fusionnée. Consultez la liste des réviseurs requis pour tous les réviseurs avec une icône en forme d'horloge à côté du nom. Une icône en forme d'horloge indique que le réviseur n'a pas approuvé la pull request.
**Note**
Si un réviseur requis a été retiré de votre projet avant d'approuver la pull request, vous ne pouvez pas fusionner la pull request. Fermez la pull request et créez une nouvelle pull request.
+ Il peut y avoir un conflit de fusion entre la branche source et la branche de destination. CodeCatalyst ne prend pas en charge toutes les stratégies et options de fusion Git possibles. Vous pouvez évaluer les branches pour détecter les conflits de fusion dans un environnement de développement ou cloner le référentiel et utiliser un IDE ou des outils Git pour rechercher et résoudre les conflits de fusion. Pour de plus amples informations, veuillez consulter [Fusion d’une demande pull](pull-requests-merge.md).
# Projets et plans de résolution des problèmes
Cette section peut vous aider à résoudre certains problèmes courants que vous pouvez rencontrer lors de l'utilisation de projets et de plans sur Amazon. CodeCatalyst
# API Java avec AWS Fargate plan de dépendances manquantes pour apache-maven-3.8.6
**Problème :** Pour un projet créé à partir de l'API Java avec AWS Fargate Blueprint, le flux de travail échoue avec une erreur due à des `apache-maven-3.8.6` dépendances manquantes. Le flux de travail échoue avec une sortie similaire à l'exemple suivant :
```
Step 8/25 : RUN wget https://dlcdn.apache.org/maven/maven-3/3.8.6/binaries/apache-maven-3.8.6-bin.tar.gz -P /tmp
---> Running in 1851ce6f4d1b
[91m--2023-03-10 01:24:55-- https://dlcdn.apache.org/maven/maven-3/3.8.6/binaries/apache-maven-3.8.6-bin.tar.gz
[0m[91mResolving dlcdn.apache.org (dlcdn.apache.org)...
[0m[91m151.101.2.132, 2a04:4e42::644
Connecting to dlcdn.apache.org (dlcdn.apache.org)|151.101.2.132|:443...
[0m[91mconnected.
[0m[91mHTTP request sent, awaiting response... [0m[91m404 Not Found
2023-03-10 01:24:55 ERROR 404: Not Found.
[0mThe command '/bin/sh -c wget https://dlcdn.apache.org/maven/maven-3/3.8.6/binaries/apache-maven-3.8.6-bin.tar.gz -P /tmp' returned a non-zero code: 8
[Container] 2023/03/10 01:24:55 Command failed with exit status 8
```
**Solution :** mettez à jour le fichier Dockerfile du plan en procédant comme suit.
1. Dans la barre de recherche, entrez `apache-maven-3.8.6` pour localiser le fichier docker dans le projet créé avec l'API Java avec Blueprint. AWS Fargate
1. Mettez à jour le Dockerfile (`/static-assets/app/Dockerfile`) à utiliser `maven:3.9.0-amazoncorretto-11` comme image de base et supprimez la dépendance au `apache-maven-3.8.6` package.
1. (Recommandé) Nous recommandons également de mettre à jour la taille du tas de mémoire Maven à 6 Go.
Vous trouverez ci-dessous un exemple de Dockerfile.
```
FROM maven:3.9.0-amazoncorretto-11 AS builder
COPY ./pom.xml ./pom.xml
COPY src ./src/
ENV MAVEN_OPTS='-Xmx6g'
RUN mvn -Dmaven.test.skip=true clean package
FROM amazoncorretto:11-alpine
COPY —from=builder target/CustomerService-0.0.1.jar CustomerService-0.0.1.jar
EXPOSE 80
CMD ["java","-jar","-Dspring.profiles.active=prod","/CustomerService-0.0.1.jar", "—server.port=80"]
```
# Le flux de travail moderne du plan d'application Web à trois niveaux **OnPullRequest**échoue en raison d'une erreur d'autorisation pour Amazon CodeGuru
**Problème :** Lorsque j'essaie d'exécuter un flux de travail pour mon projet, le flux de travail ne s'exécute pas et le message suivant s'affiche :
```
Failed at codeguru_codereview: The action failed during runtime. View the action's logs for more details.
```
``
**Solution :** L'une des causes possibles de cet échec d'action peut être due à des autorisations manquantes dans la politique de rôle IAM, lorsque votre version du rôle de service utilisée par CodeCatalyst in the connected ne dispose pas des autorisations requises pour que l'action **codeguru\$1codereview** s'exécute correctement. Compte AWS Pour résoudre ce problème, soit le rôle de service doit être mis à jour avec les autorisations requises, soit vous devez remplacer le rôle de service utilisé pour le flux de travail par un rôle disposant des autorisations requises pour Amazon CodeGuru et Amazon CodeGuru Reviewer. En suivant les étapes suivantes, recherchez votre rôle et mettez à jour les autorisations de la politique de rôle afin de permettre au flux de travail de s'exécuter correctement.
**Note**
Ces étapes s'appliquent aux flux de travail suivants dans CodeCatalyst :
Le **OnPullRequest**flux de travail prévu pour les projets créés avec le plan d'application Web moderne à trois niveaux dans. CodeCatalyst
Des flux de travail ont été ajoutés aux projets CodeCatalyst avec des actions qui accèdent à Amazon CodeGuru ou Amazon CodeGuru Reviewer.
Chaque projet contient des flux de travail avec des actions qui utilisent un rôle et un environnement fournis par la Compte AWS personne connectée à votre projet dans CodeCatalyst. Le flux de travail avec les actions et leur politique désignée est stocké dans votre référentiel source dans le répertoire /.codecatalyst/workflows. Il n'est pas nécessaire de modifier le code YAML du flux de travail, sauf si vous ajoutez un nouvel ID de rôle au flux de travail existant. Pour plus d'informations sur les éléments du modèle YAML et le formatage, consultez[Définition du flux de travail YAML](workflow-reference.md).
Voici les étapes de haut niveau à suivre pour modifier votre politique de rôle et vérifier le flux de travail YAML.
**Pour référencer le nom de votre rôle dans le flux de travail YAML et mettre à jour la politique**
1. Ouvrez la CodeCatalyst console à l'[adresse https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Accédez à votre CodeCatalyst espace. Accédez à votre projet.
1. **Choisissez **CI/CD**, puis Workflows.**
1. Choisissez le flux de travail intitulé **OnPullRequest**. Choisissez l'onglet **Définition**.
1. Dans le flux de travail YAML, dans le `Role:` champ situé sous l'action **codeguru\$1codereview**, notez le nom du rôle. Il s'agit du rôle associé à la politique que vous allez modifier dans IAM. L'exemple suivant montre le nom du rôle.
![\[Afficher le nom du rôle IAM dans le flux de travail YAML\]](http://docs.aws.amazon.com/fr_fr/codecatalyst/latest/userguide/images/projects/ts-workflow-role.png)
1. Effectuez l’une des actions suivantes :
+ (Recommandé) Mettez à jour le rôle de service associé à votre projet avec les autorisations requises pour Amazon CodeGuru et Amazon CodeGuru Reviewer. Le rôle portera un nom `CodeCatalystWorkflowDevelopmentRole-spaceName` avec un identifiant unique ajouté. Pour plus d'informations sur le rôle et la politique de rôle, consultez[Comprendre le rôle **CodeCatalystWorkflowDevelopmentRole-*spaceName***du service](ipa-iam-roles.md#ipa-iam-roles-service-role). Passez aux étapes suivantes pour mettre à jour la politique dans IAM.
**Note**
Vous devez disposer d'un accès AWS administrateur Compte AWS au rôle et à la politique.
+ Modifiez le rôle de service utilisé pour le flux de travail en un rôle disposant des autorisations requises pour Amazon CodeGuru et Amazon CodeGuru Reviewer ou créez un nouveau rôle avec les autorisations requises.
1. Connectez-vous à la console IAM AWS Management Console et ouvrez-la à [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)l'adresse.
Dans la console IAM, recherchez le rôle indiqué à l'étape 5, par exemple`CodeCatalystPreviewDevelopmentRole`.
1. Dans le rôle indiqué à l'étape 5, modifiez la politique d'autorisation pour inclure les `codeguru:*` autorisations `codeguru-reviewer:*` et. Une fois ces autorisations ajoutées, la politique d'autorisation doit ressembler à la suivante :
1. Après avoir apporté les corrections de politique, revenez à l'exécution du flux de travail CodeCatalyst et recommencez.
## Vous cherchez toujours à résoudre votre problème ?
Vous pouvez vous rendre [sur Amazon CodeCatalyst](https://codecatalyst.aws/) ou remplir un [formulaire de commentaires de support](https://support.aws.amazon.com/#/contacts/aws-account-support/). Dans la section **Demande d'informations**, sous **Comment pouvons-nous vous aider**, indiquez que vous êtes un CodeCatalyst client Amazon. Fournissez le plus de détails possible afin que nous puissions résoudre votre problème le plus efficacement possible.
# 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.
# Résolution des problèmes liés aux flux de travail
Consultez les sections suivantes pour résoudre les problèmes liés aux flux de travail sur Amazon CodeCatalyst. Pour de plus amples informations sur les flux de travail, veuillez consulter [Créez, testez et déployez avec des flux de travailCréez, testez et déployez avec des flux de travail](workflow.md).
**Topics**
+ [Comment corriger les messages « Le flux de travail est inactif » ?](#troubleshooting-workflows-inactive)
+ [Comment corriger les erreurs « La définition du flux de travail comporte *n* des erreurs » ?](#troubleshooting-workflows-asterisks)
+ [Comment corriger les erreurs « Impossible de localiser les informations d'identification » et ExpiredToken « » ?](#troubleshooting-workflows-auth-errors-eks)
+ [Comment corriger les erreurs « Impossible de se connecter au serveur » ?](#troubleshooting-workflows-unable-connect-eks)
+ [Pourquoi les CodeDeploy champs sont-ils absents de l'éditeur visuel ?](#troubleshooting-workflows-codedeploy)
+ [Comment corriger les erreurs liées aux fonctionnalités IAM ?](#troubleshooting-workflows-capabilities)
+ [Comment corriger les erreurs « npm install » ?](#troubleshooting-workflows-npm)
+ [Pourquoi plusieurs flux de travail portent-ils le même nom ?](#troubleshooting-workflows-name)
+ [Puis-je stocker les fichiers de définition de mon flux de travail dans un autre dossier ?](#troubleshooting-workflows-folder)
+ [Comment ajouter des actions en séquence à mon flux de travail ?](#troubleshooting-workflows-visual)
+ [Pourquoi mon flux de travail est-il correctement validé mais échoue-t-il lors de l'exécution ?](#troubleshooting-workflows-validation)
+ [La détection automatique ne détecte aucun rapport concernant mon action](#troubleshooting-reports-auto-discovery)
+ [Mon action échoue sur les rapports découverts automatiquement une fois que j'ai configuré les critères de réussite](#troubleshooting-success-auto-discovery)
+ [La découverte automatique génère des rapports dont je ne veux pas](#troubleshooting-unwanted-auto-discovery)
+ [La découverte automatique génère de nombreux petits rapports pour une seule infrastructure de test](#troubleshooting-reports-combined)
+ [Les flux de travail répertoriés sous CI/CD ne correspondent pas à ceux du référentiel source](#troubleshooting-workflow-source)
+ [Je n'arrive pas à créer ou à mettre à jour des flux de travail](#troubleshooting-workflows-branchrules)
## Comment corriger les messages « Le flux de travail est inactif » ?
**Problème** : Dans la CodeCatalyst console, sous **CI/CD**, **Workflows**, votre flux de travail apparaît avec le message suivant :
`Workflow is inactive.`
Ce message indique que le fichier de définition du flux de travail contient un déclencheur qui ne s'applique pas à la branche sur laquelle vous vous trouvez actuellement. Par exemple, votre fichier de définition de flux de travail peut contenir un `PUSH` déclencheur qui fait référence à votre `main` branche, mais vous êtes sur une branche de fonctionnalités. Étant donné que les modifications que vous apportez à votre branche de fonctionnalités ne s'appliquent pas aux `main` exécutions du flux de travail et ne démarrent pas`main`, CodeCatalyst désactive le flux de travail de la branche et marquez-le comme tel`Inactive`.
**Correctifs possibles :**
Si vous souhaitez démarrer un flux de travail sur votre branche de fonctionnalités, vous pouvez effectuer les opérations suivantes :
+ Dans votre branche de fonctionnalités, dans le fichier de définition du flux de travail, supprimez la `Branches` propriété de la `Triggers` section pour qu'elle ressemble à ceci :
```
Triggers:
- Type: PUSH
```
Cette configuration entraîne l'activation du déclencheur lors d'un push vers n'importe quelle branche, y compris votre branche de fonctionnalités. Si le déclencheur est activé, un flux de travail CodeCatalyst sera lancé à l'aide du fichier de définition du flux de travail et des fichiers source, quelle que soit la branche vers laquelle vous envoyez le message.
+ Dans votre branche de fonctionnalités, dans le fichier de définition du flux de travail, supprimez la `Triggers` section et exécutez le flux de travail manuellement.
+ Dans votre branche de fonctionnalités, dans le fichier de définition du flux de travail, modifiez la `PUSH` section afin qu'elle fasse référence à votre branche de fonctionnalités plutôt qu'à une autre branche (par exemple). `main`
**Important**
Veillez à ne pas valider ces modifications si vous n'avez pas l'intention de les fusionner pour les réintégrer dans votre `main` succursale.
Pour plus d'informations sur la modification du fichier de définition du flux de travail, consultez[Création d'un flux de travail](workflows-create-workflow.md).
Pour plus d'informations sur les déclencheurs, consultez [Démarrage d'un flux de travail exécuté automatiquement à l'aide de déclencheurs](workflows-add-trigger.md).
## Comment corriger les erreurs « La définition du flux de travail comporte *n* des erreurs » ?
**Problème** : l'un des messages d'erreur suivants s'affiche :
**Erreur 1 :**
Sur la page **CI/CD**, **Workflows**, sous le nom de votre flux de travail, vous pouvez voir :
`Workflow definition has n errors`
**Erreur 2 :**
Lorsque vous modifiez un flux de travail, vous cliquez sur le bouton **Valider** et le message suivant apparaît en haut de la CodeCatalyst console :
`The workflow definition has errors. Fix the errors and choose Validate to verify your changes.`
**Erreur 3 :**
Après avoir accédé à la page de détails de votre flux de travail, l'erreur suivante s'affiche dans le champ de **définition du flux de travail** :
`n errors`
**Correctifs possibles :**
+ Choisissez **CI/CD**, choisissez **Workflows**, puis choisissez le nom du flux de travail contenant l'erreur. Dans le champ **de définition du flux** de travail situé en haut, choisissez le lien vers l'erreur. Les détails de l'erreur apparaissent au bas de la page. Suivez les conseils de dépannage indiqués dans le message d'erreur pour résoudre le problème.
+ Assurez-vous que le fichier de définition du flux de travail est un fichier YAML.
+ Assurez-vous que les propriétés YAML du fichier de définition du flux de travail sont imbriquées au bon niveau. Pour savoir comment les propriétés doivent être imbriquées dans le fichier de définition du flux de travail, reportez-vous à la documentation de votre action[Définition du flux de travail YAML](workflow-reference.md), ou consultez la documentation de votre action, qui est liée à from[Ajouter une action à un flux de travail](workflows-add-action.md).
+ Assurez-vous que les astérisques (`*`) et les autres caractères spéciaux sont correctement masqués. Pour y échapper, ajoutez des guillemets simples ou doubles. Par exemple :
```
Outputs:
Artifacts:
- Name: myartifact
Files:
- "**/*"
```
Pour plus d'informations sur les caractères spéciaux dans le fichier de définition du flux de travail, consultez[Consignes et conventions de syntaxe](workflow-reference.md#workflow.terms.syntax.conv).
+ Assurez-vous que les propriétés YAML du fichier de définition du flux de travail utilisent les bonnes majuscules. Pour plus d'informations sur les règles relatives au boîtier, voir[Consignes et conventions de syntaxe](workflow-reference.md#workflow.terms.syntax.conv). Pour déterminer le bon boîtier de chaque propriété, reportez-vous à la documentation de votre action ou consultez la [Définition du flux de travail YAML](workflow-reference.md) documentation relative à votre action, dont le lien se trouve à partir de[Ajouter une action à un flux de travail](workflows-add-action.md).
+ Assurez-vous que la `SchemaVersion` propriété est présente et définie sur la bonne version dans le fichier de définition du flux de travail. Pour de plus amples informations, veuillez consulter [SchemaVersion](workflow-reference.md#workflow.schemaversion).
+ Assurez-vous que la `Triggers` section du fichier de définition du flux de travail inclut toutes les propriétés requises. Pour déterminer les propriétés requises, choisissez le déclencheur dans l'[éditeur visuel](workflow.md#workflow.editors) et recherchez les champs dans lesquels des informations sont manquantes, ou consultez la documentation de référence du déclencheur à l'adresse[Triggers](workflow-reference.md#triggers-reference).
+ Assurez-vous que la `DependsOn` propriété du fichier de définition du flux de travail est correctement configurée et qu'elle n'introduit pas de dépendances circulaires. Pour de plus amples informations, veuillez consulter [Actions de séquençage](workflows-depends-on.md).
+ Assurez-vous que la `Actions` section du fichier de définition du flux de travail inclut au moins une action. Pour de plus amples informations, veuillez consulter [Actions](workflow-reference.md#actions-reference).
+ Assurez-vous que chaque action inclut toutes les propriétés requises. Pour déterminer les propriétés requises, choisissez l'action dans l'[éditeur visuel](workflow.md#workflow.editors) et recherchez les champs dans lesquels des informations sont manquantes, ou consultez la documentation de votre action, qui est liée à partir de[Ajouter une action à un flux de travail](workflows-add-action.md).
+ Assurez-vous que tous les artefacts d'entrée ont des artefacts de sortie correspondants. Pour de plus amples informations, veuillez consulter [Définition d'un artefact de sortie](workflows-working-artifacts-output.md).
+ Assurez-vous que les variables définies dans une action sont exportées afin de pouvoir être utilisées dans d'autres actions. Pour de plus amples informations, veuillez consulter [Exporter une variable afin que d'autres actions puissent l'utiliser](workflows-working-with-variables-export-input.md).
## Comment corriger les erreurs « Impossible de localiser les informations d'identification » et ExpiredToken « » ?
**Problème** : pendant que vous travaillez[Tutoriel : Déploiement d'une application sur Amazon EKS](deploy-tut-eks.md), l'un des messages d'erreur suivants ou les deux s'affichent dans la fenêtre du terminal de votre machine de développement :
`Unable to locate credentials. You can configure credentials by running "aws configure".`
`ExpiredToken: The security token included in the request is expired`
**Correctifs possibles :**
Ces erreurs indiquent que les informations d'identification que vous utilisez pour accéder aux AWS services ont expiré. Dans ce cas, n'exécutez pas la `aws configure` commande. Utilisez plutôt les instructions suivantes pour actualiser votre clé AWS d'accès et votre jeton de session.
**Pour actualiser votre clé AWS d'accès et votre jeton de session**
1. Assurez-vous de disposer de l'URL, du nom d'utilisateur et du mot de passe du portail d' AWS accès de l'utilisateur que vous utilisez dans l'intégralité du didacticiel Amazon EKS (`codecatalyst-eks-user`). Vous devriez avoir configuré ces éléments à la fin [Étape 1 : Configuration de votre machine de développement](deploy-tut-eks.md#deploy-tut-eks-dev-env-create) du didacticiel.
**Note**
Si vous ne disposez pas de ces informations, rendez-vous sur la page de `codecatalyst-eks-user` détails dans IAM Identity Center, choisissez **Réinitialiser le mot de passe**, **Générer un mot de passe à usage unique [...]** , et **Réinitialisez à nouveau le mot** de passe pour afficher les informations à l'écran.
1. Effectuez l’une des actions suivantes :
+ Collez l'URL du portail d' AWS accès dans la barre d'adresse de votre navigateur.
Or
+ Actualisez la page du portail d' AWS accès si elle est déjà chargée.
1. Connectez-vous avec le nom `codecatalyst-eks-user` d'utilisateur et le mot de passe, si ce n'est pas déjà fait.
1. Choisissez **Compte AWS**, puis choisissez le nom auquel vous avez attribué l'`codecatalyst-eks-user`utilisateur et le jeu d'autorisations. Compte AWS
1. À côté du nom du jeu d'autorisations (`codecatalyst-eks-permission-set`), choisissez **Ligne de commande ou Accès programmatique**.
1. Copiez les commandes au milieu de la page. Ils ressemblent à ce qui suit :
```
export AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE"
export AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
export AWS_SESSION_TOKEN="session-token"
```
... où se *session-token* trouve une longue chaîne aléatoire.
1. Collez les commandes dans l'invite de votre terminal sur votre machine de développement et appuyez sur Entrée.
Les nouvelles clés et le nouveau jeton de session sont chargés.
Vous avez maintenant actualisé vos informations d'identification. Les `kubectl` commandes AWS CLI`eksctl`, et devraient maintenant fonctionner.
## Comment corriger les erreurs « Impossible de se connecter au serveur » ?
**Problème** : pendant que vous suivez le didacticiel décrit dans[Tutoriel : Déploiement d'une application sur Amazon EKS](deploy-tut-eks.md), un message d'erreur similaire au suivant s'affiche dans la fenêtre du terminal de votre machine de développement :
`Unable to connect to the server: dial tcp: lookup long-string.gr7.us-west-2.eks.amazonaws.com on 1.2.3.4:5: no such host`
**Correctifs possibles :**
Cette erreur indique généralement que les informations d'identification utilisées par l'`kubectl`utilitaire pour se connecter à votre cluster Amazon EKS ont expiré. Pour résoudre le problème, actualisez les informations d'identification en saisissant la commande suivante à l'invite du terminal :
```
aws eks update-kubeconfig --name codecatalyst-eks-cluster --region us-west-2
```
Où :
+ *codecatalyst-eks-cluster*est remplacé par le nom de votre cluster Amazon EKS.
+ *us-west-2*est remplacé par la AWS région dans laquelle votre cluster est déployé.
## Pourquoi les CodeDeploy champs sont-ils absents de l'éditeur visuel ?
**Problème** : vous utilisez une action [Deploy to Amazon ECS](deploy-action-ecs.md) et les CodeDeploy champs ne s'affichent pas, par exemple **CodeDeploy AppSpec**dans l'éditeur visuel du flux de travail. Ce problème peut se produire parce que le service Amazon ECS que vous avez spécifié dans le champ **Service** n'est pas configuré pour effectuer des déploiements bleu/vert.
**Correctifs possibles :**
+ Choisissez un autre service Amazon ECS dans l'onglet **Configuration** de l'action **Deploy to Amazon ECS**. Pour de plus amples informations, veuillez consulter [Déploiement sur Amazon ECS à l'aide d'un flux de travail](deploy-action-ecs.md).
+ Configurez le service Amazon ECS sélectionné pour effectuer des blue/green déploiements. Pour plus d'informations sur la configuration des blue/green déploiements, consultez la section [Déploiement bleu/vert avec dans CodeDeploy le manuel](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-type-bluegreen.html) *Amazon Elastic Container Service* Developer Guide.
## Comment corriger les erreurs liées aux fonctionnalités IAM ?
**Problème** : vous utilisez une action [Deploy CloudFormation stack](deploy-action-cfn.md), et vous pouvez le voir `##[error] requires capabilities: [capability-name]` dans les journaux de votre action **Deploy CloudFormation stack**.
**Correctifs possibles** : suivez la procédure suivante pour ajouter la fonctionnalité au fichier de définition du flux de travail. Pour plus d'informations sur les fonctionnalités IAM, consultez la section [Reconnaissance des ressources IAM dans les CloudFormation modèles](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#using-iam-capabilities) du Guide de l'utilisateur *IAM*.
------
#### [ Visual ]
**Pour ajouter une fonctionnalité IAM à l'aide de l'éditeur visuel**
1. Ouvrez la CodeCatalyst console à l'[adresse https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Choisissez votre projet.
1. **Dans le volet de navigation, choisissez **CI/CD**, puis Workflows.**
1. Choisissez le nom de votre flux de travail. Vous pouvez filtrer par le nom du référentiel source ou de la branche où le flux de travail est défini, ou filtrer par nom ou statut du flux de travail.
1. Choisissez **Modifier**.
1. Choisissez **Visual**.
1. Dans le diagramme du flux de travail, choisissez votre action **Deploy CloudFormation stack**.
1. Cliquez sur l’onglet **Configuration**.
1. En bas de la page, sélectionnez **Avancé - facultatif**.
1. Dans la liste déroulante **Fonctionnalités**, cochez la case à côté de la fonctionnalité mentionnée dans le message d'erreur. Si la fonctionnalité n'est pas disponible dans la liste, utilisez l'éditeur YAML pour l'ajouter.
1. (Facultatif) Choisissez **Valider** pour valider le code YAML du flux de travail avant de le valider.
1. Choisissez **Valider**, entrez un message de validation, puis choisissez à nouveau **Valider**.
1. Si une nouvelle exécution de flux de travail ne démarre pas automatiquement, exécutez-le manuellement pour voir si les modifications corrigent l'erreur. Pour plus d'informations sur l'exécution manuelle d'un flux de travail, consultez[Démarrage manuel de l’exécution d’un flux de travail](workflows-manually-start.md).
------
#### [ YAML ]
**Pour ajouter une fonctionnalité IAM à l'aide de l'éditeur YAML**
1. Ouvrez la CodeCatalyst console à l'[adresse https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Choisissez votre projet.
1. **Dans le volet de navigation, choisissez **CI/CD**, puis Workflows.**
1. Choisissez le nom de votre flux de travail. Vous pouvez filtrer par le nom du référentiel source ou de la branche où le flux de travail est défini, ou filtrer par nom ou statut du flux de travail.
1. Choisissez **Modifier**.
1. Choisissez **YAML.**
1. Dans l'action **Deploy CloudFormation stack**, ajoutez une `capabilities` propriété, comme celle-ci :
```
DeployCloudFormationStack:
Configuration:
capabilities: capability-name
```
*capability-name*Remplacez-le par le nom de la fonctionnalité IAM indiqué dans le message d'erreur. Utilisez des virgules et aucun espace pour répertorier plusieurs fonctionnalités. Pour plus d'informations, consultez la description de la `capabilities` propriété dans le[Action « Déployer une CloudFormation pile » YAML](deploy-action-ref-cfn.md).
1. (Facultatif) Choisissez **Valider** pour valider le code YAML du flux de travail avant de le valider.
1. Choisissez **Valider**, entrez un message de validation, puis choisissez à nouveau **Valider**.
1. Si une nouvelle exécution de flux de travail ne démarre pas automatiquement, exécutez-le manuellement pour voir si les modifications corrigent l'erreur. Pour plus d'informations sur l'exécution manuelle d'un flux de travail, consultez[Démarrage manuel de l’exécution d’un flux de travail](workflows-manually-start.md).
------
## Comment corriger les erreurs « npm install » ?
**Problème** : votre [action de AWS CDK déploiement ou d'AWS CDK](cdk-dep-action.md)[amorçage](cdk-boot-action.md) échoue avec une `npm install` erreur. Cette erreur peut se produire parce que vous stockez les dépendances de votre AWS CDK application dans un registre npm (private node package manager) auquel l'action ne peut pas accéder.
**Corrections possibles** : suivez les instructions suivantes pour mettre à jour le `cdk.json` fichier de votre AWS CDK application avec des informations de registre et d'authentification supplémentaires.
**Avant de commencer**
1. Créez des secrets pour vos informations d'authentification. Vous allez référencer ces secrets dans le `cdk.json` fichier au lieu de fournir les équivalents en texte clair. Pour créer les secrets, procédez comme suit :
1. Ouvrez la CodeCatalyst console à l'[adresse https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Choisissez votre projet.
1. **Dans le volet de navigation, choisissez **CI/CD**, puis Secrets.**
1. Créez deux secrets dotés des propriétés suivantes :
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/codecatalyst/latest/userguide/troubleshooting-workflows.html)
Pour plus d'informations sur les secrets, consultez[Masquage de données à l'aide de secrets](workflows-secrets.md).
1. Ajoutez les secrets en tant que variables d'environnement à votre AWS CDK action. L'action remplacera les variables par des valeurs réelles lors de son exécution. Pour ajouter les secrets, procédez comme suit :
1. **Dans le volet de navigation, choisissez **CI/CD**, puis Workflows.**
1. Choisissez le nom de votre flux de travail. Vous pouvez filtrer par le nom du référentiel source ou de la branche où le flux de travail est défini, ou filtrer par nom ou statut du flux de travail.
1. Choisissez **Modifier**.
1. Choisissez **Visual**.
1. Dans le diagramme du flux de travail, choisissez votre AWS CDK action.
1. Sélectionnez l’onglet **Entrées**.
1. Ajoutez deux variables avec les propriétés suivantes :
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/codecatalyst/latest/userguide/troubleshooting-workflows.html)
Vous disposez désormais de deux variables contenant des références à des secrets.
Le code YAML de votre fichier de définition de flux de travail doit ressembler à ce qui suit :
**Note**
L'exemple de code suivant provient d'une action d'**AWS CDK amorçage** ; une action de **AWS CDK déploiement** sera similaire.
```
Name: CDK_Bootstrap_Action
SchemaVersion: 1.0
Actions:
CDKBootstrapAction:
Identifier: aws/cdk-bootstrap@v2
Inputs:
Variables:
- Name: NPMUSER
Value: ${Secrets.npmUsername}
- Name: NPMTOKEN
Value: ${Secrets.npmAuthToken}
Sources:
- WorkflowSource
Environment:
Name: Dev2
Connections:
- Name: account-connection
Role: codecatalystAdmin
Configuration:
Parameters:
Region: "us-east-2"
```
Vous êtes maintenant prêt à utiliser les `NPMTOKEN` variables `NPMUSER` et de votre `cdk.json` fichier. Passez à la procédure suivante.
**Pour mettre à jour votre fichier cdk.json**
1. Accédez au répertoire racine de votre AWS CDK projet et ouvrez le `cdk.json` fichier.
1. Recherchez la `"app":` propriété et modifiez-la pour inclure le code affiché dans *red italics* :
**Note**
L'exemple de code suivant provient d'un TypeScript projet. Si vous utilisez un JavaScript projet, le code sera similaire mais pas identique.
```
{
"app": "npm set registry=https://your-registry/folder/CDK-package/ --userconfig .npmrc && npm set //your-registry/folder/CDK-package/:always-auth=true --userconfig .npmrc && npm set //your-registry/folder/CDK-package/:_authToken=\"${NPMUSER}\":\"${NPMTOKEN}\" && npm install && npx ts-node --prefer-ts-exts bin/hello-cdk.ts|js",
"watch": {
"include": [
"**"
],
"exclude": [
"README.md",
"cdk*.json",
"**/*.d.ts",
"**/*.js",
"tsconfig.json",
"package*.json",
...
```
1. Dans le code surligné dans*red italics*, remplacez :
+ *your-registry/folder/CDK-package/*avec le chemin d'accès aux dépendances de votre AWS CDK projet dans votre registre privé.
+ *hello-cdk.ts\$1.js*avec le nom de votre fichier de point d'entrée. Il peut s'agir d'un fichier `.ts` `.js` (TypeScriptJavaScript) ou () selon la langue que vous utilisez.
**Note**
L'action remplacera les *NPMTOKEN* variables *NPMUSER* et par le nom d'utilisateur npm et le jeton d'accès que vous avez spécifiés dans **Secrets**.
1. Enregistrez votre fichier `cdk.json`.
1. Réexécutez l'action manuellement pour voir si les modifications corrigent l'erreur. Pour plus d'informations sur l'exécution manuelle d'actions, consultez[Démarrage manuel de l’exécution d’un flux de travail](workflows-manually-start.md).
## Pourquoi plusieurs flux de travail portent-ils le même nom ?
Les flux de travail sont stockés par branche et par référentiel. Deux flux de travail différents peuvent porter le même nom s'ils existent dans des branches différentes. Sur la page Flux de travail, vous pouvez différencier les flux de travail du même nom en consultant le nom de la branche. Pour de plus amples informations, veuillez consulter [Organisation de votre code source : travaillez avec des branches sur Amazon CodeCatalyst](source-branches.md).
![\[Branche Workflow\]](http://docs.aws.amazon.com/fr_fr/codecatalyst/latest/userguide/images/flows/workflow-branch.png)
## Puis-je stocker les fichiers de définition de mon flux de travail dans un autre dossier ?
Non, vous devez stocker tous les fichiers de définition du flux de travail dans le `.codecatalyst/workflows` dossier ou dans les sous-dossiers de ce dossier. Si vous utilisez un dépôt mono avec plusieurs projets logiques, placez tous les fichiers de définition de votre flux de travail dans le `.codecatalyst/workflows` dossier ou dans l'un de ses sous-dossiers, puis utilisez le champ **Fichiers modifiés** (éditeur visuel) ou la `FilesChanged` propriété (éditeur YAML) dans un déclencheur pour déclencher le flux de travail automatiquement sur un chemin de projet spécifié. Pour plus d’informations, consultez [Ajouter des déclencheurs aux flux de travail](workflows-add-trigger-add.md) et [Exemple : un déclencheur avec un push, des branches et des fichiers](workflows-add-trigger-examples.md#workflows-add-trigger-examples-push-multi).
## Comment ajouter des actions en séquence à mon flux de travail ?
Par défaut, lorsque vous ajoutez une action à votre flux de travail, celle-ci ne comporte aucune dépendance et s'exécute en parallèle avec les autres actions.
Si vous souhaitez organiser les actions en séquence, vous pouvez définir une dépendance par rapport à une autre action en définissant le `DependsOn` champ. Vous pouvez également configurer une action pour consommer des artefacts ou des variables issus d'autres actions. Pour de plus amples informations, veuillez consulter [Actions de séquençage](workflows-depends-on.md).
## Pourquoi mon flux de travail est-il correctement validé mais échoue-t-il lors de l'exécution ?
Si vous avez validé votre flux de travail à l'aide du `Validate` bouton, mais que celui-ci a quand même échoué, cela peut être dû à une limitation du validateur.
Toute erreur faisant référence à une CodeCatalyst ressource telle que des secrets, des environnements ou des flottes dans la configuration du flux de travail ne sera pas enregistrée lors d'une validation. Si des références non valides sont utilisées, l'erreur ne sera identifiée que lors de l'exécution d'un flux de travail. De même, s'il existe des erreurs dans la configuration de votre action, telles que l'absence d'un champ obligatoire ou des fautes de frappe dans les attributs de l'action, elles ne seront identifiées que lors de l'exécution du flux de travail. Pour de plus amples informations, veuillez consulter [Création d'un flux de travail](workflows-create-workflow.md).
## La détection automatique ne détecte aucun rapport concernant mon action
**Problème :** J'ai configuré la détection automatique pour une action qui exécute des tests, mais aucun rapport n'est découvert par CodeCatalyst.
**Correctifs possibles :** Cela peut être dû à un certain nombre de problèmes. Essayez une ou plusieurs des solutions suivantes :
+ Assurez-vous que l'outil utilisé pour exécuter les tests produit des sorties dans l'un des formats CodeCatalyst compatibles. Par exemple, si vous `pytest` souhaitez autoriser la découverte des rapports CodeCatalyst de test et de couverture du code, incluez les arguments suivants :
```
--junitxml=test_results.xml --cov-report xml:test_coverage.xml
```
Pour de plus amples informations, veuillez consulter [Types de rapports sur la qualité](test-workflow-actions.md#test-reporting).
+ Assurez-vous que l'extension de fichier pour les sorties correspond au format choisi. Par exemple, lors de la configuration `pytest` pour produire des résultats au `JUnitXML` format, vérifiez que l'extension du fichier est bien`.xml`. Pour de plus amples informations, veuillez consulter [Types de rapports sur la qualité](test-workflow-actions.md#test-reporting).
+ Assurez-vous qu'il `IncludePaths` est configuré pour inclure l'ensemble du système de fichiers (`**/*`), sauf si vous excluez certains dossiers exprès. De même, assurez-vous de `ExcludePaths` ne pas exclure les répertoires dans lesquels vous souhaitez que vos rapports se trouvent.
+ Si vous avez configuré manuellement un rapport pour utiliser un fichier de sortie spécifique, il sera exclu de la détection automatique. Pour de plus amples informations, veuillez consulter [Exemple de rapports de qualité YAML](test-config-action.md#test.success-criteria-example).
+ La détection automatique peut ne pas trouver de rapports car l'action a échoué avant que les résultats ne soient générés. Par exemple, il se peut que la compilation ait échoué avant que les tests unitaires aient été exécutés.
## Mon action échoue sur les rapports découverts automatiquement une fois que j'ai configuré les critères de réussite
**Problème :** lorsque j'active la découverte automatique et que je configure les critères de réussite, certains rapports ne répondent pas aux critères de réussite et l'action échoue par conséquent.
**Correctifs possibles :** Pour résoudre ce problème, essayez une ou plusieurs des solutions suivantes :
+ Modifiez `IncludePaths` ou `ExcludePaths` excluez les rapports qui ne vous intéressent pas.
+ Mettez à jour les critères de réussite pour permettre à tous les rapports de passer. Par exemple, si deux rapports ont été découverts, l'un présentant une couverture linéaire de 50 % et l'autre de 70 %, ajustez la couverture linéaire minimale à 50 %. Pour de plus amples informations, consultez [Critères de réussite](test-best-practices.md#test.best-success-criteria).
+ Transformez le rapport défaillant en un rapport configuré manuellement. Cela vous permet de configurer différents critères de réussite pour ce rapport spécifique. Pour de plus amples informations, veuillez consulter [Configuration des critères de réussite pour les rapports](test-config-action.md#test.success-criteria).
## La découverte automatique génère des rapports dont je ne veux pas
**Problème :** lorsque j'active la découverte automatique, cela génère des rapports dont je ne veux pas avoir besoin. Par exemple, CodeCatalyst génère des rapports de couverture de code pour les fichiers inclus dans les dépendances de mon application stockées dans`node_modules`.
**Corrections possibles :** vous pouvez ajuster la `ExcludePaths` configuration pour exclure les fichiers indésirables. Par exemple, pour exclure`node_modules`, ajoutez`node_modules/**/*`. Pour de plus amples informations, veuillez consulter [Inclure/exclure des chemins](test-best-practices.md#test.best-include-exclude).
## La découverte automatique génère de nombreux petits rapports pour une seule infrastructure de test
**Problème :** lorsque j'utilise certains frameworks de reporting relatifs aux tests et à la couverture du code, j'ai remarqué que la découverte automatique génère un grand nombre de rapports. Par exemple, lorsque vous utilisez le [plug-in Maven Surefire](https://maven.apache.org/surefire/maven-surefire-plugin/), la découverte automatique produit un rapport différent pour chaque classe de test.
**Corrections possibles :** votre framework peut être en mesure d'agréger les sorties dans un seul fichier. Par exemple, si vous utilisez le plugin Maven Surefire, vous pouvez l'utiliser `npx junit-merge` pour agréger les fichiers manuellement. L'expression complète peut ressembler à ceci :
```
mvn test; cd test-package-path/surefire-reports && npx junit-merge -d ./ && rm *Test.xml
```
## Les flux de travail répertoriés sous CI/CD ne correspondent pas à ceux du référentiel source
**Problème :** Les flux de travail affichés sur la page **CI/CD**, **Workflows** ne correspondent pas à ceux du `~/.codecatalyst/workflows/` dossier de votre référentiel [source](source.md). Vous pouvez constater les incohérences suivantes :
+ Un flux de travail apparaît sur la page **Flux** de travail, mais aucun fichier de définition de flux de travail correspondant n'existe dans votre référentiel source.
+ Un fichier de définition de flux de travail existe dans votre référentiel source, mais aucun flux de travail correspondant n'apparaît sur la page **Workflows**.
+ Un flux de travail existe à la fois dans le référentiel source et dans la page **Workflows**, mais les deux sont différents.
Ce problème peut se produire si la page **Workflows** n'a pas eu le temps de s'actualiser ou si un quota de flux de travail a été dépassé.
**Correctifs possibles :**
+ Patientez. Vous devez généralement attendre deux ou trois secondes après une validation dans la source avant de voir le changement sur la page **Workflows**.
+ Si vous avez dépassé un quota de flux de travail, effectuez l'une des opérations suivantes :
**Note**
Pour déterminer si un quota de flux de travail a été dépassé[Quotas pour les flux de travail dans CodeCatalyst](workflows-quotas.md), passez en revue et recoupez les quotas documentés par rapport aux flux de travail de votre référentiel source ou sur la page **Flux** de travail. Aucun message d'erreur n'indique qu'un quota a été dépassé. Vous devrez donc vérifier par vous-même.
+ Si vous avez dépassé le **nombre maximal de flux de travail par quota d'espace**, supprimez certains flux de travail, puis effectuez un test de validation par rapport au fichier de définition du flux de travail. Un exemple de validation de test peut consister à ajouter un espace au fichier.
+ Si vous avez dépassé le quota de **taille maximale du fichier de définition du flux** de travail, modifiez le fichier de définition du flux de travail pour réduire sa longueur.
+ Si vous avez dépassé le **nombre maximal de fichiers de flux de travail traités dans le cadre d'un quota d'événements source unique**, effectuez plusieurs validations de test. Modifiez un nombre de flux de travail inférieur au maximum dans chaque validation.
## Je n'arrive pas à créer ou à mettre à jour des flux de travail
**Problème :** je souhaite créer ou mettre à jour un flux de travail, mais une erreur s'affiche lorsque j'essaie de valider la modification.
**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 fichiers YAML pour les flux de travail sont stockés dans des référentiels. Pour de plus amples informations, veuillez consulter [Fichiers de définition du flux de travail](workflows-concepts.md#workflows-concepts-workflows-def). Les rôles **d'administrateur d'espace**, d'**administrateur de projet** et de **contributeur** sont tous autorisés à valider et à envoyer du code vers les référentiels d'un projet.
Si vous avez le rôle de **contributeur** mais que vous ne pouvez pas créer ou modifier le flux de travail YAML dans une branche spécifique, il se peut qu'une règle de branche configurée pour cette branche empêche les utilisateurs ayant ce rôle de transmettre du code à cette branche en particulier. Essayez de créer un flux de travail dans une autre branche ou de valider vos modifications dans une autre 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).
# Résolution des problèmes liés aux problèmes
Les informations suivantes peuvent vous aider à résoudre les problèmes courants liés aux problèmes liés à CodeCatalyst.
**Topics**
+ [Je ne parviens pas à choisir un destinataire pour mon problème](#troubleshooting-issues-assignees)
## Je ne parviens pas à choisir un destinataire pour mon problème
**Problème :** lors de la création d'un problème, la liste des personnes assignées est vide.
**Corrections possibles :** La liste des destinataires est directement liée aux CodeCatalyst utilisateurs répertoriés en tant que membres du projet. Pour vérifier que l'accès au profil utilisateur fonctionne correctement, cliquez sur l'icône du profil, puis sur **Profil utilisateur**. Si les informations du profil utilisateur ne sont pas renseignées, consultez le rapport de santé pour détecter tout incident. S'il est renseigné, déposez un ticket de service.
# Résolution des problèmes liés à la recherche dans CodeCatalyst
Consultez les sections suivantes pour résoudre les problèmes liés à la recherche. CodeCatalyst Pour de plus amples informations sur les flux de travail, veuillez consulter [Recherchez du code, des problèmes, des projets et des utilisateurs dans CodeCatalystRechercher du code, des problèmes, des projets et des utilisateurs](search.md).
**Topics**
+ [Je ne trouve pas d'utilisateur dans mon projet](#troubleshooting-search-users)
+ [Je ne vois pas ce que je recherche dans mon projet ou mon espace](#troubleshooting-missing-results)
+ [Le nombre de résultats de recherche ne cesse de changer lorsque je navigue dans les pages](#troubleshooting-search-results)
+ [Ma requête de recherche n'est pas terminée](#troubleshooting-requests-limits)
## Je ne trouve pas d'utilisateur dans mon projet
**Problème :** Lorsque j'essaie de consulter les informations d'un utilisateur, je ne les vois pas dans le projet.
**Corrections possibles :** La recherche ne prend actuellement pas en charge la recherche d'utilisateurs au sein d'un projet. Pour rechercher des utilisateurs ayant accès à votre espace, passez à **Cet espace** dans QuickSearch ou supprimez les filtres de projet que vous avez éventuellement spécifiés à l'aide du langage de requête avancé.
## Je ne vois pas ce que je recherche dans mon projet ou mon espace
**Problème :** les résultats ne s'affichent pas lorsque j'essaie de rechercher des informations spécifiques.
**Correctifs possibles :** les mises à jour du contenu peuvent prendre quelques secondes pour s'afficher dans les résultats de recherche. Les mises à jour importantes peuvent prendre plusieurs minutes.
Pour les ressources qui n'ont pas été mises à jour récemment, vous devrez peut-être affiner votre recherche. Vous pouvez affiner en ajoutant d'autres mots clés ou en utilisant le langage de requête avancé. Pour plus d'informations sur l'affinement de vos requêtes, consultez[Affiner votre requête de recherche](search.md#search-query-language-examples).
## Le nombre de résultats de recherche ne cesse de changer lorsque je navigue dans les pages
**Problème :** le nombre de résultats de recherche semble changer lorsque je passe à la page suivante. Le nombre total de résultats n'est donc pas clair.
**Corrections possibles :** Lorsque vous naviguez dans les pages des résultats de recherche, vous pouvez constater une modification du nombre de résultats de recherche correspondant à votre requête. Le nombre de résultats peut être mis à jour pour refléter un nombre plus précis de correspondances découvertes lorsque vous naviguez dans les pages.
Lorsque vous parcourez les résultats, le message suivant peut s'afficher : **Aucun résultat pour « test »**. Vous recevrez le message si vous n'avez pas accès aux résultats restants.
## Ma requête de recherche n'est pas terminée
**Problème :** les résultats de ma recherche ne s'affichent pas et cela semble prendre trop de temps.
**Corrections possibles :** il est possible que votre recherche ne soit pas terminée lorsque plusieurs recherches sont effectuées simultanément dans l'espace, soit par programmation, soit en raison d'une forte activité de l'équipe. Si vous effectuez des recherches programmatiques, mettez-les en pause ou diminuez-les. Sinon, réessayez dans quelques secondes.
# Résolution des problèmes liés aux extensions
Consultez les sections suivantes pour résoudre les problèmes liés aux extensions dans CodeCatalyst. Pour plus d’informations sur les extensions, consultez [Ajoutez des fonctionnalités aux projets avec des extensions dans CodeCatalystAjoutez des fonctionnalités aux projets avec des extensions](extensions.md).
**Topics**
+ [Je ne peux pas voir les modifications apportées aux référentiels tiers liés ni rechercher les résultats de ces modifications](#troubleshooting-detect-3p-changes)
## Je ne peux pas voir les modifications apportées aux référentiels tiers liés ni rechercher les résultats de ces modifications
**Problème :** Les modifications apportées à mon dépôt tiers n'apparaissent pas dans. CodeCatalyst
**Correctifs possibles :** CodeCatalyst actuellement, il n'est pas possible de détecter les modifications dans la branche par défaut pour les référentiels liés. Pour modifier la branche par défaut d'un dépôt lié, vous devez d'abord en dissocier CodeCatalyst, modifier la branche par défaut, puis la lier à nouveau. Pour de plus amples informations, veuillez consulter [Lier GitHub les référentiels, les référentiels Bitbucket, les référentiels de GitLab projets et les projets Jira dans CodeCatalyst](extensions-link.md).
# Résolution des problèmes liés aux comptes associés à votre espace
Dans CodeCatalyst, vous pouvez ajouter un Compte AWS à votre espace pour accorder des autorisations aux ressources et à des fins de facturation. Les informations suivantes peuvent vous aider à résoudre les problèmes courants liés aux comptes associés dans CodeCatalyst.
**Topics**
+ [Ma demande Compte AWS de connexion reçoit une erreur de jeton non valide](#troubleshooting-connection-token)
+ [CodeCatalyst Le flux de travail de mon projet Amazon échoue avec une erreur concernant le compte, l'environnement ou le rôle IAM configuré](#connections-troubleshoot-workflow)
+ [J'ai besoin d'un compte, d'un rôle et d'un environnement associés pour créer un projet](#connections-troubleshoot-environment)
+ [Je ne parviens pas à accéder à la page Amazon CodeCatalyst Spaces dans le AWS Management Console](#connections-troubleshoot-console)
+ [Je veux un autre compte comme compte de facturation](#connections-troubleshoot-billing)
+ [Le flux de travail de mon projet échoue en raison d'une erreur de nom de connexion](#connections-troubleshoot-restriction)
## Ma demande Compte AWS de connexion reçoit une erreur de jeton non valide
**Problème :** lors de la création d'une demande de connexion avec un jeton de connexion, la page n'accepte pas le jeton et affiche une erreur indiquant que le jeton n'est pas valide.
**Corrections possibles :** Assurez-vous de fournir l'identifiant de compte que vous souhaitez ajouter à votre espace. Vous devez disposer d'autorisations administratives pour votre compte Compte AWS ou être en mesure de travailler avec votre administrateur pour l'ajouter.
Lorsque vous choisissez de vérifier le compte, une nouvelle fenêtre de navigateur s'ouvre dans le AWS Management Console. Le même compte doit être connecté côté console. Réessayez après avoir vérifié les points suivants :
+ Vous êtes connecté AWS Management Console avec le même Compte AWS que celui que vous souhaitez ajouter à votre espace.
+ Vous êtes connecté au AWS Management Console avec la région définie sur la bonne région pour votre espace.
+ Si vous êtes arrivé depuis la page de facturation et Compte AWS que vous souhaitez ajouter le compte de facturation spécifié pour votre espace, assurez-vous que le compte n'a pas atteint le quota en tant que compte de facturation pour un ou plusieurs autres espaces.
## CodeCatalyst Le flux de travail de mon projet Amazon échoue avec une erreur concernant le compte, l'environnement ou le rôle IAM configuré
**Problème :** lorsque le flux de travail s'exécute et ne trouve aucun compte configuré ou aucun rôle IAM associé à votre espace, vous devez remplir les champs rôle, connexion et environnement manuellement dans le flux de travail YAML. Consultez l'action de flux de travail qui a échoué et notez si les messages d'erreur sont les suivants :
+ Le rôle n'est pas disponible pour être utilisé avec la connexion associée à l'environnement.
+ L'action n'a pas abouti. État : ÉCHEC ; la valeur fournie pour la connexion au compte ou l'environnement n'est pas valide. Vérifiez que la connexion est associée à votre espace et que l'environnement est associé à votre projet.
+ L'action n'a pas abouti. État : ÉCHEC ; la valeur fournie pour le rôle IAM n'est pas valide. Vérifiez que le nom existe, que le rôle IAM est ajouté à la connexion de votre compte et que la connexion est déjà associée à votre espace Amazon CodeCatalyst
**Corrections possibles :** assurez-vous que les champs YAML du flux de travail contiennent des valeurs précises pour [l'environnement](build-action-ref.md#build.environment), [les connexions](build-action-ref.md#build.environment.connections) et [le rôle](build-action-ref.md#build.environment.connections.role). Les actions CodeCatalyst de flux de travail qui nécessitent un environnement sont des actions de création ou de déploiement qui exécutent AWS des ressources ou qui génèrent des piles de AWS ressources.
Choisissez le bloc d'action du flux de travail qui a échoué, puis choisissez **Visual**. Cliquez sur l’onglet **Configuration**. Si les champs **Environnement**, **Nom de connexion** et **Nom du rôle** ne sont pas renseignés, vous devrez mettre à jour le flux de travail manuellement. Procédez comme suit pour modifier le code YAML de votre flux de travail :
+ Développez le `/.codecatalyst` répertoire, puis `/workflows` développez-le. Ouvrez le fichier YAML du flux de travail. Assurez-vous que les rôles IAM et les informations de compte sont spécifiés dans le code YAML que vous avez configuré pour votre flux de travail. Exemple :
```
Actions:
cdk_bootstrap:
Identifier: action-@v1
Inputs:
Sources:
- WorkflowSource
Environment:
Name: Staging
Connections:
- Name: account-connection
Role: build-role
```
Les propriétés **Environment, Connection et Role** sont requises pour exécuter des actions de création et de déploiement de CodeCatalyst flux de travail avec AWS des ressources. Pour un exemple, consultez les paramètres YAML de référence de l'action de CodeCatalyst construction pour [l'environnement](build-action-ref.md#build.environment), [les connexions](build-action-ref.md#build.environment.connections) et [le rôle](build-action-ref.md#build.environment.connections.role).
+ Assurez-vous qu'un compte a été ajouté à votre espace et que le ou les rôles IAM appropriés ont été ajoutés au compte. Vous pouvez ajuster ou ajouter des comptes si vous avez le rôle d'**administrateur de l'espace**. Pour de plus amples informations, veuillez consulter [Permettre l'accès aux AWS ressources avec Connected Comptes AWS](ipa-connect-account.md).
## J'ai besoin d'un compte, d'un rôle et d'un environnement associés pour créer un projet
**Problème :** Dans les options de création de projet, soit aucun compte supplémentaire n'est disponible dans mon espace pour mon projet, soit j'ai besoin qu'un autre compte soit ajouté à mon espace pour que mon projet puisse l'utiliser.
**Corrections possibles :** Pour votre espace, vous pouvez ajouter des personnes autorisées Comptes AWS à les ajouter à votre projet si vous avez le rôle d'**administrateur de l'espace**. Vous devez également disposer d'un Compte AWS endroit où vous disposez d'autorisations administratives ou pouvez travailler avec votre AWS administrateur.
Pour vous assurer qu'un compte et un rôle seront disponibles sur l'écran de création du projet, vous devez d'abord ajouter le compte et les rôles. Pour de plus amples informations, veuillez consulter [Permettre l'accès aux AWS ressources avec Connected Comptes AWS](ipa-connect-account.md).
Vous avez la possibilité de choisir de créer un rôle de service avec une politique de rôle appelée politique de **CodeCatalystWorkflowDevelopmentRole-*spaceName***rôle. Le rôle portera un nom `CodeCatalystWorkflowDevelopmentRole-spaceName` avec un identifiant unique ajouté. Pour plus d'informations sur le rôle et la politique de rôle, consultez[Comprendre le rôle **CodeCatalystWorkflowDevelopmentRole-*spaceName***du service](ipa-iam-roles.md#ipa-iam-roles-service-role). Pour connaître les étapes de création du rôle, consultez[Création du **CodeCatalystWorkflowDevelopmentRole-*spaceName***rôle pour votre compte et votre espace](ipa-iam-roles.md#ipa-iam-roles-service-create). Le rôle est ajouté à votre compte et disponible sur les pages de création de projets de CodeCatalyst.
## Je ne parviens pas à accéder à la page Amazon CodeCatalyst Spaces dans le AWS Management Console
**Problème :** Lorsque j'essaie d'accéder à la CodeCatalyst page Amazon AWS Management Console pour ajouter un compte à mon CodeCatalyst espace ou ajouter des rôles à un compte dans AWS, je reçois une erreur d'autorisation.
**Correctifs possibles :**
Pour votre espace, vous pouvez ajouter des personnes autorisées Comptes AWS à les ajouter à votre projet si vous avez le rôle d'**administrateur de l'espace**. Vous devez également disposer d'un Compte AWS endroit où vous disposez d'autorisations administratives ou pouvez travailler avec votre AWS administrateur. Vous devez d'abord vous assurer que vous êtes connecté AWS Management Console au même compte que celui que vous souhaitez gérer. Une fois connecté au AWS Management Console, vous pouvez ouvrir la console et réessayer.
Ouvrir la CodeCatalyst page Amazon dans la page AWS Management Console d'[https://us-west-2.console.aws.amazon.com/codecatalyst/accueil ? region=us-ouest-2\$1/](https://us-west-2.console.aws.amazon.com/codecatalyst/home?region=us-west-2#/).
## Je veux un autre compte comme compte de facturation
**Problème :** Lorsque j'ai configuré mon CodeCatalyst identifiant, j'ai effectué plusieurs étapes pour configurer mon espace et associer un utilisateur autorisé Compte AWS. Maintenant, je souhaite autoriser un autre compte pour la facturation.
**Corrections possibles :** Pour votre espace, vous pouvez autoriser les comptes de facturation si vous avez le rôle d'**administrateur de l'espace**. Vous devez également disposer d'un Compte AWS endroit où vous disposez d'autorisations administratives ou pouvez travailler avec votre AWS administrateur.
Pour plus d'informations, consultez [la section Gestion de la facturation](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing.html) dans le manuel Amazon CodeCatalyst Administrator Guide.
## Le flux de travail de mon projet échoue en raison d'une erreur de nom de connexion
**Problème :** lors de la création d'un projet puis de l'exécution du flux de travail du projet, celui-ci échoue et affiche une erreur indiquant que le nom de connexion n'est pas valide, comme suit :
Échec survenu à : le nom de connexion n'est pas valide.
**Corrections possibles :** assurez-vous de fournir l'identifiant de compte que vous souhaitez ajouter à votre espace, et assurez-vous que le compte n'est pas activé pour les connexions à des comptes restreints au projet. Si le compte est activé pour les connexions aux comptes restreints au projet, vous devrez peut-être mettre à jour la connexion au compte en autorisant l'accès au nouveau projet. Pour plus d'informations, consultez la section [Configuration des connexions aux comptes restreints au projet](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts.html#managing-accounts-restriction).
# Résolution des problèmes entre Amazon CodeCatalyst et le AWS SDKs ou le AWS CLI
Les informations suivantes peuvent vous aider à résoudre les problèmes courants liés à CodeCatalyst l'utilisation du AWS CLI ou du AWS SDKs.
**Topics**
+ [Je reçois un message d'erreur lorsque j'entre **aws codecatalyst** sur une ligne de commande ou un terminal indiquant que le choix n'est pas valide](#cli-sdk-troubleshoot-no-commands)
+ [Je reçois une erreur d'identification lorsque j'exécute **aws codecatalyst** des commandes](#cli-sdk-troubleshoot-profile)
## Je reçois un message d'erreur lorsque j'entre **aws codecatalyst** sur une ligne de commande ou un terminal indiquant que le choix n'est pas valide
**Problème :** Lorsque j'essaie d'utiliser le AWS CLI with CodeCatalyst, une ou plusieurs **aws codecatalyst** commandes ne sont pas reconnues comme valides.
**Solution :** La cause la plus courante de ce problème est que vous utilisez une version du AWS CLI qui ne contient pas les mises à jour les plus récentes pour les derniers services et commandes. Mettez à jour votre installation du, AWS CLI puis réessayez. Pour plus d'informations, voir [Configuration pour utiliser le AWS CLI avec CodeCatalyst](set-up-cli.md).
## Je reçois une erreur d'identification lorsque j'exécute **aws codecatalyst** des commandes
**Problème :** Lorsque j'essaie d'utiliser le AWS CLI with CodeCatalyst, je reçois un message indiquant `You can configure credentials by running "aws configure".` ou`Unable to locate authorization token`.
**Solution :** Vous devez configurer un AWS CLI profil pour fonctionner avec CodeCatalyst les commandes. Pour plus d'informations, voir [Configuration pour utiliser le AWS CLI avec CodeCatalyst](set-up-cli.md).