Errbotで得られる、ChatOps入門

Transcript

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

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

3. > 自己紹介 lKazuya Takei l株式会社ニジボックス lインフラ関係 l事業外全般 lエンジニアに啓蒙する系 l@attakei lTwitter/GitLab/GitHub/Qiita

   l技術的に面白そうなら、雑に手を出すタイプ

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

   l自社サービス/パッケージ l レシポ l Biztom

5. > 雑) ChatBot と ChatOps ChatBot = Chat + Bot

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

6. Errbotについて

7. > Errbotについて lPython製のChatBotフレームワーク lhttp://errbot.io/ lhttps://github.com/errbotio/errbot lhubot, rubotyなどが類似ライブラリ lバージョン: 5.1.2 (2017/09/06現在)

   l現行バージョンはPython3.3以降のみ対応 lプラグイン方式

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

9. > Backend plugins <Built in> •Slack •HipChat •Telegram •XMPP •IRC

   •Text •Local GUI <Community> •Gitter •Skype •Discord •Mattermost •Cisco Spark

10. > Storage plugins <Built in or Official> •Shelf •SQL •Google

    Cloud Datastore <Community> •Redis •RethinkDB

11. Errbotの始め方

12. Errbotの始め方 (1) 最速で始める $ mkdir mybot $ pip install errbot

    $ errbot --init $ sed -i -e 's/CHANGE ME/@you/g' config.py $ errbot -T

13. Errbotの始め方 (2) 構造 + config.py | + data/ | +

    plugins/ + err-example/ + example.plug + example.py <-- 設定ファイル <-- 永続データやらなんやら <-- プラグインの置き場その1

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

    = example [Documentation] Description = This is a simple plugin

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

16. commandを 作ってみる

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

18. > @botcmd botcmdがBotPluginのメソッドを勝手にcommandと みなす 最終的に何か返せばOKなので、 出来ることの制限は（ほぼ）無い class Example(BotPlugin): @botcmd def

    hello(self, msg, args): return 'Hello {}!'.format(msg.frm) >>> !hello Hello you!

19. > @botcmd メソッド名に _ (アンダースコア)があると、 勝手に半角スペース扱い lcloudfront_create -> cloudfront create

    lcloudfront_invalidate -> cloudfront invalidate https://github.com/attakei/errbot-cloudfront/ サブコマンドっぽい！

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

    msg, zone): # Expression return 'Now creating'

21. > 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 %}

22. > 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,))

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

24. > 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

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