アーティファクトを収集する

ジョブの実行中に生成された 1 つ以上の成果物を収集できる成果物の収集ジョブステップの概要。

アーティファクトは、アーティファクト収集ジョブステップフォームから選択できる次の 2 つの手順のいずれかを使用して収集できます。

個々のアーティファクトを収集する

ジョブステップ設定 (図 1 ) では、ジョブステップに関する次のような情報をカスタマイズできます。

カスタムステップ名を定義できます。定義しない場合は、デフォルトのステップ名が使用されます。
アーティファクトの収集: ワークスペースから収集するファイルを定義します。ワークスペースルートから特定のファイルを1つ収集するには、フィールドにそのファイル名（例: requirements.txt ）を入力します。ワークスペースルートから複数のファイルを収集するには、カンマで区切ります（例: requirements_1.txt, requirements_2.txt ）。入力した正規表現に基づいてアーティファクトを収集することもできます。入力した正規表現は、 fnmatch pythonモジュールで定義されたルールに従う必要があります。例えば、すべての.txtファイルを収集する場合、正規表現は*.txtとなります。
各ステップには、ステップを管理するための詳細オプションがあります。ステップの実行に失敗した場合、ジョブの実行は継続されます。「ステップ失敗時にジョブを中止する」オプションが選択されている場合、このステップが失敗するとジョブの実行が停止し、それ以降のステップは実行されません。スキップ条件については、条件が満たされた場合に現在のステップをスキップできます。

ジョブステップの設定 (図 2 ) では、ジョブステップに関する次のような情報をカスタマイズできます。

カスタムステップ名を定義できます。定義しない場合は、デフォルトのステップ名が使用されます。
アーティファクトの収集: ワークスペースから圧縮して収集するディレクトリを定義します。ワークスペースのルートから特定のディレクトリをzipアーカイブとして収集するには、そのディレクトリ名（例： build_directory ）をフィールドに入力します。ワークスペースのルートから複数のディレクトリをzipアーカイブとして収集するには、ディレクトリ名をカンマで区切ります（例： build_directory_1, build_directory_2 ）。
各ステップには、ステップを管理するための詳細オプションがあります。ステップの実行に失敗した場合、ジョブの実行は継続されます。「ステップ失敗時にジョブを中止する」オプションが選択されている場合、このステップが失敗するとジョブの実行が停止し、それ以降のステップは実行されません。スキップ条件については、条件が満たされた場合に現在のステップをスキップできます。
図3 .高度なオプションが表示された成果物収集ジョブステップ

注:フォームを保存するには、すべての入力フィールドが有効である必要があります。必須フィールドには*が付いています。