Løse problemer med Quarkus-tester, testbeholdere og Liquibase-integrasjon

Sikre riktig integrasjon mellom Liquibase og testcontainere i Quarkus

Backend-løsning som bruker Quarkus med TestContainers for å administrere PostgreSQL- og Liquibase-migreringer. Dette skriptet løser problemer med containerfeiljustering.

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();
        }
    }
}

Validering av applikasjon-Liquibase-integrasjon ved hjelp av enhetstester

Et modulært og gjenbrukbart Quarkus-testeksempel som verifiserer databasetilkoblingen og kjøring av migreringsskript.

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.");
    }
}

Sikre konfigurasjonskonsistens på tvers av testprofiler

Tilpasset testprofilkonfigurasjon for å garantere justering mellom Liquibase og applikasjonsbeholdere.

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");
    }
}

Front-end-simulering for datavalidering

Dynamisk frontend-kodebit for å sikre at data fra databaseintegrasjon vises riktig.

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));

Enhetstester for konsistens i backend og front-end

Eksempel på testskript for å validere både backend-logikk og frontend-integrasjon med testdata.

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));
    }
}

Vanlige spørsmål om Quarkus, TestContainers og Liquibase-integrasjon

1. Hva er rollen til TestContainers i integrasjonstester?
2. TestContainers hjelper med å administrere isolerte databaseforekomster under testing, og sikrer konsistente miljøer.
3. Hvorfor trenger jeg withReuse(true) kommando?
4. De withReuse(true) kommando lar deg gjenbruke den samme beholderen på tvers av flere tester, og sparer ressurser og oppsettstid.
5. Hva er hensikten med TC_INITSCRIPT eiendom?
6. De TC_INITSCRIPT egenskapen spesifiserer et initialiserings-SQL-skript for å starte databasen ved oppstart av beholderen.
7. Hvordan sikrer jeg at Liquibase-migreringer brukes riktig?
8. Ved å konfigurere quarkus.liquibase.jdbc.url egenskap, kan du sikre at Liquibase bruker samme databasebeholder som applikasjonen.
9. Hvilke loggnivåer bør jeg bruke for feilsøking?
10. Sett TRACE eller DEBUG nivåer for Liquibase og TestContainers for å overvåke databaseoperasjoner og migreringer.
11. Hvordan kan jeg teste API-svar med seeded data?
12. Bruk verktøy som RestAssured å sende forespørsler til endepunkter og bekrefte at dataene som returneres samsvarer med testdataene.
13. Hva gjør @QuarkusTestResource annotering gjøre?
14. De @QuarkusTestResource merknad registrerer en tilpasset livssyklusbehandler for eksterne avhengigheter som databaser.
15. Hvorfor trenger jeg en tilpasset TestProfileResolver?
16. Det sikrer at de riktige konfigurasjonene lastes inn for testkjøring, justering av miljøvariabler og ressurser.
17. Hvordan kan jeg oppdage om flere beholdere blir opprettet?
18. Sjekk Docker Desktop eller overvåk konsollloggene for dupliserte containerforekomster og deres respektive porter.
19. Hva er den beste måten å rydde opp i testressurser?
20. Overstyr stop metoden i livssyklusbehandlingen for å stoppe og fjerne beholderen etter at testene er fullført.

Nøkkelmuligheter for å løse testkonflikter

Integrasjonstesting med Quarkus, Liquibase og TestContainers krever nøye oppsett for å sikre at migreringer og databaseinteraksjoner stemmer overens. Ved å tilpasse testressursbehandlingen og bruke en enhetlig konfigurasjon kan du eliminere konflikter mellom beholderne som brukes av Liquibase og applikasjonen din.

Disse trinnene hjelper til med å strømlinjeforme testprosessen, noe som gjør det enklere å feilsøke og validere testene dine. Husk å bruke detaljerte logger, for eksempel aktivering SPOR for Liquibase, for å overvåke oppførselen til testene dine og løse avvik tidlig. Med denne tilnærmingen kan du trygt bygge skalerbare og vedlikeholdbare tester. 🐛