クラウド上の自社専用区画やオンプレミスに導入でき、外部システム連携可能なチャットルール「Mattermost」のインストールハンズオン資料です。 Ubuntu 16.04 ServerにMySQL 5.7を入れた仮想マシンを用意し、Virtual Boxを用いてハンズオンを行います。

1. Mattermost導入ハンズオン
DevOps活用研究会
2018.08.28
https://devops-association.connpass.com/ 1

2. 当日配布仮想マシンの仕様
イメージ名：Ubuntu for Mattermost.ova
OS：Ubuntu 16.04 Server
メモリ：1GB
CPU：1コア
ストレージ：10GB
MySQL 5.7 導入済み
Ubuntu Server ユーザー名：user , パスワード：user
MySQL rootパスワード：zaq12wsx
DB名：mattermost
DBユーザー名：mmuser
DBパスワード：mattermostischat
Mattermost Server 5.2.1
Mattrmost ディレクトリ：/opt/mattermost
https://devops-association.connpass.com/ 2

3. 仮想マシンイメージのインポートとネットワーク設定
① Mattermost
Minimal.ovaを
インポート
② インポートし
た仮想マシンを
選択
③ 設定をクリック
④ ネットワーク
をクリック
⑤ NATになって
いることを確認
⑥ ポートフォワー
ディングをクリック
NAT接続のネットワーク設定で、ポートフォワーディングを確認し、
ホストOSとゲストOS間のポート割り当てを確認します。
22番、8065番が登録されています。
https://devops-association.connpass.com/ 3

4. ネットワーク設定：ポートフォワーディング
NAT接続のネットワーク設定で、ポートフォワーディングを確認し、ホストOSとゲストOS間のポート割り当
てを確認します。22番、8065番が登録されています。
https://devops-association.connpass.com/ 4

5. SSHクライアントから接続
⑧ ネットワーク
設定を確認した
後、起動します。
⑨ localhost と
入れます。
⑩ OKをクリック
します。
⑪ ユーザー名とパス
ワードは、それぞれ、
user です。
⑫ OKをクリック
します。
SSHクライアントとして、Windows10上で、「Tera Term」を使っています。
ネットワーク設定を確認した後、仮想マシンの設定画面を閉じ、SSHクライアントから、ホスト名 localhost に対して
SSH接続を実施しています。ポートフォワーディング済みですので、仮想マシンにつながります。
https://devops-association.connpass.com/ 5

6. Mattermost設定ファイル：DB設定の編集
⑬ 仮想マシンに接続後、Mattermostの設定ファイルを編集します。
$ sudo nano /opt/mattermost/config/config.json
<修正場所>
“DataSource”: “mmuser:mostest@tcp(dockerhost:3306)/mattermost_test?charset=utf8mb4,utf8&read
Timeout=30s&writeTimeout=30s",
ハイライト表示の3か所を修正
mostest：DBパスワードなので、変更
dockerhost：MySQLのホストなので、変更
mattermost_test:DB名のことなので、作成済みのDB名に変更
<修正例>
"DataSource": "mmuser:mattermostischat@tcp(localhost:3306)/mattermost?charset=utf8mb4,utf8
&readTimeout=30s&writeTimeout=30s",
nanoエディタを使用のため、Ctrlキー + xキーを押し、yキーで保存。
https://devops-association.connpass.com/ 6

7. Mattermost設定ファイル：言語設定の編集
⑭ 引き続き、Mattermostの設定ファイルを編集します。
$ sudo nano /opt/mattermost/config/config.json
<修正場所>
"DefaultServerLocale": "en",
"DefaultClientLocale": "en",
"AvailableLocales": ""
<修正例>
"DefaultServerLocale": “ja",
"DefaultClientLocale": “ja",
"AvailableLocales": “ja"
nanoエディタを使用のため、Ctrlキー + xキーを押し、yキーで保存。
https://devops-association.connpass.com/ 7

8. Mattermost起動スクリプトの作成
⑮ オンラインドキュメントをもとに、自動起動スクリプト
を作成します。
$ sudo nano /lib/systemd/system/mattermost.service
$ sudo systemctl daemon-reload
$ sudo systemctl start mattermost.service
$ sudo systemctl status mattermost.service
Active: active (running) と表示されていればOKです。
qキーを押して、入力状態に戻る。
$ sudo systemctl enable mattermost.service
$ sudo reboot
サーバーを再起動し、http://localhost:8065 にWebブラ
ウザからアクセス。Mattermostが表示されればOKです。
[Unit]
Description=Mattermost
After=network.target
After=mysql.service
Requires=mysql.service
[Service]
Type=notify
ExecStart=/opt/mattermost/bin/mattermost
TimeoutStartSec=3600
Restart=always
RestartSec=10
WorkingDirectory=/opt/mattermost
User=mattermost
Group=mattermost
LimitNOFILE=49152
[Install]
WantedBy=mysql.service
https://devops-association.connpass.com/ 8

9. Mattermost 最初のユーザー(=管理者)を登録
⑯ Mattermostに初めてアクセスすると、管理者ユーザーがい
ないため、ユーザー登録を求められます。
メールアドレス、ユーザー名、パスワードを入力し、「アカ
ウントを作成する」をクリックします。
⑰ 「システムコンソールへ移動する」をクリックします。
https://devops-association.connpass.com/ 9

10. 一般的なユーザー登録：1st Step チーム作成
AD連携などを行っていない場合、Mattermostの仕様の範囲内でユーザ管理を行い
ます。ユーザ登録には、特定を踏みます。
「システムコンソール」から、「三」→「チームを切り替える」の順にクリック。
「新しいチームを作成する」をクリック。
チーム(部屋)の名前を決め、「次へ」をクリック。
チームURLを決め、
「完了」をクリック。
https://devops-association.connpass.com/ 10

11. 一般的なユーザー登録：2nd Step チームに招待
AD連携などを行っていない場合、各ユーザーが所属するチーム
を作成します。チームを作成することで、ユーザー登録が可能
になります。
作成したチームの画面で、「三」をクリックすると表示される
「チーム招待リンクを入手」画面に表示されるチーム専用の
URLを登録して欲しい人に送り、ユーザー登録を行ってもらい
ます。
デフォルト設定では、チームに招待され
Mattermostにユーザー登録した人は、だれでも
チームを作成し、他のユーザーを招待する機能が
有効になっています。
システムコンソール画面で無効にできます。
https://devops-association.connpass.com/ 11

12. チーム作成を抑制する。
管理者が入れるシステムコンソー
ル画面の「設定」→「ユーザーと
チーム」をクリック。
「チーム作成を有効にする」を
「無効」にすると管理者のみが
チーム作成を行えるようになり、
無秩序なチーム作成を抑制するこ
とができます。
https://devops-association.connpass.com/ 12

13. チームとチャンネル
https://devops-association.connpass.com/ 13
チーム チャンネル
チャンネル
チャンネル
チームは、部署や
プロジェクトに該当
チャンネルは、
Mattermostで会話する
トピックや話題
タスクの進捗も良いかも
しれいない

14. ユーザー登録が手間、対策は？
OpenSource Team Edition Enterprise Edition
招待リンク 〇 〇
Email認証 〇 〇
Gitlab連携 〇 〇
Active Directory/LDAP連携 × 〇
リポジトリ管理やチケット管理に、「Gitlab」を使っていない場合、一括でユーザー管理するには、
Mattermost Enterprise Editionを使用し、AD連携機能を有効にする必要があります。
https://devops-association.connpass.com/ 14

15. Jira連携プラグインの有効化
「有効にする」
をクリック
https://devops-association.connpass.com/ 15
有効にした後は、
JIRAをクリック

16. 参考記事：Mattermost用ボットの作り方
上記の2つを順に確認すると、Node-REDを用いて一からコードを書くよりも少ない工数で、クラウドや
オンプレミスのシステムと連携したボットを実装することができます。
Node-REDでMattermostのIncomng Webhookを使う
https://qiita.com/kolinz/items/4a2d222ac39c69673cfd
Mattermost向けチャットボットをNode-REDとWatson Assistantで実装
https://qiita.com/kolinz/items/1a6669646573cfdb4b17
https://devops-association.connpass.com/ 16

17. END OF DOCUMENT
https://devops-association.connpass.com/ 17