Testcontainers

핵심 개념

Container

테스트에 필요한 PostgreSQL, Redis, Kafka 같은 서비스를 담은 Docker 컨테이너. Testcontainers가 테스트 시작 시 자동으로 띄우고 종료 시 제거합니다.

GenericContainer

임의의 Docker 이미지를 실행할 수 있는 기본 컨테이너 클래스. 포트, 환경변수, 볼륨 등을 코드로 설정할 수 있습니다.

Module

특정 기술 스택에 최적화된 사전 구성 컨테이너. PostgreSQLContainer, MySQLContainer처럼 JDBC URL, 드라이버 등을 자동으로 설정해줍니다.

Lifecycle

컨테이너의 시작과 종료 시점을 테스트 생명주기에 맞춰 관리하는 메커니즘. 테스트 클래스 단위 또는 메서드 단위로 컨테이너를 재사용하거나 격리할 수 있습니다.

Wait Strategy

컨테이너가 실제로 사용 가능한 상태가 될 때까지 기다리는 전략. 특정 포트 개방, 로그 메시지 출력, HTTP 응답 등을 조건으로 설정합니다.

PostgreSQL 컨테이너를 사용한 JUnit 5 테스트

테스트 클래스 실행 시 PostgreSQL 컨테이너를 시작하고, JDBC URL을 받아 실제 DB에 연결해 테스트합니다. 모든 테스트가 끝나면 컨테이너는 자동으로 정리됩니다.

@Testcontainers
class UserRepositoryTest {

    @Container
    static PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:15-alpine")
        .withDatabaseName("testdb")
        .withUsername("test")
        .withPassword("test");

    @Test
    void shouldSaveAndFindUser() {
        String jdbcUrl = postgres.getJdbcUrl();
        // jdbcUrl로 실제 PostgreSQL에 연결해 테스트 수행
        // 테스트 종료 후 컨테이너는 자동으로 제거됨
    }
}