Решение проблем с тестами Quarkus, тестовыми контейнерами и интеграцией Liquibase

Обеспечение правильной интеграции между Liquibase и TestContainers в Quarkus

Серверное решение, использующее Quarkus с TestContainers для управления миграциями PostgreSQL и Liquibase. Этот скрипт решает проблемы с несовпадением контейнеров.

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

Проверка интеграции приложения и Liquibase с помощью модульных тестов

Модульный и многократно используемый пример теста Quarkus, который проверяет подключение к базе данных и выполнение сценария миграции.

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

Обеспечение согласованности конфигурации между профилями тестирования

Конфигурация пользовательского тестового профиля, гарантирующая согласованность между Liquibase и контейнерами приложений.

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

Внешнее моделирование для проверки данных

Фрагмент динамического внешнего кода, обеспечивающий правильное отображение данных интеграции базы данных.

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

Модульные тесты для согласованности серверной и внешней части

Примеры тестовых сценариев для проверки внутренней логики и внешней интеграции с тестовыми данными.

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

Часто задаваемые вопросы об интеграции Quarkus, TestContainers и Liquibase

1. Какова роль TestContainers в интеграционных тестах?
2. TestContainers помогает управлять изолированными экземплярами баз данных во время тестирования, обеспечивая согласованность сред.
3. Зачем мне нужен withReuse(true) команда?
4. withReuse(true) Команда позволяет повторно использовать один и тот же контейнер в нескольких тестах, экономя ресурсы и время установки.
5. Какова цель TC_INITSCRIPT свойство?
6. TC_INITSCRIPT Свойство указывает сценарий SQL инициализации для заполнения базы данных при запуске контейнера.
7. Как обеспечить правильное применение миграции Liquibase?
8. Настроив quarkus.liquibase.jdbc.url вы можете убедиться, что Liquibase использует тот же контейнер базы данных, что и приложение.
9. Какие уровни журнала следует использовать для отладки?
10. Набор TRACE или DEBUG уровни для Liquibase и TestContainers для мониторинга операций базы данных и миграции.
11. Как я могу протестировать ответы API с заполненными данными?
12. Используйте такие инструменты, как RestAssured для отправки запросов к конечным точкам и проверки соответствия возвращаемых данных тестовым данным.
13. Что означает @QuarkusTestResource аннотацию делать?
14. @QuarkusTestResource аннотация регистрирует пользовательский менеджер жизненного цикла для внешних зависимостей, таких как базы данных.
15. Зачем мне нужен собственный TestProfileResolver?
16. Это гарантирует загрузку правильных конфигураций для выполнения теста, согласование переменных среды и ресурсов.
17. Как я могу определить, создается ли несколько контейнеров?
18. Проверьте свой Docker Desktop или просмотрите журналы консоли на предмет дублирующихся экземпляров контейнеров и соответствующих портов.
19. Как лучше всего очистить тестовые ресурсы?
20. Переопределить stop в вашем диспетчере жизненного цикла, чтобы остановить и удалить контейнер после завершения тестов.

Ключевые выводы по разрешению конфликтов тестирования

Интеграционное тестирование с Quarkus, Liquibase и TestContainers требует тщательной настройки, чтобы обеспечить согласованность миграции и взаимодействия с базой данных. Настраивая свой менеджер тестовых ресурсов и используя унифицированную конфигурацию, вы можете устранить конфликты между контейнерами, используемыми Liquibase, и вашим приложением.

Эти шаги помогут оптимизировать процесс тестирования, упрощая отладку и проверку тестов. Не забудьте использовать подробные журналы, например включение СЛЕД для Liquibase, чтобы отслеживать поведение ваших тестов и устранять несоответствия на ранней стадии. Благодаря такому подходу вы можете уверенно создавать масштабируемые и удобные в сопровождении тесты. 🐛