はじめてのJenkins #Jenkins

Jenkinsを試しに触ってどんなものか理解してもらうことを目的としています。
JOBを一度も作ったことがない人向けのハンズオン資料です。

環境

Mac
JDK8(たぶん6以上だった動くと思われる）
Jenkins1.619

準備

JenkinsのサイトのJava Web Archiveからwarをダウンロードし、以下を実行。
ポートを変えたい場合はhttpPortで指定してください。

java -jar jenkins.war –-httpPort=8080

エラーが出た場合

ソケット周りでエラーが出た場合は

2015 9:18:08 午後 hudson.UDPBroadcastThread run
警告: UDP handling problem
java.net.SocketException: Can't assign requested address
    at java.net.PlainDatagramSocketImpl.join(Native Method)
    at java.net.AbstractPlainDatagramSocketImpl.join(AbstractPlainDatagramSocketImpl.java:178)
    at java.net.MulticastSocket.joinGroup(MulticastSocket.java:323)
    at hudson.UDPBroadcastThread.run(UDPBroadcastThread.java:77)

こうすることで解決しました。
IPv6アドレスあたりが邪魔をしているらしいです（よくわかってない

java -Djava.net.preferIPv4Stack=true -jar jenkins.war --httpPort=8080

参考

http://pcworkmemo.blogspot.jp/2013/10/freebsdjenkins.html

http://localhost:8080/ にアクセスしてこんな感じの画面がでれば成功。

Jobの作成

JobとはJenkins上で実行される処理のひとかたまりのことです。Jobの中にいろんな処理をつめこむこともできますし、複数のJobをつなげて実行することも可能です。

まずはHello,JenkinsというJobを作ってみましょう。

新規Job作成
「hello_jenkins」というジョブ名で、「フリースタイルプロジェクトのビルド」を選択。
「ビルド手順の追加」から「シェルの実行」を選択
シェルスクリプトの入力欄に echo "Hello,Jenkins"と入力して保存

これだけです。

Jobの手動実行

Jenkinsのホーム画面から先ほど作った「hello_jenkins」Jobを選択
左側にある「ビルド実行」ボタンを押す
「ビルドがスケジュールされました」と表示され、ビルド履歴が追加される

Jobを実行することをビルドと言い、何回もビルド実行するとビルド履歴が残ります。
実行結果はビルド履歴のコンソールから確認できます

このように、Hello,Jenkinsと出力されます。

[workspace] $ /bin/sh -xe /var/folders/lb/yn_3vms5485_j4t34b8xx00r0000gn/T/hudson2910569267105369273.sh
+ echo Hello,Jenkins
Hello,Jenkins
Finished: SUCCESS

ちなみにシェルを異常終了させると、Jobも失敗します。

ビルド履歴の左の丸いアイコンも青から赤になったり、Jobが「曇り」マークになったり、いろいろ変わっているので何が変わったか探してみるのも面白いと思います。

失敗した時のコンソールはこのようになります。

[workspace] $ /bin/sh -xe /var/folders/lb/yn_3vms5485_j4t34b8xx00r0000gn/T/hudson4268607205151617609.sh
+ echo Hello,Jenkins
Hello,Jenkins
+ exit 1
Build step 'シェルの実行' marked build as failure
Finished: FAILURE

Jenkinsおじさんに怒られてみたい人はこんなのもあります。
Jenkins | Emotional Jenkins Pluginで執事を怒らす

Jobの自動実行

Jenkinsのホーム画面から先ほど作った「hello_jenkins」Jobを選択
左側にある「設定」ボタンを押す
ビルドトリガの「定期的に実行」にチェックを入れる
スケジュール欄に実行したい間隔を入れる。

下記の例は毎日9時台のどこか(システム的に都合がいいタイミング)で実行する例です。

GitHubと連携したJobを作る

まずGitプラグインを追加します。事前にMacにgitが入れておいてください。

Jenkinsのホーム画面から左の「Jenkinsの管理」を選択
「プラグインの管理」を選択
「利用可能」タブに変えて、フィルター欄に「git plugin」と入力
GitPluginにチェックを入れて「再起動せずにインストール」（再起動してもいいです）

同様にGradlePluginもインストールしておいてください。

これでGitが使えるようになりましたのでJobを作りましょう

Job名は「github_sample」にしました（なんでもいいです）
ソースコード管理の欄に「git」が追加されてるので、それを選択
Repositoryはなんでもいいですが、サンプルを使うなら以下を入力 https://github.com/nyasba/JenkinsHandsonSample.git
「ビルド手順を追加」で「Invoke Gradle script」を選択
ここになければGradlePluginのリリースをしてください。
「Use Gradle Wrapper」を選択
「Make gradlew executable」をチェック
Tasksに「clean test」を入力　　 gitの設定詳細