EL7環境において BoltzMessenger で複数環境に対応するには

BoltzMessenger は、標準インストールでは1サーバあたり1つのインスタンスしか実行しません。そのため、検証環境と本番環境を分けたい・複数のアプリを1台で対応したい、といった場合は、BoltzMessenger が利用するデータベースと各種設定を、環境分だけ作成いただく必要があります。

以下の手順では、検証環境を新しく構築する手順を紹介します。

DBにデータベースを追加

BoltzMessenger が利用するデータベースを作成するには、boltz-messenger-init コマンドを使います。このコマンドは、オプション以外に引数を与えると、その名前でデータベースを作成します。以下の例では boltz_staging というデータベースを、ローカルで動作しているサーバに作成しています。

1$ boltz-messenger-init \
2    -u $user \
3    -p $pass \
4    -h localhost:3306 boltz_staging

BoltzMessenger の設定ファイルをコピー

BoltzMessenger の設定ファイル /etc/boltz-messenger/config.yml をコピーします。ここでは検証環境の構築が目的なので、ファイル名を config-staging.yml としました。

1# cd /etc/boltz-messenger
2# cp config.yml config-staging.yml

コピーしたファイルの、db.name を前の手順で作成したデータベースへ変更します。また、必要ならデータベースへログインするユーザも登録しておきます。

1mysql> grant all privileges on boltz_staging.* to boltz@localhost identified by 'passpass';
2// passpassは実際のパスワードで置き換え

boltz-messenger-gatewayをコピーする

boltz-messenger-gateway は管理画面に登録した通知の配信管理サービスです。このサービスは、config.yml によって参照するデータベースや認証情報を設定しているため、ファイルの参照を切り替えるためにサービスのコピーが必要です。

以下の例では、staging というサフィックスを付与していますが、任意の名前を指定していただけます。

 1# cd /etc/sysconfig/boltz
 2# cp messenger-gateway messenger-gateway-staging
 3# vi messenger-gateway-staging
 4(各種設定を変更、特にconfigとlisten_addrは必須)
 5
 6# cd /etc/systemd/system
 7# cp /usr/lib/systemd/system/boltz-messenger-gateway.service \
 8    boltz-messenger-gateway-staging.service
 9# vi boltz-messenger-gateway-staging.service
10(Environment=のパスをmessenger-gateway-stagingに変更)

終わったらsystemctlでenable & startします。

1# systemctl daemon-reload
2# systemctl enable boltz-messenger-gateway-staging.service
3# systemctl start boltz-messenger-gateway-staging.service

管理画面を分離する

管理画面も boltz-messenger-gateway と同じ設定ファイルを参照します。こちらは Systemd ではなく、環境変数で切り替えるようになります。

1# cd /etc/httpd/conf.d
2# cp boltz-messenger-admin.conf boltz-messenger-admin-staging.conf
3# vi /etc/httpd/conf.d/boltz-messenger-admin-staging.conf

boltz-messenger-admin-staging.conf は以下のように記述してください。

 1Alias /boltz-messenger-staging/ /usr/share/boltz-messenger-admin/app/webroot/
 2<Location /boltz-messenger-staging>
 3    SetEnv BE_CONFIG_PATH /etc/boltz-messenger/config-staging.yml
 4    RewriteEngine On
 5    RewriteCond %{REQUEST_FILENAME} !-d
 6    RewriteCond %{REQUEST_FILENAME} !-f
 7    RewriteBase /boltz-messenger-staging
 8    RewriteRule ^ index.php [L]
 9</Location>
10
11<Directory /usr/share/boltz-messenger-admin/app/webroot/>
12    AllowOverride All
13    require all granted
14</Directory>

また、標準でインストールした boltz-messenger-admin.conf も、以下のように修正してください。

 1Alias /boltz-messenger/ /usr/share/boltz-messenger-admin/app/webroot/
 2<Location /boltz-messenger>
 3  SetEnv BE_CONFIG_PATH /etc/boltz-messenger/config.yml
 4  RewriteEngine On
 5  RewriteCond %{REQUEST_FILENAME} !-d
 6  RewriteCond %{REQUEST_FILENAME} !-f
 7  RewriteBase /boltz-messenger
 8  RewriteRule ^ index.php [L]
 9</Location>
10
11<Directory /usr/share/boltz-messenger-admin/app/webroot/>
12  AllowOverride All
13  require all granted
14</Directory>

再起動を行えば、/boltz-messenger/ と /boltz-messenger-staging/ の2つ管理画面が利用可能になります。

1# systemctl restart httpd.service

Web API / BoltzMessenger Webを分離する

2.2 以降をお使いの場合、アプリ用の API やウェブプッシュ受信画面は、BoltzMessenger Web というパッケージに含まれるようになりました。こちらをお使いの場合、管理画面と同様な設定を、Web パッケージにも行う必要があります。

1# cd /etc/httpd/conf.d
2# cp boltz-messenger-web.conf boltz-messenger-web-staging.conf
3# vi boltz-messenger-web-staging.conf

boltz-messenger-web-staging.conf の例です。

 1Alias /bm-staging/ /usr/share/boltz-messenger-web/webroot/
 2<Location /bm-staging>
 3    SetEnv BE_CONFIG_PATH /etc/boltz-messenger/config-staging.yml
 4    RewriteEngine On
 5    RewriteCond %{REQUEST_FILENAME} !-d
 6    RewriteCond %{REQUEST_FILENAME} !-f
 7    RewriteBase /bm-staging
 8    RewriteRule ^ index.php [L]
 9</Location>
10
11<Directory /usr/share/boltz-messenger-web/webroot/>
12    AllowOverride All
13    require all granted
14</Directory>

boltz-messenger-web.conf も変更します。

 1Alias /bm/ /usr/share/boltz-messenger-web/webroot/
 2<Location /bm>
 3    SetEnv BE_CONFIG_PATH /etc/boltz-messenger/config.yml
 4    RewriteEngine On
 5    RewriteCond %{REQUEST_FILENAME} !-d
 6    RewriteCond %{REQUEST_FILENAME} !-f
 7    RewriteBase /bm
 8    RewriteRule ^ index.php [L]
 9</Location>
10
11<Directory /usr/share/boltz-messenger-web/webroot/>
12    AllowOverride All
13    require all granted
14</Directory>

これで、httpd を再起動すれば反映されます。

制限事項

BoltzMessenger Web を同一ドメインに複数設置した場合、ウェブプッシュ受信画面に関する設定は最後にアクセスした画面のものが有効となり、チャンネル・セグメントの設定が失われます。ウェブプッシュを同一サーバーで動作させる場合はバーチャルホストの定義などでドメインが各画面で変更されるように設定してください。

目次