会社でのワークショップネタ

1. ソフトウェア開発自動化ワークショップ
古川 剛啓
http://www.flickr.com/photos/aquilaonline/510921786

2. はじめに
•
今日は、手を動かすだけでなく、話し合いもしてもらい
ます。積極的に意見を出して下さい。
•
何か１つでも持って帰って貰えたら嬉しいです。
2

3. http://www.flickr.com/photos/danielito311/9642013216

4. 自己紹介
各自A3用紙に所属、氏名、仕事の概要を書い
てグループで自己紹介をして下さい。
10分

5. ワークショップ１
タスクの洗い出し
日々行っている仕事のタスク（作業項目）には
どんな物がありますか？
皆で洗い出して下さい。
15分

6. 自動化するって
どういうこと？
http://www.flickr.com/photos/ores2k/394359583

7. ある結果を得るために、決められたことを手順通りに
機械にやらせること
http://www.flickr.com/photos/toyotamheurope/8431432401

8. どんな物が対象
になる？
http://www.flickr.com/photos/ores2k/394359583

9. 比較的単純な作業で、厳密な、また
は固定化したルールに基づいて決
定が行われるようなケースがあれ
ば、自動化の第一候補となる。
BABOKⓇガイド Version 2.0より引用

10. ワークショップ２
自動化候補のタスクはあった？
洗い出したタスクから自動化の候補になりそう
なものを識別して下さい。
10分

11. ワークショップ３
どうやるか？
どうやると自動化できますか？
15分

12. 既に自動化している
ところはどうやってる
んだろう

13. 自動化の方法
• スクリプトを作成する
• cronによる周期処理
（ログローテーション等）
• taskによる周期処理
• Jenkinsを使用

14. と、いうことで
Jenkinsを使ってみよう！

15. Jenkinsとは
• 継続的インテグレーション(CI)ツール
• Jobを監視し、成功／失敗を
通知してくれる
• Windowsのバッチ、シェル
の実行等をしてくれる
• プラグインにより機能拡張
が可能

16. Jenkinsの画面
（ダッシュボード）
Job
傾向
最新の結果

17. Jenkinsを使った自動化処理の流れ
リポジトリ
② 通知
① コミット
自動
手動
③ チェック
アウト
確認（随時）
クライアント
Jobの実行
自動ビルド
自動テスト 等
Jenkins

18. １. リポジトリを準備する
通常は、普段使っている
リポジトリを参照します。
リポジトリ
今日は、ワークショップ用に
各PC上にリポジトリを作成し
ます。
② 通知
① コミット
③ チェック
アウト
確認（随時）
クライアント
workshop¥script内にある
「 setup_repository.bat」
を実行して下さい。
c:¥svnRepo¥trunk
にリポジトリが作成されま
Jobの実行
す。 自動ビルド
自動テスト 等
Jenkins

19. 2. Jenkinsを起動する
Jenkinsのオフィシャルサイト
（http://jenkins-ci.org/）を開く。
画面右にある、「Download Jenkins」
から最新のwarファイルをダウンロードするか、OSに合っ
たパッケージをダウンロードする。
各OSのパッケージへのリンクは、別ページが開き、イン
ストール手順が書いてあるのもがある。この場合は、そ
の手順に従い、インストールする。
以下のコマンドでjenkinsを起動する。
java ⊔ -jar ⊔ jenkins.war
⊔ : 半角スペース

20. 3. Jenkinsに接続する
ブラウザで、以下のアドレスを開くとJenkinsに接続
できる。
http://(Jenkinsが動作しているサーバ):8080/
今日は、
http://localhost:8080/

21. 4. Jobを作成する
Job作成手順
(1) 必要なツールをインストールする。
(2) ツールに合わせたプラグインをインストールする。
(3) Jobを作成する。

22. 4.1 必要なツールをインストールする
ここでの「ツール」とは、静的解析ツールや、
ユニットテストフレームワーク、ドキュメント作成ツールを
指す。
今日の環境には、以下のツールがイントール済み。
静的解析ツール ： cppcheck
メトリックス測定ツール ： cccc
ユニットテストフレームワーク ： GoogleTest
重複コード解析ツール ： CPD
ドキュメント作成ツール ： Doxygen

23. 4.2 プラグインをインストールする
ダッシュボードから、
Jenkinsの管理 -> プラグインの管理を選択。

24. 4.2 プラグインをインストールする
「高度な設定」タブをクリックし、
Proxyを設定。

25. 4.2 プラグインをインストールする
「利用可能」タブをクリックし、必要なプラグインにチェックを
入れ、「ダウンロードして再起動後にインストール」ボタンを
クリック。
ツール名
プラグイン名
cppcheck
Cppcheck Plugin
cccc
CCCC Plugin
GoogleTest
CPD
Doxygen
xUnit Plugin
DRY Plugin
Doxygen Plugin

26. 4.3 Jobを作成する
クリック
入力
選択

27. 4.3 Jobを作成する
ソースコードのチェックアウト元のリポジトリを設定する
file:///c:/svnRepo/trunk

28. 4.3 Jobを作成する
チェックアウトのタイミングを設定する
周期的なチェックアウトは、コミットしてからJob実行までに
タイムラグがある。
ので、コミットをトリガにJobを実行するように設定した方が
良い。

29. 4.3 Jobを作成する
実行するコマンドを設定する
cppcheck ⊔ --enable=all ⊔ --xml-version=2 ⊔ src/ ⊔ 2> ⊔ cppcheck-result.xml
⊔ : 半角スペース

30. 4.3 Jobを作成する
実行結果の集計を設定する
入力

31. 4.4 受動でJobを起動する
クリック

32. 4. Jobを作成する（振り返り）
Job作成手順
(1) 必要なツールをインストールする。
(2) ツールに合わせたプラグインをインストールする。
(3) Jobを作成する。
(a) リポジトリからのチェックアウトを設定
(b) コマンドを設定
(c) 結果確認を設定

33. ワークショップ４
他のコマンドを起動するJobを設定する
コマンド名
シェルスクリプト欄の設定
結果（ビルド後の処理）の設定
cccc
cccc ⊔ --lang=c++ ⊔ src/*.cpp
.cccc/cccc.xml
GoogleTest
cd ⊔ src;
make ⊔ clean;
make ⊔ test;
./a.outTest ⊔ --gtest_output=xml
**/test_detail.xml
CPD
cpd.sh ⊔ 10 ⊔ src ⊔ cpp ⊔ > ⊔ cpd.xml
**/cpd.xml
Doxygen
doxygen
Doxyfile
30分

34. ５. コミットをトリガにJobを起動する
リポジトリをポーリングする方法は、タイムラグがある。
リポジトリへのコミットをトリガにしてJobを起動する。

35. ５.1 Jenkins CLIを使う
Jenkinsでは、外部からJobを起動する方法が幾つかの
方法があります。その内の１つがCLIです。
(1) ビルドトリガの設定を削除する
(2) Subversionのhook設定をする
(a) c:¥svnRepo¥hooksに「post-commit.bat」を作成
(b) batファイルの内容は、
java ⊔ -jar ⊔ jenkins-ci.jar ⊔ -s ⊔
http://localhost:8080/ ⊔ build ⊔ StaticCheck

36. ワークショップ５
コミットしたらJobが起動されるように設定をしてみよう
15分

37. ６. ビルドパイプラインを作る
http://www.flickr.com/photos/surfglassy/4178802068

38. ビルドパイプラインとは
複数のJobを連続して処理するようにしたもの。

39. ６. ビルドパイプラインを作る
(1) Build Pipelineプラグインをインストールする
(2) 上流のJobから順に設定を修正する
(a) ビルド後の処理の追加で「他のプロジェクトのビ
ルド」を選択

40. ６. ビルドパイプラインを作る
(b) ビルドするプロジェクト欄に次のJob名を入力し、
起動条件を設定

41. ６. ビルドパイプラインを作る
（下流となるJobのみ）
(c) プロジェクトの高度なオプション欄の[高度な設
定]ボタンをクリック

42. ６. ビルドパイプラインを作る
（下流となるJobのみ）
(d) 「上流プロジェクトがビルド中の場合はビルドしな
い」と「カスタムワークスペースを使用」にチェック
(e) ディレクトリに最上流のJobのワークスペースを設
定
$JENKINS_HOME/jobs/(最上流のJob名)/workspace

43. ６. ビルドパイプラインを作る
（下流となるJobのみ）
(f) ソースコード管理を「なし」に変更

44. ６. ビルドパイプラインを作る
(g) ワークスペースの「＋」をクリック

45. ６. ビルドパイプラインを作る
(h) 「ビュー名」を入力し、「Build Pipeline View」を選
択

46. ６. ビルドパイプラインを作る
(i) 「Select Initial Job」のリストから最上流のJob
を選択

47. ワークショップ６
ビルドパイプラインを設定してみよう
15分

48. ワークショップ７
ワークショップ３で自動化方法を考えたタスク
の自動化方法を再考してみよう
15分

49. 関連書籍
出版社: オライリージャパン
言語
: 日本語
ISBN-10: 4873115345
ISBN-13: 978-4873115344
出版社: アスキー・メディアワークス
言語
: 日本語
ISBN-10: 4048707876
ISBN-13: 978-4048707879