Вирішення проблем із тестами 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();
        }
    }
}

Перевірка інтеграції Application-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. The withReuse(true) Команда дозволяє повторно використовувати той самий контейнер у кількох тестах, заощаджуючи ресурси та час налаштування.
5. Яка мета TC_INITSCRIPT власність?
6. The TC_INITSCRIPT властивість визначає сценарій SQL ініціалізації для заповнення бази даних під час запуску контейнера.
7. Як переконатися, що міграції Liquibase застосовані правильно?
8. Налаштувавши quarkus.liquibase.jdbc.url ви можете переконатися, що Liquibase використовує той самий контейнер бази даних, що й програма.
9. Які рівні журналу слід використовувати для налагодження?
10. встановити TRACE або DEBUG рівні для Liquibase і TestContainers для моніторингу операцій бази даних і міграцій.
11. Як я можу перевірити відповіді API із заправленими даними?
12. Використовуйте такі інструменти, як RestAssured для надсилання запитів до кінцевих точок і перевірки відповідності повернутих даних тестовим даним.
13. Що означає @QuarkusTestResource анотацію зробити?
14. The @QuarkusTestResource анотація реєструє настроюваний менеджер життєвого циклу для зовнішніх залежностей, таких як бази даних.
15. Навіщо мені власний TestProfileResolver?
16. Він забезпечує завантаження правильних конфігурацій для виконання тесту, узгодження змінних середовища та ресурсів.
17. Як я можу визначити, чи створюється кілька контейнерів?
18. Перевірте свій робочий стіл Docker або перевірте журнали консолі на наявність дублікатів контейнерів і відповідних портів.
19. Який найкращий спосіб очистити тестові ресурси?
20. Перевизначити stop у вашому менеджері життєвого циклу, щоб зупинити та видалити контейнер після завершення тестів.

Ключові висновки для вирішення конфліктів тестування

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

Ці кроки допоможуть оптимізувати процес тестування, полегшуючи налагодження та перевірку тестів. Пам’ятайте про використання докладних журналів, таких як увімкнення СЛІД для Liquibase, щоб відстежувати поведінку ваших тестів і завчасно вирішувати невідповідності. За допомогою такого підходу ви можете з упевненістю створювати масштабовані та підтримувані тести. 🐛