

Amazon CodeCatalyst ist nicht mehr offen für Neukunden. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter [Wie migriert man von CodeCatalyst](migration.md).

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Problembehebung bei Amazon CodeCatalyst
<a name="troubleshooting"></a>

Die folgenden Informationen können Ihnen helfen, häufig auftretende Probleme in zu beheben CodeCatalyst. Sie können auch den CodeCatalyst Amazon-Gesundheitsbericht verwenden, um festzustellen, ob es Serviceprobleme gibt, die sich auf Ihre Erfahrung auswirken könnten.

**Topics**
+ [Behebung allgemeiner Zugriffsprobleme](#troubleshooting-general)
+ [Behebung von Support-Problemen](#troubleshoot-support)
+ [Amazon CodeCatalyst ist teilweise oder vollständig nicht verfügbar](#service-unavailable)
+ [Ich kann kein Projekt erstellen in CodeCatalyst](#troubleshoot-create-project)
+ [Ich kann als neuer Benutzer nicht auf meinen BID-Bereich zugreifen oder kann aufgrund eines verkürzten Benutzernamens nicht als neuer SSO-Benutzer hinzugefügt werden](#troubleshoot-username-truncated)
+ [Durch das Hinzufügen eines SSO-Benutzers zu meinem Verbundbereich als neuer Benutzer wurde ein doppelter Benutzer erstellt](#troubleshoot-username-duplicated-SSO)
+ [Ich möchte Feedback einreichen in CodeCatalyst](#troubleshoot-create-feedback)
+ [Behebung von Problemen mit Quell-Repositorys](troubleshooting-source.md)
+ [Problembehebung bei Projekten und Blueprints](projects-troubleshooting.md)
+ [Behebung von Problemen mit Entwicklungsumgebungen](devenvironments-troubleshooting.md)
+ [Behebung von Problemen mit Workflows](troubleshooting-workflows.md)
+ [Behebung von Problemen mit Problemen](troubleshooting-issues.md)
+ [Behebung von Problemen mit der Suche in CodeCatalyst](troubleshooting-search.md)
+ [Behebung von Problemen mit Erweiterungen](troubleshooting-extensions.md)
+ [Behebung von Problemen mit Konten, die mit deinem Bereich verknüpft sind](troubleshooting-connections.md)
+ [Behebung von Problemen zwischen Amazon CodeCatalyst und dem AWS SDKs oder dem AWS CLI](troubleshooting-cli-sdk.md)

## Behebung allgemeiner Zugriffsprobleme
<a name="troubleshooting-general"></a>

### Ich habe mein Passwort vergessen
<a name="id-forgot-password"></a>

**Problem:** Ich habe das Passwort vergessen, das ich für meine AWS Builder-ID und Amazon verwende CodeCatalyst.

**Mögliche Lösungen:** Dieses Problem lässt sich am einfachsten beheben, indem Sie Ihr Passwort zurücksetzen.

1. Öffnen Sie [Amazon CodeCatalyst](https://codecatalyst.aws/) und geben Sie Ihre **E-Mail-Adresse** ein. Klicken Sie nun auf **Continue** (Weiter).

1. Wählen Sie **Passwort vergessen?**

1. Wir senden Ihnen eine E-Mail mit einem Link, über den Sie Ihr Passwort ändern können. Wenn Sie die E-Mail nicht in Ihrem Posteingang sehen, überprüfen Sie Ihren Spam-Ordner.

### Amazon CodeCatalyst ist teilweise oder vollständig nicht verfügbar
<a name="service-unavailable"></a>

**Problem:** Ich habe zur CodeCatalyst Konsole navigiert oder bin einem Link gefolgt, aber es wird ein Fehler angezeigt.

**Mögliche Lösungen:** Die häufigsten Gründe für dieses Problem sind, dass Sie entweder einem Link zu einem Projekt oder einem Bereich gefolgt sind, zu dem Sie nicht eingeladen wurden, oder dass ein Problem mit der allgemeinen Verfügbarkeit des Dienstes vorliegt. Prüfen Sie im [Gesundheitsbericht](health-dashboard.md), ob es bekannte Probleme mit dem Dienst gibt. Falls nicht, kontaktiere die Person, die dich zu dem Projekt oder Space eingeladen hat, und bitte um eine weitere Einladung. Wenn du zu keinem Projekt oder [Space eingeladen wurdest, kannst du dich registrieren und deinen eigenen Bereich und deine eigenen Projekte erstellen](sign-up-create-resources.md).

### Ich kann kein Projekt erstellen in CodeCatalyst
<a name="troubleshoot-create-project"></a>

**Problem:** Ich möchte ein Projekt erstellen, aber die Schaltfläche **Projekt erstellen** wird als nicht verfügbar angezeigt, oder ich erhalte eine Fehlermeldung.

**Mögliche Lösungen:** Die häufigsten Gründe für dieses Problem sind, dass Sie bei der Konsole mit einer AWS Builder-ID angemeldet sind, die nicht über die **Space-Administratorrolle** verfügt. Sie benötigen diese Rolle, um Projekte in einem Space erstellen zu können.

Wenn Sie über diese Rolle verfügen und die Schaltfläche nicht als verfügbar angezeigt wird, liegt möglicherweise ein vorübergehendes Problem mit dem Dienst vor. Aktualisieren Sie Ihren Browser und versuchen Sie es erneut.

## Behebung von Support-Problemen
<a name="troubleshoot-support"></a>

### Ich erhalte eine Fehlermeldung, wenn ich auf Amazon Support zugreife CodeCatalyst
<a name="troubleshoot-support-rolepolicy"></a>

**Problem:** Wenn ich die CodeCatalyst Option Support für Amazon wähle, erhalte ich die folgende Fehlermeldung:

**`Unable to assume role`**

`To access support cases, you must add the role AWSRoleForCodeCatalystSupport to the AWS-Konto that is the billing account for the space.`

**Mögliche Lösungen:** Fügen Sie die erforderliche Rolle dem AWS-Konto Rechnungskonto für den Bereich hinzu. Das als Rechnungskonto für den Bereich angegebene Konto verwendet die `AWSRoleForCodeCatalystSupport` Rolle und die `AmazonCodeCatalystSupportAccess` verwaltete Richtlinie. Weitere Informationen finden Sie unter [Die **AWSRoleForCodeCatalystSupport**Rolle für Ihr Konto und Ihren Bereich erstellen](ipa-iam-roles.md#ipa-iam-roles-support-create).

**Anmerkung**  
Eine AWS Builder-ID kann nur Unterstützung für den Alias erhalten, mit dem sie authentifiziert wurde, und nur für Ressourcen, die auf den entsprechenden Berechtigungen basieren. CodeCatalyst Support für Konten und Abrechnung ist für alle Benutzer in diesem Bereich verfügbar. Entwickler können jedoch nur Unterstützung für Ressourcen und Informationen erhalten, für die sie über entsprechende Berechtigungen verfügen CodeCatalyst.

### Ich kann keine Anfragen für technischen Support für meine Unterkunft erstellen
<a name="troubleshoot-support-technical-cases"></a>

**Problem:** Ich kann keine Anfragen für technischen Support für meine Unterkunft erstellen.

**Korrekturen:** Dem Space-Abrechnungskonto muss ein Business Support- oder Enterprise Support-Plan hinzugefügt werden, damit Benutzer im Space Anfragen für technischen Support erstellen können. Bitten Sie Ihren Space-Administrator, Ihrem Space-Abrechnungskonto einen Support Tarif hinzuzufügen, oder besuchen Sie https://repost.aws/, um die AWS Community zu fragen.

### Mein Konto für Supportanfragen ist nicht mehr mit meinem Bereich in verbunden CodeCatalyst
<a name="troubleshoot-support-disconnected-account"></a>

**Problem:** Mein Konto für Supportanfragen ist nicht mehr mit meinem Bereich in verbunden CodeCatalyst.

**Behebung:** Wenn ein Benutzer mit der Rolle „**Space-Administrator**“ das Space-Abrechnungskonto wechselt, werden dadurch der Support Tarif und alle zugehörigen Fälle vom Space getrennt. Die mit dem alten Space-Abrechnungskonto verknüpften Support Fälle sind in Support Amazon nicht mehr sichtbar CodeCatalyst. Der Root-Benutzer für dieses Rechnungskonto kann alte Fälle über anzeigen und lösen AWS-Managementkonsole und IAM-Berechtigungen einrichten, damit andere Benutzer alte Fälle einsehen und lösen können. Support Sie können über das nicht mehr technischen Support für CodeCatalyst das alte Space-Abrechnungskonto in Anspruch nehmen AWS-Managementkonsole, aber Sie können technischen Support für andere Dienste erhalten, bis Ihr Support Plan gekündigt wird.

Weitere Informationen finden Sie im *Support Benutzerhandbuch* unter [Aktualisierung, Lösung und erneutes Öffnen Ihres Falls](https://docs.aws.amazon.com//awssupport/latest/user/monitoring-your-case.html).

### Ich kann keinen Support-Fall für ein anderes AWS-Service in Support for Amazon eröffnen CodeCatalyst
<a name="troubleshoot-support-other-services"></a>

**Problem:** Ich kann keinen Support-Fall für ein anderes AWS-Service Mitglied Support eröffnen CodeCatalyst.

**Mögliche Lösungen:** Sie können CodeCatalyst Supportanfragen nur von Support für aus öffnen CodeCatalyst. Wenn Sie Support für Dienste oder Ressourcen benötigen, die von CodeCatalyst einem anderen Service AWS, Amazon oder einem anderen Drittanbieter bereitgestellt werden, müssen Sie einen Fall über den AWS-Managementkonsole oder den Service-Support-Kanal eines Drittanbieters erstellen. Weitere Informationen finden Sie im *Support Benutzerhandbuch* unter [Erstellen von Supportanfragen und Fallmanagement](https://docs.aws.amazon.com//awssupport/latest/user/case-management.html). 

## Amazon CodeCatalyst ist teilweise oder vollständig nicht verfügbar
<a name="service-unavailable"></a>

**Problem:** Ich habe zur CodeCatalyst Konsole navigiert oder bin einem Link gefolgt, aber es wird ein Fehler angezeigt.

**Mögliche Lösungen:** Die häufigsten Gründe für dieses Problem sind, dass Sie entweder einem Link zu einem Projekt oder einem Bereich gefolgt sind, zu dem Sie nicht eingeladen wurden, oder dass ein Problem mit der allgemeinen Verfügbarkeit des Dienstes vorliegt. Prüfen Sie im [Gesundheitsbericht](health-dashboard.md), ob es bekannte Probleme mit dem Dienst gibt. Falls nicht, kontaktiere die Person, die dich zu dem Projekt oder Space eingeladen hat, und bitte um eine weitere Einladung. Wenn du zu keinem Projekt oder [Space eingeladen wurdest, kannst du dich registrieren und deinen eigenen Bereich und deine eigenen Projekte erstellen](sign-up-create-resources.md).

## Ich kann kein Projekt erstellen in CodeCatalyst
<a name="troubleshoot-create-project"></a>

**Problem:** Ich möchte ein Projekt erstellen, aber die Schaltfläche **Projekt erstellen** wird als nicht verfügbar angezeigt, oder ich erhalte eine Fehlermeldung.

**Mögliche Lösungen:** Die häufigsten Gründe für dieses Problem sind, dass Sie bei der Konsole mit einer AWS Builder-ID angemeldet sind, die nicht über die **Space-Administratorrolle** verfügt. Sie benötigen diese Rolle, um Projekte in einem Space erstellen zu können.

Wenn Sie über diese Rolle verfügen und die Schaltfläche nicht als verfügbar angezeigt wird, liegt möglicherweise ein vorübergehendes Problem mit dem Dienst vor. Aktualisieren Sie Ihren Browser und versuchen Sie es erneut.

## Ich kann als neuer Benutzer nicht auf meinen BID-Bereich zugreifen oder kann aufgrund eines verkürzten Benutzernamens nicht als neuer SSO-Benutzer hinzugefügt werden
<a name="troubleshoot-username-truncated"></a>

**Problem:** CodeCatalyst Kürzt Benutzernamen nach 100 Zeichen ab, was dazu führen kann, dass einige Benutzernamen identisch erscheinen. Als neuer Benutzer, der auf einen CodeCatalyst Bereich zugreift, tritt dieses Problem je nach Art des Bereichs wie folgt auf:
+ Ich habe eine AWS Builder-ID, mit der ich mich anmelden möchte CodeCatalyst. Wenn ich versuche, mich bei dem Space anzumelden, erhalte ich eine Meldung, dass mein Benutzername nicht gültig ist.
+ Ich bin Administrator für föderierte Identitäten für einen CodeCatalyst Bereich, der Identitätsverbund unterstützt. Wenn ich einen neuen Benutzer zu SSO-Benutzern und -Gruppen in IAM Identity Center hinzufüge, erhalte ich die Meldung, dass der Benutzer ungültig ist.

**Mögliche Lösungen:** Der erste Benutzer, der sich als SSO-Benutzer mit einem bestimmten verkürzten Benutzernamen anmeldet CodeCatalyst oder dem Bereich hinzugefügt wird, wird erfolgreich sein. Alle Benutzer, die sich mit einer AWS Builder-ID registrieren oder danach zum IAM Identity Center hinzugefügt werden, können sich nicht anmelden, da es sich bei dem Namen um ein Duplikat zu handeln scheint. Führen Sie je nach Art des Speicherplatzes einen der folgenden Schritte aus:
+ Um sich im AWS Builder-ID-Bereich anmelden zu können, melden Sie sich mit einem anderen Benutzernamen an.
+ Um den neuen Benutzer in IAM Identity Center hinzufügen zu können, fügen Sie den Benutzer mit einem anderen Benutzernamen hinzu.

**Anmerkung**  
Auch wenn der Benutzername gekürzt zu sein scheint, wird er der CodeCatalyst Identität auf eine Weise zugeordnet, die nicht durch Benutzernamen mit gekürzten Namen beeinträchtigt wird. Wenn jedoch ein Benutzername erstellt wird, der mit einem gekürzten Benutzernamen identisch ist, ist dieser Benutzername nicht verfügbar, wenn ein anderer Benutzer (mit demselben Space oder derselben IAM Identity Center-Anwendung) bereits eine Verbindung CodeCatalyst mit diesem verkürzten Benutzernamen hergestellt hat.

## Durch das Hinzufügen eines SSO-Benutzers zu meinem Verbundbereich als neuer Benutzer wurde ein doppelter Benutzer erstellt
<a name="troubleshoot-username-duplicated-SSO"></a>

**Problem:** CodeCatalyst SSO-Benutzer, die zu einem CodeCatalyst Bereich hinzugefügt und dann entfernt wurden, kann ein Problem auftreten, bei dem versucht wird, den Benutzernamen wiederzuverwenden. Dies kann zu einem Fehler ähnlich dem folgenden führen, bei dem der Benutzer nicht dupliziert werden darf, obwohl er neu erstellt wurde. 

**`Unable to assume role`**

`To access support cases, you must add the role AWSRoleForCodeCatalystSupport to the AWS-Konto that is the billing account for the space.`

**Mögliche Lösungen:** Wenn ein vorhandener IDC-Benutzer gelöscht wird und anschließend ein neuer Benutzer mit demselben Benutzernamen neu erstellt wird, kann sich der neue Benutzer nicht anmelden, da der Benutzername mit dem alten Benutzer in Konflikt steht. Nachdem ein Benutzername als SSO-Benutzer zu einem Bereich hinzugefügt wurde, kann der Name nicht erneut verwendet werden. Alle Benutzer, die sich mit einer AWS Builder-ID registrieren oder danach im IAM Identity Center hinzugefügt werden, können sich nicht anmelden, da der Name so aussieht, als ob es sich um ein Duplikat handelt. 

Führen Sie je nach Art des Speicherplatzes einen der folgenden Schritte aus:
+ Um sich im AWS Builder-ID-Bereich anmelden zu können, melden Sie sich mit einem anderen Benutzernamen an.
+ Um den neuen Benutzer in IAM Identity Center hinzufügen zu können, fügen Sie den Benutzer mit einem anderen Benutzernamen hinzu.

## Ich möchte Feedback einreichen in CodeCatalyst
<a name="troubleshoot-create-feedback"></a>

**Problem:** Ich habe einen Fehler in gefunden CodeCatalyst und möchte Feedback einreichen.

**Mögliche Lösungen:** Sie können Feedback direkt in einreichen CodeCatalyst.

1. Öffnen Sie die CodeCatalyst Konsole unter [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Wählen Sie im Navigationsbereich **Feedback geben** aus.

1. Wählen Sie die Art des Feedbacks aus dem Drop-down-Menü aus und geben Sie Ihr Feedback ein.

# Behebung von Problemen mit Quell-Repositorys
<a name="troubleshooting-source"></a>

Die folgenden Informationen können Ihnen helfen, häufig auftretende Probleme mit Quell-Repositorys in zu beheben. CodeCatalyst

**Topics**
+ [Ich habe die maximale Speicherkapazität für meinen Speicherplatz erreicht und erhalte Warnungen oder Fehler](#source-troubleshoot-storage)
+ [Ich erhalte eine Fehlermeldung, wenn ich versuche, ein CodeCatalyst Amazon-Quell-Repository zu klonen oder zu pushen](#source-troubleshoot-clone)
+ [Ich erhalte eine Fehlermeldung, wenn ich versuche, einen Commit oder einen Push in ein CodeCatalyst Amazon-Quell-Repository durchzuführen](#source-troubleshoot-commit-code)
+ [Ich benötige ein Quell-Repository für mein Projekt](#source-troubleshoot-need-repository)
+ [Mein Quell-Repository ist brandneu, enthält aber einen Commit](#source-troubleshoot-initial-commit)
+ [Ich möchte einen anderen Zweig als meinen Standardzweig](#source-troubleshoot-default-branch)
+ [Ich erhalte E-Mails über Aktivitäten in Pull-Requests](#source-troubleshoot-repository-emails)
+ [Ich habe mein persönliches Zugriffstoken (PAT) vergessen](#source-troubleshoot-forgot-pat)
+ [Eine Pull-Anfrage zeigt nicht die Änderungen an, die ich erwarte](#source-troubleshoot-pull-request-diff)
+ [Ein Pull-Request zeigt den Status Nicht zusammenführbar](#source-troubleshoot-pull-request-not-mergeable)

## Ich habe die maximale Speicherkapazität für meinen Speicherplatz erreicht und erhalte Warnungen oder Fehler
<a name="source-troubleshoot-storage"></a>

**Problem:** Ich möchte Code in ein oder mehrere Quell-Repositorys übertragen CodeCatalyst, aber es wird ein Fehler angezeigt. In der Konsole wird auf der Quell-Repository-Seite eine Meldung angezeigt, dass ich das Speicherlimit für den Speicherplatz erreicht habe. 

**Mögliche Lösungen:** Abhängig von Ihrer Rolle im Projekt oder Space können Sie entweder die Größe eines oder mehrerer Ihrer Quell-Repositorys reduzieren, ungenutzte Quell-Repositorys löschen oder Ihre Abrechnungsstufe auf eine Stufe mit mehr Speicherplatz ändern.
+ Um die Größe eines Quell-Repositorys in einem Projekt zu reduzieren, können Sie ungenutzte Branches löschen. Weitere Informationen erhalten Sie unter [Löschen eines Zweigs](source-branches-delete.md) und [Rolle „Mitwirkender“](ipa-role-types.md#ipa-role-contributor).
+ Um den Gesamtspeicher für einen Bereich zu reduzieren, können Sie ungenutzte Quell-Repositorys löschen. Weitere Informationen erhalten Sie unter [Löschen eines Quell-Repositorys](source-repositories-delete.md) und [Die Rolle des Projektadministrators](ipa-role-types.md#ipa-role-project-admin).
+ Um den für Ihren Speicherplatz verfügbaren Speicherplatz zu erhöhen, können Sie Ihre Abrechnungsstufe auf eine Stufe mit mehr Speicherplatz ändern. Weitere Informationen finden Sie unter [Ändern Ihrer CodeCatalyst Abrechnungsstufe](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing-change-plan.html) im CodeCatalyst Amazon-Administratorhandbuch.

## Ich erhalte eine Fehlermeldung, wenn ich versuche, ein CodeCatalyst Amazon-Quell-Repository zu klonen oder zu pushen
<a name="source-troubleshoot-clone"></a>

**Problem:** Wenn ich versuche, ein Quell-Repository auf einen lokalen Computer oder in eine integrierte Entwicklungsumgebung (IDE) zu klonen, erhalte ich einen Berechtigungsfehler.

**Mögliche Lösungen:** Möglicherweise haben Sie kein Personal Access Token (PAT) für Ihre AWS Builder-ID, Sie haben Ihr Anmeldeinformationsverwaltungssystem möglicherweise nicht mit Ihrem PAT konfiguriert, oder Ihr PAT ist möglicherweise abgelaufen. Probieren Sie eine oder mehrere der folgenden Lösungen aus:
+ Erstellen Sie ein persönliches Zugriffstoken (PAT). Weitere Informationen finden Sie unter [Gewähren Sie Benutzern Repository-Zugriff mit persönlichen Zugriffstoken](ipa-tokens-keys.md).
+ Stellen Sie sicher, dass Sie eine Einladung zu dem Projekt angenommen haben, das das Quell-Repository enthält, und dass Sie immer noch Mitglied dieses Projekts sind. Sie können ein Quell-Repository nicht klonen, wenn Sie kein aktives Mitglied dieses Projekts sind. Melden Sie sich bei der Konsole an und versuchen Sie, zu dem Bereich und dem Projekt zu navigieren, in dem Sie ein Quell-Repository klonen möchten. Wenn Sie das Projekt nicht in der Projektliste für den Bereich sehen können, sind Sie entweder kein Mitglied dieses Projekts oder Sie haben eine Einladung zu diesem Projekt nicht angenommen. Weitere Informationen finden Sie unter [Eine Einladung annehmen und eine AWS Builder-ID erstellen](sign-up-sign-in.md).
+ Vergewissern Sie sich, dass Ihr Clone-Befehl korrekt formatiert ist und Ihre AWS Builder-ID enthält. Beispiel:

  ```
  https://LiJuan@git.us-west-2.codecatalyst.aws/v1/ExampleCorp/MyExampleProject/MyExampleRepo
  ```
+ Verwenden Sie den, AWS CLI um sicherzustellen, dass Ihrer AWS Builder-ID eine PAT zugeordnet ist und dass diese nicht abgelaufen ist. Wenn Sie noch keine haben oder die PAT abgelaufen ist, erstellen Sie eine. Weitere Informationen finden Sie unter [Gewähren Sie Benutzern Repository-Zugriff mit persönlichen Zugriffstoken](ipa-tokens-keys.md).
+ Versuchen Sie, eine Entwicklungsumgebung zu erstellen, um mit dem Code im Quell-Repository zu arbeiten, anstatt ihn in ein lokales Repo oder eine IDE zu klonen. Weitere Informationen finden Sie unter [Erstellen einer Entwicklungsumgebung](devenvironment-create.md).

## Ich erhalte eine Fehlermeldung, wenn ich versuche, einen Commit oder einen Push in ein CodeCatalyst Amazon-Quell-Repository durchzuführen
<a name="source-troubleshoot-commit-code"></a>

**Problem:** Wenn ich versuche, in ein Quell-Repository zu pushen, erhalte ich einen Berechtigungsfehler.

**Mögliche Lösungen:** Möglicherweise haben Sie keine Rolle in dem Projekt, die es Ihnen ermöglicht, Codeänderungen an das Projekt zu übertragen und per Push zu übertragen. Sehen Sie sich Ihre Rolle in dem Projekt an, in dem Sie versuchen, Änderungen in ein Quell-Repository zu übertragen. Weitere Informationen erhalten Sie unter [Eine Liste der Mitglieder und ihrer Projektrollen abrufen](projects-members.md#projects-members-view) und [Zugriff mit Benutzerrollen gewähren](ipa-roles.md). 

Wenn Sie über eine Rolle verfügen, die das Commit und das Pushen von Änderungen ermöglicht, ist für den Branch, in dem Sie versuchen, Änderungen zu übernehmen, möglicherweise eine Branch-Regel konfiguriert, die Sie daran hindert, Codeänderungen in diesen Branch zu übertragen. Versuchen Sie stattdessen, einen Branch zu erstellen und Ihren Code in diesen Branch zu übertragen. Weitere Informationen finden Sie unter [Zulässige Aktionen für einen Branch mit Branch-Regeln verwalten](source-branches-branch-rules.md).

## Ich benötige ein Quell-Repository für mein Projekt
<a name="source-troubleshoot-need-repository"></a>

**Problem:** Mein Projekt hat entweder kein Quell-Repository oder ich benötige ein anderes Quell-Repository für mein Projekt.

**Mögliche Lösungen:** Einige Projekte werden ohne Ressourcen erstellt. Wenn Sie Mitglied des Projekts sind, können Sie Quell-Repositorys für dieses Projekt in CodeCatalyst erstellen. Wenn jemand mit der **Space-Administratorrolle** die **GitHub Repositorys** installiert und sie mit einem GitHub Konto verbindet, können Sie eine Verknüpfung zu verfügbaren GitHub Repositorys herstellen, um sie Ihrem Projekt hinzuzufügen, sofern Sie die **Projektadministratorrolle** haben. Weitere Informationen finden Sie unter [Erstellen eines Quell-Repositorys und [Verknüpfen eines Quell-Repositorys](source-repositories-link.md)](source-repositories-create.md).

## Mein Quell-Repository ist brandneu, enthält aber einen Commit
<a name="source-troubleshoot-initial-commit"></a>

**Problem:** Ich habe gerade ein Quell-Repository erstellt. Es sollte leer sein, aber es enthält einen Commit, einen Branch und eine `README.md` Datei.

**Mögliche Korrekturen:** Dies ist das erwartete Verhalten. Alle Quell-Repositorys CodeCatalyst enthalten einen ersten Commit, der den Standard-Branch auf setzt `main` und entweder Beispielcode (falls das Repository für ein Projekt mit einem Blueprint erstellt wurde, der Beispielcode enthielt) oder eine Markdown-Template-Datei für eine Readme-Datei des Repositorys enthält. Sie können zusätzliche Branches in der Konsole und in Git-Clients erstellen. Sie können Dateien in der Konsole erstellen und bearbeiten und Dateien in Entwicklungsumgebungen und Git-Clients löschen.

## Ich möchte einen anderen Zweig als meinen Standardzweig
<a name="source-troubleshoot-default-branch"></a>

**Problem:** Mein Quell-Repository hatte einen Standard-Branch mit dem Namen`main`, aber ich möchte einen anderen Branch als Standard-Branch.

**Mögliche Lösungen:** Sie können den Standard-Branch in den Quell-Repositorys in CodeCatalyst nicht ändern oder löschen. Sie können zusätzliche Branches erstellen und diese Branches in Quellaktionen in Workflows verwenden. Sie können sich auch dafür entscheiden, GitHub Repositorys zu verknüpfen und sie als Repositorys für Ihr Projekt zu verwenden.

## Ich erhalte E-Mails über Aktivitäten in Pull-Requests
<a name="source-troubleshoot-repository-emails"></a>

**Problem:** Ich habe mich nicht registriert oder E-Mail-Benachrichtigungen über Pull-Request-Aktivitäten konfiguriert, erhalte sie aber trotzdem.

**Mögliche Korrekturen:** E-Mail-Benachrichtigungen werden automatisch über Pull-Request-Aktivitäten gesendet. Weitere Informationen finden Sie unter [Code mit Pull-Requests in Amazon überprüfen CodeCatalyst](source-pull-requests.md).

## Ich habe mein persönliches Zugriffstoken (PAT) vergessen
<a name="source-troubleshoot-forgot-pat"></a>

**Problem:** Ich habe ein PAT zum Klonen, Übertragen und Abrufen von Code für Quell-Repositorys verwendet, aber ich habe den Wert für mein Token verloren und kann es in der CodeCatalyst Konsole nicht finden.

**Mögliche Lösungen:** Dieses Problem lässt sich am schnellsten lösen, indem Sie ein weiteres PAT erstellen und Ihren Credential Manager oder Ihre IDE so konfigurieren, dass dieses neue PAT verwendet wird. Wir zeigen den Wert einer PAT nur an, wenn Sie sie erstellen. Wenn Sie diesen Wert verlieren, kann er nicht abgerufen werden. Weitere Informationen finden Sie unter [Gewähren Sie Benutzern Repository-Zugriff mit persönlichen Zugriffstoken](ipa-tokens-keys.md).

## Eine Pull-Anfrage zeigt nicht die Änderungen an, die ich erwarte
<a name="source-troubleshoot-pull-request-diff"></a>

**Problem:** Ich habe eine Pull-Anfrage erstellt, sehe aber nicht die Änderungen, die ich erwarte, zwischen dem Quell- und dem Ziel-Branch.

**Mögliche Korrekturen:** Dies könnte durch eine Reihe von Problemen verursacht werden. Probieren Sie eine oder mehrere der folgenden Lösungen aus:
+ Möglicherweise überprüfen Sie die Änderungen zwischen älteren Versionen, oder Sie sehen sich möglicherweise nicht die neuesten Änderungen an. Aktualisieren Sie Ihren Browser und stellen Sie sicher, dass Sie den Vergleich zwischen den Versionen ausgewählt haben, den Sie sich ansehen möchten.
+ Nicht alle Änderungen in einer Pull-Anfrage können in der Konsole angezeigt werden. Sie können beispielsweise keine Git-Submodule in der Konsole anzeigen, sodass Sie auch keine Unterschiede in einem Submodul in einer Pull-Anfrage anzeigen können. Einige Unterschiede sind möglicherweise zu groß, um angezeigt zu werden. Weitere Informationen erhalten Sie unter [Kontingente für Quell-Repositorys in CodeCatalyst](source-quotas.md) und [Eine Datei ansehenDen Verlauf der Änderungen an einer Datei anzeigen](source-files-view.md).
+ In Pull-Requests werden die Unterschiede zwischen der Merge-Basis und der von Ihnen ausgewählten Revision angezeigt. Wenn du einen Pull Request erstellst, ist der Unterschied, der dir angezeigt wird, der Unterschied zwischen der Spitze des Quell-Branches und der Spitze des Ziel-Branches. Sobald der Pull Request erstellt wurde, besteht der angezeigte Unterschied zwischen der Revision und der zugehörigen Merge-Basis. Die Merge-Base ist der Commit, der bei der Erstellung der Revision die Spitze des Ziel-Branches war. Die Merge-Basis kann sich zwischen den Revisionen ändern. Weitere Informationen zu Unterschieden und Merge-Bases in Git finden Sie [git-merge-base](https://git-scm.com/docs/git-merge-base)in der Git-Dokumentation. 

## Ein Pull-Request zeigt den Status Nicht zusammenführbar
<a name="source-troubleshoot-pull-request-not-mergeable"></a>

**Problem:** Ich möchte eine Pull-Anfrage zusammenführen, aber ihr Status wird als **Nicht** zusammenführbar angezeigt.

**Mögliche Lösungen:** Dies kann durch ein oder mehrere Probleme verursacht werden:
+ Alle für deinen Pull Request erforderlichen Reviewer müssen einen Pull Request genehmigen, bevor er zusammengeführt werden kann. Sieh dir in der Liste der erforderlichen Prüfer alle Prüfer an, neben deren Namen ein Uhrsymbol angezeigt wird. Ein Uhrsymbol weist darauf hin, dass der Prüfer den Pull-Request nicht genehmigt hat.
**Anmerkung**  
Wenn ein erforderlicher Prüfer vor der Genehmigung des Pull Requests aus deinem Projekt entfernt wurde, kannst du den Pull Request nicht zusammenführen. Schließen Sie den Pull Request und erstellen Sie einen neuen Pull Request.
+ Möglicherweise besteht ein Mergekonflikt zwischen dem Quell-Branch und dem Ziel-Branch. CodeCatalyst unterstützt nicht alle möglichen Git-Merge-Strategien und -Optionen. Sie können die Branches in einer Entwicklungsumgebung auf Merge-Konflikte untersuchen oder das Repository klonen und mithilfe von IDE- oder Git-Tools Merge-Konflikte finden und lösen. Weitere Informationen finden Sie unter [Zusammenführen einer Pull-Anforderung](pull-requests-merge.md).

# Problembehebung bei Projekten und Blueprints
<a name="projects-troubleshooting"></a>

Dieser Abschnitt kann Ihnen helfen, einige häufig auftretende Probleme zu beheben, die bei der Arbeit mit Projekten und Blueprints in Amazon CodeCatalyst auftreten können.

# Java-API mit AWS Fargate Blueprint, fehlende Abhängigkeiten für Apache-Maven-3.8.6
<a name="projects-troubleshooting-error-maven"></a>

**Problem:** Bei einem Projekt, das über die Java-API mit AWS Fargate Blueprint erstellt wurde, schlägt der Workflow fehl und es wird ein Fehler wegen fehlender Abhängigkeiten angezeigt. `apache-maven-3.8.6` Der Workflow schlägt fehl und es wird eine Ausgabe ähnlich dem folgenden Beispiel angezeigt:

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

**Lösung:** Aktualisieren Sie das Blueprint-Dockerfile mithilfe der folgenden Schritte.

1. Geben Sie in der Suchleiste ein, `apache-maven-3.8.6` um das Dockerfile in dem Projekt zu suchen, das mit der Java-API mit Blueprint erstellt wurde. AWS Fargate 

1.  Aktualisieren Sie das Dockerfile (`/static-assets/app/Dockerfile`), das `maven:3.9.0-amazoncorretto-11` als Basisimage verwendet werden soll, und entfernen Sie die Abhängigkeit vom Paket. `apache-maven-3.8.6` 

1. (Empfohlen) Wir empfehlen außerdem, die Maven-Heap-Größe auf 6 GB zu aktualisieren.

Im Folgenden finden Sie ein Beispiel für eine 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"]
```

# Moderner dreistufiger Blueprint-Workflow für Webanwendungen **OnPullRequest**schlägt mit einem Berechtigungsfehler für Amazon fehl CodeGuru
<a name="projects-troubleshooting-onpullrequest"></a>

**Problem:** Wenn ich versuche, einen Workflow für mein Projekt auszuführen, schlägt die Ausführung des Workflows fehl und die folgende Meldung wird angezeigt: 

```
Failed at codeguru_codereview: The action failed during runtime. View the action's logs for more details.
```

``

**Lösung:** Eine mögliche Ursache für diesen Aktionsfehler könnte auf fehlende Berechtigungen in der IAM-Rollenrichtlinie zurückzuführen sein, sodass in Ihrer Version der Servicerolle, die von CodeCatalyst in the connected AWS-Konto verwendet wird, die erforderlichen Berechtigungen für die erfolgreiche Ausführung der Aktion **codeguru\$1codereview** fehlen. Um dieses Problem zu beheben, muss entweder die Servicerolle mit den erforderlichen Berechtigungen aktualisiert werden, oder Sie müssen die für den Workflow verwendete Servicerolle so ändern, dass sie über die erforderlichen Berechtigungen für Amazon CodeGuru und Amazon CodeGuru Reviewer verfügt. Suchen Sie anhand der folgenden Schritte nach Ihrer Rolle und aktualisieren Sie die Rollenrichtlinien-Berechtigungen, damit der Workflow erfolgreich ausgeführt werden kann.

**Anmerkung**  
Diese Schritte gelten für die folgenden Workflows in CodeCatalyst:  
Der **OnPullRequest**Workflow wurde für Projekte bereitgestellt, die mit dem Blueprint für moderne dreistufige Webanwendungen in erstellt wurden. CodeCatalyst
Workflows, die zu Projekten CodeCatalyst mit Aktionen hinzugefügt wurden, die auf Amazon CodeGuru oder Amazon CodeGuru Reviewer zugreifen.

Jedes Projekt enthält Workflows mit Aktionen, die eine Rolle und Umgebung verwenden, die von der AWS-Konto mit Ihrem Projekt verbundenen Person in bereitgestellt CodeCatalyst werden. Der Workflow mit den Aktionen und den ihnen zugewiesenen Richtlinien wird in Ihrem Quell-Repository im Verzeichnis /.codecatalyst/workflows gespeichert. Das Ändern des Workflow-YAML ist nicht erforderlich, es sei denn, Sie fügen dem vorhandenen Workflow eine neue Rollen-ID hinzu. Informationen zu YAML-Vorlagenelementen und Formatierungen finden Sie unter. [YAML-Workflow-Definition](workflow-reference.md)

Dies sind die allgemeinen Schritte, die Sie befolgen müssen, um Ihre Rollenrichtlinie zu bearbeiten und den YAML-Workflow zu überprüfen.

**Um im Workflow-YAML auf Ihren Rollennamen zu verweisen und die Richtlinie zu aktualisieren**

1. Öffnen Sie die CodeCatalyst Konsole unter [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Navigiere zu deinem CodeCatalyst Bereich. Navigiere zu deinem Projekt.

1. **Wählen Sie **CI/CD** und dann Workflows.** 

1. Wählen Sie den Workflow mit dem Titel. **OnPullRequest** Wählen Sie die Registerkarte **Definition**.

1. Notieren Sie sich im Workflow-YAML im `Role:` Feld unter der Aktion **codeguru\$1codereview** den Rollennamen. Dies ist die Rolle mit der Richtlinie, die Sie in IAM ändern werden. Das folgende Beispiel zeigt den Rollennamen.  
![\[Zeigen Sie den IAM-Rollennamen im Workflow-YAML an\]](http://docs.aws.amazon.com/de_de/codecatalyst/latest/userguide/images/projects/ts-workflow-role.png)

1. Führen Sie eine der folgenden Aktionen aus:
   + (Empfohlen) Aktualisieren Sie die mit Ihrem Projekt verbundene Servicerolle mit den erforderlichen Berechtigungen für Amazon CodeGuru und Amazon CodeGuru Reviewer. Der Rolle wird ein Name `CodeCatalystWorkflowDevelopmentRole-spaceName` mit einer angehängten eindeutigen Kennung zugewiesen. Weitere Informationen zur Rolle und zur Rollenrichtlinie finden Sie unter[Grundlegendes zur **CodeCatalystWorkflowDevelopmentRole-*spaceName***Servicerolle](ipa-iam-roles.md#ipa-iam-roles-service-role). Fahren Sie mit den nächsten Schritten fort, um die Richtlinie in IAM zu aktualisieren.
**Anmerkung**  
Sie benötigen AWS Administratorzugriff auf die AWS-Konto Rolle und Richtlinie. 
   + Ändern Sie die für den Workflow verwendete Servicerolle in eine, die über die erforderlichen Berechtigungen für Amazon CodeGuru und Amazon CodeGuru Reviewer verfügt, oder erstellen Sie eine neue Rolle mit den erforderlichen Berechtigungen.

1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die IAM-Konsole unter [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

   Suchen Sie in der IAM-Konsole nach der Rolle aus Schritt 5, z. B. `CodeCatalystPreviewDevelopmentRole`

1. Ändern Sie in der Rolle aus Schritt 5 die Berechtigungsrichtlinie so, dass sie die `codeguru:*` Berechtigungen `codeguru-reviewer:*` und einschließt. Nach dem Hinzufügen dieser Berechtigungen sollte die Berechtigungsrichtlinie etwa wie folgt aussehen:

1. Nachdem Sie die Richtlinienkorrekturen vorgenommen haben, kehren Sie zu der Workflow-Ausführung zurück CodeCatalyst und starten Sie die Ausführung erneut.

## Sie suchen immer noch nach einer Lösung für Ihr Problem?
<a name="projects-last-help"></a>

Sie können zu [Amazon](https://codecatalyst.aws/) gehen CodeCatalyst oder ein [Support-Feedback-Formular](https://support.aws.amazon.com/#/contacts/aws-account-support/) ausfüllen. Geben Sie im Abschnitt **Informationen anfordern** unter **Wie können wir Ihnen helfen**, an, dass Sie ein CodeCatalyst Amazon-Kunde sind. Geben Sie so viele Details wie möglich an, damit wir Ihr Problem am effizientesten lösen können.

# Behebung von Problemen mit Entwicklungsumgebungen
<a name="devenvironments-troubleshooting"></a>

Lesen Sie die folgenden Abschnitte, um Probleme im Zusammenhang mit Entwicklungsumgebungen zu beheben. Weitere Informationen zu Entwicklungsumgebungen finden Sie unter[Schreiben und ändern Sie Code mit Dev Environments in CodeCatalystSchreiben und ändern Sie Code mit Dev Environments](devenvironment.md).

**Topics**
+ [Die Erstellung meiner Entwicklungsumgebung war aufgrund eines Problems mit den Kontingenten nicht erfolgreich](#troubleshooting-devenvironments-create)
+ [Ich kann keine Änderungen aus meiner Entwicklungsumgebung in einen bestimmten Zweig in einem Repository übertragen](#troubleshooting-devenvironments-branchrules)
+ [Meine Entwicklungsumgebung wurde nicht wieder aufgenommen](#troubleshooting-devenvironments-resume)
+ [Die Verbindung zu meiner Entwicklungsumgebung wurde unterbrochen](#troubleshooting-devenvironments-connection)
+ [Meine mit dem VPC verbundene Entwicklungsumgebung ist ausgefallen](#troubleshooting-devenvironments-vpc)
+ [Ich kann nicht finden, in welchem Verzeichnis sich mein Projekt befindet](#troubleshooting-devenvironments-projects)
+ [Ich kann keine Verbindung zu meiner Entwicklungsumgebung über SSH herstellen](#troubleshooting-devenvironments-connect-ssh)
+ [Ich kann keine Verbindung zu meiner Entwicklungsumgebung über SSH herstellen, da meine lokale SSH-Konfiguration fehlt](#troubleshooting-devenvironments-projects-ssh-config)
+ [Ich kann keine Verbindung zu meiner Entwicklungsumgebung über SSH herstellen, da ich Probleme mit meinem Profil AWS Config habe `codecatalyst`](#troubleshooting-devenvironments-config-profile)
+ [Ich kann keine Entwicklungsumgebung erstellen, wenn ich CodeCatalyst mit einem Single-Sign-On-Konto angemeldet bin](#troubleshoot-create-dev-env-idprovider)
+ [Behebung von Problemen mit IDEs](devenvironments-troubleshooting-ides.md)
+ [Behebung von Problemen mit Devfiles](devenvironments-devenvironments-devfile.md)

## Die Erstellung meiner Entwicklungsumgebung war aufgrund eines Problems mit den Kontingenten nicht erfolgreich
<a name="troubleshooting-devenvironments-create"></a>

**Problem:** Ich möchte eine Entwicklungsumgebung in erstellen CodeCatalyst, sehe aber einen Fehler. In der Konsole wird auf der Seite „Entwicklungsumgebungen“ eine Meldung angezeigt, dass ich das Speicherlimit für den Speicherplatz erreicht habe.

**Mögliche Lösungen:** Abhängig von Ihrer Rolle im Projekt oder Space können Sie entweder eine oder mehrere Ihrer eigenen Entwicklungsumgebungen löschen, oder wenn Sie die Rolle eines Space-Administrators haben, können Sie ungenutzte Entwicklungsumgebungen löschen, die von anderen Benutzern erstellt wurden. Sie können sich auch dafür entscheiden, die Abrechnungsstufe auf eine Stufe zu ändern, die mehr Speicherplatz beinhaltet.
+ Um die Speicherlimits einzusehen, schauen Sie im CodeCatalyst Amazon-Bereich auf der Registerkarte **Abrechnung** nach, ob die **Nutzungskontingente** das zulässige Maximum erreicht haben. Wenn die Kontingente das Maximum erreicht haben, wenden Sie sich an jemanden mit der Rolle des Space-Administrators, um nicht benötigte Entwicklungsumgebungen zu entfernen oder eine Änderung der Abrechnungsstufe in Betracht zu ziehen.
+ Informationen zum Entfernen von Entwicklungsumgebungen, die Sie nicht mehr benötigen, finden Sie unter[Löschen einer Entwicklungsumgebung](devenvironment-delete.md).

Wenn das Problem weiterhin besteht und Sie einen Fehler in Ihrer IDE erhalten, überprüfen Sie, ob Sie über eine CodeCatalyst Rolle verfügen, mit der Sie eine Entwicklungsumgebung erstellen können. Die Rollen **Space-Administrator**, **Projektadministrator** und **Mitwirkender** verfügen alle über die Berechtigung, Entwicklungsumgebungen zu erstellen. Weitere Informationen finden Sie unter [Zugriff mit Benutzerrollen gewähren](ipa-roles.md).

## Ich kann keine Änderungen aus meiner Entwicklungsumgebung in einen bestimmten Zweig in einem Repository übertragen
<a name="troubleshooting-devenvironments-branchrules"></a>

**Problem:** Ich möchte Codeänderungen in meiner Entwicklungsumgebung in einen Branch in einem Quell-Repository übertragen und per Push übertragen, aber es wird ein Fehler angezeigt. 

**Mögliche Lösungen:** Abhängig von Ihrer Rolle im Projekt oder Bereich verfügen Sie möglicherweise nicht über die erforderlichen Berechtigungen, um Code in Quell-Repositorys im Projekt zu übertragen. Die Rollen **Space-Administrator**, **Projektadministrator** und **Mitwirkender** sind alle berechtigt, Code in Repositorys im Projekt zu pushen.

Wenn Sie die Rolle „**Mitwirkender**“ haben, aber keinen Code in einen bestimmten Zweig übertragen können, ist möglicherweise eine Verzweigungsregel für diesen bestimmten Zweig konfiguriert, die verhindert, dass Benutzer mit dieser Rolle Code in diesen bestimmten Zweig übertragen. Versuchen Sie, Ihre Änderungen in einen anderen Zweig zu übertragen, oder erstellen Sie einen Zweig und übertragen Sie dann Ihren Code in diesen Zweig. Weitere Informationen finden Sie unter [Zulässige Aktionen für einen Branch mit Branch-Regeln verwalten](source-branches-branch-rules.md).

## Meine Entwicklungsumgebung wurde nicht wieder aufgenommen
<a name="troubleshooting-devenvironments-resume"></a>

**Problem:** Meine Entwicklungsumgebung wurde nicht wieder aufgenommen, nachdem ich sie beendet hatte.

**Mögliche Lösungen:** Um das Problem zu beheben, schauen Sie im CodeCatalyst Amazon-Bereich auf der Registerkarte **Abrechnung** nach, ob die **Nutzungskontingente** die Höchstgrenzen erreicht haben. Wenn die Kontingente das Höchstlimit erreicht haben, wenden Sie sich an Ihren Space-Administrator, um die Abrechnungsstufe zu erhöhen.

## Die Verbindung zu meiner Entwicklungsumgebung wurde unterbrochen
<a name="troubleshooting-devenvironments-connection"></a>

**Problem:** Die Verbindung zu meiner Entwicklungsumgebung wurde unterbrochen, während ich sie verwendet habe.

**Mögliche Lösungen:** Überprüfen Sie Ihre Internetverbindung, um das Problem zu beheben. Wenn Sie nicht mit dem Internet verbunden sind, stellen Sie eine Verbindung her und setzen Sie Ihre Arbeit in Ihrer Entwicklungsumgebung fort.

## Meine mit dem VPC verbundene Entwicklungsumgebung ist ausgefallen
<a name="troubleshooting-devenvironments-vpc"></a>

**Problem:** Ich habe eine VPC-Verbindung mit meiner Entwicklungsumgebung verknüpft und es treten Fehler auf.

**Mögliche Lösungen:** Docker verwendet ein Link-Layer-Gerät, ein sogenanntes Bridge-Netzwerk, das es Containern ermöglicht, zu kommunizieren, die mit demselben Bridge-Netzwerk verbunden sind. Die Standard-Bridge verwendet normalerweise das `172.17.0.0/16` Subnetz für Container-Netzwerke. Wenn das VPC-Subnetz für die Instance Ihrer Umgebung denselben Adressbereich verwendet, der bereits von Docker genutzt wird, kann ein IP-Adressenkonflikt auftreten. Um einen IP-Adresskonflikt zu lösen, der dadurch verursacht wird, dass Amazon VPC Docker denselben IPv4 CIDR-Adressblock verwendet, konfigurieren Sie einen anderen CIDR-Block als. `172.17.0.0/16`

**Anmerkung**  
Sie können den IP-Adressbereich einer vorhandenen VPC oder eines Subnetzes nicht ändern.

## Ich kann nicht finden, in welchem Verzeichnis sich mein Projekt befindet
<a name="troubleshooting-devenvironments-projects"></a>

**Problem:** Ich kann nicht finden, in welchem Verzeichnis sich mein Projekt befindet.

**Mögliche Lösungen:** Um Ihr Projekt zu finden, wechseln Sie in das Verzeichnis`/projects`. Dies ist das Verzeichnis, in dem Sie Ihre Projekte finden können.

## Ich kann keine Verbindung zu meiner Entwicklungsumgebung über SSH herstellen
<a name="troubleshooting-devenvironments-connect-ssh"></a>

Um Fehler bei der Verbindung zu Ihrer Entwicklungsumgebung über SSH zu beheben, können Sie den `ssh` Befehl mit der `-vvv` Option ausführen, um weitere Informationen zur Lösung Ihres Problems anzuzeigen:

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

## Ich kann keine Verbindung zu meiner Entwicklungsumgebung über SSH herstellen, da meine lokale SSH-Konfiguration fehlt
<a name="troubleshooting-devenvironments-projects-ssh-config"></a>

Wenn Ihre lokale SSH-Konfiguration (`~/.ssh/config`) fehlt oder der Inhalt des `Host codecatalyst-dev-env*` Abschnitts veraltet ist, können Sie keine Verbindung zu Ihrer Entwicklungsumgebung über SSH herstellen. Um dieses Problem zu beheben, löschen Sie den `Host codecatalyst-dev-env*` Abschnitt und führen Sie den ersten Befehl aus dem **SSH Access-Modal** erneut aus. Weitere Informationen finden Sie unter [Mit SSH eine Verbindung zu einer Entwicklungsumgebung herstellen](devenvironment-connect-ssh.md).

## Ich kann keine Verbindung zu meiner Entwicklungsumgebung über SSH herstellen, da ich Probleme mit meinem Profil AWS Config habe `codecatalyst`
<a name="troubleshooting-devenvironments-config-profile"></a>

Stellen Sie sicher, dass Ihr AWS Config (`~/.aws/config`) für das `codecatalyst` Profil mit dem unter beschriebenen übereinstimmt[Einrichtung für die AWS CLI Verwendung von CodeCatalyst](set-up-cli.md). Wenn nicht, löschen Sie das Profil für `codecatalyst` und führen Sie den ersten Befehl aus dem **SSH Access-Modal** erneut aus. Weitere Informationen finden Sie unter [Mit SSH eine Verbindung zu einer Entwicklungsumgebung herstellen](devenvironment-connect-ssh.md).

## Ich kann keine Entwicklungsumgebung erstellen, wenn ich CodeCatalyst mit einem Single-Sign-On-Konto angemeldet bin
<a name="troubleshoot-create-dev-env-idprovider"></a>

**Problem:** Wenn ich als SSO-Benutzer bei der CodeCatalyst Konsole angemeldet bin, erhalte ich einen unbekannten Ausnahmefehler, wenn ich beschließe, eine Entwicklungsumgebung in dem Bereich zu erstellen. Wenn ich beispielsweise eine Entwicklungsumgebung erstellen und die IDE für den Zugriff auswähle AWS Cloud9, treten Probleme auf, die den folgenden ähneln: 
+ Auf der Seite **Entwicklungsumgebungen** in der CodeCatalyst Konsole wird die Entwicklungsumgebung in der Liste mit einem `FAILED` Status angezeigt.
+ Es wird eine Fehlermeldung ähnlich der folgenden angezeigt:

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

**Mögliche Lösungen:** 

Entwicklungsumgebungen sind für Benutzer in Bereichen, in denen Active Directory als Identitätsanbieter verwendet wird, nicht verfügbar. Administratoren für den Bereich können einen alternativen Identitätsanbieter verwenden, um auf Entwicklungsumgebungen wie IAM Identity Center zuzugreifen. Weitere Informationen zur Planung eines Bereichs, der Identitätsverbund unterstützt, finden Sie im *CodeCatalyst Administratorhandbuch* unter [Planung Ihres Bereichs, der Identitätsverbund unterstützt](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/setting-up-federation.html#setting-up-planning-federation).

# Behebung von Problemen mit IDEs
<a name="devenvironments-troubleshooting-ides"></a>

In den folgenden Abschnitten finden Sie Informationen zur Behebung von Problemen IDEs im CodeCatalyst Zusammenhang mit Weitere Informationen zu finden IDEs Sie unter[Eine Entwicklungsumgebung in einer IDE erstellen](devenvironment-create.md#devenvironment-using-ide).

**Topics**
+ [Ich habe nicht übereinstimmende Runtime-Image-Versionen in AWS Cloud9](#troubleshooting-devenvironments-c9-runtime)
+ [Ich kann nicht auf meine Dateien zugreifen `/projects/projects` in AWS Cloud9](#troubleshooting-devenvironments-c9-filesystem)
+ [Ich kann meine Entwicklungsumgebung nicht AWS Cloud9 mit einer benutzerdefinierten Entwicklungsdatei starten](#troubleshooting-devenvironments-c9-image)
+ [Ich habe Probleme in AWS Cloud9](#troubleshooting-c9)
+ [In JetBrains, ich kann keine Verbindung zu meinen Entwicklungsumgebungen herstellen über CodeCatalyst](#troubleshooting-jetbrains-connect)
+ [Ich kann nicht AWS Toolkit für meine IDE installieren](#troubleshooting-ide-toolkit)
+ [In meiner IDE kann ich meine Entwicklungsumgebungen nicht starten](#troubleshooting-ide-launch)

## Ich habe nicht übereinstimmende Runtime-Image-Versionen in AWS Cloud9
<a name="troubleshooting-devenvironments-c9-runtime"></a>

AWS Cloud9 verwendet unterschiedliche Versionen des Frontend-Assets und des Back-End-Runtime-Images. Die Verwendung verschiedener Versionen kann dazu führen, dass die AWS Toolkit Git-Erweiterung nicht richtig funktioniert. Um das Problem zu beheben, navigieren Sie zum Dev Environment-Dashboard, beenden Sie Ihre Entwicklungsumgebung und starten Sie sie dann erneut. Um das Problem zu beheben APIs, verwenden Sie die `UpdateDevEnvironment` API, um die Laufzeit zu aktualisieren. Weitere Informationen finden Sie [UpdateDevEnvironment](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_UpdateDevEnvironment.html)in der * CodeCatalyst Amazon-API-Referenz*.

## Ich kann nicht auf meine Dateien zugreifen `/projects/projects` in AWS Cloud9
<a name="troubleshooting-devenvironments-c9-filesystem"></a>

Der AWS Cloud9 Editor kann nicht auf Dateien im Verzeichnis zugreifen`/projects/projects`. Um das Problem zu beheben, verwenden Sie das AWS Cloud9 Terminal, um auf Ihre Dateien zuzugreifen, oder verschieben Sie sie in ein anderes Verzeichnis.

## Ich kann meine Entwicklungsumgebung nicht AWS Cloud9 mit einer benutzerdefinierten Entwicklungsdatei starten
<a name="troubleshooting-devenvironments-c9-image"></a>

Ihr Devfile-Image ist möglicherweise nicht kompatibel mit. AWS Cloud9 Um das Problem zu beheben, überprüfen Sie die Dev-Datei aus Ihrem Repository und der entsprechenden Entwicklungsumgebung und erstellen Sie eine neue, um fortzufahren.

## Ich habe Probleme in AWS Cloud9
<a name="troubleshooting-c9"></a>

Informationen zu anderen Problemen finden Sie im Abschnitt zur Fehlerbehebung im [AWS Cloud9 Benutzerhandbuch](https://docs.aws.amazon.com/cloud9/latest/user-guide/troubleshooting.html).

## In JetBrains, ich kann keine Verbindung zu meinen Entwicklungsumgebungen herstellen über CodeCatalyst
<a name="troubleshooting-jetbrains-connect"></a>

Um das Problem zu beheben, stellen Sie sicher, dass Sie nur die neueste Version von JetBrains installiert haben. Wenn Sie mehrere Versionen haben, deinstallieren Sie die älteren Versionen und registrieren Sie Ihren Protokollhandler erneut, indem Sie die IDE und den Browser schließen. Öffnen JetBrains und registrieren Sie dann den Protokollhandler erneut.

## Ich kann nicht AWS Toolkit für meine IDE installieren
<a name="troubleshooting-ide-toolkit"></a>

Um dieses Problem für VS Code zu beheben, installieren Sie manuell AWS Toolkit for Visual Studio Code von [GitHub](https://github.com/aws/aws-toolkit-vscode/releases).

Um dieses Problem zu beheben JetBrains, installieren Sie manuell AWS Toolkit for JetBrains von [GitHub](https://github.com/aws/aws-toolkit-jetbrains/releases).

## In meiner IDE kann ich meine Entwicklungsumgebungen nicht starten
<a name="troubleshooting-ide-launch"></a>

Um dieses Problem für VS Code zu beheben, überprüfen Sie, ob Sie die neueste Version von VS Code AWS Toolkit for Visual Studio Code installiert haben. Wenn Sie nicht über die neueste Version verfügen, aktualisieren und starten Sie Ihre Entwicklungsumgebung. Weitere Informationen finden Sie unter [Amazon CodeCatalyst for VS Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/codecatalyst-service.html).

Um dieses Problem zu beheben JetBrains, überprüfen Sie, ob Sie die neueste Version von JetBrains und AWS Toolkit for JetBrains installiert haben. Wenn Sie nicht über die neueste Version verfügen, aktualisieren Sie Ihre Entwicklungsumgebung und starten Sie sie. Weitere Informationen finden Sie [bei Amazon CodeCatalyst für JetBrains](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/codecatalyst-overview.html).

# Behebung von Problemen mit Devfiles
<a name="devenvironments-devenvironments-devfile"></a>

In den folgenden Abschnitten finden Sie Informationen zur Behebung von Problemen im Zusammenhang mit Devfiles in. CodeCatalyst Weitere Informationen zu Devfiles finden Sie unter. [Konfiguration einer Dev-Datei für eine Entwicklungsumgebung](devenvironment-devfile.md)

**Topics**
+ [Meine Entwicklungsumgebung verwendet die standardmäßige universelle Dev-Datei, obwohl ich ein benutzerdefiniertes Image in einer benutzerdefinierten Dev-Datei implementiert habe](#troubleshooting-devenvironments-custom-image)
+ [Mein Projekt wird nicht in meiner Entwicklungsumgebung mit der standardmäßigen universellen Devdatei erstellt](#troubleshooting-devenvironments-default-image)
+ [Ich möchte eine Repository-Dev-Datei für eine Entwicklungsumgebung verschieben](#troubleshooting-devenvironments-devfile-moving)
+ [Ich habe ein Problem beim Starten meiner Dev-Datei](#troubleshooting-devenvironments-devfile-recovery)
+ [Ich bin mir nicht sicher, wie ich den Status meiner Dev-Datei überprüfen soll](#troubleshooting-devenvironments-devfile-status)
+ [Meine Dev-Datei ist nicht mit den Tools kompatibel, die im neuesten Image bereitgestellt werden](#troubleshooting-devenvironments-devfile-version)

## Meine Entwicklungsumgebung verwendet die standardmäßige universelle Dev-Datei, obwohl ich ein benutzerdefiniertes Image in einer benutzerdefinierten Dev-Datei implementiert habe
<a name="troubleshooting-devenvironments-custom-image"></a>

Wenn beim Starten einer Entwicklungsumgebung, die eine benutzerdefinierte Entwicklungsdatei verwendet, Fehler CodeCatalyst auftreten, verwendet die Entwicklungsumgebung standardmäßig die standardmäßige universelle Entwicklungsdatei. Um das Problem zu beheben, können Sie den genauen Fehler in den Protokollen unter überprüfen. `/aws/mde/logs/devfile.log` Sie können auch in Ihren Protokollen überprüfen, ob die `postStart` Ausführung erfolgreich war:`/aws/mde/logs/devfileCommand.log`.

## Mein Projekt wird nicht in meiner Entwicklungsumgebung mit der standardmäßigen universellen Devdatei erstellt
<a name="troubleshooting-devenvironments-default-image"></a>

Um das Problem zu beheben, stellen Sie sicher, dass Sie keine benutzerdefinierte Entwicklungsdatei verwenden. Wenn Sie keine benutzerdefinierte Entwicklungsdatei verwenden, schauen Sie sich die `devfile.yaml` Datei im Quell-Repository des Projekts an, um Fehler zu finden und zu beheben.

## Ich möchte eine Repository-Dev-Datei für eine Entwicklungsumgebung verschieben
<a name="troubleshooting-devenvironments-devfile-moving"></a>

Sie können die Standard-Dev-Datei in `/projects/devfile.yaml` Ihr Quellcode-Repository verschieben. Verwenden Sie den folgenden Befehl, um den Speicherort der Dev-Datei zu aktualisieren:. `/aws/mde/mde start --location repository-name/devfile.yaml`

## Ich habe ein Problem beim Starten meiner Dev-Datei
<a name="troubleshooting-devenvironments-devfile-recovery"></a>

Wenn beim Starten Ihrer Dev-Datei ein Problem auftritt, wechselt sie in den Wiederherstellungsmodus, sodass Sie weiterhin eine Verbindung zu Ihrer Umgebung herstellen und Ihre Dev-Datei reparieren können. Wenn Sie sich im Wiederherstellungsmodus befinden, enthält die Ausführung `/aws/mde/mde status` nicht den Speicherort Ihrer Dev-Datei.

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

Sie können den Fehler in den Protokollen unter überprüfen`/aws/mde/logs`, die Dev-Datei korrigieren und erneut versuchen, es auszuführen`/aws/mde/mde start`.

## Ich bin mir nicht sicher, wie ich den Status meiner Dev-Datei überprüfen soll
<a name="troubleshooting-devenvironments-devfile-status"></a>

Sie können Ihren Devfile-Status überprüfen, indem Sie Folgendes ausführen. `/aws/mde/mde status` Nachdem Sie diesen Befehl ausgeführt haben, wird möglicherweise eine der folgenden Optionen angezeigt:
+ `{"status": "STABLE", "location": "devfile.yaml" }`

  Dies zeigt an, dass Ihre Dev-Datei korrekt ist.
+ `{"status": "STABLE" }`

  Dies deutet darauf hin, dass Ihre Dev-Datei nicht gestartet werden konnte und sich im Wiederherstellungsmodus befindet.

Sie können den genauen Fehler in den Protokollen unter `/aws/mde/logs/devfile.log` überprüfen.

Sie können auch in Ihren Protokollen überprüfen, ob die `postStart` Ausführung erfolgreich war:`/aws/mde/logs/devfileCommand.log`.

Weitere Informationen finden Sie unter [Spezifizierung universeller Devfile-Images für eine Entwicklungsumgebung](devenvironment-universal-image.md).

## Meine Dev-Datei ist nicht mit den Tools kompatibel, die im neuesten Image bereitgestellt werden
<a name="troubleshooting-devenvironments-devfile-version"></a>

In Ihrer Entwicklungsumgebung `devfile` oder `devfile postStart` kann fehlschlagen, wenn das `latest` Tool nicht über die für ein bestimmtes Projekt erforderlichen Tools verfügt. Gehen Sie wie folgt vor, um das Problem zu beheben:<a name="devenvironment-devfile-version"></a>

1. Navigiere zu deiner Dev-Datei.

1. Aktualisieren Sie in Ihrer Dev-Datei stattdessen auf eine detaillierte Image-Version. `latest` Sie könnte wie folgt aussehen:

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

1. Erstellen Sie mit der aktualisierten Dev-Datei eine neue Entwicklungsumgebung.

# Behebung von Problemen mit Workflows
<a name="troubleshooting-workflows"></a>

Lesen Sie die folgenden Abschnitte, um Probleme im Zusammenhang mit Workflows in Amazon zu beheben CodeCatalyst. Weitere Informationen zu Workflows finden Sie unter [Erstellen, Testen und Bereitstellen mit WorkflowsMit Workflows erstellen, testen und bereitstellen](workflow.md).

**Topics**
+ [Wie behebe ich die Meldung „Der Workflow ist inaktiv“?](#troubleshooting-workflows-inactive)
+ [Wie behebe ich den Fehler „Workflow-Definition enthält *n* Fehler“?](#troubleshooting-workflows-asterisks)
+ [Wie behebe ich die Fehler „Anmeldeinformationen konnten nicht gefunden werden“ und ExpiredToken „“?](#troubleshooting-workflows-auth-errors-eks)
+ [Wie behebe ich die Fehler „Es konnte keine Verbindung zum Server hergestellt werden“?](#troubleshooting-workflows-unable-connect-eks)
+ [Warum fehlen CodeDeploy Felder im visuellen Editor?](#troubleshooting-workflows-codedeploy)
+ [Wie behebe ich Fehler bei den IAM-Fähigkeiten?](#troubleshooting-workflows-capabilities)
+ [Wie behebe ich „npm install“ -Fehler?](#troubleshooting-workflows-npm)
+ [Warum haben mehrere Workflows denselben Namen?](#troubleshooting-workflows-name)
+ [Kann ich meine Workflow-Definitionsdateien in einem anderen Ordner speichern?](#troubleshooting-workflows-folder)
+ [Wie füge ich meinem Workflow nacheinander Aktionen hinzu?](#troubleshooting-workflows-visual)
+ [Warum wird mein Workflow erfolgreich validiert, schlägt aber zur Laufzeit fehl?](#troubleshooting-workflows-validation)
+ [Die automatische Erkennung erkennt keine Berichte für meine Aktion](#troubleshooting-reports-auto-discovery)
+ [Meine Aktion schlägt bei automatisch erkannten Berichten fehl, nachdem ich Erfolgskriterien konfiguriert habe](#troubleshooting-success-auto-discovery)
+ [Autodiscovery generiert Berichte, die ich nicht haben möchte](#troubleshooting-unwanted-auto-discovery)
+ [Auto-Discovery generiert viele kleine Berichte für ein einzelnes Test-Framework](#troubleshooting-reports-combined)
+ [Die unter aufgeführten Workflows stimmen CI/CD nicht mit denen im Quell-Repository überein](#troubleshooting-workflow-source)
+ [Ich kann keine Workflows erstellen oder aktualisieren](#troubleshooting-workflows-branchrules)

## Wie behebe ich die Meldung „Der Workflow ist inaktiv“?
<a name="troubleshooting-workflows-inactive"></a>

**Problem**: In der CodeCatalyst Konsole wird unter **CI/CD**, **Workflows**, Ihr Workflow mit der folgenden Meldung angezeigt: 

`Workflow is inactive.`

Diese Meldung weist darauf hin, dass die Workflow-Definitionsdatei einen Trigger enthält, der nicht für den Zweig gilt, in dem Sie sich gerade befinden. Ihre Workflow-Definitionsdatei könnte beispielsweise einen `PUSH` Trigger enthalten, der auf Ihren `main` Zweig verweist, aber Sie befinden sich in einem Feature-Branch. Da die Änderungen, die Sie an Ihrem Feature-Branch vornehmen`main`, sich nicht auf Workflow-Läufe beziehen und auch keine Workflow-Läufe starten`main`, wird CodeCatalyst der Workflow in dem Branch außer Betrieb genommen und als `Inactive` markiert.

**Mögliche Lösungen:**

Wenn Sie einen Workflow für Ihren Feature Branch starten möchten, können Sie wie folgt vorgehen:
+ Entfernen Sie in Ihrem Feature Branch in der Workflow-Definitionsdatei die `Branches` Eigenschaft aus dem `Triggers` Abschnitt, sodass sie wie folgt aussieht:

  ```
  Triggers:
    - Type: PUSH
  ```

  Diese Konfiguration bewirkt, dass der Trigger bei einem Push in einen beliebigen Branch aktiviert wird, einschließlich Ihres Feature-Branches. Wenn der Trigger aktiviert ist, CodeCatalyst wird ein Workflow-Lauf mit der Workflow-Definitionsdatei und den Quelldateien in dem Zweig gestartet, in den Sie pushen.
+ Entfernen Sie in Ihrem Feature-Branch in der Workflow-Definitionsdatei den `Triggers` Abschnitt und führen Sie den Workflow manuell aus.
+ Ändern Sie in Ihrem Feature-Branch in der Workflow-Definitionsdatei den `PUSH` Abschnitt so, dass er auf Ihren Feature-Branch verweist und nicht auf einen anderen Branch (wie `main` zum Beispiel).

**Wichtig**  
Achten Sie darauf, diese Änderungen nicht zu übernehmen, wenn Sie nicht beabsichtigen, sie wieder in Ihrem `main` Branch zusammenzuführen.

Weitere Informationen zum Bearbeiten der Workflow-Definitionsdatei finden Sie unter[Einen Workflow erstellen](workflows-create-workflow.md).

Weitere Informationen zu Auslösern finden Sie unter [Automatisches Starten einer Workflow-Ausführung mithilfe von Triggern](workflows-add-trigger.md).

## Wie behebe ich den Fehler „Workflow-Definition enthält *n* Fehler“?
<a name="troubleshooting-workflows-asterisks"></a>

**Problem**: Es wird eine der folgenden Fehlermeldungen angezeigt:

**Fehler 1:**

Auf der Seite **CI/CD**, **Workflows**, sehen Sie unter dem Namen Ihres Workflows:

`Workflow definition has n errors`

**Fehler 2:**

Wenn Sie einen Workflow bearbeiten, klicken Sie auf die Schaltfläche **Validieren** und die folgende Meldung wird oben in der CodeCatalyst Konsole angezeigt:

`The workflow definition has errors. Fix the errors and choose Validate to verify your changes.`

**Fehler 3:**

Nachdem Sie zur Detailseite Ihres Workflows navigiert haben, wird im Feld **Workflow-Definition** der folgende Fehler angezeigt:

`n errors`

**Mögliche Lösungen:** 
+ Wählen Sie **CI/CD**, wählen Sie **Workflows** und wählen Sie den Namen des Workflows aus, in dem der Fehler aufgetreten ist. Wählen Sie im Feld **Workflow-Definition** oben den Link zu dem Fehler aus. Details zum Fehler werden unten auf der Seite angezeigt. Folgen Sie den Tipps zur Fehlerbehebung in der Fehlermeldung, um das Problem zu beheben.
+ Stellen Sie sicher, dass die Workflow-Definitionsdatei eine YAML-Datei ist.
+ Stellen Sie sicher, dass die YAML-Eigenschaften in der Workflow-Definitionsdatei auf der richtigen Ebene verschachtelt sind. Informationen darüber, wie Eigenschaften in der Workflow-Definitionsdatei verschachtelt werden sollten, finden Sie in der [YAML-Workflow-Definition](workflow-reference.md) oder in der Dokumentation Ihrer Aktion, die mit dem Link von verknüpft ist. [Aktion zu einem Workflow hinzufügen](workflows-add-action.md) 
+ Stellen Sie sicher, dass Sternchen (`*`) und andere Sonderzeichen korrekt maskiert werden. Um sie zu maskieren, fügen Sie einfache oder doppelte Anführungszeichen hinzu. Beispiel:

  ```
  Outputs:      
    Artifacts:
      - Name: myartifact
        Files:
          - "**/*"
  ```

  Weitere Hinweise zu Sonderzeichen in der Workflow-Definitionsdatei finden Sie unter[Richtlinien und Konventionen zur Syntax](workflow-reference.md#workflow.terms.syntax.conv).
+ Stellen Sie sicher, dass die YAML-Eigenschaften in der Workflow-Definitionsdatei die richtige Groß-/Kleinschreibung verwenden. Weitere Informationen zu Regeln für Groß- und Kleinschreibung finden Sie unter. [Richtlinien und Konventionen zur Syntax](workflow-reference.md#workflow.terms.syntax.conv) Informationen zur korrekten Groß- und Kleinschreibung der einzelnen Eigenschaften finden Sie in der [YAML-Workflow-Definition](workflow-reference.md) oder in der Dokumentation zu Ihrer Aktion, die mit dem Link von verknüpft ist[Aktion zu einem Workflow hinzufügen](workflows-add-action.md).
+ Vergewissern Sie sich, dass die `SchemaVersion` Eigenschaft in der Workflow-Definitionsdatei vorhanden und auf die richtige Version eingestellt ist. Weitere Informationen finden Sie unter [SchemaVersion](workflow-reference.md#workflow.schemaversion).
+ Stellen Sie sicher, dass der `Triggers` Abschnitt in der Workflow-Definitionsdatei alle erforderlichen Eigenschaften enthält. Um die erforderlichen Eigenschaften zu ermitteln, wählen Sie den Trigger im [Visual Editor](workflow.md#workflow.editors) aus und suchen Sie nach Feldern, in denen Informationen fehlen, oder lesen Sie in der Referenzdokumentation zu Triggern unter[Triggers](workflow-reference.md#triggers-reference).
+ Stellen Sie sicher, dass die `DependsOn` Eigenschaft in der Workflow-Definitionsdatei richtig konfiguriert ist und keine zirkulären Abhängigkeiten mit sich bringt. Weitere Informationen finden Sie unter [Aktionen sequenzieren](workflows-depends-on.md).
+ Stellen Sie sicher, dass der `Actions` Abschnitt in der Workflow-Definitionsdatei mindestens eine Aktion enthält. Weitere Informationen finden Sie unter [Aktionen](workflow-reference.md#actions-reference). 
+ Stellen Sie sicher, dass jede Aktion alle erforderlichen Eigenschaften enthält. Um die erforderlichen Eigenschaften zu ermitteln, wählen Sie die Aktion im [Visual Editor](workflow.md#workflow.editors) aus und suchen Sie nach Feldern, in denen Informationen fehlen, oder schauen Sie in der Dokumentation zu Ihrer Aktion nach, auf die von verlinkt wird[Aktion zu einem Workflow hinzufügen](workflows-add-action.md).
+ Stellen Sie sicher, dass alle Eingabeartefakte über entsprechende Ausgabeartefakte verfügen. Weitere Informationen finden Sie unter [Definition eines Ausgabeartefakts](workflows-working-artifacts-output.md).
+ Stellen Sie sicher, dass die in einer Aktion definierten Variablen exportiert werden, damit sie in anderen Aktionen verwendet werden können. Weitere Informationen finden Sie unter [Eine Variable exportieren, damit sie von anderen Aktionen verwendet werden kann](workflows-working-with-variables-export-input.md).

## Wie behebe ich die Fehler „Anmeldeinformationen konnten nicht gefunden werden“ und ExpiredToken „“?
<a name="troubleshooting-workflows-auth-errors-eks"></a>

**Problem**: Während der [Tutorial: Bereitstellen einer Anwendung in Amazon EKS](deploy-tut-eks.md) Bearbeitung werden im Terminalfenster Ihres Entwicklungscomputers eine oder beide der folgenden Fehlermeldungen angezeigt:

`Unable to locate credentials. You can configure credentials by running "aws configure".`

`ExpiredToken: The security token included in the request is expired` 

**Mögliche Lösungen:**

Diese Fehler weisen darauf hin, dass die Anmeldeinformationen, die Sie für den Zugriff auf AWS Dienste verwenden, abgelaufen sind. Führen Sie in diesem Fall den `aws configure` Befehl nicht aus. Verwenden Sie stattdessen die folgenden Anweisungen, um Ihren AWS Zugriffsschlüssel und Ihr Sitzungstoken zu aktualisieren.

**Um Ihren AWS Zugriffsschlüssel und Ihr Sitzungstoken zu aktualisieren**

1. Stellen Sie sicher, dass Sie die URL, den Benutzernamen und das Passwort des AWS Zugriffsportals für den Benutzer haben, den Sie verwenden, um das Amazon EKS-Tutorial abzuschließen (`codecatalyst-eks-user`). Sie sollten diese Elemente konfiguriert haben, als Sie das Tutorial abgeschlossen [Schritt 1: Richten Sie Ihren Entwicklungscomputer ein](deploy-tut-eks.md#deploy-tut-eks-dev-env-create) haben.
**Anmerkung**  
Wenn Ihnen diese Informationen nicht vorliegen, rufen Sie die `codecatalyst-eks-user` Detailseite im IAM Identity Center auf und wählen Sie **Passwort zurücksetzen**, **Einmalpasswort generieren [...]** , und klicken **Sie erneut auf Passwort zurücksetzen**, um die Informationen auf dem Bildschirm anzuzeigen.

1. Führen Sie eine der folgenden Aktionen aus:
   + Fügen Sie die URL des AWS Zugangsportals in die Adressleiste Ihres Browsers ein.

     Oder
   + Aktualisieren Sie die AWS Access-Portalseite, falls sie bereits geladen ist.

1. Melden Sie sich mit dem Benutzernamen und dem Passwort `codecatalyst-eks-user` von an, falls Sie noch nicht angemeldet sind.

1. Wählen Sie **AWS-Konto**und wählen Sie dann den Namen des Benutzers, AWS-Konto dem Sie den `codecatalyst-eks-user` Benutzer und den Berechtigungssatz zugewiesen haben.

1. Wählen Sie neben dem Namen des Berechtigungssatzes (`codecatalyst-eks-permission-set`) die Option **Befehlszeilenzugriff oder programmatischer Zugriff** aus.

1. Kopieren Sie die Befehle in der Mitte der Seite. Sie sehen etwa wie folgt aus:

   ```
   export AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE" 
   export AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" 
   export AWS_SESSION_TOKEN="session-token"
   ```

   ... wo *session-token* ist eine lange zufällige Zeichenfolge.

1. Fügen Sie die Befehle in Ihre Terminal-Eingabeaufforderung auf Ihrem Entwicklungscomputer ein und drücken Sie die Eingabetaste.

   Die neuen Schlüssel und das Sitzungstoken werden geladen.

   Sie haben jetzt Ihre Anmeldeinformationen aktualisiert. Die `kubectl` Befehle AWS CLI`eksctl`, und sollten jetzt funktionieren. 

## Wie behebe ich die Fehler „Es konnte keine Verbindung zum Server hergestellt werden“?
<a name="troubleshooting-workflows-unable-connect-eks"></a>

**Problem**: Während Sie das unter beschriebene Tutorial durcharbeiten[Tutorial: Bereitstellen einer Anwendung in Amazon EKS](deploy-tut-eks.md), wird im Terminalfenster Ihres Entwicklungscomputers eine Fehlermeldung ähnlich der folgenden angezeigt:

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

**Mögliche Lösungen:**

Dieser Fehler weist normalerweise darauf hin, dass die Anmeldeinformationen, die das `kubectl` Hilfsprogramm für die Verbindung mit Ihrem Amazon EKS-Cluster verwendet, abgelaufen sind. Um das Problem zu lösen, aktualisieren Sie die Anmeldeinformationen, indem Sie an der Terminal-Eingabeaufforderung den folgenden Befehl eingeben:

```
aws eks update-kubeconfig --name codecatalyst-eks-cluster --region us-west-2
```

Wobei Folgendes gilt:
+ *codecatalyst-eks-cluster*wird durch den Namen Ihres Amazon EKS-Clusters ersetzt.
+ *us-west-2*wird durch die AWS Region ersetzt, in der Ihr Cluster bereitgestellt wird.

## Warum fehlen CodeDeploy Felder im visuellen Editor?
<a name="troubleshooting-workflows-codedeploy"></a>

**Problem**: Sie verwenden eine Aktion „In [Amazon ECS bereitstellen](deploy-action-ecs.md)“ und die CodeDeploy Felder werden nicht angezeigt, z. B. **CodeDeploy AppSpec**im visuellen Editor des Workflows. Dieses Problem kann auftreten, weil der Amazon ECS-Service, den Sie im Feld **Service** angegeben haben, nicht für Blau/Grün-Bereitstellungen konfiguriert ist.

**Mögliche Lösungen:** 
+ Wählen Sie auf der Registerkarte **Konfiguration** der Aktion In Amazon ECS **bereitstellen einen anderen Amazon ECS-Service** aus. Weitere Informationen finden Sie unter [Bereitstellung auf Amazon ECS mit einem Workflow](deploy-action-ecs.md).
+ Konfigurieren Sie den ausgewählten Amazon ECS-Service für die Durchführung von blue/green Bereitstellungen. Weitere Informationen zur Konfiguration von blue/green Bereitstellungen finden Sie unter [Blue/Green Deployment with CodeDeploy](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-type-bluegreen.html) im *Amazon Elastic Container Service Developer Guide*.

## Wie behebe ich Fehler bei den IAM-Fähigkeiten?
<a name="troubleshooting-workflows-capabilities"></a>

**Problem**: Sie verwenden eine Aktion „[CloudFormation Stack bereitstellen](deploy-action-cfn.md)“ und dies wird `##[error] requires capabilities: [capability-name]` in den Protokollen Ihrer Aktion „** CloudFormation Stack bereitstellen**“ angezeigt.

**Mögliche Lösungen**: Gehen Sie wie folgt vor, um die Funktion zur Workflow-Definitionsdatei hinzuzufügen. Weitere Informationen zu IAM-Funktionen finden Sie unter [Bestätigung von IAM-Ressourcen in CloudFormation Vorlagen im](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#using-iam-capabilities) *IAM-Benutzerhandbuch*.

------
#### [ Visual ]

**So fügen Sie eine IAM-Funktion mit dem Visual Editor hinzu**

1. Öffnen Sie die CodeCatalyst Konsole unter [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Wählen Sie Ihr Projekt.

1. **Wählen Sie im Navigationsbereich **CI/CD** und dann Workflows aus.**

1. Wählen Sie den Namen Ihres Workflows. Sie können nach dem Quell-Repository oder dem Branch-Namen filtern, in dem der Workflow definiert ist, oder nach Workflow-Namen oder -Status filtern.

1. Wählen Sie **Bearbeiten** aus.

1. Wählen Sie **Visual**.

1. Wählen Sie im Workflow-Diagramm die Aktion ** CloudFormation Stack bereitstellen** aus.

1. Wählen Sie die Registerkarte **Konfiguration** aus.

1. Wählen Sie unten **Erweitert — optional** aus.

1. Aktivieren Sie in der Dropdownliste **Funktionen** das Kontrollkästchen neben der in der Fehlermeldung genannten Funktion. Wenn die Funktion in der Liste nicht verfügbar ist, fügen Sie sie mit dem YAML-Editor hinzu.

1. (Optional) Wählen Sie „**Validieren**“, um den YAML-Code des Workflows vor dem Commit zu überprüfen.

1. Wählen Sie **Commit**, geben Sie eine Commit-Nachricht ein und wählen Sie erneut **Commit**.

1. Wenn eine neue Workflow-Ausführung nicht automatisch gestartet wird, führen Sie den Workflow manuell aus, um zu überprüfen, ob die Änderungen den Fehler beheben. Weitere Informationen zum manuellen Ausführen eines Workflows finden Sie unter[Manuelles Starten einer Workflow-Ausführung](workflows-manually-start.md).

------
#### [ YAML ]

**So fügen Sie eine IAM-Fähigkeit mit dem YAML-Editor hinzu**

1. [Öffnen Sie die CodeCatalyst Konsole unter https://codecatalyst.aws/.](https://codecatalyst.aws/)

1. Wählen Sie Ihr Projekt.

1. **Wählen Sie im Navigationsbereich **CI/CD** und dann Workflows aus.**

1. Wählen Sie den Namen Ihres Workflows. Sie können nach dem Quell-Repository oder dem Branch-Namen filtern, in dem der Workflow definiert ist, oder nach Workflow-Namen oder -Status filtern.

1. Wählen Sie **Bearbeiten** aus.

1. Wählen Sie **YAML.**

1. Fügen Sie in der Aktion ** CloudFormation Stack bereitstellen** eine `capabilities` Eigenschaft wie folgt hinzu:

   ```
   DeployCloudFormationStack:
     Configuration:
       capabilities: capability-name
   ```

   *capability-name*Ersetzen Sie es durch den Namen der IAM-Fähigkeit, der in der Fehlermeldung angezeigt wird. Verwenden Sie Kommas und keine Leerzeichen, um mehrere Funktionen aufzulisten. Weitere Informationen finden Sie in der Beschreibung der `capabilities` Immobilie im[Aktion CloudFormation 'Stack bereitstellen' YAML](deploy-action-ref-cfn.md).

1. (Optional) Wählen Sie „**Validieren**“, um den YAML-Code des Workflows vor dem Commit zu überprüfen.

1. Wählen Sie **Commit**, geben Sie eine Commit-Nachricht ein und wählen Sie erneut **Commit**.

1. Wenn eine neue Workflow-Ausführung nicht automatisch gestartet wird, führen Sie den Workflow manuell aus, um zu überprüfen, ob die Änderungen den Fehler beheben. Weitere Informationen zum manuellen Ausführen eines Workflows finden Sie unter[Manuelles Starten einer Workflow-Ausführung](workflows-manually-start.md).

------

## Wie behebe ich „npm install“ -Fehler?
<a name="troubleshooting-workflows-npm"></a>

**Problem**: Ihre [AWS CDK Bereitstellungs- oder [AWS CDK Bootstrap-Aktion](cdk-boot-action.md)](cdk-dep-action.md) schlägt mit einem Fehler fehl. `npm install` Dieser Fehler kann auftreten, weil Sie Ihre AWS CDK App-Abhängigkeiten in einer NPM-Registrierung (Private Node Package Manager) speichern, auf die die Aktion nicht zugreifen kann. 

**Mögliche Lösungen**: Verwenden Sie die folgenden Anweisungen, um die `cdk.json` Datei Ihrer AWS CDK App mit zusätzlichen Registrierungs- und Authentifizierungsinformationen zu aktualisieren.

**Bevor Sie beginnen**

1. Erstellen Sie Geheimnisse für Ihre Authentifizierungsinformationen. Sie werden in der `cdk.json` Datei auf diese Geheimnisse verweisen, anstatt die Entsprechungen im Klartext anzugeben. Um die Geheimnisse zu erstellen:

   1. Öffnen Sie die CodeCatalyst Konsole unter [https://codecatalyst.aws/](https://codecatalyst.aws/).

   1. Wählen Sie Ihr Projekt.

   1. **Wählen Sie im Navigationsbereich **CI/CD** und dann Secrets aus.**

   1. Erstellen Sie zwei Geheimnisse mit den folgenden Eigenschaften:    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/codecatalyst/latest/userguide/troubleshooting-workflows.html)

      Weitere Hinweise zu Geheimnissen finden Sie unter[Daten mithilfe von Geheimnissen maskieren](workflows-secrets.md).

1. Fügen Sie die Geheimnisse als Umgebungsvariablen zu Ihrer AWS CDK Aktion hinzu. Die Aktion ersetzt die Variablen durch echte Werte, wenn sie ausgeführt wird. Um die Geheimnisse hinzuzufügen:

   1. **Wählen Sie im Navigationsbereich **CI/CD** und dann Workflows aus.**

   1. Wählen Sie den Namen Ihres Workflows. Sie können nach dem Quell-Repository oder dem Branch-Namen filtern, in dem der Workflow definiert ist, oder nach Workflow-Namen oder -Status filtern.

   1. Wählen Sie **Bearbeiten** aus.

   1. Wählen Sie **Visual**.

   1. Wählen Sie im Workflow-Diagramm Ihre AWS CDK Aktion aus.

   1. Wählen Sie die Registerkarte **Eingaben**.

   1. Fügen Sie zwei Variablen mit den folgenden Eigenschaften hinzu:    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/codecatalyst/latest/userguide/troubleshooting-workflows.html)

      Sie haben jetzt zwei Variablen, die Verweise auf Geheimnisse enthalten.

   Der YAML-Code Ihrer Workflow-Definitionsdatei sollte etwa wie folgt aussehen:
**Anmerkung**  
Das folgende Codebeispiel stammt aus einer **AWS CDK Bootstrap-Aktion**; eine **AWS CDK Bereitstellungsaktion** sieht ähnlich aus.

   ```
   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"
   ```

   Sie sind jetzt bereit, die `NPMTOKEN` Variablen `NPMUSER` und in Ihrer `cdk.json` Datei zu verwenden. Fahren Sie mit dem nächsten Schritt fort.

**Um deine cdk.json-Datei zu aktualisieren**

1. Wechseln Sie in das Stammverzeichnis Ihres AWS CDK Projekts und öffnen Sie die `cdk.json` Datei.

1. Suchen Sie die `"app":` Eigenschaft und ändern Sie sie so, dass sie den Code enthält, der in*red italics*:
**Anmerkung**  
Der folgende Beispielcode stammt aus einem TypeScript Projekt. Wenn Sie ein JavaScript Projekt verwenden, sieht der Code ähnlich, wenn auch nicht identisch aus.

   ```
   {
     "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. Ersetzen Sie in dem unter hervorgehobenen Code: *red italics*
   + *your-registry/folder/CDK-package/*mit dem Pfad zu Ihren AWS CDK Projektabhängigkeiten in Ihrer privaten Registrierung.
   + *hello-cdk.ts\$1.js*mit dem Namen Ihrer Einstiegspunktdatei. Je nachdem, welche Sprache Sie verwenden, kann es sich dabei um eine `.ts` `.js` (TypeScriptJavaScript) oder () -Datei handeln.
**Anmerkung**  
Die Aktion ersetzt die *NPMTOKEN* Variablen *NPMUSER* und durch den npm-Benutzernamen und das Zugriffstoken, die Sie in **Secrets** angegeben haben.

1. Speichern Sie Ihre `cdk.json`-Datei.

1. Führen Sie die Aktion manuell erneut aus, um festzustellen, ob die Änderungen den Fehler beheben. Weitere Informationen zum manuellen Ausführen von Aktionen finden Sie unter[Manuelles Starten einer Workflow-Ausführung](workflows-manually-start.md).

## Warum haben mehrere Workflows denselben Namen?
<a name="troubleshooting-workflows-name"></a>



Workflows werden pro Zweig pro Repository gespeichert. Zwei verschiedene Workflows können denselben Namen haben, wenn sie in verschiedenen Branchen existieren. Auf der Seite Workflows können Sie Workflows mit demselben Namen anhand des Branchnamens unterscheiden. Weitere Informationen finden Sie unter [Organisation Ihrer Quellcode-Arbeit mit Filialen in Amazon CodeCatalyst](source-branches.md).

![\[Zweig „Workflow“\]](http://docs.aws.amazon.com/de_de/codecatalyst/latest/userguide/images/flows/workflow-branch.png)


## Kann ich meine Workflow-Definitionsdateien in einem anderen Ordner speichern?
<a name="troubleshooting-workflows-folder"></a>

Nein, Sie müssen alle Workflow-Definitionsdateien in dem `.codecatalyst/workflows` Ordner oder in Unterordnern dieses Ordners speichern. Wenn Sie ein Mono-Repo mit mehreren logischen Projekten verwenden, platzieren Sie alle Ihre Workflow-Definitionsdateien in dem `.codecatalyst/workflows` Ordner oder einem seiner Unterordner und verwenden Sie dann das Feld **Geänderte Dateien** (visueller Editor) oder die `FilesChanged` Eigenschaft (YAML-Editor) in einem Trigger, um den Workflow automatisch an einem bestimmten Projektpfad auszulösen. Weitere Informationen erhalten Sie unter [Hinzufügen von Triggern zu Workflows](workflows-add-trigger-add.md) und [Beispiel: Ein Trigger mit einem Push, Branches und Dateien](workflows-add-trigger-examples.md#workflows-add-trigger-examples-push-multi).

## Wie füge ich meinem Workflow nacheinander Aktionen hinzu?
<a name="troubleshooting-workflows-visual"></a>

Wenn Sie Ihrem Workflow eine Aktion hinzufügen, hat diese standardmäßig keine Abhängigkeiten und wird parallel zu anderen Aktionen ausgeführt.

Wenn Sie Aktionen der Reihe nach anordnen möchten, können Sie eine Abhängigkeit von einer anderen Aktion festlegen, indem Sie das `DependsOn` Feld festlegen. Sie können eine Aktion auch so konfigurieren, dass sie Artefakte oder Variablen verwendet, die Ergebnisse anderer Aktionen sind. Weitere Informationen finden Sie unter [Aktionen sequenzieren](workflows-depends-on.md).

## Warum wird mein Workflow erfolgreich validiert, schlägt aber zur Laufzeit fehl?
<a name="troubleshooting-workflows-validation"></a>

Wenn Sie Ihren Workflow mit der `Validate` Schaltfläche validiert haben, Ihr Workflow aber trotzdem fehlgeschlagen ist, kann das an einer Einschränkung des Validators liegen.

Fehler in Bezug auf eine CodeCatalyst Ressource wie Geheimnisse, Umgebungen oder Flotten in der Workflow-Konfiguration werden bei einem Commit nicht registriert. Wenn ungültige Verweise verwendet werden, wird der Fehler nur erkannt, wenn ein Workflow ausgeführt wird. Ebenso werden Fehler in Ihrer Aktionskonfiguration, wie z. B. das Fehlen eines erforderlichen Felds oder Tippfehler in den Aktionsattributen, erst erkannt, wenn der Workflow ausgeführt wird. Weitere Informationen finden Sie unter [Einen Workflow erstellen](workflows-create-workflow.md).

## Die automatische Erkennung erkennt keine Berichte für meine Aktion
<a name="troubleshooting-reports-auto-discovery"></a>

**Problem:** Ich habe Autodiscovery für eine Aktion konfiguriert, die Tests ausführt, aber es werden keine Berichte von CodeCatalyst erkannt.

**Mögliche Lösungen:** Dies kann durch eine Reihe von Problemen verursacht werden. Probieren Sie eine oder mehrere der folgenden Lösungen aus:
+ Stellen Sie sicher, dass das zum Ausführen von Tests verwendete Tool Ausgaben in einem der Formate erzeugt, die ich CodeCatalyst verstehe. Wenn Sie beispielsweise zulassen CodeCatalyst möchten, dass Berichte `pytest` zur Test- und Codeabdeckung erkannt werden, geben Sie die folgenden Argumente an:

  ```
  --junitxml=test_results.xml --cov-report xml:test_coverage.xml
  ```

  Weitere Informationen finden Sie unter [Typen von Qualitätsberichten](test-workflow-actions.md#test-reporting).
+ Stellen Sie sicher, dass die Dateierweiterungen für die Ausgaben dem ausgewählten Format entsprechen. Wenn Sie beispielsweise so konfigurieren`pytest`, dass Ergebnisse im `JUnitXML` Format angezeigt werden, überprüfen Sie, ob die Dateierweiterung lautet`.xml`. Weitere Informationen finden Sie unter [Typen von Qualitätsberichten](test-workflow-actions.md#test-reporting).
+ Stellen Sie sicher, dass `IncludePaths` es so konfiguriert ist, dass es das gesamte Dateisystem (`**/*`) einschließt, es sei denn, Sie schließen absichtlich bestimmte Ordner aus. Achten Sie auch darauf, dass `ExcludePaths` Sie keine Verzeichnisse ausschließen, in denen sich Ihre Berichte voraussichtlich befinden werden.
+ Wenn Sie einen Bericht manuell für die Verwendung einer bestimmten Ausgabedatei konfiguriert haben, wird er von der automatischen Erkennung ausgeschlossen. Weitere Informationen finden Sie unter [YAML-Beispiel für Qualitätsberichte](test-config-action.md#test.success-criteria-example).
+ Die automatische Erkennung findet möglicherweise keine Berichte, da die Aktion fehlgeschlagen ist, bevor Ausgaben generiert wurden. Beispielsweise ist der Build möglicherweise fehlgeschlagen, bevor Komponententests ausgeführt wurden.

## Meine Aktion schlägt bei automatisch erkannten Berichten fehl, nachdem ich Erfolgskriterien konfiguriert habe
<a name="troubleshooting-success-auto-discovery"></a>

**Problem:** Wenn ich die automatische Erkennung aktiviere und Erfolgskriterien konfiguriere, erfüllen einige Berichte die Erfolgskriterien nicht und die Aktion schlägt daher fehl.

**Mögliche Lösungen:** Versuchen Sie eine oder mehrere der folgenden Lösungen, um dieses Problem zu beheben:
+ Ändern Sie Berichte`ExcludePaths`, an denen Sie nicht interessiert sind, `IncludePaths` oder schließen Sie sie aus.
+ Aktualisieren Sie die Erfolgskriterien, damit alle Berichte erfolgreich sind. Wenn beispielsweise zwei Berichte gefunden wurden, von denen einer eine Leitungsabdeckung von 50% und der andere von 70% aufweist, passen Sie die Mindestleitungsabdeckung auf 50% an. Weitere Informationen finden Sie unter [Erfolgskriterien](test-best-practices.md#test.best-success-criteria).
+ Verwandeln Sie den fehlgeschlagenen Bericht in einen manuell konfigurierten Bericht. Auf diese Weise können Sie verschiedene Erfolgskriterien für diesen bestimmten Bericht konfigurieren. Weitere Informationen finden Sie unter [Erfolgskriterien für Berichte konfigurieren](test-config-action.md#test.success-criteria).

## Autodiscovery generiert Berichte, die ich nicht haben möchte
<a name="troubleshooting-unwanted-auto-discovery"></a>

**Problem:** Wenn ich die automatische Erkennung aktiviere, werden Berichte generiert, die ich nicht möchte. CodeCatalyst Generiert beispielsweise Berichte zur Codeabdeckung für Dateien, die in den Abhängigkeiten meiner Anwendung enthalten sind, die in `node_modules` gespeichert sind.

**Mögliche Lösungen:** Sie können die `ExcludePaths` Konfiguration so anpassen, dass unerwünschte Dateien ausgeschlossen werden. Um beispielsweise auszuschließen`node_modules`, fügen Sie hinzu`node_modules/**/*`. Weitere Informationen finden Sie unter [Pfade einschließen/ausschließen](test-best-practices.md#test.best-include-exclude).

## Auto-Discovery generiert viele kleine Berichte für ein einzelnes Test-Framework
<a name="troubleshooting-reports-combined"></a>

**Problem:** Bei der Verwendung bestimmter Frameworks für Test- und Codeabdeckungsberichte habe ich festgestellt, dass Autodiscovery eine große Anzahl von Berichten generiert. Wenn Sie beispielsweise das [Maven Surefire-Plugin](https://maven.apache.org/surefire/maven-surefire-plugin/) verwenden, erstellt die automatische Erkennung für jede Testklasse einen anderen Bericht. 

**Mögliche Korrekturen:** Ihr Framework kann möglicherweise Ausgaben in einer einzigen Datei zusammenfassen. Wenn Sie beispielsweise das Maven Surefire Plugin verwenden, können Sie es verwenden, um die Dateien `npx junit-merge` manuell zu aggregieren. Der vollständige Ausdruck könnte so aussehen:

```
mvn test; cd test-package-path/surefire-reports && npx junit-merge -d ./ && rm *Test.xml
```

## Die unter aufgeführten Workflows stimmen CI/CD nicht mit denen im Quell-Repository überein
<a name="troubleshooting-workflow-source"></a>

**Problem:** Die auf der Seite **CI/CD**, Workflows angezeigten **Workflows** stimmen nicht mit denen im `~/.codecatalyst/workflows/` Ordner in Ihrem [Quell-Repository](source.md) überein. Möglicherweise sehen Sie die folgenden Diskrepanzen:
+ Ein Workflow wird auf der **Workflow-Seite** angezeigt, aber eine entsprechende Workflow-Definitionsdatei ist in Ihrem Quell-Repository nicht vorhanden.
+ In Ihrem Quell-Repository ist eine Workflow-Definitionsdatei vorhanden, aber ein entsprechender Workflow wird nicht auf der **Workflow-Seite** angezeigt.
+ Ein Workflow ist sowohl im Quell-Repository als auch auf der **Workflow-Seite** vorhanden, aber die beiden sind unterschiedlich.

Dieses Problem kann auftreten, wenn die **Workflow-Seite** nicht aktualisiert werden konnte oder wenn ein Workflow-Kontingent überschritten wurde.

**Mögliche Lösungen:**
+ Warten Sie. Normalerweise müssen Sie nach einem Commit an die Quelle zwei oder drei Sekunden warten, bis Sie die Änderung auf der **Workflow-Seite** sehen.
+ Wenn Sie ein Workflow-Kontingent überschritten haben, gehen Sie wie folgt vor:
**Anmerkung**  
Um festzustellen, ob ein Workflow-Kontingent überschritten wurde[Kontingente für Workflows in CodeCatalyst](workflows-quotas.md), überprüfen Sie die dokumentierten Kontingente und vergleichen Sie sie mit den Workflows in Ihrem Quell-Repository oder auf der **Workflow-Seite**. Es gibt keine Fehlermeldung, die darauf hinweist, dass ein Kontingent überschritten wurde. Sie müssen es also selbst untersuchen.
  + Wenn Sie die **maximale Anzahl von Workflows pro Speicherkontingent** überschritten haben, löschen Sie einige Workflows und führen Sie dann einen Test-Commit anhand der Workflow-Definitionsdatei durch. Ein Beispiel für ein Test-Commit könnte darin bestehen, der Datei ein Leerzeichen hinzuzufügen.
  + Wenn Sie das Kontingent für die **maximale Größe der Workflow-Definitionsdatei** überschritten haben, ändern Sie die Länge der Workflow-Definitionsdatei.
  + Wenn Sie die **maximale Anzahl von Workflow-Dateien, die in einer einzelnen Quelle verarbeitet werden, überschritten haben,** führen Sie mehrere Test-Commits durch. Ändern Sie weniger als die maximale Anzahl von Workflows pro Commit.

## Ich kann keine Workflows erstellen oder aktualisieren
<a name="troubleshooting-workflows-branchrules"></a>

**Problem:** Ich möchte einen Workflow erstellen oder aktualisieren, erhalte aber eine Fehlermeldung, wenn ich versuche, die Änderung zu übernehmen.

**Mögliche Lösungen:** Abhängig von Ihrer Rolle im Projekt oder Space sind Sie möglicherweise nicht berechtigt, Code in Quell-Repositorys im Projekt zu pushen. Die YAML-Dateien für Workflows werden in Repositorys gespeichert. Weitere Informationen finden Sie unter [Workflow-Definitionsdateien](workflows-concepts.md#workflows-concepts-workflows-def). Die Rollen „**Space-Administrator**“, „**Projektadministrator**“ und „**Mitwirkender**“ sind alle berechtigt, Code in Repositorys in einem Projekt zu übertragen und dort per Push zu speichern.

Wenn Sie die Rolle **Mitwirkender** haben, aber in einem bestimmten Branch keine Änderungen an Workflow-YAML erstellen oder übernehmen können, ist möglicherweise für diesen Branch eine Branch-Regel konfiguriert, die verhindert, dass Benutzer mit dieser Rolle Code in diesen bestimmten Branch pushen. Versuchen Sie, einen Workflow in einem anderen Zweig zu erstellen oder Ihre Änderungen an einen anderen Zweig zu übertragen. Weitere Informationen finden Sie unter [Zulässige Aktionen für einen Branch mit Branch-Regeln verwalten](source-branches-branch-rules.md).

# Behebung von Problemen mit Problemen
<a name="troubleshooting-issues"></a>

Die folgenden Informationen können Ihnen helfen, häufig auftretende Probleme mit Problemen in zu beheben CodeCatalyst.

**Topics**
+ [Ich kann keinen Beauftragten für mein Problem auswählen](#troubleshooting-issues-assignees)

## Ich kann keinen Beauftragten für mein Problem auswählen
<a name="troubleshooting-issues-assignees"></a>

**Problem:** Beim Erstellen eines Problems ist die Liste der Verantwortlichen leer.

**Mögliche Lösungen:** Die Liste der Beauftragten ist direkt mit den CodeCatalyst Benutzern verknüpft, die als Mitglieder für das Projekt aufgeführt sind. **Um zu überprüfen, ob der Zugriff auf das Benutzerprofil ordnungsgemäß funktioniert, wählen Sie das Profilsymbol und dann Benutzerprofil aus.** Wenn die Benutzerprofilinformationen nicht angezeigt werden, überprüfen Sie den Statusbericht auf Vorfälle. Wenn er ausgefüllt wird, reichen Sie ein Serviceticket ein.

# Behebung von Problemen mit der Suche in CodeCatalyst
<a name="troubleshooting-search"></a>

Lesen Sie die folgenden Abschnitte, um Probleme im Zusammenhang mit der Suche in zu beheben CodeCatalyst. Weitere Informationen zu Workflows finden Sie unter [Suchen Sie nach Code, Problemen, Projekten und Benutzern in CodeCatalystSuchen Sie nach Code, Problemen, Projekten und Benutzern](search.md).

**Topics**
+ [Ich kann in meinem Projekt keinen Benutzer finden](#troubleshooting-search-users)
+ [Ich sehe in meinem Projekt oder Bereich nicht, wonach ich suche](#troubleshooting-missing-results)
+ [Die Anzahl der Suchergebnisse ändert sich ständig, wenn ich durch die Seiten navigiere](#troubleshooting-search-results)
+ [Meine Suchabfrage wird nicht abgeschlossen](#troubleshooting-requests-limits)

## Ich kann in meinem Projekt keinen Benutzer finden
<a name="troubleshooting-search-users"></a>

**Problem:** Wenn ich versuche, die Details eines Benutzers anzuzeigen, sehe ich seine Informationen nicht im Projekt.

**Mögliche Korrekturen:** Die Suche unterstützt derzeit nicht die Suche nach Benutzern innerhalb eines Projekts. Um nach Benutzern zu suchen, die Zugriff auf Ihren Bereich haben, wechseln Sie zu **Dieser Bereich** in oder entfernen Sie alle Projektfilter QuickSearch, die Sie möglicherweise mithilfe der erweiterten Abfragesprache angegeben haben.

## Ich sehe in meinem Projekt oder Bereich nicht, wonach ich suche
<a name="troubleshooting-missing-results"></a>

**Problem:** Wenn ich versuche, nach bestimmten Informationen zu suchen, werden keine Ergebnisse angezeigt.

**Mögliche Lösungen:** Es dauert wahrscheinlich einige Sekunden, bis Inhaltsaktualisierungen in den Suchergebnissen aktualisiert werden. Umfangreiche Updates können mehrere Minuten dauern.

Bei Ressourcen, die in letzter Zeit nicht aktualisiert wurden, müssen Sie möglicherweise Ihre Suche verfeinern. Sie können Ihre Suche verfeinern, indem Sie weitere Stichwörter hinzufügen oder die erweiterte Abfragesprache verwenden. Weitere Informationen zur Verfeinerung Ihrer Abfragen finden Sie unter[Verfeinern Sie Ihre Suchabfrage](search.md#search-query-language-examples).

## Die Anzahl der Suchergebnisse ändert sich ständig, wenn ich durch die Seiten navigiere
<a name="troubleshooting-search-results"></a>

**Problem:** Die Anzahl der Suchergebnisse scheint sich zu ändern, wenn ich zur nächsten Seite gehe, sodass nicht klar ist, wie viele Ergebnisse es insgesamt gibt.

**Mögliche Lösungen:** Wenn Sie durch Seiten mit Suchergebnissen navigieren, sehen Sie möglicherweise eine Änderung der Anzahl der Suchergebnisse, die Ihrer Anfrage entsprechen. Die Anzahl der Ergebnisse wird möglicherweise aktualisiert, um eine genauere Anzahl der Treffer wiederzugeben, die beim Navigieren durch die Seiten gefunden wurden.

Wenn Sie durch die Ergebnisse navigieren, wird möglicherweise die folgende Meldung angezeigt: **Keine Ergebnisse für „Test“**. Sie erhalten die Nachricht, wenn Sie keinen Zugriff auf die verbleibenden Ergebnisse haben.

## Meine Suchabfrage wird nicht abgeschlossen
<a name="troubleshooting-requests-limits"></a>

**Problem:** Die Ergebnisse meiner Suchabfrage werden nicht angezeigt und es scheint zu lange zu dauern.

**Mögliche Lösungen:** Ihre Suche wird möglicherweise nicht abgeschlossen, wenn in dem Bereich viele Suchanfragen gleichzeitig durchgeführt werden, entweder programmgesteuert oder aufgrund hoher Teamaktivität. Wenn Sie programmatische Suchen ausführen, pausieren oder reduzieren Sie sie. Andernfalls versuchen Sie es in ein paar Sekunden erneut.

# Behebung von Problemen mit Erweiterungen
<a name="troubleshooting-extensions"></a>

In den folgenden Abschnitten finden Sie Informationen zur Behebung von Problemen im Zusammenhang mit Erweiterungen in CodeCatalyst. Weitere Informationen zu Erweiterungen finden Sie unter [Fügen Sie Funktionen zu Projekten mit Erweiterungen hinzu in CodeCatalystFügen Sie Funktionen zu Projekten mit Erweiterungen hinzu](extensions.md).

**Topics**
+ [Ich kann die Änderungen an verknüpften Drittanbieter-Repositorys nicht sehen und auch nicht nach Ergebnissen dieser Änderungen suchen](#troubleshooting-detect-3p-changes)

## Ich kann die Änderungen an verknüpften Drittanbieter-Repositorys nicht sehen und auch nicht nach Ergebnissen dieser Änderungen suchen
<a name="troubleshooting-detect-3p-changes"></a>

**Problem:** Die Änderungen in meinem Drittanbieter-Repository werden nicht in angezeigt. CodeCatalyst

**Mögliche Korrekturen:** Unterstützt CodeCatalyst derzeit nicht die Erkennung von Änderungen im Standard-Branch für verknüpfte Repositorys. Um den Standard-Branch für ein verknüpftes Repository zu ändern, musst du zuerst die Verknüpfung mit dem Repository CodeCatalyst aufheben, den Standard-Branch ändern und ihn dann erneut verknüpfen. Weitere Informationen finden Sie unter [Verknüpfen von GitHub Repositorys, Bitbucket-Repositorys, GitLab Projekt-Repositorys und Jira-Projekten in CodeCatalyst](extensions-link.md).

# Behebung von Problemen mit Konten, die mit deinem Bereich verknüpft sind
<a name="troubleshooting-connections"></a>

In CodeCatalyst können Sie Ihrem Bereich eine hinzufügen AWS-Konto , um Berechtigungen für Ressourcen zu erteilen und zu Abrechnungszwecken. Die folgenden Informationen können Ihnen helfen, häufig auftretende Probleme mit zugehörigen Konten in zu beheben CodeCatalyst.

**Topics**
+ [Bei meiner AWS-Konto Verbindungsanfrage wird der Fehler „Ungültiges Token“ angezeigt](#troubleshooting-connection-token)
+ [Mein CodeCatalyst Amazon-Projekt-Workflow schlägt mit einem Fehler für das konfigurierte Konto, die Umgebung oder die IAM-Rolle fehl](#connections-troubleshoot-workflow)
+ [Ich benötige ein zugehöriges Konto, eine zugehörige Rolle und eine zugehörige Umgebung, um ein Projekt zu erstellen](#connections-troubleshoot-environment)
+ [Ich kann nicht auf die Amazon CodeCatalyst Spaces-Seite in der AWS-Managementkonsole](#connections-troubleshoot-console)
+ [Ich möchte ein anderes Konto als mein Rechnungskonto](#connections-troubleshoot-billing)
+ [Mein Projekt-Workflow schlägt mit einem Fehler beim Verbindungsnamen fehl](#connections-troubleshoot-restriction)

## Bei meiner AWS-Konto Verbindungsanfrage wird der Fehler „Ungültiges Token“ angezeigt
<a name="troubleshooting-connection-token"></a>

**Problem:** Beim Erstellen einer Verbindungsanfrage mit einem Verbindungstoken akzeptiert die Seite das Token nicht und es wird ein Fehler angezeigt, der besagt, dass das Token nicht gültig ist.

**Mögliche Lösungen:** Stellen Sie sicher, dass Sie die Konto-ID angeben, die Sie Ihrem Bereich hinzufügen möchten. Sie müssen über Administratorrechte verfügen AWS-Konto oder in der Lage sein, mit Ihrem Administrator zusammenzuarbeiten, um das Konto hinzuzufügen.

Wenn Sie das Konto verifizieren möchten, öffnet sich ein neues Browserfenster im AWS-Managementkonsole. Das gleiche Konto muss auf der Konsolenseite angemeldet sein. Versuchen Sie es erneut, nachdem Sie Folgendes überprüft haben:
+ Sie sind AWS-Managementkonsole mit demselben Konto angemeldet AWS-Konto , das Sie Ihrem Bereich hinzufügen möchten.
+ Sie sind im angemeldet und die AWS-Managementkonsole Region ist auf die richtige Region für Ihren Bereich eingestellt.
+ Wenn du von der Abrechnungsseite gekommen bist und das AWS-Konto angegebene Rechnungskonto für deine Unterkunft hinzufügen möchtest, vergewissere dich, dass das Konto das Kontingent als Rechnungskonto für einen oder mehrere andere Bereiche nicht erreicht hat.

## Mein CodeCatalyst Amazon-Projekt-Workflow schlägt mit einem Fehler für das konfigurierte Konto, die Umgebung oder die IAM-Rolle fehl
<a name="connections-troubleshoot-workflow"></a>

**Problem:** Wenn der Workflow ausgeführt wird und kein konfiguriertes Konto oder keine mit Ihrem Bereich verknüpften IAM-Rollen gefunden werden, müssen Sie die Felder Rolle, Verbindung und Umgebung manuell im Workflow-YAML ausfüllen. Sehen Sie sich die fehlgeschlagene Workflow-Aktion an und notieren Sie, ob die Fehlermeldungen wie folgt lauten: 
+ Die Rolle ist nicht für die Verwendung mit der Verbindung verfügbar, die der Umgebung zugeordnet ist.
+ Die Aktion war nicht erfolgreich. Status: FEHLGESCHLAGEN; Der angegebene Wert für die Kontoverbindung oder Umgebung ist nicht gültig. Stellen Sie sicher, dass die Verbindung mit Ihrem Bereich und die Umgebung mit Ihrem Projekt verknüpft ist.
+ Die Aktion war nicht erfolgreich. Status: FEHLGESCHLAGEN; Der angegebene Wert für die IAM-Rolle ist nicht gültig. Stellen Sie sicher, dass der Name existiert, die IAM-Rolle zu Ihrer Kontoverbindung hinzugefügt wurde und die Verbindung bereits mit Ihrem CodeCatalyst Amazon-Bereich verknüpft ist

**Mögliche Lösungen:** [Stellen Sie sicher, dass die Workflow-YAML-Felder korrekte Werte für [Umgebung](build-action-ref.md#build.environment), [Verbindungen](build-action-ref.md#build.environment.connections) und Rolle enthalten.](build-action-ref.md#build.environment.connections.role) Bei den CodeCatalyst Workflow-Aktionen, für die eine Umgebung erforderlich ist, handelt es sich um Build- oder Deployment-Aktionen, die AWS Ressourcen ausführen oder AWS Ressourcenstapel generieren.

Wählen Sie den fehlgeschlagenen Workflow-Aktionsblock und dann **Visual** aus. Wählen Sie die Registerkarte **Konfiguration** aus. Wenn die Felder **Umgebung**, **Verbindungsname** **und Rollenname** nicht ausgefüllt sind, müssen Sie den Workflow manuell aktualisieren. Gehen Sie wie folgt vor, um Ihr Workflow-YAML zu bearbeiten:
+ Erweitern Sie das `/.codecatalyst` Verzeichnis und dann das `/workflows` Verzeichnis. Öffnen Sie die Workflow-YAML-Datei. Stellen Sie sicher, dass die IAM-Rollen und Kontoinformationen in der YAML angegeben sind, die Sie für Ihren Workflow konfiguriert haben. Beispiel: 

  ```
  Actions:
    cdk_bootstrap:
      Identifier: action-@v1
      Inputs:
        Sources:
          - WorkflowSource
      Environment:
        Name: Staging
        Connections:
          - Name: account-connection
            Role: build-role
  ```

  Die Eigenschaften „**Umgebung“, „Verbindung“ und „Rolle“ sind erforderlich,** um CodeCatalyst Workflow-Build- und Bereitstellungsaktionen mit AWS Ressourcen auszuführen. Ein Beispiel finden Sie in den YAML-Parametern der CodeCatalyst Build-Aktionsreferenz für [Environment](build-action-ref.md#build.environment), [Connections](build-action-ref.md#build.environment.connections) und [Role](build-action-ref.md#build.environment.connections.role).
+ Vergewissern Sie sich, dass Ihrem Bereich ein Konto hinzugefügt wurde, und stellen Sie sicher, dass dem Konto die entsprechende IAM-Rolle oder Rollen hinzugefügt wurden. Sie können Konten anpassen oder hinzufügen, wenn Sie die Rolle eines **Space-Administrators** haben. Weitere Informationen finden Sie unter [Ermöglichen des Zugriffs auf AWS Ressourcen mit verbundenen AWS-Konten](ipa-connect-account.md).

## Ich benötige ein zugehöriges Konto, eine zugehörige Rolle und eine zugehörige Umgebung, um ein Projekt zu erstellen
<a name="connections-troubleshoot-environment"></a>

**Problem:** In den Optionen zur Projekterstellung ist für mein Projekt entweder kein zusätzliches Konto in meinem Bereich verfügbar, oder ich benötige ein weiteres Konto, das meinem Bereich hinzugefügt werden muss, damit mein Projekt verwendet werden kann.

**Mögliche Lösungen:** Für deinen Bereich kannst du autorisierte Personen hinzufügen, die sie AWS-Konten zu deinem Projekt hinzufügen dürfen, wenn du die Rolle eines **Space-Administrators** hast. Du benötigst außerdem einen AWS-Konto Ort, an dem du über Administratorrechte verfügst oder mit deinem AWS Administrator zusammenarbeiten kannst.

Um sicherzustellen, dass ein Konto und eine Rolle auf dem Bildschirm zur Projekterstellung verfügbar sind, müssen Sie zuerst das Konto und die Rollen hinzufügen. Weitere Informationen finden Sie unter [Ermöglichen des Zugriffs auf AWS Ressourcen mit verbundenen AWS-Konten](ipa-connect-account.md).

Sie haben die Möglichkeit, eine Servicerolle mit einer Rollenrichtlinie zu erstellen, die als **CodeCatalystWorkflowDevelopmentRole-*spaceName***Rollenrichtlinie bezeichnet wird. Der Rolle wird ein Name `CodeCatalystWorkflowDevelopmentRole-spaceName` mit einer angehängten eindeutigen Kennung zugewiesen. Weitere Informationen zur Rolle und zur Rollenrichtlinie finden Sie unter[Grundlegendes zur **CodeCatalystWorkflowDevelopmentRole-*spaceName***Servicerolle](ipa-iam-roles.md#ipa-iam-roles-service-role). Die Schritte zum Erstellen der Rolle finden Sie unter[Die **CodeCatalystWorkflowDevelopmentRole-*spaceName***Rolle für Ihr Konto und Ihren Bereich erstellen](ipa-iam-roles.md#ipa-iam-roles-service-create). Die Rolle wird Ihrem Konto hinzugefügt und ist auf den Seiten zur Projekterstellung in verfügbar CodeCatalyst.

## Ich kann nicht auf die Amazon CodeCatalyst Spaces-Seite in der AWS-Managementkonsole
<a name="connections-troubleshoot-console"></a>

**Problem:** Wenn ich versuche, auf die CodeCatalyst Amazon-Seite in zuzugreifen AWS-Managementkonsole , um meinem CodeCatalyst Bereich ein Konto hinzuzufügen oder Rollen zu einem Konto hinzuzufügen AWS, erhalte ich einen Berechtigungsfehler.

**Mögliche Lösungen:**

Für Ihren Bereich können Sie Autorisierte hinzufügen, um sie AWS-Konten zu Ihrem Projekt hinzuzufügen, sofern Sie die Rolle eines **Space-Administrators** haben. Sie müssen auch über einen Bereich verfügen AWS-Konto , in dem Sie über Administratorrechte verfügen oder mit Ihrem AWS Administrator zusammenarbeiten können. Sie müssen zunächst sicherstellen, dass Sie AWS-Managementkonsole mit demselben Konto angemeldet sind, das Sie verwalten möchten. Nachdem Sie sich bei angemeldet haben AWS-Managementkonsole, können Sie die Konsole öffnen und es erneut versuchen.

Die CodeCatalyst Amazon-Seite AWS-Managementkonsole zu [https://us-west-2.console.aws.amazon.com/codecatalyst/Hause öffnen? region=us-west-2\$1/](https://us-west-2.console.aws.amazon.com/codecatalyst/home?region=us-west-2#/).

## Ich möchte ein anderes Konto als mein Rechnungskonto
<a name="connections-troubleshoot-billing"></a>

**Problem:** Bei der Einrichtung meines CodeCatalyst Logins habe ich mehrere Schritte ausgeführt, um meinen Bereich einzurichten und eine autorisierte Person zuzuordnen AWS-Konto. Jetzt möchte ich ein anderes Konto für die Abrechnung autorisieren.

**Mögliche Lösungen:** Für deinen Space kannst du Rechnungskonten autorisieren, wenn du die Rolle eines **Space-Administrators** hast. Du benötigst außerdem einen AWS-Konto , in dem du über Administratorrechte verfügst oder mit deinem AWS Administrator zusammenarbeiten kannst.

Weitere Informationen finden Sie unter [Abrechnung verwalten](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing.html) im CodeCatalyst Amazon-Administratorhandbuch.

## Mein Projekt-Workflow schlägt mit einem Fehler beim Verbindungsnamen fehl
<a name="connections-troubleshoot-restriction"></a>

**Problem:** Wenn Sie ein Projekt erstellen und dann den Projekt-Workflow ausführen, schlägt der Workflow fehl und es wird ein Fehler angezeigt, der besagt, dass der Verbindungsname ungültig ist, und zwar wie folgt:

Fehlgeschlagen bei: Der Verbindungsname ist ungültig. <action\$1name>

**Mögliche Lösungen:** Stellen Sie sicher, dass Sie die Konto-ID angeben, die Sie Ihrem Bereich hinzufügen möchten, und stellen Sie sicher, dass das Konto nicht für projektbeschränkte Kontoverbindungen aktiviert ist. Wenn das Konto für projektbeschränkte Kontoverbindungen aktiviert ist, müssen Sie möglicherweise die Kontoverbindung aktualisieren, indem Sie den Zugriff auf das neue Projekt aktivieren. Weitere Informationen finden Sie unter [Konfiguration von projektbeschränkten Kontoverbindungen](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts.html#managing-accounts-restriction).

# Behebung von Problemen zwischen Amazon CodeCatalyst und dem AWS SDKs oder dem AWS CLI
<a name="troubleshooting-cli-sdk"></a>

Die folgenden Informationen können Ihnen helfen, häufig auftretende Probleme bei der Arbeit mit CodeCatalyst und dem AWS CLI oder dem zu beheben AWS SDKs.

**Topics**
+ [Ich erhalte eine Fehlermeldung, wenn ich **aws codecatalyst** in einer Befehlszeile oder im Terminal eingebe, dass es sich um eine ungültige Auswahl handelt](#cli-sdk-troubleshoot-no-commands)
+ [Ich erhalte einen Anmeldeinformationsfehler, wenn ich **aws codecatalyst** Befehle ausführe](#cli-sdk-troubleshoot-profile)

## Ich erhalte eine Fehlermeldung, wenn ich **aws codecatalyst** in einer Befehlszeile oder im Terminal eingebe, dass es sich um eine ungültige Auswahl handelt
<a name="cli-sdk-troubleshoot-no-commands"></a>

**Problem:** Wenn ich versuche, with AWS CLI zu verwenden CodeCatalyst, werden einer oder mehrere **aws codecatalyst** Befehle nicht als gültig erkannt.

**Lösung:** Die häufigste Ursache für dieses Problem ist, dass Sie eine Version von verwenden AWS CLI , die nicht die neuesten Updates für die neuesten Dienste und Befehle enthält. Aktualisieren Sie Ihre Installation von AWS CLI und versuchen Sie es erneut. Weitere Informationen finden Sie unter [Einrichtung für die AWS CLI Verwendung von CodeCatalyst](set-up-cli.md).

## Ich erhalte einen Anmeldeinformationsfehler, wenn ich **aws codecatalyst** Befehle ausführe
<a name="cli-sdk-troubleshoot-profile"></a>

**Problem:** Wenn ich versuche, with zu verwenden CodeCatalyst, erhalte ich die Meldung `You can configure credentials by running "aws configure".` oder`Unable to locate authorization token`. AWS CLI 

**Lösung:** Sie müssen ein AWS CLI Profil konfigurieren, um mit CodeCatalyst Befehlen arbeiten zu können. Weitere Informationen finden Sie unter [Einrichtung für die AWS CLI Verwendung von CodeCatalyst](set-up-cli.md).