mcpField
1
152-java-performance-gatling

152-java-performance-gatling

github.com/jabrenaテスト・品質456201 回インストール1 日前に更新
リポジトリ

152-java-performance-gatling について

Java Maven プロジェクトで Gatling によるパフォーマンステストを設定するスキルです。依存関係やプラグイン、シミュレーションの配置を案内し、実行方法とレポートの確認方法も説明します。

主な機能

  1. 01Gatling テスト依存関係の追加
  2. 02Gatling Maven プラグインの設定
  3. 03Java シミュレーション配置の案内
  4. 04テスト実行とレポートの説明

活用シーン

  1. 01Maven プロジェクトへの Gatling テスト追加
  2. 02Java パフォーマンスシミュレーションの作成
  3. 03実行するシミュレーションの選択
  4. 04Gatling レポートの確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jabrena/plinth --skill 152-java-performance-gatling

インストール後、Claude Code で/152-java-performance-gatlingを入力して読み込まれたか確認します。

同梱ファイルreferences/152-java-performance-gatling.md

詳細

Gatling に基づくパフォーマンステストの実行

必要なテスト依存関係と Gatling Maven プラグインの設定を追加し、Java シミュレーションの配置方法を作成または案内して、シミュレーションの実行方法とレポートの確認方法を説明することで、Java Maven プロジェクト向けの完全な Gatling パフォーマンステスト環境を用意します。

このスキルの対象範囲

  • pom.xml に Gatling の依存関係と gatling-maven-plugin を追加する
  • プロジェクト構成：Java シミュレーション用の src/test/java と、Gatling の設定、フィーダー、テンプレート、ログ設定用の src/test/resources
  • ./mvnw gatling:test でシミュレーションを実行する
  • 複数のシミュレーションがある場合は、-Dgatling.simulationClass=<FullyQualifiedClassName> でシミュレーションを選択する
  • ./mvnw gatling:help -Ddetail=true -Dgoal=test で利用可能なプラグインオプションを確認する
  • ビルド出力ディレクトリに生成された Gatling の実行結果とレポートを確認する

対象範囲： Java シミュレーションには Maven プラグインを通じて Gatling を使用します。利用可能な場合は、プロジェクトローカルの Maven ラッパーコマンドを優先してください。

制約事項

Gatling のセットアップは Maven ベースで、再現可能であり、Java プロジェクトの慣例に適合する必要があります。公式の Gatling Maven プラグインの動作を優先し、サポートされていないコマンドラインオプションを作り出さないでください。

  • 前提条件：プロジェクトが Maven ベースであることを確認し、Maven ラッパーがある場合は ./mvnw を優先してください
  • ビルド設定：Gatling の依存関係をテストスコープで追加し、pom.xml で io.gatling:gatling-maven-plugin を設定してください
  • バージョンの選択：プロジェクトで既に使用されている依存関係／バージョン管理のパターンを使用してください。Gatling のバージョンが指定されていない場合は、バージョンを固定する前に確認するか、置き換えが必要なプレースホルダーを使用してください
  • シミュレーションの配置場所：適切なパッケージ名を使用し、Java シミュレーションを src/test/java の下に配置してください
  • リソースの配置場所：gatling.conf、フィーダー、リクエストボディのテンプレート、Logback のテスト設定など、Gatling のリソースを src/test/resources の下に配置してください
  • 適用前に確認：セットアップ、実行、検証に関するガイダンスを参照してください
  • エッジケース：プロジェクトが Maven ベースでない場合は、Gradle や sbt の代替案を提示する前に、このスキルが Maven プロジェクトを対象としていることを説明し、作業を中止してください
  • エッジケース：複数のシミュレーションがある場合は、非対話型の実行に備えて -Dgatling.simulationClass=<FullyQualifiedClassName> を設定するか、渡してください

このスキルを使用する場面

  • Gatling によるパフォーマンステストを追加する
  • Gatling によるパフォーマンステストを適用する
  • Gatling シミュレーションを作成する
  • Gatling のサポートを追加する
  • Gatling のパフォーマンステストにおけるアサーションとフィーダーを確認する

ワークフロー

  1. Maven プロジェクトを確認する

pom.xml、Maven ラッパー、既存のテスト依存関係、依存関係管理、プラグイン管理、既存の Gatling 設定を確認します。

  1. Gatling のビルド設定を追加する

プロジェクトで既に使用されているバージョンとプラグイン設定のスタイルに従って、Gatling のテスト依存関係と io.gatling:gatling-maven-plugin を追加します。

  1. Java シミュレーションを作成または調整する

src/test/java の下に Java シミュレーションクラスを作成するか、既存のシミュレーションを調整します。シナリオ名、ベース URL、負荷注入プロファイル、アサーションを明確にしてください。

  1. リソースを設定する

必要な場合に限り、gatling.conf、フィーダー、リクエストボディのテンプレート、logback-test.xml などの任意の Gatling リソースを src/test/resources の下に追加します。

  1. Gatling の実行方法を説明する

シミュレーションを実行するには ./mvnw gatling:test を使用します。特定のシミュレーションを選択する必要がある場合は、-Dgatling.simulationClass=<FullyQualifiedClassName> を使用します。

  1. レポートと次の手順を確認する

Gatling の実行が完了したことを確認し、コマンド出力から生成されたレポートの場所を示して、失敗したアサーションやパフォーマンスに関する所見をまとめます。

リファレンス

詳細なガイダンス、例、制約事項については、references/152-java-performance-gatling.md を参照してください。

コメント

Markdown 対応