Resolució de problemes amb les proves Quarkus, els contenidors de prova i la integració de Liquibase

Garantir la integració adequada entre Liquibase i TestContainers a Quarkus

Solució de backend que utilitza Quarkus amb TestContainers per gestionar les migracions de PostgreSQL i Liquibase. Aquest script resol els problemes de desalineació dels contenidors.

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

Validació de la integració aplicació-liquibase mitjançant proves unitàries

Un exemple de prova de Quarkus modular i reutilitzable que verifica la connexió de la base de dades i l'execució de l'script de migració.

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

Assegurar la coherència de la configuració entre els perfils de prova

Configuració personalitzada del perfil de prova per garantir l'alineació entre Liquibase i els contenidors d'aplicacions.

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

Simulació frontal per a la validació de dades

Fragment de codi frontal dinàmic per garantir que les dades de la integració de la base de dades es mostrin correctament.

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

Proves d'unitat de coherència de backend i front-end

Exemples de scripts de prova per validar tant la lògica del backend com la integració del front-end amb les dades de prova.

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

Preguntes freqüents sobre Quarkus, TestContainers i la integració de Liquibase

1. Quin és el paper de TestContainers en proves d'integració?
2. TestContainers ajuda a gestionar instàncies de bases de dades aïllades durant les proves, garantint entorns coherents.
3. Per què necessito el withReuse(true) comandar?
4. El withReuse(true) L'ordre us permet reutilitzar el mateix contenidor en diverses proves, estalviant recursos i temps de configuració.
5. Quina és la finalitat del TC_INITSCRIPT propietat?
6. El TC_INITSCRIPT La propietat especifica un script SQL d'inicialització per iniciar la base de dades a l'inici del contenidor.
7. Com puc assegurar-me que les migracions de Liquibase s'apliquen correctament?
8. Configurant el quarkus.liquibase.jdbc.url propietat, podeu assegurar-vos que Liquibase utilitza el mateix contenidor de base de dades que l'aplicació.
9. Quins nivells de registre he d'utilitzar per a la depuració?
10. Set TRACE o DEBUG nivells per a Liquibase i TestContainers per supervisar les operacions de la base de dades i les migracions.
11. Com puc provar les respostes de l'API amb dades sembrades?
12. Utilitzeu eines com RestAssured per enviar sol·licituds als punts finals i verificar que les dades retornades coincideixen amb les dades de prova.
13. Què fa el @QuarkusTestResource anotació fer?
14. El @QuarkusTestResource anotació registra un gestor de cicle de vida personalitzat per a dependències externes, com ara bases de dades.
15. Per què necessito un TestProfileResolver personalitzat?
16. Assegura que es carreguen les configuracions correctes per a l'execució de proves, alineant les variables d'entorn i els recursos.
17. Com puc detectar si s'estan creant diversos contenidors?
18. Comproveu el vostre escriptori Docker o superviseu els registres de la consola per trobar instàncies de contenidors duplicades i els seus ports respectius.
19. Quina és la millor manera de netejar els recursos de prova?
20. Anul·lar el stop mètode del vostre gestor de cicle de vida per aturar i treure el contenidor un cop finalitzades les proves.

Punts clau per resoldre els conflictes de proves

Les proves d'integració amb Quarkus, Liquibase i TestContainers requereixen una configuració acurada per garantir que les migracions i les interaccions de la base de dades s'alineen. Si personalitzeu el vostre gestor de recursos de prova i utilitzeu una configuració unificada, podeu eliminar els conflictes entre els contenidors utilitzats per Liquibase i la vostra aplicació.

Aquests passos ajuden a racionalitzar el procés de prova, facilitant la depuració i validació de les proves. Recordeu utilitzar registres detallats, com ara l'habilitació TRAÇA per a Liquibase, per supervisar el comportament de les vostres proves i resoldre les discrepàncies amb antelació. Amb aquest enfocament, podeu crear proves escalables i mantenir amb confiança. 🐛