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.
# Behebung von Problemen mit Entwicklungsumgebungen
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
**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
**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
**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
**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
**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
**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
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===
```
## Ich kann keine Verbindung zu meiner Entwicklungsumgebung über SSH herstellen, da meine lokale SSH-Konfiguration fehlt
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`
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
**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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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:
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.