Rozwiązywanie problemów z testami Quarkus, kontenerami testowymi i integracją z Liquibase

Zapewnienie właściwej integracji pomiędzy Liquibase i TestContainers w Quarkus

Rozwiązanie backendowe wykorzystujące Quarkus z TestContainers do zarządzania migracjami PostgreSQL i Liquibase. Ten skrypt rozwiązuje problemy z niewspółosiowością kontenera.

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

Sprawdzanie integracji aplikacji z Liquibase za pomocą testów jednostkowych

Modułowy i wielokrotnego użytku przykład testu Quarkus, który weryfikuje połączenie z bazą danych i wykonanie skryptu migracji.

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

Zapewnienie spójności konfiguracji w profilach testowych

Niestandardowa konfiguracja profilu testowego gwarantująca zgodność pomiędzy Liquibase i kontenerami aplikacji.

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

Symulacja front-endu do sprawdzania poprawności danych

Dynamiczny fragment kodu front-end zapewniający prawidłowe wyświetlanie danych z integracji z bazą danych.

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

Testy jednostkowe pod kątem spójności backendu i frontonu

Przykładowe skrypty testowe umożliwiające sprawdzenie zarówno logiki backendu, jak i integracji frontonu z danymi testowymi.

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

Często zadawane pytania dotyczące integracji Quarkus, TestContainers i Liquibase

1. Jaka jest rola TestContainers w testach integracyjnych?
2. TestContainers pomaga zarządzać izolowanymi instancjami baz danych podczas testowania, zapewniając spójne środowiska.
3. Dlaczego potrzebuję withReuse(true) rozkaz?
4. The withReuse(true) polecenie umożliwia ponowne użycie tego samego kontenera w wielu testach, oszczędzając zasoby i czas konfiguracji.
5. Jaki jest cel TC_INITSCRIPT nieruchomość?
6. The TC_INITSCRIPT Właściwość określa inicjujący skrypt SQL, który ma zapełnić bazę danych podczas uruchamiania kontenera.
7. Jak zapewnić prawidłowe zastosowanie migracji Liquibase?
8. Konfigurując quarkus.liquibase.jdbc.url możesz mieć pewność, że Liquibase korzysta z tego samego kontenera bazy danych co aplikacja.
9. Jakich poziomów dziennika należy używać do debugowania?
10. Ustawić TRACE Lub DEBUG poziomy dla Liquibase i TestContainers do monitorowania operacji i migracji baz danych.
11. Jak mogę przetestować odpowiedzi API z danymi zaszczepionymi?
12. Użyj narzędzi takich jak RestAssured do wysyłania żądań do punktów końcowych i sprawdzania, czy zwrócone dane są zgodne z danymi testowymi.
13. Co robi @QuarkusTestResource adnotacja?
14. The @QuarkusTestResource adnotacja rejestruje niestandardowego menedżera cyklu życia dla zewnętrznych zależności, takich jak bazy danych.
15. Dlaczego potrzebuję niestandardowego narzędzia TestProfileResolver?
16. Zapewnia załadowanie prawidłowych konfiguracji do wykonania testu, dopasowując zmienne środowiskowe i zasoby.
17. Jak mogę wykryć, czy tworzonych jest wiele kontenerów?
18. Sprawdź swój pulpit Docker lub monitoruj dzienniki konsoli pod kątem zduplikowanych instancji kontenerów i ich odpowiednich portów.
19. Jaki jest najlepszy sposób oczyszczenia zasobów testowych?
20. Zastąp stop metodę w menedżerze cyklu życia, aby zatrzymać i usunąć kontener po zakończeniu testów.

Kluczowe wnioski dotyczące rozwiązywania konfliktów testowych

Testowanie integracji z Quarkus, Liquibase i TestContainers wymaga starannej konfiguracji, aby zapewnić zgodność migracji i interakcji z bazą danych. Dostosowując menedżera zasobów testowych i stosując ujednoliconą konfigurację, możesz wyeliminować konflikty pomiędzy kontenerami używanymi przez Liquibase i Twoją aplikacją.

Te kroki pomagają usprawnić proces testowania, ułatwiając debugowanie i sprawdzanie poprawności testów. Pamiętaj o korzystaniu ze szczegółowych logów, np. włączania NAMIERZAĆ dla Liquibase, aby monitorować zachowanie testów i wcześnie rozwiązywać rozbieżności. Dzięki takiemu podejściu możesz śmiało budować skalowalne i łatwe w utrzymaniu testy. 🐛