What is this ?

JMeter クラスター環境をプロビジョニングする Ansible Playbook です。
対応するクラウドリソースをデプロイするための Terraform コードも併せて管理しています。
※ Terraform の詳細は ./terraform/ 配下の README.md を参照ください。

Requirements

Target

• AlmaLinux8
• AlmaLinux9
• RockyLinux9

Usage

1. リポジトリの clone

git clone https://github.com/snkk1210/jmeter-MS.git
cd jmeter-MS

2. プロビジョニング対象を定義

cp -p hosts.example hosts
vi hosts

-> プロビジョニング対象の IP アドレス をそれぞれ記述して下さい。
※ 複数のホストを記述できます。

[controller] 
jmeter-controller ansible_host=xxx.xxx.xxx.xxx <- Controller ノード  
[worker]  
jmeter-worker1 ansible_host=xxx.xxx.xxx.xxx <- Worker ノード
jmeter-worker2 ansible_host=xxx.xxx.xxx.xxx <- Worker ノード

3. 接続ユーザを定義

cp -p target.yml.example target.yml
vi target.yml

-> 以下項目にプロビジョニング対象の SSH 接続ユーザを定義

remote_user: xxxxxx

4. パラメタ変数を定義

cp -p group_vars/all.yml.example group_vars/all.yml
vi group_vars/all.yml

• HEAPメモリ のサイズを定義
  ※ 定義しなければ 256M が設定されます。

heapm_size: xxxm

• VNC 接続のパスワードを定義 ( 6 文字以上 )
  ※ 定義しなければ vncserver の文字列が設定されます。

vnc_passwd: string_6

• Controller に紐づける Worker の IP アドレスをカンマ ( , ) 区切りで定義
  ※ 後述の WEB コンパネでも操作可能なので定義しなくても OK

remote_hosts: 192.168.33.xx,192.168.33.xx

• WEB コンパネアプリのブランチを指定
  ※ 定義がなければ、最新版が導入されます。

flanker_branch: release/0.0.7

5. Playbook の実行

• パスワード

ansible-playbook -i hosts target.yml --ask-pass

• 秘密鍵

ansible-playbook -i hosts target.yml --private-key=xxxxxxx

WEB コンパネ

WEB ベースで JMeter を一括操作できるコントロールパネルを用意しています。

※ 詳細は以下リポジトリの README を参照下さい。
https://github.com/snkk1210/flanker

プロビジョニング後の対応

※ 先の「WEB コンパネ」で JMeter を操作するのであれば、本項は無視ください。

1. Controller と Worker の紐づけ

vi /usr/local/jmeter/bin/jmeter.properties

-> 以下項目に使用する Worker サーバの IP を記述
※ カンマ ( , ) 区切りで複数指定できます。

remote_hosts=xxx.xxx.xxx.xxx,xxx.xxx.xxx.xxx,xxx.xxx.xxx.xxx

2. Controller サーバの JMeter 起動スクリプト調整

vi /usr/local/jmeter/bin/start-controller_cui.sh

-> 以下変数に使用するシナリオファイルを絶対パスで定義

FILE_JMX=/path/to/sample.jmx

3. JMeter の起動（ 負荷試験開始 ）

/usr/local/jmeter/bin/start-controller_cui.sh

-> 試験結果レポートは Apache のドキュメントルート配下に生成されます。
※ ブラウザを使用して Controller サーバに接続し、レポートを確認することができます。

トラシュー

vncserver が立ち上がらない時

rm /tmp/.X11-unix/*
systemctl restart vncserver@:1.service

Version

release/0.0.5