gerritのパッチセットを検証するのに有用なGerrit Trigger Pluginの使い方をまとめました。
gerritはdebian-8というホスト名のサーバで稼働しています。
gerritのプロジェクト名はtestです。
gerritのインストール方法はこちらを参照してください。
git-reviewの使い方はこちらを参照してください。
Table of Contents
1 Gerrit Tigger Pluginとは
gerritにアップロードされたパッチセットを検証するプラグインです。各パッチを単独で当てたソースコードに対してテストを実行し、テストの成否をVerifiedスコアとしてgerritに投稿します。
2 Gerrit Tigger Pluginのインストール方法
Jenkinsのプラグイン制御画面からインストールします。
Jenkinsの管理 -> プラグインの管理 -> 利用可能
3 Gerritトリガーの設定
gerritサーバを追加します。
Jenkinsの管理 -> Gerritトリガー
左側の「新しいサーバを追加」をクリックします。
jenkins上で表示されるgerritサーバの名前を設定します（ホスト名と同じで問題ないでしょう）。
gerritサーバのプロパティを設定します。
| 名前 | 先ほど入力したgerritサーバの名前 |
| ホスト名 | gerritサーバのホスト名 |
| フロントエンドURL | gerritサーバのURL（HTTPかHTTPS） |
| ユーザ名 | gerritサーバ上のユーザ名 |
「テスト接続」でgerritサーバへの接続を確認できます。
「高度な設定」をクリックするとCode-Reviewスコア等のスコア値とgerrit CLIコマンドのオプションを設定することができます。
gerritでlabel "Verified"の設定をしていない場合は–verifiedオプションを削除する必要が有ります。
CLIコマンドが失敗したかどうかがわかりづらいので注意が注意が必要です。
保存して設定を反映させます。
状態が赤色の場合はgerritサーバにアクセスできていないので、gerritサーバが動いてるかどうかとGerrit Triggerの設定を確認してください。
4 プロジェクトの設定
プロジェクトの設定を開きます。
「ソースコードの管理」でgerritサーバのURLを指定します。
ここはHTTP経由でもSSH経由でも構いません。SSH経由の場合はCredentialsの登録が必要です。
高度な設定をクリックしてRefSpecに$GERRIT_REFSPECを入力します。
Branches to buildに$GERRIT_MASTERを入力します。
Additional BehaavioursでStrategy for choosing what to buildを追加し、Choosing strategyにGerritトリガーを選択します。
「Gerritトリガー」にチェックを入れ、トリガーするパッチセットの対象を設定します。
サーバは先ほど追加したgerritサーバを設定します。
今回はプロジェクトに設定されたパッチセット全てを対象とする為、Gerritプロジェクトの左側をPlainとtestに、右側をPathと**にしています（testはgerritのプロジェクト名です）。
5 自動でテストを実行
上記の設定を済ませた状態でgit-reviewコマンドを実行すれば、Jenkinsは自動でテストを実行します。
上記の設定の前にすでにgit-review済みのパッチセットについては自動で実行されません。
テストが成功すればVerifiedスコアが+1されます。
あとはCode-Reviewスコアを+2すればSubmit可能になります。
6 手動でテストを実行
パッチセットを検索して手動でテストを実行することもできます。
Jenkins -> Gerritパッチのクエリとトリガー
「検索ボタン」ボタンを押した後、各パッチにチェックを入れ、「トリガー実行」ボタンを押すことでテストが実行されます。
