Risoluzione dei problemi con i test Quarkus, i contenitori di test e l'integrazione con Liquibase

Garantire una corretta integrazione tra Liquibase e TestContainers in Quarkus

Soluzione backend che utilizza Quarkus con TestContainers per gestire le migrazioni PostgreSQL e Liquibase. Questo script risolve i problemi di disallineamento del contenitore.

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

Convalida dell'integrazione applicazione-Liquibase utilizzando test unitari

Un esempio di test Quarkus modulare e riutilizzabile che verifica la connessione al database e l'esecuzione dello script di migrazione.

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

Garantire la coerenza della configurazione tra i profili di test

Configurazione personalizzata del profilo di test per garantire l'allineamento tra Liquibase e i contenitori delle applicazioni.

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

Simulazione front-end per la convalida dei dati

Snippet di codice front-end dinamico per garantire che i dati provenienti dall'integrazione del database vengano visualizzati correttamente.

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

Test unitari per la coerenza del backend e del front-end

Script di test di esempio per convalidare sia la logica di backend che l'integrazione front-end con i dati di test.

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

Domande frequenti su Quarkus, TestContainers e integrazione con Liquibase

1. Qual è il ruolo di TestContainers nei test di integrazione?
2. TestContainers aiuta a gestire le istanze di database isolate durante i test, garantendo ambienti coerenti.
3. Perché ho bisogno di withReuse(true) comando?
4. IL withReuse(true) Il comando consente di riutilizzare lo stesso contenitore per più test, risparmiando risorse e tempo di configurazione.
5. Qual è lo scopo del TC_INITSCRIPT proprietà?
6. IL TC_INITSCRIPT La proprietà specifica uno script SQL di inizializzazione per eseguire il seeding del database all'avvio del contenitore.
7. Come posso garantire che le migrazioni di Liquibase siano applicate correttamente?
8. Configurando il quarkus.liquibase.jdbc.url proprietà, puoi assicurarti che Liquibase utilizzi lo stesso contenitore di database dell'applicazione.
9. Quali livelli di log devo utilizzare per il debug?
10. Impostato TRACE O DEBUG livelli per Liquibase e TestContainers per monitorare le operazioni e le migrazioni del database.
11. Come posso testare le risposte API con i dati seminati?
12. Utilizza strumenti come RestAssured per inviare richieste agli endpoint e verificare che i dati restituiti corrispondano ai dati di test.
13. Cosa significa il @QuarkusTestResource annotazione fare?
14. IL @QuarkusTestResource l'annotazione registra un gestore del ciclo di vita personalizzato per dipendenze esterne come i database.
15. Perché ho bisogno di un TestProfileResolver personalizzato?
16. Garantisce che vengano caricate le configurazioni corrette per l'esecuzione del test, allineando le variabili e le risorse di ambiente.
17. Come posso rilevare se vengono creati più contenitori?
18. Controlla il tuo desktop Docker o monitora i log della console per individuare istanze di container duplicate e le rispettive porte.
19. Qual è il modo migliore per ripulire le risorse di test?
20. Sostituisci il stop nel Lifecycle Manager per arrestare e rimuovere il contenitore una volta completati i test.

Punti chiave per la risoluzione dei conflitti di test

I test di integrazione con Quarkus, Liquibase e TestContainers richiedono un'attenta configurazione per garantire l'allineamento delle migrazioni e delle interazioni del database. Personalizzando il tuo gestore delle risorse di test e utilizzando una configurazione unificata, puoi eliminare i conflitti tra i contenitori utilizzati da Liquibase e la tua applicazione.

Questi passaggi aiutano a semplificare il processo di test, semplificando il debug e la convalida dei test. Ricordarsi di utilizzare log dettagliati, come l'abilitazione TRACCIA per Liquibase, per monitorare il comportamento dei tuoi test e risolvere tempestivamente le discrepanze. Con questo approccio, puoi creare con sicurezza test scalabili e gestibili. 🐛