Verwenden Sie den codebuild-tests-run CLI-Befehl - AWS CodeBuild

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

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

String

Erforderlich

Dieser Befehl wird zum Ausführen der Tests verwendet.

files-search

String

Erforderlich

Dieser Befehl gibt eine Liste von Testdateien. Sie können den AWS CodeBuild bereitgestellten codebuild-glob-searchCLI-Befehl oder ein anderes Dateisuchtool Ihrer Wahl verwenden.

Anmerkung

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: Teilen Sie Testdateien gleichmäßig auf der Grundlage der Testdateinamen.

  • stability: Shard-Testdateien mit konsistentem Hashing der Dateinamen.

Weitere Informationen finden Sie unter Über das Aufteilen von Tests.

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.