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.
# Konfiguration einer Dev-Datei für eine Entwicklungsumgebung
Eine *Dev-Datei* ist ein offener Standard, mit dem Sie Ihre Entwicklungsumgebungen in Ihrem Team individuell anpassen können. Eine Dev-Datei ist eine YAML-Datei, die Ihre benötigten Entwicklungstools kodifiziert. Durch die Konfiguration einer Dev-Datei können Sie vorab festlegen, welche Projekttools und Anwendungsbibliotheken Sie benötigen, und Amazon CodeCatalyst installiert sie für Sie in Ihrer Entwicklungsumgebung. Die Dev-Datei ist spezifisch für das Repository, für das sie erstellt wurde, und Sie können für jedes Repository eine separate Dev-Datei erstellen. Ihre Entwicklungsumgebung unterstützt Befehle und Ereignisse und stellt ein standardmäßiges universelles Devfile-Image bereit.
Wenn Sie ein Projekt mit dem leeren Blueprint erstellen, können Sie eine Dev-Datei manuell erstellen. Wenn Sie ein Projekt mit einem anderen Blueprint erstellen, CodeCatalyst wird automatisch eine Dev-Datei erstellt. Das `/projects` Verzeichnis einer Entwicklungsumgebung speichert die Dateien, die aus dem Quell-Repository und der Dev-Datei abgerufen werden. Das `/home` Verzeichnis, das leer ist, wenn Sie zum ersten Mal eine Entwicklungsumgebung erstellen, speichert die Dateien, die Sie während der Verwendung Ihrer Entwicklungsumgebung erstellen. Alles in den `/home` Verzeichnissen `/projects` und einer Entwicklungsumgebung wird persistent gespeichert.
**Anmerkung**
Der `/home` Ordner ändert sich nur, wenn Sie den Namen der Dev-Datei oder der Devfile-Komponente ändern. Wenn Sie den Namen der Devfile- oder Devfile-Komponente ändern, wird der Inhalt des `/home` Verzeichnisses ersetzt und Ihre vorherigen `/home` Verzeichnisdaten können nicht wiederhergestellt werden.
Wenn Sie eine Entwicklungsumgebung mit einem Quell-Repository erstellen, das keine Dev-Datei im Stammverzeichnis enthält, oder wenn Sie eine Entwicklungsumgebung ohne Quell-Repository erstellen, wird automatisch eine standardmäßige universelle Dev-Datei auf das Quell-Repository angewendet. Für alle wird dasselbe standardmäßige universelle Devfile-Image verwendet. IDEs CodeCatalyst unterstützt derzeit die Devfile-Version 2.0.0. Weitere Informationen zur Dev-Datei finden Sie unter [Devfile-Schema — Version 2.0.0](https://devfile.io/docs/2.0.0/devfile-schema).
**Anmerkung**
Sie können nur öffentliche Container-Images in Ihre Devfile-Datei aufnehmen.
Beachten Sie, dass VPC-verbundene Entwicklungsumgebungen nur die folgenden Devfile-Images unterstützen:
+ Universelles Image
+ Private Amazon ECR-Images, wenn sich das Repository in derselben Region wie die VPC befindet
**Topics**
+ [Bearbeiten einer Repository-Dev-Datei für eine Entwicklungsumgebung](devenvironment-devfile-moving.md)
+ [Devfile-Funktionen werden unterstützt von CodeCatalyst](#devenvironment-devfile-support)
+ [Beispiel für eine Dev-Datei für eine Entwicklungsumgebung](#devenvironment-devfile-example)
+ [Fehlerbehebung bei einer Repository-Dev-Datei im Wiederherstellungsmodus](#devenvironment-devfile-recovery)
+ [Spezifizierung universeller Devfile-Images für eine Entwicklungsumgebung](devenvironment-universal-image.md)
+ [Devfile-Befehle](devenvironment-devfile-commands.md)
+ [Devfile-Ereignisse](devenvironment-devfile-events.md)
+ [Devfile-Komponenten](devenvironment-devfile-components.md)
## Devfile-Funktionen werden unterstützt von CodeCatalyst
CodeCatalyst unterstützt die folgenden Devfile-Funktionen in Version 2.0.0. Weitere Informationen zur Dev-Datei finden Sie unter [Devfile-Schema — Version 2.0.0](https://devfile.io/docs/2.0.0/devfile-schema).
| Feature | Typ |
| --- | --- |
| `exec` | Befehl |
| `postStart` | Veranstaltung |
| `container` | Komponente |
| `args` | Eigenschaften der Komponenten |
| `env` | Eigenschaften der Komponenten |
| `mountSources` | Eigenschaften der Komponenten |
| `volumeMounts` | Eigenschaften der Komponenten |
## Beispiel für eine Dev-Datei für eine Entwicklungsumgebung
Das Folgende ist ein Beispiel für eine einfache Dev-Datei.
```
schemaVersion: 2.0.0
metadata:
name: al2
components:
- name: test
container:
image: public.ecr.aws/amazonlinux/amazonlinux:2
mountSources: true
command: ['sleep', 'infinity']
- name: dockerstore
commands:
- id: setupscript
exec:
component: test
commandLine: "chmod +x script.sh"
workingDir: /projects/devfiles
- id: executescript
exec:
component: test
commandLine: "/projects/devfiles/script.sh"
- id: yumupdate
exec:
component: test
commandLine: "yum -y update --security"
events:
postStart:
- setupscript
- executescript
- yumupdate
```
Start-, Befehls- und Ereignisprotokolle von Devfiles werden erfasst und gespeichert in. `/aws/mde/logs` Um das Verhalten von Devfiles zu debuggen, starten Sie Ihre Entwicklungsumgebung mit einer funktionierenden Dev-Datei und greifen Sie auf die Protokolle zu.
## Fehlerbehebung bei einer Repository-Dev-Datei im Wiederherstellungsmodus
Falls es ein Problem gibt, Ihre Dev-Datei zu starten, wechselt sie in den Wiederherstellungsmodus, sodass Sie immer noch 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`.