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.

# Verwenden Sie den `codebuild-tests-run` CLI-Befehl
<a name="parallel-test-tests-run"></a>

AWS CodeBuild stellt CLI bereit, die den Testbefehl und den Speicherort der Testdatei als Eingabe verwendet. Die CLI mit diesen Eingaben teilt die Tests in eine Anzahl von Shards auf, wie im `parallelism` Feld angegeben, basierend auf den Testdateinamen. Die Zuweisung der Testdateien zum Shard wird durch die Sharding-Strategie entschieden.

```
codebuild-tests-run \
    --files-search "codebuild-glob-search '**/__tests__/*.js'" \
    --test-command 'npx jest --runInBand --coverage' \
    --sharding-strategy 'equal-distribution'
```

In der folgenden Tabelle werden die Felder für den `codebuild-tests-run` CLI-Befehl beschrieben.


| Feldname | Typ | Erforderlich oder optional | Definition | 
| --- | --- | --- | --- | 
|  `test-command`  |  Zeichenfolge  |  Erforderlich  |  Dieser Befehl wird zum Ausführen der Tests verwendet.  | 
|  `files-search`  |  Zeichenfolge  |  Erforderlich  |  Dieser Befehl gibt eine Liste von Testdateien. Sie können den AWS CodeBuild bereitgestellten [codebuild-glob-search](parallel-test-glob-search.md)CLI-Befehl oder ein anderes Dateisuchtool Ihrer Wahl verwenden.  Stellen Sie sicher, dass der `files-search` Befehl Dateinamen ausgibt, die jeweils durch eine neue Zeile getrennt sind.   | 
|  `sharding-strategy`  |  Enum  |  Optional  |  Zulässige Werte: `equal-distribution` (Standard), `stability` [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/codebuild/latest/userguide/parallel-test-tests-run.html) Weitere Informationen finden Sie unter [Über das Aufteilen von Tests](parallel-test-splitting.md).  | 

Die `codebuild-tests-run` CLI identifiziert zunächst die Liste der Testdateien mithilfe des im `files-search` Parameter angegebenen Befehls. Anschließend bestimmt sie unter Verwendung der angegebenen Sharding-Strategie eine Teilmenge von Testdateien, die für den aktuellen Shard (Umgebung) bestimmt sind. Schließlich wird diese Teilmenge von Testdateien in eine durch Leerzeichen getrennte Liste formatiert und vor der Ausführung an das Ende des im Parameter angegebenen Befehls angehängt. `test-command`

Für Testframeworks, die keine durch Leerzeichen getrennten Listen akzeptieren, bietet die `codebuild-tests-run` CLI über die `CODEBUILD_CURRENT_SHARD_FILES` Umgebungsvariable eine flexible Alternative. Diese Variable enthält eine durch Zeilenumbrüche getrennte Liste von Testdateipfaden, die für den aktuellen Build-Shard bestimmt sind. Durch die Nutzung dieser Umgebungsvariablen können Sie sich leicht an verschiedene Anforderungen des Test-Frameworks anpassen und dabei auch diejenigen berücksichtigen, die Eingabeformate erwarten, die sich von durch Leerzeichen getrennten Listen unterscheiden. Darüber hinaus können Sie die Namen der Testdateien auch gemäß den Anforderungen des Testframeworks formatieren. Das Folgende ist ein Beispiel für die Verwendung von `CODEBUILD_CURRENT_SHARD_FILES` unter Linux mit dem Django-Framework. Hier `CODEBUILD_CURRENT_SHARD_FILES` wird verwendet, um Dateipfade in *Punktnotation* abzurufen, die von Django unterstützt werden:

```
codebuild-tests-run \
    —files-search "codebuild-glob-search '/tests/test_.py'" \
    —test-command 'python3 manage.py test $(echo "$CODEBUILD_CURRENT_SHARD_FILES" | sed -E "s/\//__/g; s/\.py$//; s/__/./g")' \
    —sharding-strategy 'equal-distribution'
```

**Anmerkung**  
Beachten Sie, dass die `CODEBUILD_CURRENT_SHARD_FILES` Umgebungsvariable nur innerhalb des Bereichs der `codebuild-tests-run` CLI verwendet werden kann.  
Wenn Sie den Befehl `CODEBUILD_CURRENT_SHARD_FILES` inside test-command verwenden, setzen Sie ihn außerdem `CODEBUILD_CURRENT_SHARD_FILES` in doppelte Anführungszeichen, wie im obigen Beispiel gezeigt.