Quarkus テスト、テスト コンテナ、および Liquibase 統合に関する問題の解決

Quarkus での Liquibase と TestContainers 間の適切な統合の確保

Quarkus と TestContainers を使用して PostgreSQL と Liquibase の移行を管理するバックエンド ソリューション。このスクリプトは、コンテナーの位置ずれの問題を解決します。

import org.testcontainers.containers.PostgreSQLContainer;
import org.testcontainers.utility.DockerImageName;
import java.util.HashMap;
import java.util.Map;
public class PostgreSQLTestResource implements QuarkusTestResourceLifecycleManager {
    private static PostgreSQLContainer<?> postgreSQLContainer;
    @Override
    public Map<String, String> start() {
        postgreSQLContainer = new PostgreSQLContainer<>(DockerImageName.parse("postgres:alpine"))
            .withDatabaseName("test")
            .withUsername("postgres")
            .withPassword("password")
            .withReuse(true);
        postgreSQLContainer.start();
        Map<String, String> config = new HashMap<>();
        config.put("quarkus.datasource.jdbc.url", postgreSQLContainer.getJdbcUrl());
        config.put("quarkus.datasource.username", postgreSQLContainer.getUsername());
        config.put("quarkus.datasource.password", postgreSQLContainer.getPassword());
        return config;
    }
    @Override
    public void stop() {
        if (postgreSQLContainer != null) {
            postgreSQLContainer.stop();
        }
    }
}

単体テストを使用したアプリケーションとLiquibaseの統合の検証

データベース接続と移行スクリプトの実行を検証する、モジュール式で再利用可能な Quarkus テストの例。

import org.junit.jupiter.api.Test;
import io.quarkus.test.junit.QuarkusTest;
import io.quarkus.test.junit.TestProfile;
@QuarkusTest
@TestProfile(TestProfileResolver.class)
public class XServiceTest {
    @Inject
    XTypeVersionService xTypeVersionService;
    @Test
    public void getXTypeVersion() {
        List<XTypeVersionEntity> entities = xTypeVersionService.get();
        assertFalse(entities.isEmpty(), "The entity list should not be empty.");
    }
}

テストプロファイル全体での設定の一貫性の確保

Liquibase とアプリケーション コンテナ間の調整を保証するためのカスタム テスト プロファイル構成。

public class TestProfileResolver implements QuarkusTestProfile {
    @Override
    public String getConfigProfile() {
        return "test";
    }
    @Override
    public Map<String, String> getConfigOverrides() {
        return Map.of("quarkus.config.locations", "src/test/resources/application.yaml");
    }
}

データ検証のためのフロントエンド シミュレーション

データベース統合からのデータが正しく表示されることを保証するための動的なフロントエンド コード スニペット。

fetch('/api/xTypeVersion')
    .then(response => response.json())
    .then(data => {
        const list = document.getElementById('entity-list');
        data.forEach(entity => {
            const item = document.createElement('li');
            item.textContent = entity.name;
            list.appendChild(item);
        });
    })
    .catch(error => console.error('Error fetching data:', error));

バックエンドとフロントエンドの一貫性のための単体テスト

バックエンド ロジックとフロントエンドのテスト データとの統合の両方を検証するテスト スクリプトの例。

import org.junit.jupiter.api.Test;
public class FrontEndValidationTest {
    @Test
    public void fetchData() {
        given().when().get("/api/xTypeVersion")
            .then().statusCode(200)
            .body("size()", greaterThan(0));
    }
}

Quarkus、TestContainers、Liquibase の統合に関する FAQ

1. の役割は何ですか TestContainers 統合テストでは？
2. TestContainers テスト中に分離されたデータベース インスタンスを管理し、一貫した環境を確保するのに役立ちます。
3. なぜ必要なのでしょうか withReuse(true) 指示？
4. の withReuse(true) コマンドを使用すると、複数のテストで同じコンテナを再利用できるため、リソースとセットアップ時間を節約できます。
5. の目的は何ですか TC_INITSCRIPT 財産？
6. の TC_INITSCRIPT プロパティは、コンテナーの起動時にデータベースをシードするための初期化 SQL スクリプトを指定します。
7. Liquibase の移行が正しく適用されていることを確認するにはどうすればよいですか?
8. を設定することで、 quarkus.liquibase.jdbc.url プロパティを使用すると、Liquibase がアプリケーションと同じデータベース コンテナを使用するようにすることができます。
9. デバッグにはどのログ レベルを使用すればよいですか?
10. セット TRACE または DEBUG Liquibase と TestContainers がデータベースの操作と移行を監視するためのレベル。
11. シードされたデータを使用して API 応答をテストするにはどうすればよいですか?
12. 次のようなツールを使用します RestAssured エンドポイントにリクエストを送信し、返されたデータがテスト データと一致することを確認します。
13. は何ですか @QuarkusTestResource 注釈はしますか？
14. の @QuarkusTestResource アノテーションは、データベースなどの外部依存関係のカスタム ライフサイクル マネージャーを登録します。
15. カスタム TestProfileResolver が必要なのはなぜですか?
16. これにより、テスト実行のために正しい構成がロードされ、環境変数とリソースが調整されるようになります。
17. 複数のコンテナが作成されているかどうかを検出するにはどうすればよいですか?
18. Docker デスクトップを確認するか、コンソール ログを監視して、重複したコンテナ インスタンスとそれぞれのポートを確認します。
19. テスト リソースをクリーンアップする最善の方法は何ですか?
20. オーバーライド stop ライフサイクル マネージャーのメソッドを使用して、テストの完了後にコンテナを停止して削除します。

テストの競合を解決するための重要なポイント

Quarkus、Liquibase、および TestContainers との統合テストでは、移行とデータベースの相互作用を確実に調整するために慎重なセットアップが必要です。テスト リソース マネージャーをカスタマイズし、統合された構成を使用することにより、Liquibase で使用されるコンテナーとアプリケーション間の競合を排除できます。

これらの手順は、テスト プロセスを合理化し、テストのデバッグと検証を容易にするのに役立ちます。詳細なログを使用することを忘れないでください。 トレース Liquibase の場合、テストの動作を監視し、不一致を早期に解決します。このアプローチを使用すると、スケーラブルで保守可能なテストを自信を持って構築できます。 🐛