Resolución de problemas con las pruebas de Quarkus, los contenedores de prueba y la integración de Liquibase

Garantizar la integración adecuada entre Liquibase y TestContainers en Quarkus

Solución backend que utiliza Quarkus con TestContainers para gestionar migraciones de PostgreSQL y Liquibase. Este script resuelve problemas de desalineación de contenedores.

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ón de la integración entre aplicaciones y Liquibase mediante pruebas unitarias

Un ejemplo de prueba de Quarkus modular y reutilizable que verifica la conexión de la base de datos y la ejecución del script de migración.

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

Garantizar la coherencia de la configuración en todos los perfiles de prueba

Configuración de perfil de prueba personalizado para garantizar la alineación entre Liquibase y los contenedores de aplicaciones.

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ón front-end para validación de datos

Fragmento de código de interfaz dinámico para garantizar que los datos de la integración de la base de datos se muestren correctamente.

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

Pruebas unitarias para la coherencia del backend y del front-end

Scripts de prueba de ejemplo para validar tanto la lógica de backend como la integración de frontend con datos de prueba.

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

Preguntas frecuentes sobre la integración de Quarkus, TestContainers y Liquibase

1. ¿Cuál es el papel de TestContainers en pruebas de integración?
2. TestContainers ayuda a gestionar instancias de bases de datos aisladas durante las pruebas, garantizando entornos consistentes.
3. ¿Por qué necesito el withReuse(true) ¿dominio?
4. El withReuse(true) El comando le permite reutilizar el mismo contenedor en múltiples pruebas, ahorrando recursos y tiempo de configuración.
5. ¿Cuál es el propósito de la TC_INITSCRIPT ¿propiedad?
6. El TC_INITSCRIPT La propiedad especifica un script SQL de inicialización para inicializar la base de datos al iniciar el contenedor.
7. ¿Cómo me aseguro de que las migraciones de Liquibase se apliquen correctamente?
8. Al configurar el quarkus.liquibase.jdbc.url propiedad, puede asegurarse de que Liquibase utilice el mismo contenedor de base de datos que la aplicación.
9. ¿Qué niveles de registro debo usar para la depuración?
10. Colocar TRACE o DEBUG niveles para Liquibase y TestContainers para monitorear las operaciones y migraciones de bases de datos.
11. ¿Cómo puedo probar las respuestas de la API con datos inicializados?
12. Utilice herramientas como RestAssured para enviar solicitudes a los puntos finales y verificar que los datos devueltos coincidan con los datos de prueba.
13. ¿Qué hace el @QuarkusTestResource anotación hacer?
14. El @QuarkusTestResource La anotación registra un administrador de ciclo de vida personalizado para dependencias externas como bases de datos.
15. ¿Por qué necesito un TestProfileResolver personalizado?
16. Garantiza que se carguen las configuraciones correctas para la ejecución de pruebas, alineando las variables de entorno y los recursos.
17. ¿Cómo puedo detectar si se están creando varios contenedores?
18. Verifique su Docker Desktop o supervise los registros de la consola para detectar instancias de contenedor duplicadas y sus respectivos puertos.
19. ¿Cuál es la mejor manera de limpiar los recursos de prueba?
20. Anular el stop método en su administrador de ciclo de vida para detener y eliminar el contenedor una vez completadas las pruebas.

Conclusiones clave para resolver conflictos de pruebas

Las pruebas de integración con Quarkus, Liquibase y TestContainers requieren una configuración cuidadosa para garantizar que las migraciones y las interacciones de las bases de datos se alineen. Al personalizar su administrador de recursos de prueba y utilizar una configuración unificada, puede eliminar los conflictos entre los contenedores utilizados por Liquibase y su aplicación.

Estos pasos ayudan a optimizar su proceso de prueba, facilitando la depuración y validación de sus pruebas. Recuerde utilizar registros detallados, como habilitar RASTRO para Liquibase, para monitorear el comportamiento de sus pruebas y resolver discrepancias tempranamente. Con este enfoque, puede crear con confianza pruebas escalables y mantenibles. 🐛