翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
codebuild-tests-run CLI コマンドを使用する
AWS CodeBuild は、テストコマンドとテストファイルの場所を入力として受け取る CLI を提供します。これらの入力を持つ CLI は、テストファイル名に基づいて、 parallelismフィールドで指定されたシャードの数にテストを分割します。テストファイルのシャードへの割り当ては、シャーディング戦略によって決まります。
codebuild-tests-run \ --files-search "codebuild-glob-search '**/__tests__/*.js'" \ --test-command 'npx jest --runInBand --coverage' \ --sharding-strategy 'equal-distribution'
次の表に、 codebuild-tests-run CLI コマンドのフィールドを示します。
| フィールド名 | タイプ | 必須またはオプション | 定義 |
|---|---|---|---|
|
|
String |
必須 |
このコマンドは、テストの実行に使用されます。 |
|
|
String |
必須 |
このコマンドは、テストファイルのリストを提供します。 AWS CodeBuild 提供されている codebuild-glob-search CLI コマンドまたは任意の他のファイル検索ツールを使用できます。 注記
|
|
|
列挙型 |
オプションです。 |
有効な値:
詳細については、「テスト分割について」を参照してください。 |
CLI は、最初に codebuild-tests-run files-searchパラメータで指定された コマンドを使用してテストファイルのリストを識別します。次に、指定されたシャーディング戦略を使用して、現在のシャード (環境) に指定されたテストファイルのサブセットを決定します。最後に、このテストファイルのサブセットはスペース区切りリストにフォーマットされ、実行前に test-commandパラメータで指定されたコマンドの末尾に追加されます。
スペース区切りリストを受け入れないテストフレームワークの場合、 CLI codebuild-tests-run は CODEBUILD_CURRENT_SHARD_FILES環境変数を通じて柔軟な代替手段を提供します。この変数には、現在のビルドシャードに指定されたテストファイルパスの改行区切りリストが含まれています。この環境変数を活用することで、さまざまなテストフレームワーク要件に簡単に適応し、スペース区切りリストとは異なる入力形式を想定する要件に対応できます。さらに、テストフレームワークの必要性に応じてテストファイル名をフォーマットすることもできます。以下は、Django フレームワークでの Linux CODEBUILD_CURRENT_SHARD_FILESでの の使用例です。以下はCODEBUILD_CURRENT_SHARD_FILES、Django でサポートされているドット表記ファイルパスを取得するために使用されます。
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'
注記
CODEBUILD_CURRENT_SHARD_FILES 環境変数は CLI codebuild-tests-run の範囲内でのみ使用できることに注意してください。
また、test-command CODEBUILD_CURRENT_SHARD_FILES内で を使用している場合は、上記の例に示すように二重引用符CODEBUILD_CURRENT_SHARD_FILESで囲んでください。
