hubot-traq
使い方
新しいbotをつくる
インストール
前提としてNode.jsが必要です
# 利用ツールのインストール
npm install -g hubot coffee-script yo generator-hubot
# botを管理するディレクトリの作成
mkdir -p /path/to/hubot
cd /path/to/hubot
# テンプレートの作成
yo hubot
ここまでしたら、画面にしたがって入力していき、Bot adapterと表示されたらtraq
と入力します
(もしくはyo hubot
のあとにすべてコマンド引数で指定することもできます)
既定で入っているscriptsが存在するので一度除きます(このままだとredisがないだの怒られるため)
./external-scripts.json
を開いて[]
にします
package.json
のdependencies
のhubot
とhubot-traq
以外を取り除いてnpm install
をするといいかもしれません
さらに./hubot-scripts.json
を消すと非推奨というエラーが出なくなります
# gitレポジトリの作成
git init
git add .
git commit -m "Init"
初期設定
下記の環境変数をそれぞれ設定します
-
HUBOT_TRAQ_NAME
- traQで動かすHubotのtraQ ID (例:@BOT_TEST
ならBOT_TEST
) -
HUBOT_TRAQ_MODE
- BOTのモード (HTTP
またはWebSocket
、省略時はHTTP
) -
HUBOT_TRAQ_ACCESS_TOKEN
- traQで動かすHubotのAccess Token -
HUBOT_TRAQ_EMBED
- メンション・チャンネルリンクの自動埋め込みの有無(TRUE
にすると有効、省略時は無効) -
PORT
またはEXPRESS_PORT
- HTTPモードでのポート (省略時は8080
) - 以下はHTTPモードのときのみ必要
-
HUBOT_TRAQ_VERIFY_TOKEN
- traQで動かすHubotのVerification Code -
HUBOT_TRAQ_PATH
- Botサーバーエンドポイントのパス(直下で受け取るなら""
、/webhook/
で受け取るなら"/webhook/"
)
-
Verification CodeなどはそれぞれtraQのBot Consoleから確認できます
実行
./bin/hubot -a traq -n "$HUBOT_TRAQ_NAME"
showcase.yaml
type: runtime
startup: |
npm install -g coffee-script
npm ci
entrypoint: exec node_modules/.bin/hubot -a traq -n "$HUBOT_TRAQ_NAME" "$@"
http_proxy: 8080
このようにするとshowcaseで実行できます
javascript
coffeescript
typescript
./scripts/example.coffee
が存在していますが、拡張子が.coffee
ではなく.js
のファイルを./scripts
に置くことでcoffeescriptではなくJavaScriptで書くことも可能です
ただし、この場合でもnpm install -g coffee-script
は必要です
また、Typescriptで書くことも可能です。
ただし、あまり型の恩恵を受けれないと思います…。
さらに詳しい説明はhubotのドキュメントを参照してください