JMeter APIクライアントとCI/CDパイプラインの統合

このガイドでは、LoadFocus JMeter APIクライアントをCircleCI、Azure DevOps、GitHub Actionsなどの主要なCI/CDプラットフォームと統合し、デプロイメントパイプラインの一部として自動化されたパフォーマンステストを実現する方法を説明します。

目次

一般的なアプローチ

CI/CDプラットフォームに関係なく、LoadFocus JMeter APIクライアントの統合には共通の手順があります：

クライアントのインストール：ワークフローの開始時に@loadfocus/loadfocus-api-clientをインストール
資格情報の設定：APIキーとチームIDを安全に設定
テストの実行：パイプラインの一部としてテストを実行
結果の処理：テスト結果を収集・分析
意思決定：テスト結果に基づいてデプロイメントを進めるかどうかを判断

ベストプラクティス

LoadFocus JMeter APIクライアントをCI/CDパイプラインに統合する際は、以下のベストプラクティスを考慮してください：

セキュリティ

APIキーやチームIDをパイプライン設定にハードコードしない
CI/CDプラットフォームのシークレット管理システムを使用する
パフォーマンステスト結果へのアクセスを権限のある担当者に制限する

パフォーマンステスト設定

テストされるブランチ/環境を含む説明的なテスト名を使用する
アプリケーションのパフォーマンス要件に基づいて適切なしきい値を設定する
異なる環境に対して異なるテストプロファイルの実行を検討する（例：開発環境は軽いテスト、ステージング環境はフルテスト）

パイプライン統合

機能テストが合格した後にパフォーマンステストを実行する
パフォーマンステストを他の非ブロッキングタスクと並行して実行することを検討する
パフォーマンステスト失敗時の通知を設定する

結果分析

履歴比較のためにパフォーマンステスト結果をアーティファクトとして保存する
時間経過に伴うパフォーマンスの低下を検出するためのトレンド分析の実装を検討する
比較のためにベースラインパフォーマンスメトリクスを文書化する

トラブルシューティング

よくある問題

テスト実行の失敗

APIキーとチームIDが正しく設定されていることを確認する
アカウントの同時テスト制限に達していないか確認する
テスト名がLoadFocusアカウントに存在することを確認する

しきい値が期待通りに機能しない

しきい値の構文が正しいことを確認する（例：avgresponse<=200,errors==0）
評価しているメトリクスがテストに関連しているか確認する
テストが意味のある結果を生成するのに十分な負荷を生成していることを確認する

パイプラインのタイムアウト

CI/CD設定のタイムアウト設定を調整する
テスト実行時間を制限するために--waitTimeoutパラメータの使用を検討する
長時間実行されるテストの場合、パイプラインで待機する代わりにポーリングメカニズムを実装する

プラットフォーム固有の統合の詳細については、CircleCI、Azure DevOps、GitHub Actions、Jenkins、GitLab CI/CDの専用ガイドをご覧ください。

Jenkinsインテグレーション

負荷ジェネレーターに割り当てられるハードウェアリソースは？