Problemen oplossen met Quarkus-tests, testcontainers en Liquibase-integratie

Zorgen voor een goede integratie tussen Liquibase en TestContainers in Quarkus

Backend-oplossing die Quarkus gebruikt met TestContainers om PostgreSQL- en Liquibase-migraties te beheren. Dit script lost problemen met onjuiste uitlijning van containers op.

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

Validatie van applicatie-Liquibase-integratie met behulp van unit-tests

Een modulair en herbruikbaar Quarkus-testvoorbeeld dat de databaseverbinding en uitvoering van het migratiescript verifieert.

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

Garanderen van configuratieconsistentie tussen testprofielen

Aangepaste testprofielconfiguratie om afstemming tussen Liquibase en applicatiecontainers te garanderen.

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-endsimulatie voor gegevensvalidatie

Dynamisch front-end codefragment om ervoor te zorgen dat gegevens uit de database-integratie correct worden weergegeven.

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

Unit-tests voor backend- en front-end-consistentie

Voorbeeldtestscripts om zowel backend-logica als front-end-integratie met testgegevens te valideren.

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

Veelgestelde vragen over Quarkus, TestContainers en Liquibase-integratie

1. Wat is de rol van TestContainers bij integratietesten?
2. TestContainers helpt bij het beheren van geïsoleerde database-instances tijdens het testen, waardoor consistente omgevingen worden gegarandeerd.
3. Waarom heb ik de withReuse(true) commando?
4. De withReuse(true) Met command kunt u dezelfde container voor meerdere tests hergebruiken, waardoor u bronnen en insteltijd bespaart.
5. Wat is het doel van de TC_INITSCRIPT eigendom?
6. De TC_INITSCRIPT eigenschap specificeert een initialisatie-SQL-script om de database te seeden bij het opstarten van de container.
7. Hoe zorg ik ervoor dat Liquibase-migraties correct worden uitgevoerd?
8. Door het configureren van de quarkus.liquibase.jdbc.url property, kunt u er zeker van zijn dat Liquibase dezelfde databasecontainer gebruikt als de applicatie.
9. Welke logniveaus moet ik gebruiken voor foutopsporing?
10. Set TRACE of DEBUG niveaus voor Liquibase en TestContainers om databasebewerkingen en -migraties te monitoren.
11. Hoe kan ik API-reacties testen met geplaatste gegevens?
12. Gebruik hulpmiddelen zoals RestAssured om verzoeken naar eindpunten te sturen en te verifiëren dat de geretourneerde gegevens overeenkomen met de testgegevens.
13. Wat doet de @QuarkusTestResource annotatie doen?
14. De @QuarkusTestResource annotatie registreert een aangepaste levenscyclusmanager voor externe afhankelijkheden zoals databases.
15. Waarom heb ik een aangepaste TestProfileResolver nodig?
16. Het zorgt ervoor dat de juiste configuraties worden geladen voor testuitvoering, waarbij omgevingsvariabelen en bronnen op één lijn worden gebracht.
17. Hoe kan ik detecteren of er meerdere containers worden gemaakt?
18. Controleer uw Docker Desktop of controleer de consolelogboeken op dubbele containerinstanties en hun respectieve poorten.
19. Wat is de beste manier om testbronnen op te schonen?
20. Overschrijf de stop methode in uw levenscyclusmanager om de container te stoppen en te verwijderen nadat de tests zijn voltooid.

Belangrijkste aandachtspunten voor het oplossen van testconflicten

Integratietesten met Quarkus, Liquibase en TestContainers vereisen een zorgvuldige opzet om ervoor te zorgen dat migraties en database-interacties op één lijn liggen. Door uw testresourcemanager aan te passen en een uniforme configuratie te gebruiken, kunt u conflicten tussen de containers die door Liquibase worden gebruikt en uw applicatie elimineren.

Met deze stappen kunt u uw testproces stroomlijnen, waardoor het eenvoudiger wordt om uw tests te debuggen en te valideren. Vergeet niet om gedetailleerde logboeken te gebruiken, zoals het inschakelen SPOOR voor Liquibase, om het gedrag van uw tests te monitoren en afwijkingen vroegtijdig op te lossen. Met deze aanpak kunt u vol vertrouwen schaalbare en onderhoudbare tests bouwen. 🐛