JenkinsのPatch Parameter Pluginを使ってみる

ジョブの実行時にビルドパラメータとしてソースコードへのパッチを取り込むことができるプラグインです。テストをしたパッチのみをリポジトリに取り込みたい場合に有用です。

ビルドパラメータでパッチファイルを指定して、シェルの実行でpatchコマンドを実行した場合と動作は同様になると思います。しかし何度も同じパッチでジョブを実行した場合に、パッチが重複して適用されてしまいます。Patch Parameter Pluginはそのあたりをケアしてくれるようです。

patchutilsパッケージに複数のパッチをひとつのパッチにするcombinediffコマンドが含まれています。Patch Parameter Pluginはひとつのパッチのみを取り込むので、複数のパッチがある場合はcombinediffコマンドでひとつにしてから取り込むと良いでしょう。

$ combinediff [Patch1] [Patch2] ...

$ cat 0001.patch
--- a.c.org     2015-07-09 09:48:03.000000000 +0900
+++ a.c 2015-07-09 09:48:13.000000000 +0900
@@ -1,6 +1,6 @@
 #include <stdio.h>

-int main()
+int main(int argc, char *argv[])
 {
   return 0;
 }

$ cat 0002.patch
--- a.c.org     2015-07-09 09:48:37.000000000 +0900
+++ a.c 2015-07-09 09:53:47.000000000 +0900
@@ -1,6 +1,6 @@
 #include <stdio.h>

-int main(int argc, char *argv[])
+int main(int argc, char **argv)
 {
   return 0;
 }

$ combinediff 0001.patch 0002.patch
diff -u a.c a.c
--- a.c 2015-07-09 09:48:13.000000000 +0900
+++ a.c 2015-07-09 09:53:47.000000000 +0900
@@ -1,6 +1,6 @@
 #include <stdio.h>

-int main()
+int main(int argc, char **argv)
 {
   return 0;
 }

Jenkinsのプラグイン制御画面からインストールします。

Jenkinsの管理 -> プラグインの管理 -> 利用可能

ビルドのパラメータ化にチェックを入れ、「Patch file as parameter」を選択します。

パラメータ付きビルドにて、パッチファイルをアップロードします。パッチファイルは「patch.diff」というパラメータで扱われます。

コンソール出力にログが出力されます。

Applying a patch

Jenkins CLIからビルドパラメータ「patch.diff」を指定してジョブをビルドします。

java -jar jenkins-cli.jar -s [JenkinsサーバのURL] \
   build [ジョブの名前] -p patch.diff=[パッチファイル]

SSH認証でJenkins CLIを使う方法はこちらを参照してください。