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 `CLI-Befehl codebuild-tests-run`
<a name="parallel-test-tests-run"></a>

AWS CodeBuild stellt eine CLI bereit, die einen Testbefehl und den Speicherort der Testdatei als Eingabe verwendet. Die CLI mit dieser Eingabe teilt die Tests anhand der Testdateinamen in die im `parallelism` Feld angegebene Anzahl von Shards auf. Die Zuweisung von Testdateien zu 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 aus. Sie können den AWS CodeBuild mitgelieferten [ CLI-Befehl ](parallel-test-glob-search.md) codebuild-glob-search oder ein anderes Dateisuchwerkzeug 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`+  `equal-distribution`: Verteilen Sie Testdateien gleichmäßig auf der Grundlage der Testdateinamen. <br />+  `stability`: Teilen Sie Testdateien mit konsistentem Hashing der Dateinamen. <br />Weitere Informationen finden Sie unter [Über das Teilen von Tests](parallel-test-splitting.md). | 

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

Für Testframeworks, die keine durch Leerzeichen getrennten Listen akzeptieren, bietet die `codebuild-tests-run` CLI über die Umgebungsvariable eine flexible Alternative. `CODEBUILD_CURRENT_SHARD_FILES` 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 problemlos an verschiedene Anforderungen des Testframeworks anpassen und so 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 die von Django unterstützten * Dateipfade mit * Punktnotation abzurufen:

```
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 im Rahmen der `codebuild-tests-run` CLI verwendet werden kann.  
Wenn Sie den Befehl `CODEBUILD_CURRENT_SHARD_FILES` inside test-command verwenden, setzen `CODEBUILD_CURRENT_SHARD_FILES` Sie außerdem doppelte Anführungszeichen, wie im obigen Beispiel gezeigt.