ウォームアップ

デフォルトでは、コミットがリポジトリにプッシュされると、Space は変更がコミットされたのと同じブランチ内の devfile.yaml ファイルからウォームアップを実行しようとします。例: cool-feature ブランチに変更をプッシュすると、Space は cool-feature ブランチでこのリビジョンの devfile.yaml ファイルからウォームアップを実行しようとします。

branchFilter を使用すると、Space がウォームアップを実行する必要があるブランチのリストを指定できます。例: 次のウォームアップは、my-feature ブランチの変更時にのみ実行されます。

変更が my-feature ブランチにプッシュされた場合、このウォームアップは my-feature で開始されますが、main やその他のブランチでは開始されません。変更が main ブランチにプッシュされた場合、ウォームアップは開始されません。Space は main ブランチでスクリプトを実行しようとしますが、これを阻止する branchFilter があります。

branchFilter は次のフィルタリングルールをサポートしています。

• フィルターは、include ルールと exclude ルールをサポートします。

• アスタリスク (*) ワイルドカードを使用できます。

  include: - 'refs/heads/release-*'

• フィルターは、正規表現の包含ルールと除外ルールをサポートします。

  includeRegex: - 'release-\d+' excludeRegex: - 'release-221'

• 除外ルールは、含めるルールよりも優先されます。

• branchFilter では、Git タグによってフィルターを指定することもできます。

  # run only if there's a release tag # e.g., release/v1.0.0 include: - 'refs/tags/release/*'

• 例:

  schemaVersion: 2.2.0 attributes: space: editor: type: Idea warmup: startOn: - type: gitPush branchFilter: # add 'main' and all '222.*' tags include: - 'refs/heads/main' - 'refs/tags/222.*' # add all branches containing 'feature' includeRegex: - 'feature' # exclude test-feature exclude: - 'refs/heads/test-feature'

pathFilter を使用すると、特定のディレクトリおよびファイルへのパスを指定できます。例: 以下のウォームアップは、Main.kt ファイルに変更があった場合にのみ実行されます。

pathFilter を使用して branchFilter を微調整できます。Space は最初に特定のブランチに変更があるかどうかを確認し、その後で初めて pathFilter を適用します。branchFilter が指定されていない場合、pathFilter は現在のブランチ (変更がコミットされたもの) 内でのみ機能します。

pathFilter は次のフィルタリングルールをサポートしています。

• 少なくとも 1 つのファイルが指定されたフィルターに一致する場合、ウォームアップが実行されます。

• フィルターは、include ルールと exclude ルールをサポートします。

• プロジェクトのルートディレクトリを基準とした相対パスを指定する必要があります。

• 現在のディレクトリ内のみでファイルを照合するにはアスタリスク (*) ワイルドカードを使用し、再帰的照合には二重アスタリスク (**) を使用できます。例: src/tests/* は、tests ディレクトリ内のすべてのファイルと一致します。src/tests/** は、tests 内のすべてのファイルとそのすべてのサブディレクトリに一致します。

• より具体的なパスは、それほど具体的ではないパスよりも優先されます。src/tests/MyTests.kt は src/tests/** よりも優先されます。

• 例:

  schemaVersion: 2.2.0 attributes: space: editor: type: Idea warmup: startOn: - type: gitPush branchFilter: include: - 'refs/heads/main' pathFilter: exclude: # exclude 'targets/main' dir - 'targets/main/**' include: # include everything from 'targets' dir - 'targets/**' # include all 'Main.kt' files in the project # As this rule is more specific, # 'Main.kt' will be included even if # it's located in 'targets/main' - '**/Main.kt' # include all '.java' files from the 'common' dir - 'common/**/*.java'