Errbotによって得られる、 ChatOpsライフ入門 PyconJP Reject Conference 2017 株式会社ニジボックス 武居和也

Agenda l自己紹介 l【PR】ニジボックスについて lChatBotとChatOps lErrbotについて lErrbotの始め方 lcommandを作る l便利な機能を知る

> 自己紹介 lKazuya Takei l株式会社ニジボックス lインフラ関係 l事業外全般 lエンジニアに啓蒙する系 l@attakei lTwitter/GitLab/GitHub/Qiita l技術的に面白そうなら、雑に手を出すタイプ

> 【PR】ニジボックスについて lNIJIBOX Co., Ltd. lhttps://nijibox.jp lリクルートグループ発の新規事業開発会社 lやってること l新規事業開発の支援 lO2Oキャンペーン受託 l自社サービス/パッケージ l レシポ l Biztom

> 雑) ChatBot と ChatOps ChatBot = Chat + Bot Øチャット(Chat)サービスのインターフェースを介して 自動で動作するプログラム(Bot) ⦁ 自然対話が主目的 ⦁ ChatOpsが主目的 ChatOps = Chat + Ops Øチャット(Chat)サービスをベースに システム運用(Ops)をしていくこと

Errbotについて

> Errbotについて lPython製のChatBotフレームワーク lhttp://errbot.io/ lhttps://github.com/errbotio/errbot lhubot, rubotyなどが類似ライブラリ lバージョン: 5.1.2 (2017/09/06現在) l現行バージョンはPython3.3以降のみ対応 lプラグイン方式

> Errbotについて (2) Backend plugin Storage plugins User plugins

> Backend plugins •Slack •HipChat •Telegram •XMPP •IRC •Text •Local GUI •Gitter •Skype •Discord •Mattermost •Cisco Spark

> Storage plugins •Shelf •SQL •Google Cloud Datastore •Redis •RethinkDB

Errbotの始め方

Errbotの始め方 (1) 最速で始める $ mkdir mybot $ pip install errbot $ errbot --init $ sed -i -e 's/CHANGE ME/@you/g' config.py $ errbot -T

Errbotの始め方 (2) 構造 + config.py | + data/ | + plugins/ + err-example/ + example.plug + example.py <-- 設定ファイル <-- 永続データやらなんやら <-- プラグインの置き場その1

Errbotの始め方 (3) l.plugファイルには、プラグインの情報を記述 lErrbot上の名前と使用するモジュール lhelpコマンド時の説明 [Core] Name = Example Module = example [Documentation] Description = This is a simple plugin

Errbotの始め方 (ex) lGitリポジトリに.plugと対応する.pyファイルが有る なら、reposコマンドでcloneからのプラグインインス トールが可能

commandを 作ってみる

> Errbotのcommand Errbotのコマンドは、デコレータで定義 l@botcmd l@arg_botcmd l@re_botcmd これらを知ってれば、プラグインを作れる

> @botcmd botcmdがBotPluginのメソッドを勝手にcommandと みなす 最終的に何か返せばOKなので、 出来ることの制限は（ほぼ）無い class Example(BotPlugin): @botcmd def hello(self, msg, args): return 'Hello {}!'.format(msg.frm) >>> !hello Hello you!

> @botcmd メソッド名に _ (アンダースコア)があると、 勝手に半角スペース扱い lcloudfront_create -> cloudfront create lcloudfront_invalidate -> cloudfront invalidate https://github.com/attakei/errbot-cloudfront/ サブコマンドっぽい！

> @arg_botcmd argparseライクな記述で、commandに引数を指定 することが可能 class Route53(BotPlugin): @arg_botcmd('zone', type=str) def route53_create(self, msg, zone): # Expression return 'Now creating'

> template Jinja2が利用可能 import boto3 class Route53(BotPlugin): @botcmd(template='route53_list') def route53_list(self, msg, zone): client = boto3.client('route53') result = client.list_hosted_zones() return {'zones': result['HostedZones']} **List of zones** {% for zone in zones %} - {{ zone.Id }}: {{ zone.Name }} {% endfor %}

> schedule 「定期的に○ ○ をさせる」「10分後に○○させる」 をやりたいときに from errbot import BotPlugin, botcmd, arg_botcmd import demo class Example(BotPlugin): @arg_botcmd('min', type=int) def noodle_timer(self, msg, min): self.start_poller(min * 60, self.finished, (msg.frm, min,)) return 'Start {} mins'.format(min) def finished(self, frm, min): self.send(frm, 'Finished') self.stop_poller(self.finished, (frm, min,))

> extra lWebhook lFlow ※今回はスキップ

> Repositories lhttps://github.com/errbotio/errbot lhttps://github.com/attakei/errbot-route53 lhttps://github.com/attakei/errbot-cloudfront lhttps://github.com/attakei/ lhttps://gist.github.com/attakei/6d43b8733d891b9 8a9b6a3bcf9b902a3

ご清聴、ありがとうございました 日本でErrbotユーザーが増えることを願いつつ