422-frameworks-quarkus-testing-integration-tests

Quarkus 統合テスト

実際の配線と再現可能なインフラストラクチャを使用して、Quarkus の統合テストパターンを適用します。

このスキルで扱う内容

• 実際の CDI 配線を使用した JVM 内統合テストのための @QuarkusTest
• コンテナーを自動的にプロビジョニングする Dev Services（%test.quarkus.datasource.devservices）
• QuarkusTestResourceLifecycleManager を介した Testcontainers（起動／停止のライフサイクル、動的な設定の注入）
• QuarkusTestResourceLifecycleManager を介した外部 HTTP サービスのスタブ化に使う WireMock
• パッケージ化された JAR またはネイティブバイナリに対するブラックボックステストのための @QuarkusIntegrationTest
• Quarkus のテストポートに対する REST Assured を使用した HTTP テスト
• データの分離：自動ロールバック用の @TestTransaction、HTTP テストのための @BeforeEach によるクリーンアップ
• Maven の 3 階層分割：*Test → Surefire（高速）、*IT + *AT → Failsafe（verify）
• @DisabledOnNativeImage を使用するネイティブイメージのテストに関する考慮事項

範囲： リファレンスのルールと適切／不適切なコード例に基づいて、推奨事項を適用します。

制約

変更前にコンパイルし、変更後に検証してください。コンテナーには Docker が必要な場合があります。

• 必須：変更を適用する前に ./mvnw compile または mvn compile を実行してください
• 前提条件：統合テストを改善する前に、プロジェクトがコンパイルできる必要があります
• 安全性：コンパイルに失敗した場合は、直ちに作業を中止してください
• ブロッキング条件：コンパイルエラーは、作業を続行する前にユーザーが解決する必要があります
• 検証：改善を適用した後、./mvnw clean verify または mvn clean verify を実行してください。Testcontainers と Dev Services には Docker が必要です
• 適用前：詳細なルールと例について、リファレンスを読んでください

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

• Quarkus プロジェクトに統合テストを追加または改善する
• Quarkus のテスト用に Testcontainers または Dev Services を設定する
• Quarkus の統合テストで外部 HTTP 依存関係用の WireMock スタブを追加する
• パッケージ化された成果物またはネイティブバイナリをテストするために @QuarkusIntegrationTest を設定する
• テストデータの分離を修正する、または Maven の Surefire／Failsafe 分割を設定する

ワークフロー

1. リファレンスを読み、プロジェクトのコンテキストを評価する

変更を提案する前に references/422-frameworks-quarkus-testing-integration-tests.md を読み、現在のプロジェクト設定を確認してください。

2. 範囲を把握し、改善対象を決める

求められる結果と制約を特定し、適用する変更を安全に必要な最小限の範囲に絞ります。

3. フレームワークに沿った変更を適用する

リファレンスのパターンとプロジェクトの規約に従って、設定やコードを実装またはリファクタリングします。

4. 検証を実行し、結果を報告する

適切なビルドやテストを実行し、変更内容、検証内容、必要なフォローアップ作業をまとめます。

リファレンス

詳細なガイダンス、例、制約については、references/422-frameworks-quarkus-testing-integration-tests.md を参照してください。