Løsning af problemer med Quarkus-tests, testbeholdere og Liquibase-integration

Sikring af korrekt integration mellem Liquibase og testcontainere i Quarkus

Backend-løsning, der bruger Quarkus med TestContainers til at administrere PostgreSQL- og Liquibase-migreringer. Dette script løser problemer med containerfejljustering.

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 af applikation-Liquibase-integration ved hjælp af enhedstests

Et modulært og genanvendeligt Quarkus-testeksempel, der verificerer databaseforbindelsen og udførelse af migreringsscript.

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

Sikring af konfigurationskonsistens på tværs af testprofiler

Tilpasset testprofilkonfiguration for at garantere justering mellem Liquibase og applikationsbeholdere.

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 til datavalidering

Dynamisk frontend-kodestykke for at sikre, at data fra databaseintegration vises korrekt.

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

Enhedstest for Backend- og Front-End-konsistens

Eksempler på testscripts til at validere både backend-logik og frontend-integration 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));
    }
}

Ofte stillede spørgsmål om Quarkus, TestContainers og Liquibase Integration

1. Hvad er rollen TestContainers i integrationstest?
2. TestContainers hjælper med at administrere isolerede databaseforekomster under test, hvilket sikrer ensartede miljøer.
3. Hvorfor har jeg brug for withReuse(true) kommando?
4. De withReuse(true) kommandoen giver dig mulighed for at genbruge den samme container på tværs af flere tests, hvilket sparer ressourcer og opsætningstid.
5. Hvad er formålet med TC_INITSCRIPT ejendom?
6. De TC_INITSCRIPT egenskaben angiver et initialiserings-SQL-script til at seed databasen ved containerstart.
7. Hvordan sikrer jeg, at Liquibase-migreringer anvendes korrekt?
8. Ved at konfigurere quarkus.liquibase.jdbc.url egenskab, kan du sikre, at Liquibase bruger den samme databasebeholder som applikationen.
9. Hvilke logniveauer skal jeg bruge til fejlretning?
10. Sæt TRACE eller DEBUG niveauer for Liquibase og TestContainere til at overvåge databaseoperationer og migreringer.
11. Hvordan kan jeg teste API-svar med seeded data?
12. Brug værktøjer som f.eks RestAssured at sende anmodninger til slutpunkter og kontrollere, at de returnerede data stemmer overens med testdataene.
13. Hvad gør @QuarkusTestResource anmærkning gøre?
14. De @QuarkusTestResource annotation registrerer en brugerdefineret livscyklusmanager for eksterne afhængigheder som databaser.
15. Hvorfor har jeg brug for en brugerdefineret TestProfileResolver?
16. Det sikrer, at de korrekte konfigurationer indlæses til testudførelse, justering af miljøvariabler og ressourcer.
17. Hvordan kan jeg registrere, om der oprettes flere containere?
18. Tjek din Docker Desktop eller overvåg konsollogfilerne for duplikerede containerforekomster og deres respektive porte.
19. Hvad er den bedste måde at rydde op i testressourcer på?
20. Tilsidesæt stop metode i din livscyklusmanager til at stoppe og fjerne beholderen, efter at testene er gennemført.

Nøglemuligheder til løsning af testkonflikter

Integrationstest med Quarkus, Liquibase og TestContainers kræver omhyggelig opsætning for at sikre, at migreringer og databaseinteraktioner stemmer overens. Ved at tilpasse din testressourcemanager og bruge en samlet konfiguration kan du eliminere konflikter mellem de containere, der bruges af Liquibase, og din applikation.

Disse trin hjælper med at strømline din testproces, hvilket gør det nemmere at fejlfinde og validere dine tests. Husk at bruge detaljerede logfiler, såsom aktivering SPOR for Liquibase, for at overvåge adfærden af ​​dine tests og løse uoverensstemmelser tidligt. Med denne tilgang kan du trygt bygge skalerbare og vedligeholdelige tests. 🐛