======================================================================== テスト操作手順 (Test Operation Guide) ======================================================================== 1. 概要 (Overview) ------------------------------------------------------------------------ 本ドキュメントは，プロジェクト内のテスト関連ファイルの実行方法を整理し，チーム内で共通の運用手順を共有することを目的とする． 1-1. 対象範囲 ■ 対象ファイル ・テスト実行用スクリプト: /workspace/test/load-bot.mjs ・テスト用依存定義: /workspace/test/package.json ■ 対象外 ・アプリ本体のビルドと起動手順 ・本番運用の監視設定 2. 前提条件 (Prerequisites) ------------------------------------------------------------------------ 2-1. 環境 ・Node.js / pnpm が利用可能であること ・インターネット接続が利用可能であること 2-2. 設定値 ■ 接続先URL ・既定値: https://skillsemiwebgame.onrender.com ・変更方法: CLI引数または環境変数で指定する 3. 実行手順 (Execution Steps) ------------------------------------------------------------------------ 3-1. 初回準備 1. テスト用ディレクトリへ移動 - コマンド: $ cd /workspace/test 2. 依存関係のインストール - コマンド: $ pnpm install 3-2. 実行 1. テストの実行 - コマンド: $ pnpm start 2. パラメータ指定の例 - コマンド: $ pnpm start -- --bots=30 --rooms=3 --duration-ms=60000 4. パラメータ一覧 (Parameters) ------------------------------------------------------------------------ 4-1. CLI引数 ・--url: 接続先URL ・--bots: 同時接続数 ・--rooms: ルーム数 ・--duration-ms: 実行時間 (ms) ・--join-delay-ms: 参加間隔 (ms) ・--start-game: ゲーム開始の有効化 (1/0) ・--move-interval-ms: 移動送信間隔 (ms) ・--max-x: X座標上限 ・--max-y: Y座標上限 4-2. 環境変数 ・TARGET_URL: 接続先URL ・BOTS: 同時接続数 ・ROOMS: ルーム数 ・DURATION_MS: 実行時間 (ms) ・JOIN_DELAY_MS: 参加間隔 (ms) ・START_GAME: ゲーム開始の有効化 (1/0) ・MOVE_INTERVAL_MS: 移動送信間隔 (ms) ・MAX_X: X座標上限 ・MAX_Y: Y座標上限 5. 出力と終了 (Output & Termination) ------------------------------------------------------------------------ 5-1. 標準出力 ・開始時に設定値が出力される ・終了時に簡易統計 (接続数など) が出力される 5-2. 終了方法 ・指定時間経過後に自動終了する ・途中終了する場合はプロセスを終了する 6. 注意事項 (Notes) ------------------------------------------------------------------------ 6-1. 本番サーバへの負荷 ・負荷テストは低負荷から段階的に実施すること ・必要に応じて管理者へ事前連絡を行うこと 6-2. 依存関係 ・test配下は独立した依存関係を持つため，別途pnpm installが必要になる 6-3. 計測の限界 ・本スクリプトは簡易負荷確認用であり，詳細な計測は専用ツールの利用を推奨する