Amazon CodeCatalyst ist nicht mehr offen für neue Kunden. 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
<a name="devenvironment-devfile"></a>

Eine * Devfile * ist ein offener Standard, der Ihnen hilft, Ihre Entwicklungsumgebungen im gesamten Team anzupassen. Ein Devfile ist eine YAML-Datei, die Ihre benötigten Entwicklungstools kodifiziert. Durch die Konfiguration einer Devfile 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 bietet ein standardmäßiges universelles Devfile-Image.

Wenn Sie ein Projekt mit dem leeren Blueprint erstellen, können Sie eine Devfile manuell erstellen. Wenn Sie ein Projekt mit einem anderen Blueprint erstellen, CodeCatalyst wird automatisch eine Entwicklungsdatei 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 erstellen, während Sie Ihre Entwicklungsumgebung verwenden. Alles in den `/home` Verzeichnissen `/projects` und einer Entwicklungsumgebung wird dauerhaft gespeichert.

**Anmerkung**  
Der `/home` Ordner ändert sich nur, wenn Sie den Namen der Devfile- oder 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 Devfile im Stammverzeichnis enthält, oder wenn Sie eine Entwicklungsumgebung ohne Quell-Repository erstellen, wird automatisch eine standardmäßige universelle Devfile auf das Quell-Repository angewendet. Das gleiche universelle Standard-Devfile-Image wird für alle IDEs verwendet. CodeCatalyst unterstützt derzeit die Devfile-Version 2.0.0. Weitere Informationen zur Devfile 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-connected Dev-Umgebungen nur die folgenden Devfile-Images unterstützen:
+ Universelles Bild
+ Private Amazon ECR-Images, wenn sich das Repository in derselben Region wie die VPC befindet

**Topics**
+ [Eine Repository-Devfile für eine Entwicklungsumgebung bearbeiten](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)
+ [Problembehandlung bei einer Repository-Devfile 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
<a name="devenvironment-devfile-support"></a>

CodeCatalyst unterstützt die folgenden Devfile-Funktionen in Version 2.0.0. Weitere Informationen zur Devfile 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 Komponente | 
| `env` | Eigenschaften der Komponente | 
| `mountSources` | Eigenschaften der Komponente | 
| `volumeMounts` | Eigenschaften der Komponente | 

## Beispiel für eine Dev-Datei für eine Entwicklungsumgebung
<a name="devenvironment-devfile-example"></a>

Das Folgende ist ein Beispiel für eine einfache Devfile.

```
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 darin gespeichert. `/aws/mde/logs` Um das Verhalten von Devfiles zu debuggen, starten Sie Ihre Dev-Umgebung mit einer funktionierenden Devfile und greifen Sie auf die Protokolle zu.

## Problembehandlung bei einer Repository-Devfile im Wiederherstellungsmodus
<a name="devenvironment-devfile-recovery"></a>

Wenn beim Starten Ihrer Devfile ein Problem auftritt, wechselt sie in den Wiederherstellungsmodus, sodass Sie immer noch eine Verbindung zu Ihrer Umgebung herstellen und Ihre Devfile reparieren können. Wenn Sie sich im Wiederherstellungsmodus befinden, enthält das Ausführen `/aws/mde/mde status` nicht den Speicherort Ihrer Devfile.

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

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