ビルド失敗/不安定時のGerritメッセージを、指定されたファイルパスから取得します。
これはビルドがいくつかのステップを持っていて、それぞれがビルド失敗に関する情報を持っている場合に有用です。 この時、それぞれのビルドステップでビルド失敗をマークする前に、失敗に関するの詳細な情報を1つのテキストファイルに格納してください。 プラグインはGerritにレポートを戻す際に、このファイルの内容を読み込んでレビューメッセージとして使用します。
ファイルパスはワークスペースからの相対パスで指定してください。 'module/dist/**/*.zip'のようなワイルドカードを使用することができます。詳細は the @includes of Ant fileset を見てください。
テキスト内のビルド変数は展開されます。Jenkinsが提供する環境変数も同様です。
例:
Build Step: Execute Shell
run-unit-tests.shが失敗(0以外の終了コードを返す)し、STDERRにエラーメッセージを出力した時、
ビルドは失敗としてマークされ、STDERRへの出力はbuild-error_<BUILD_NUMBER>.txtに送られます。
結果、エラーメッセージの内容はGerritにレビューコメントとして追加されます。
${WORKSPACE}/bin/run-unit-tests.sh 2>build-error_${BUILD_NUMBER}.txt