Testcontainers for Java

3ステップで試す

1. 1

   固定版のJUnitプロジェクトを作る

   Java 17以上、Maven、稼働中のDocker互換環境が必要です。Testcontainers 2.0.5とJUnitを固定した一時プロジェクトを作ります。

   demo=$(mktemp -d "${TMPDIR:-/tmp}/testcontainers-java.XXXXXX") && cd "$demo" && mkdir -p src/test/java/demo && printf '%s\n' '<project xmlns="http://maven.apache.org/POM/4.0.0"><modelVersion>4.0.0</modelVersion><groupId>demo</groupId><artifactId>container-test</artifactId><version>1</version>' '<properties><maven.compiler.release>17</maven.compiler.release></properties>' '<dependencies><dependency><groupId>org.testcontainers</groupId><artifactId>testcontainers</artifactId><version>2.0.5</version><scope>test</scope></dependency><dependency><groupId>org.testcontainers</groupId><artifactId>testcontainers-junit-jupiter</artifactId><version>2.0.5</version><scope>test</scope></dependency><dependency><groupId>org.junit.jupiter</groupId><artifactId>junit-jupiter</artifactId><version>5.11.4</version><scope>test</scope></dependency></dependencies>' '<build><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>3.14.1</version></plugin><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-surefire-plugin</artifactId><version>3.5.4</version></plugin></plugins></build></project>' > pom.xmlコピー
2. 2

   使い捨てコンテナの試験を書く

   Alpine 3.22を試験期間だけ起動し、readyログを最大30秒待つJUnit試験を書きます。

   printf '%s\n' 'package demo;' 'import org.junit.jupiter.api.Test;' 'import org.testcontainers.containers.GenericContainer;' 'import org.testcontainers.junit.jupiter.Container;' 'import org.testcontainers.junit.jupiter.Testcontainers;' 'import org.testcontainers.containers.wait.strategy.Wait;' 'import java.time.Duration;' 'import org.testcontainers.utility.DockerImageName;' 'import static org.junit.jupiter.api.Assertions.assertTrue;' '@Testcontainers class ContainerTest {' ' @Container static GenericContainer<?> alpine = new GenericContainer<>(DockerImageName.parse("alpine:3.22")).withCommand("sh","-c","echo ready; sleep 30").waitingFor(Wait.forLogMessage(".*ready.*\n",1).withStartupTimeout(Duration.ofSeconds(30)));' ' @Test void capturesContainerOutput() { assertTrue(alpine.getLogs().contains("ready")); }' '}' > src/test/java/demo/ContainerTest.javaコピー
3. 3

   コンテナの出力を検証する

   JUnitを実行し、コンテナのログにreadyが含まれることを確認します。試験終了時の破棄はTestcontainersが管理します。

   mvn -q -Dtest=ContainerTest testコピー

Built with

• Java
• Docker

カテゴリとタグ

GitHubデータ

このOSSの使い方や活用事例をMarkdownで投稿できます。管理者が承認した後に公開されます。

あわせて探訪

• Karate8,974 Stars

  共通タグ 1件 · 共通カテゴリ 1件 · 同じ言語

  Gherkin風DSLでAPI test・mock server・performance testを一つのframeworkへまとめる

  Java
• Playwright97,099 Stars

  共通タグ 1件 · 共通カテゴリ 1件

  Chromium・Firefox・WebKitを一つのAPI/Test runnerで操作し、E2E test・script・agent browser automationを実行する

  TypeScript
• Storybook91,200 Stars

  共通タグ 1件 · 共通カテゴリ 1件

  UI状態をstoryとして保存し、Docs・interaction test・AI toolへ再利用するfrontend workshop

  TypeScript
• Hoppscotch80,566 Stars

  共通タグ 1件 · 共通カテゴリ 1件

  REST・GraphQL・realtime request・collection testをWeb/Desktop/CLI/self-hostへ横断するAPI workspace

  TypeScript
• Cypress51,042 Stars

  共通タグ 1件 · 共通カテゴリ 1件

  browser向けE2E・component testをinteractive runnerとCLIから実行する

  TypeScript
• Jest45,500 Stars

  共通タグ 1件 · 共通カテゴリ 1件

  assertion・mock・watch・snapshot・worker isolationを一つのCLIへまとめるJavaScript testing framework

  TypeScript