テストのベストプラクティス

アクションで自動検出を有効にすると、同じタイプのすべての自動的に検出されたレポートが同じ成功基準を共有します。例えば、最小合格率などの共有基準は、自動検出されるすべてのテストレポートに適用されます。同じタイプのレポートに異なる基準が必要な場合は、これらのレポートごとに明示的に設定する必要があります。

自動検出では、依存関係によって生成されたレポートも検索でき、成功基準が設定されている場合、これらのレポートのアクションが失敗する可能性があります。この問題は、除外パス設定を更新することで解決できます。

自動検出は、実行時にアクションをスキャンするため、毎回同じレポートのリストを生成するとは限りません。特定のレポートを常に生成する場合は、レポートを明示的に設定する必要があります。例えば、テストがビルドの一部として実行を停止した場合、テストフレームワークは出力を生成せず、その結果、テストレポートが生成されず、アクションが成功する可能性があります。アクションの成功をその特定のテストに依存する場合は、そのレポートを明示的に設定する必要があります。

ラインカバレッジの自動検出成功基準を 80% に設定します。これにより、最初のレポートが合格し、2 番目のレポートが失敗し、アクション全体が失敗します。ワークフローのブロックを解除するには、2 番目のレポートのラインカバレッジが 80% を超えるまで、プロジェクトに新しいテストを追加します。

ラインカバレッジの自動検出成功基準を 60% に設定します。これにより、両方のレポートが合格し、アクションが成功します。その後、2 番目のレポートでコードカバレッジを増やすことができます。ただし、このアプローチでは、最初のレポートのカバレッジが 80% 未満に低下しないことを保証できません。

ビジュアルエディタを使用するか、レポートごとに明示的なYAMLセクションとパスを追加して、レポートの一方または両方を明示的に設定します。これにより、レポートごとに個別の成功基準とカスタム名を設定できます。ただし、この方法では、レポートパスが変更されると、アクションが失敗する可能性があります。

IncludePaths を使用して、レポートを検索するときに含め CodeCatalyst るファイルとファイルパスを指定します。例えば、 を指定すると"/test/report/*"、 は /test/report/ ディレクトリを検索するアクションで使用されるビルドイメージ全体 CodeCatalyst を検索します。そのディレクトリが見つかると、 はそのディレクトリ内のレポート CodeCatalyst を検索します。

ExcludePaths を使用して、レポートの検索時に除外 CodeCatalyst するファイルとファイルパスを指定します。例えば、 を指定した場合"/test/reports/**/*"、 CodeCatalystは /test/reports/ ディレクトリ内のファイルを検索しません。ディレクトリ内のすべてのファイルを無視するには、glob **/* パターンを使用します。

スラッシュ (/) 文字は、ファイルパス内のディレクトリを区切ります。

アスタリスク (*) 記号は、フォルダの境界を超えない、0 文字以上の名前の要素と一致します。

二重アスタリスク (**) は、すべてのディレクトリをまたいで、0 文字以上の名前の要素と一致します。