[java] TestContainers를 사용하여 클라우드 서비스 테스트하기

16 Nov 2023

java

이번 포스트에서는 클라우드 서비스를 테스트하기 위해 TestContainers라는 라이브러리를 사용하는 방법에 대해 알아보겠습니다. TestContainers는 테스트 작성시에 독립적인 컨테이너를 제공하여 테스트 환경을 쉽게 설정할 수 있도록 도와주는 도구입니다. 그 중에는 Docker 컨테이너를 사용하여 클라우드 서비스를 모ock하는 것도 가능합니다.

TestContainers란?

TestContainers는 Java 기반의 통합 테스트를 위한 도구입니다. 보통 통합 테스트를 작성할 때, 테스트 환경을 설정하기 위해 별도의 환경을 구축하고 관리해야 합니다. 이를 위해 TestContainers는 Docker 컨테이너를 사용하여 테스트 환경을 간단하게 구축할 수 있도록 지원합니다.

클라우드 서비스 테스트하기

TestContainers는 클라우드 서비스 테스트에도 사용될 수 있습니다. 예를 들어, AWS S3와 같은 객체 스토리지 서비스를 테스트해야 할 때, TestContainers를 통해 S3 컨테이너를 생성하고 테스트를 진행할 수 있습니다.

아래는 TestContainers를 사용하여 AWS S3 테스트를 작성하는 예제 코드입니다.

import org.junit.ClassRule;
import org.junit.Test;
import org.testcontainers.containers.localstack.LocalStackContainer;
import software.amazon.awssdk.services.s3.S3Client;
import software.amazon.awssdk.services.s3.model.CreateBucketRequest;
import software.amazon.awssdk.services.s3.model.PutObjectRequest;
import software.amazon.awssdk.services.s3.model.S3Exception;

public class S3IntegrationTest {

    @ClassRule
    public static LocalStackContainer localStackContainer = new LocalStackContainer()
            .withServices(LocalStackContainer.Service.S3);

    @Test
    public void testS3BucketOperations() {
        S3Client s3Client = S3Client.builder()
                .endpointOverride(localStackContainer.getEndpointOverride(LocalStackContainer.Service.S3))
                .region(Region.EU_WEST_1)
                .build();

        // Create bucket
        CreateBucketRequest createBucketRequest = CreateBucketRequest.builder()
                .bucket("test-bucket")
                .build();
        s3Client.createBucket(createBucketRequest);

        // Upload object
        PutObjectRequest putObjectRequest = PutObjectRequest.builder()
                .bucket("test-bucket")
                .key("test-object")
                .build();
        s3Client.putObject(putObjectRequest);

        // Your test assertions here

    }
}

위의 코드에서는 LocalStackContainer 클래스를 사용하여 로컬에 S3 컨테이너를 생성합니다. S3Client 를 사용하여 컨테이너의 엔드포인트에 연결하고, 테스트할 S3 버킷을 생성하고 객체를 업로드하는 등의 작업을 수행합니다. 테스트 결과는 별도의 Assertions를 통해 확인할 수 있습니다.

결론

TestContainers는 클라우드 서비스 테스트를 간편하게 작성할 수 있도록 도와주는 유용한 도구입니다. Docker 컨테이너를 사용하여 테스트 환경을 관리하므로, 테스트의 격리성을 보장하고 신속한 개발 및 테스트 작업을 가능하게 합니다. 자세한 사용법은 공식 문서를 참고하시기 바랍니다.

참고 자료: