Riešenie problémov s testami Quarkus, testovacími kontajnermi a integráciou Liquibase

Zabezpečenie správnej integrácie medzi Liquibase a TestContainers v Quarkus

Backendové riešenie využívajúce Quarkus s TestContainers na správu migrácií PostgreSQL a Liquibase. Tento skript rieši problémy so zarovnaním kontajnera.

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

Overenie integrácie aplikácie a Liquibase pomocou testov jednotiek

Modulárny a opakovane použiteľný testovací príklad Quarkus, ktorý overuje pripojenie k databáze a spustenie skriptu migrácie.

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

Zabezpečenie konzistentnosti konfigurácie naprieč testovacími profilmi

Vlastná konfigurácia testovacieho profilu na zaručenie zarovnania medzi Liquibase a aplikačnými nádobami.

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

Simulácia front-endu na overenie údajov

Dynamický útržok kódu front-end na zabezpečenie správneho zobrazenia údajov z integrácie databázy.

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 Testy na backend a front-end konzistenciu

Príklady testovacích skriptov na overenie logiky backendu aj integrácie frontendu s testovacími údajmi.

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

Časté otázky o Quarkus, TestContainers a integrácii Liquibase

1. Aká je úloha TestContainers v integračných testoch?
2. TestContainers pomáha spravovať izolované inštancie databázy počas testovania, čím zabezpečuje konzistentné prostredia.
3. Prečo potrebujem withReuse(true) príkaz?
4. The withReuse(true) vám umožňuje znova použiť rovnaký kontajner vo viacerých testoch, čím šetrí zdroje a čas nastavenia.
5. Aký je účel TC_INITSCRIPT majetok?
6. The TC_INITSCRIPT vlastnosť určuje inicializačný SQL skript na nasadenie databázy pri spustení kontajnera.
7. Ako zabezpečím, aby sa migrácie Liquibase aplikovali správne?
8. Konfiguráciou quarkus.liquibase.jdbc.url vlastnosť, môžete zaistiť, že Liquibase používa rovnaký databázový kontajner ako aplikácia.
9. Aké úrovne denníka by som mal použiť na ladenie?
10. Set TRACE alebo DEBUG úrovne pre Liquibase a TestContainers na monitorovanie databázových operácií a migrácií.
11. Ako môžem testovať odpovede API s nasadenými údajmi?
12. Používajte nástroje ako RestAssured posielať požiadavky na koncové body a overovať, či sa vrátené údaje zhodujú s testovacími údajmi.
13. Čo robí @QuarkusTestResource anotácia urobiť?
14. The @QuarkusTestResource anotácia registruje vlastného manažéra životného cyklu pre externé závislosti, ako sú databázy.
15. Prečo potrebujem vlastný TestProfileResolver?
16. Zabezpečuje načítanie správnych konfigurácií na vykonanie testu, zosúladenie premenných prostredia a zdrojov.
17. Ako zistím, či sa vytvára viacero kontajnerov?
18. Skontrolujte svoju pracovnú plochu Docker alebo sledujte protokoly konzoly, či neobsahujú duplicitné inštancie kontajnerov a ich príslušné porty.
19. Aký je najlepší spôsob čistenia testovacích zdrojov?
20. Prepísať stop metódu vo vašom manažérovi životného cyklu na zastavenie a odstránenie kontajnera po dokončení testov.

Kľúčové poznatky na riešenie konfliktov pri testovaní

Testovanie integrácie s Quarkus, Liquibase a TestContainers vyžaduje starostlivé nastavenie, aby sa zabezpečilo zosúladenie migrácií a interakcií s databázou. Prispôsobením správcu testovacích prostriedkov a použitím jednotnej konfigurácie môžete eliminovať konflikty medzi kontajnermi používanými Liquibase a vašou aplikáciou.

Tieto kroky pomáhajú zefektívniť proces testovania a zjednodušiť ladenie a overovanie testov. Nezabudnite použiť podrobné protokoly, ako napríklad povolenie TRACE pre Liquibase, aby ste mohli sledovať správanie vašich testov a včas vyriešiť nezrovnalosti. S týmto prístupom môžete s istotou vytvárať škálovateľné a udržiavateľné testy. 🐛