Quarkus 테스트, 테스트 컨테이너 및 Liquibase 통합 관련 문제 해결

Quarkus에서 Liquibase와 TestContainers 간의 적절한 통합 보장

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 통합에 대한 FAQ

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의 경우 테스트 동작을 모니터링하고 불일치를 조기에 해결합니다. 이 접근 방식을 사용하면 확장 가능하고 유지 관리가 가능한 테스트를 자신있게 구축할 수 있습니다. 🐛