企業内でチャットを使いたい、Hubotと連携させたい！けど、外のサービスを使っちゃダメ！ってことよくあるじゃないですか…
ってことで、サービスを利用せずにチャット環境を整える方法を調べてみました。
Kandan
KandanはOSSのHipChatクローンなチャットサービスです。Hubotと簡単に連携出来そうで、デザインもわりと良かったので採用してみました。
Cloud FoundryやHeorkuなどにデプロイすることも可能ですが、今回は自分でサーバを立ち上げます。(社内のそこらへんに転がってるサーバに入れましょう！)
Kandanのclone, checkout
最新のKandanだとdeviseなどのGemのバージョンが上がってしまい、うまく認証が機能しなかったので v1.2 時点のタグをチェックアウトし、進めていきます。
$ git clone https://github.com/kandanapp/kandan.git
$ cd kandan
$ git checkout v1.2
依存ライブラリのインストール
$ sudo apt-get install ruby1.9.1-dev ruby-bundler libxslt-dev libxml2-dev libpq-dev libsqlite3-dev gcc g++ make nodejs
$ gem install execjs
手順簡略化の為、Database adapterをPostgreSQLからSQLiteに変更し、bundlerでGemをインストールします。
developmentとtestのGemは今回は不要なので、除いてインストールしました。
$ vim Gemfile
# Database adapters
-gem 'pg'
+# gem 'pg'
+gem 'sqlite3'
$ bundle install --without development test
DBはSQLiteを使うことにしたので、database.ymlに以下を追加します。
$ vim config/database.yml
production:
adapter: sqlite3
database: db/production.sqlite3
pool: 5
timeout: 5000
DB作成
$ RAILS_ENV=production bundle exec rake db:create db:migrate kandan:bootstrap
プリコンパイル
特に手を加えていかないので true にしておきます。一度プリコンパイルしておくと動作が軽快です。（しないと重い…)
$ vim config/environments/production.rb
# Disable Rails's static asset server (Apache or nginx will already do this)
- config.serve_static_assets = false
+ config.serve_static_assets = true
プリコンパイル実施
$ RAILS_ENV=production bundle exec rake assets:precompile
Webサーバ起動
$ bundle exec thin start -e production
起動後、ユーザサインアップすると以下のように表示されます。ここまでで、チャットサービスは起動することができました。
ちなみに、管理者アカウントはデフォルトでAdmin、パスワードはkandanappadminです。
Hubotアカウント作成
KandanにHubotアカウントを作成し、Hubotと繋ぐためのアクセスキーを取得しておきます。
# Hubotアカウント作成
$ RAILS_ENV=production bundle exec rake kandan:boot_hubot
# アクセスキー取得
$ RAILS_ENV=production bundle exec rake kandan:hubot_access_key
Your hubot access key is YOUR_KANDAN_ACCESS_KEY
Hubot
HubotとKandanを繋げるのにhubot-kandanというKandan用アダプターを利用します。
手順はhubot-kandanのREADME.mdを参考に進めていきます。
Kandan用Hubot環境作成
Kandanと同様、最新のHubotではうまく動作しなかったので、v2.4.7のHubotを取得し環境を構築します。
$ wget https://github.com/github/hubot/archive/v2.4.7.zip
$ unzip v2.4.7.zip
$ cd hubot-2.4.7
$ npm install
$ make package
Kandan adapter
$ cd hubot
$ git clone https://github.com/kandanapp/hubot-kandan.git node_modules/hubot-kandan
$ npm install faye
$ npm install ntwitter
node_modules/hubot-kandan/package.json で Invalid version: "1.0" と怒られるので、1.0.0 に修正しておきましょう。
{
"name": "hubot-kandan",
- "version": "1.0",
+ "version": "1.0.0",
"author": "kandan",
hubot-kandan用環境変数設定
export HUBOT_KANDAN_HOST=YOUR_KANDAN_HOST
# Portが80以外なら
export HUBOT_KANDAN_PORT=YOUR_KANDAN_PORT
# 上で取得したアクセスキー
export HUBOT_KANDAN_TOKEN=YOUR_KANDAN_ACCESS_KEY
# info以外に設定するなら
export HUBOT_LOG_LEVEL=debug
Hubot実行
adapterを指定して実行します。
$ ./bin/hubot -a kandan
先ほど起動したKandanにアクセスすると、Hubotがチャットに参加しているのが確認できます。
@hubot ping や、 hear が使われている ship it などを投稿し、Hubotが反応するか確認してみましょう。
まとめ
外部サービスを利用せず、チャットサービスの立ち上げからHubotと連携するところまでをやってみました。最新バージョンだとうまく動かなかったので、今後に期待です。(結構デバッグしましたが、解決できませんでした…気が向いたらもう少し頑張ります)
せっかく環境を構築したので、Jenkinsとの連携なんかも次回あたりで書けたらと思います。