1.21 jigowatts

Great Scott!

Jenkins × Slack 実行結果を通知して

Jenkins

概要

Jenkinsでジョブの実行結果をログインして調べるのって面倒ですよね。今回は僕も私もやってみたい「Jenkins × Slack」です。紳士にSlackへ実行結果を通知してもらいましょう。

f:id:sh_yoshida:20170611112658p:plain

環境
  • Windos 10
  • Jenkins 2.46.3
  • Slack
  • Slack Notification Plugin 2.2

Slackを設定する

Slackのメニューから[Apps & Integrations]を選択します。

f:id:sh_yoshida:20170611112232p:plain

「jenkins ci」を検索。

f:id:sh_yoshida:20170611112245p:plain

[Install]を選択。

f:id:sh_yoshida:20170611112341p:plain

既存のチャンネルを選択するか、[create a new channel]から新しいチャンネルを作成します。

f:id:sh_yoshida:20170611112353p:plain

今回は新しく#jenkinsチャンネルを作成しました。

f:id:sh_yoshida:20170611112406p:plain

先ほどの画面に戻り#jenkinsを選択して、[Add Jenkins CI integration]を押下。

f:id:sh_yoshida:20170611112421p:plain

設定情報の[Token]はJenkinsの設定で使うのでコピーしておきましょう。

f:id:sh_yoshida:20170611112435p:plain

Jenkinsを設定する

プラグインのインストール

[Jenkinsの管理]-[プラグインの管理]より利用可能タブで「Slack Notification Plugin」をインストールします。

f:id:sh_yoshida:20170611112447p:plain

プラグインの設定

[Jenkinsの管理]-[システムの管理]より[Global Slack Notifier Settings]で設定していきます。

f:id:sh_yoshida:20170611112500p:plain

[Team Subdomain]は以下の例での「example」の部分を入力。

https://example.slack.com/, your subdomain is 'example'.

[Integration Token]はSlack側で生成されたTokenを入力して、[Integration Token Credential ID]を[なし]にすれば接続できると思います。ただ、警告にあるようにセキュリティリスクがあるようなので、[Integration Token Credential ID]を使ってみます。

f:id:sh_yoshida:20170611121620p:plain

[Integration Token Credential ID]の追加を押下し、Jenkins Credentials Prviderで[種類]を[Secret text]に変更し、[Secret]にSlackのTokenを入力します。IDは適当な名前を入力し、[追加]を押下。

f:id:sh_yoshida:20170611112522p:plain

[Integration Token]を空にして、[Integration Token Credential ID]は先ほど追加したIDを選択します。[Test Connection]を押下してSuccessと表示されれば、Slack側に通知がでます。

f:id:sh_yoshida:20170611112512p:plain

テスト接続の通知はこんな感じ。

f:id:sh_yoshida:20170611112623p:plain

ジョブの設定

通知させたいジョブの[設定]より、[ビルド後の処理の追加]で[Slack Notifications]を追加します。通知させたい内容にチェックを入れて保存しましょう。

f:id:sh_yoshida:20170611112531p:plain

[高度な設定]では、テストのサマリーやジョブ毎の設定にオーバーライドができるようです。

f:id:sh_yoshida:20170611112546p:plain

実行結果

それではビルド実行してみましょう。

f:id:sh_yoshida:20170611112646p:plain

対象のチャンネルにJenkinsからの通知が来ました！

f:id:sh_yoshida:20170611112658p:plain

設定が簡単なのがわかったので、実際のプロジェクトでも連携させてみたくなりますね。
あー、職場にSlack導入されないかなぁ。

[改訂第3版]Jenkins実践入門 ――ビルド・テスト・デプロイを自動化する技術 (WEB+DB PRESS plus)

[改訂第3版]Jenkins実践入門 ――ビルド・テスト・デプロイを自動化する技術 (WEB+DB PRESS plus)

参考

https://github.com/jenkinsci/slack-plugin


sh-yoshida.hatenablog.com
sh-yoshida.hatenablog.com

Jenkins でGitHubと連携して.NETアプリケーションをビルドするときにパッケージを復元する

Jenkins Git Visual Studio

概要

言いたいことは全部タイトルで言った！

つーことで、GitHubから.NETのアプリケーションをCloneして、ビルドしようとしたらNuGetのパッケージが見つからないので復元するとこまでやってみました。

f:id:sh_yoshida:20170608234545p:plain

環境
  • Windos 10
  • Jenkins 2.46.3
  • Visual Studio Community 2017
  • NuGet v4.1.0

Jobの設定

ソースコード管理

Gitを選択して、リポジトリURLに適当なリポジトリを入力します。PublicリポジトリをCloneするだけなので認証情報はなし。ブランチはmasterで。

f:id:sh_yoshida:20170608234540p:plain

GitHubのリポジトリは仕事で久しぶりにVB.NETを書くことになったので練習がてらに作ったどうでもいいやつです。[Clone or download]のとこでコピー。

f:id:sh_yoshida:20170608234559p:plain

ビルド環境

ワークスペースにCloneされるので[ビルド開始前にワークスペースを削除する]にチェックを入れてみました。Timestamperプラグインもいつの間にか入っていたので、[コンソール出力にタイムスタンプを追加する]にチェック。

f:id:sh_yoshida:20170608234549p:plain

ビルド

パッケージを使っている場合復元してあげる必要があるので、別途NuGet CLIをダウンロードしてc:\toolsに配置してあります。

ダウンロードは以下から。
NuGet Distributions

nuget.exeのv4.1.0をダウンロードしました。

f:id:sh_yoshida:20170609000832p:plain

Windowsバッチコマンドの実行にて、コマンド実行。カレントはワークスペースになっているので、Cloneしたソースコードを対象にrestoreできるってわけですね。

c:\tools\nuget.4.1.exe restore

f:id:sh_yoshida:20170608234550p:plain

あとは前回と同じなので省略します。

f:id:sh_yoshida:20170608234554p:plain

実行結果

ワークスペースにソースコードがCloneされて、足りないパッケージも復元されました！

f:id:sh_yoshida:20170608234556p:plain

ビルドとユニットテストも通って青玉でました。ここにたどり着くまでにTry and Errorで19回もビルド実行しているのがバレバレ（ ^Д^)σ

f:id:sh_yoshida:20170609002403p:plain




sh-yoshida.hatenablog.com
sh-yoshida.hatenablog.com
sh-yoshida.hatenablog.com

Jenkins でMSBuildと単体テストをジョブ実行する

Jenkins Visual Studio

概要

「MSBuildでコマンドラインからビルドする」、「VSTest.Consoleでコマンドラインからテストを実行する」とやってきたので、今回はJenkinsでビルド・テスト実行を行ってみたいと思います。

sh-yoshida.hatenablog.com
sh-yoshida.hatenablog.com

f:id:sh_yoshida:20170602013815p:plain

環境

Jenkins

JenkinsとはJavaで書かれたオープンソース継続的インテグレーションツールである。

https://ja.wikipedia.org/wiki/Jenkins

Jenkinsのインストールは省略します。ダウンロードしてウィザードに従い進めていけばokです。私の環境はC:\Jenkinsにインストールしました。
jenkins.io

Jobの作成

それでは、[新規ジョブ作成]よりJobを作成していきます。ジョブ名は適当に「MyJob」で。[フリースタイル・プロジェクトのビルド]を選択しました。

f:id:sh_yoshida:20170602003033p:plain

[ビルド手順の追加]で[Windowsバッチコマンドの実行]を選択します。

Windowsバッチコマンドの実行

これでコマンド入力ができるので、前にやったMSBuildとVSTest.Consoleのコマンドをそれぞれ登録して保存、ビルド実行で出来ました！ハイ終わり！つーのもあれなので、プラグインを使ってみます。

f:id:sh_yoshida:20170601234427p:plain

Plugin

[Jenkinsの管理]-[プラグインの管理]から以下のプラグインをインストールしました。インストールができたら、それぞれ設定していきましょう。

  • MSTest plugin
  • VSTest Runner plugin

Pluginの設定

[Jenkinsの管理]-[Global Tool Configuration]で出来ます。初見でネットで調べてたらシステムの設定でできるって書いてあったけど無くてはまりました。UIが変わったタイミングだったのかな。

f:id:sh_yoshida:20170601234458p:plain

MSBuildは名前とexeのパスを登録しておきました。パスはexeの指定なし。

c:\Program Files (x86)\Microsoft Visual Studio\2017\Community\MSBuild\15.0\Bin

f:id:sh_yoshida:20170601234539p:plain

VSTestも名前とパスですが、こちらはexeまで指定。なんか警告でてるけど。。

C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\TestWindow\vstest.console.exe

f:id:sh_yoshida:20170601235028p:plain

これでPluginの準備ができたので、ジョブの設定に戻りましょう。

MSBuild

さきほどのコマンド実行の設定は削除して、[ビルド手順の追加]-[MSBuildの実行]。MSBuildバージョンは先ほど設定したPluginの名前を選択。MSBuildビルドファイルには対象のソリューション、コマンドライン引数には各種スイッチを入力します。

f:id:sh_yoshida:20170601234945p:plain

VSTest Runner

続きまして、同様に[ビルド手順の追加]-[VSTest実行]を追加します。VsTestバージョンにPluginで設定した名前、Test Filesにテスト対象のDLLファイルのフルパスを入力します。
f:id:sh_yoshida:20170601234647p:plain

さらに、[高度な設定]ボタンを押下し、プラットフォームの種類、フレームワークのバージョンなどを指定して保存します。

f:id:sh_yoshida:20170601234806p:plain

これでプラグインを使用するビルドの設定ができました！

Jobの実行結果

[ビルド実行]ボタンを押下して実行した結果、うまく行きました♪

f:id:sh_yoshida:20170602013248p:plain

workspaceにビルドログとテスト結果も出力されてます。

f:id:sh_yoshida:20170602013326p:plain

sh-yoshida.hatenablog.com
sh-yoshida.hatenablog.com