Resolvendo problemas com testes Quarkus, contêineres de teste e integração Liquibase

Garantindo a integração adequada entre Liquibase e TestContainers no Quarkus

Solução backend usando Quarkus com TestContainers para gerenciar migrações PostgreSQL e Liquibase. Este script resolve problemas de desalinhamento de contêineres.

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

Validando a integração Application-Liquibase usando testes de unidade

Um exemplo de teste Quarkus modular e reutilizável que verifica a conexão do banco de dados e a execução do script de migração.

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

Garantindo consistência de configuração em perfis de teste

Configuração personalizada do perfil de teste para garantir o alinhamento entre Liquibase e contêineres de aplicativos.

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

Simulação Front-End para Validação de Dados

Snippet de código de front-end dinâmico para garantir que os dados da integração do banco de dados sejam exibidos corretamente.

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

Testes de unidade para consistência de back-end e front-end

Exemplo de scripts de teste para validar a lógica de back-end e a integração de front-end com dados de teste.

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

Perguntas frequentes sobre integração com Quarkus, TestContainers e Liquibase

1. Qual é o papel TestContainers em testes de integração?
2. TestContainers ajuda a gerenciar instâncias isoladas de banco de dados durante os testes, garantindo ambientes consistentes.
3. Por que eu preciso do withReuse(true) comando?
4. O withReuse(true) O comando permite reutilizar o mesmo contêiner em vários testes, economizando recursos e tempo de configuração.
5. Qual é o propósito do TC_INITSCRIPT propriedade?
6. O TC_INITSCRIPT especifica um script SQL de inicialização para propagar o banco de dados na inicialização do contêiner.
7. Como posso garantir que as migrações do Liquibase sejam aplicadas corretamente?
8. Ao configurar o quarkus.liquibase.jdbc.url propriedade, você pode garantir que o Liquibase use o mesmo contêiner de banco de dados que o aplicativo.
9. Quais níveis de log devo usar para depuração?
10. Definir TRACE ou DEBUG níveis para Liquibase e TestContainers para monitorar operações e migrações de banco de dados.
11. Como posso testar as respostas da API com dados propagados?
12. Utilize ferramentas como RestAssured para enviar solicitações aos endpoints e verificar se os dados retornados correspondem aos dados de teste.
13. O que o @QuarkusTestResource anotação fazer?
14. O @QuarkusTestResource anotação registra um gerenciador de ciclo de vida personalizado para dependências externas, como bancos de dados.
15. Por que preciso de um TestProfileResolver personalizado?
16. Ele garante que as configurações corretas sejam carregadas para execução de testes, alinhando variáveis ​​de ambiente e recursos.
17. Como posso detectar se vários contêineres estão sendo criados?
18. Verifique seu Docker Desktop ou monitore os logs do console em busca de instâncias de contêiner duplicadas e suas respectivas portas.
19. Qual é a melhor maneira de limpar os recursos de teste?
20. Substituir o stop no seu gerenciador de ciclo de vida para parar e remover o contêiner após a conclusão dos testes.

Principais conclusões para resolver conflitos de teste

Os testes de integração com Quarkus, Liquibase e TestContainers requerem uma configuração cuidadosa para garantir o alinhamento das migrações e das interações do banco de dados. Ao personalizar seu gerenciador de recursos de teste e usar uma configuração unificada, você pode eliminar conflitos entre os contêineres usados ​​pelo Liquibase e sua aplicação.

Essas etapas ajudam a simplificar o processo de teste, facilitando a depuração e a validação dos testes. Lembre-se de usar registros detalhados, como ativação TRAÇO para Liquibase, para monitorar o comportamento de seus testes e resolver discrepâncias antecipadamente. Com essa abordagem, você pode criar testes escalonáveis ​​e de fácil manutenção com confiança. 🐛