テストからコンテナを実行する方法のクイックガイド

私はこうしている。 スプリングブート での プロジェクト を使うことで、定型文を減らすことができる。テスト・コンテナは スプリングフレームワーク そして、それを使わずに使うこともできる。

Testcontainersのバージョンは1.17.3を使用していますが、最新のものをご自由にお使いください。Postgresコンテナでのテスト。

まずコンテナを定義する：

public class Postgres13TC extends PostgreSQLContainer { 次のようになります。
  private static final Postgres13TC TC = new Postgres13TC()；

  プライベートPostgres13TC()
    super("postgres:13.2")；
  }

  public static Postgres13TC getInstance() { { { { { Postgres13TCを取得します。
    TC を返します；
  }

  オーバーライド
  public void start() {
    super.start()；
    System.setProperty("DB_URL", TC.getJdbcUrl())；
    System.setProperty("DB_USERNAME", TC.getUsername());；
    System.setProperty("DB_PASSWORD", TC.getPassword())；
  }

  オーバーライド
  public void stop() { // 何もしない。
    // 何もしない。これは共有インスタンスだ。この操作はJVMに任せてください。
  }
}

その後、Springアプリケーションコンテキストを初期化します。コンテナインスタンスからすべてのデータソース設定を取得し、Springの設定として設定する：

public class ContainerInit implements ApplicationContextInitializer {.

  public static Postgres13TC postgres13TC；

  スタティック
    postgres13TC = Postgres13TC.getInstance()；
    postgres13TC.start()；
  }

  オーバーライド
  public void initialize(ConfigurableApplicationContext applicationContext) { } @override
    TestPropertySourceUtils.addInlinedPropertiesToEnvironment(
        applicationContext、
        "spring.datasource.url=" + postgres13TC.getJdbcUrl()、
        "spring.datasource.username=" + postgres13TC.getUsername()、
        "spring.datasource.password=" + postgres13TC.getPassword()、
        "db.host=" + postgres13TC.getHost()、
        "db.port=" + postgres13TC.getMappedPort(postgres13TC.POSTGRESQL_PORT)、
        "db.name=" + postgres13TC.getDatabaseName()、
        "db.username=" + postgres13TC.getUsername()、
        "db.password=" + postgres13TC.getPassword()
    );
  }
}

最後にテストを実行すれば、ボンネットの中ですべてが開始される：

SpringBootTest(webEnvironment = RANDOM_PORT)
@AutoConfigureTestDatabase(replace = NONE)
@ContextConfiguration(initializers = ContainerInit.class)
テストコンテナ
クラス DummyRepositoryTest

  自動化
  private DummyRepository dummyRepository；

  テスト
  void shouldReturnDummy() { 以下のようにします。
    var byId = dummyRepository.getById(10L)；
    var expected = new Dummy()；
    expected.setId(10L)；
    assertThat(byId).completes().emitsCount(1).emits(expected)；
  }
}

また、Springに依存しないテストを実行したい場合は、コンテナを直接使用することもできる：

テストコンテナ
クラス SimpleDbTest

  コンテナ
  private static final Postgres13TC postgres13TC = Postgres13TC.getInstance()；

  テスト
  void testConnection() {
    assumeThat(postgres13TC.isRunning())；
    var connectionProps = new Properties()；
    connectionProps.put("user", postgres13TC.getUsername())；
    connectionProps.put("password", postgres13TC.getPassword());；
    try (Connection connection = DriverManager.getConnection(postgres13TC.getJdbcUrl()、
        connectionProps))
    var resultSet = connection.prepareStatement("Select 1").executeQuery()；
    resultSet.next()；
    assertThat(resultSet.getInt(1)).isEqualTo(1)；
    } catch (SQLException sqlException) { {.
    assertThat((Exception) sqlException).doesNotThrowAnyException()；
    }
  }
}

まとめ

Testcontainersは非常に使いやすいツールで、Dockerコンテナを使用した統合テストを作成するのに役立ちます。これにより、柔軟性が増し、開発スピードが向上します。テスト構成を適切にセットアップすることで、新しい開発者の受け入れに必要な時間が短縮される。彼らはすべての依存関係をセットアップする必要はなく、選択した設定ファイルを使って書かれたテストを実行するだけです。