

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