Hubotを用いて、HipChatと連携。 HipChatからJenkinsで自動デプロイしたり、 Backlogの更新をHipChatに通知したり。 開発のお供にいかがでしょうか。

1. Hubotを使ってbotをつくろう！
(Hipchat, Jenkins, Backlog連携)
企画開発部開発Gr.
菊池大輔

2. 話すこと
Hubotとは
HipChat連携
JenkinsやBacklogとの連携

3. Hubotとは
GitHub社が開発した
チャットbot開発・実行フレームワーク
MITライセンス
Node.js上で動く
Redis(インメモリDB)

4. Hubotの導入手順
Node.jsとRedisをインストール
npmでhubotをインストール
これだけ！

5. Node.jsとnpmの導入手順
Macの場合
$ brew install node redis
CentOSの場合
# EPELリポジトリ追加
$ sudo rpm –ivh
http://ftp.jaist.ac.jp/pub/Linux/Fedora/epel/6/x86_64/epel-release-
6-8.noarch.rpm
# nodeとredisをインストール
$ sudo yum install node redis
Windowsの場合
「nodist」を入れると良いかも

6. Hubotの導入手順
# hubotのインストール
$ npm install -g hubot coffee-script
# 任意のディレクトリに移動(ここではホームディレクトリ)
$ cd ~
# 「mybot」というhubotを作成
$ hubot --create mybot
# 「mybot」というディレクトリができている
$ cd mybot
$ npm install

7. Hubotを動かしてみよう！
$ cd mybot
# hubot起動
$ ./bin/hubot
Hubot> hubot ping
Hubot> PONG # hubotがエコーで返してくる
# 終わるとき
Hubot> exit

8. どう動いてる？
CoffeeScript またはJavaScript
# CoffeeScript(デフォルト: scripts/ping.coffee)
module.exports = (robot) ->↲
robot.respond /PING$/i, (msg) ->↲
msg.send "PONG"
# JavaScript
module.exports = function(robot) {↲
robot.respond(/PING$/i, function(msg) {↲
msg.send("PONG”);
});
});

9. 自作のイベントを作るには
「scriptsディレクトリ」の中に
CoffeeScriptかJavaScriptを入れるだけ
# テンプレート(CoffeeScript)
module.exports = (robot) ->↲
robot.respond [正規表現], (msg) ->↲
msg.send [返すメッセージ]
# テンプレート(JavaScript)
module.exports = function(robot) {↲
robot.respond([正規表現], function(msg) {↲
msg.send([返すメッセージ]);
});
});

10. HipChat連携
HipChatに、
hubotが投稿することができる！
HipChat上でhubotと会話しよう！

11. HipChat連携手順
HipChatでhubot用アカウントを作成
グループ管理者が作る必要あり
作ったアカウントのJabber IDを取得
HipChatのPCサイトにログイン
アカウント設定の画面で取得可能
HubotにHipChat用プラグインを
インストール(次のページ)

12. HipChat用プラグインの
インストール
# 依存ライブラリのインストール(Mac)
$ brew install icu4c
$ brew link icu4c
# 依存ライブラリのインストール(CentOS)
$ sudo yum install libicu-devel
# プラグインインストール
$ npm install --save hubot-hipchat
# 環境変数設定
$ export HUBOT_HIPCHAT_JID=“[Jabber ID]”
$ export HUBOT_HIPCHAT_PASSWORD=“[パスワード]”

13. 起動！
# hipchatにつなぐためアダプタの設定をする
$ bin/hubot -a hipchat
部屋にhubotを入れてあげる

14. JenkinsやBacklogとの連携
Jenkins：CIツール
Backlog：プロジェクト管理システム
バグトラッキングシステム
(開発元：ヌーラボさん)
どちらも
HTTPSでAPIがたたける
データがJSON形式で取得できる

15. Jenkins Remote API
URLを打ってみる
ジョブに設定しているブランチ名の取得
[JenkinsホームのURL]/job/[Jobの名前]/api/json
ジョブを起動
[JenkinsホームのURL]/job/[Jobの名前]/
buildWithParameters?[パラメータ名]=[パラメータ値]
※パラメータは「設定」で定義したもの

16. Backlog API v2
2014/07/07リリース(！)
複数のプロジェクトからイシュー一覧を
取得
[BacklogホームのURL]/api/v2/issues?
projectId[]=[プロジェクト1のID]&
projectId[]=[プロジェクト2のID]…
BacklogのAPI Keyが必要
アカウント設定で取得

17. 大体の流れ
APIをたたいてデータをJSON形式で取得
JSON.parseでパースしてオブジェクト化
得られたデータを元にHipChatに対し
通知を行なう

18. APIをたたくには
# CoffeeScript
module.exports = (robot) ->
path = [APIのURL]↲
req = robot.http path↲
req.get() (err, res, body) ->
contents = JSON.parse(body)
:
:

19. まとめ
Hubotによってbotが簡単に作れる！
他の機能と組み合わせることで
様々な通知機能を作成可能
開発のお供にぜひ使ってみては？

20. ご静聴ありがとうございました