用Testcontainers实现SpringBoot+Docker集成测试

栏目: 数据库 · Mysql · 发布时间: 5年前

内容简介:我们的大多数应用程序都必须与数据库,HTTP API,消息代理,SMTP服务器等进行通信......使用这些组件设置真正的测试环境非常复杂。在某些情况下,我们可以在测试执行期间简单地模拟这些组件或具有内存中的组件。例如,H2 或HSQLDB是众所周知的在集成测试期间使用的内存数据库。但是,它们不是生产环境中使用的,我们的测试似乎没有代表性。今天,

我们的大多数应用程序都必须与数据库,HTTP API,消息代理,SMTP服务器等进行通信......使用这些组件设置真正的测试环境非常复杂。

在某些情况下,我们可以在测试执行期间简单地模拟这些组件或具有内存中的组件。例如,H2 或HSQLDB是众所周知的在集成测试期间使用的内存数据库。但是,它们不是生产环境中使用的,我们的测试似乎没有代表性。

今天, 借助Testcontainers, 可以轻松利用 Docker 的所有功能并轻松建立连接的测试环境。

Testcontainers

Testcontainers允许我们在测试执行期间轻松操作Docker容器。它使用Docker客户端 docker-java 与Docker守护进程通信。它适用于大多数操作系统和环境,尽管对Windows提供了最大的支持,但我每天都使用Docker Toolbox。您可以在 此处 看看与你的操作系统兼容性。

当你创建一个容器,Testcontainers将尝试使用连接到Docker 守护进程,这是通过DOCKER_HOST,DOCKER_TLS_VERIFY和DOCKER_CERT_PATH环境变量实现,可以在JVM中轻松覆盖这些环境变量。

创建一个容器

容器是使用对象GenericContainer表示。可以从镜像、Dockerfile或动态创建的Dockerfile创建容器。此外,还可以从 Docker Compose文件 创建容器。

例如,这是一个从镜像 docker.elastic.co/elasticsearch/elasticsearch:6.1.1 创建的Elasticsearch服务器。

GenericContainer container = <b>new</b> GenericContainer(<font>"docker.elastic.co/elasticsearch/elasticsearch:6.1.1"</font><font>)
 .withEnv(</font><font>"discovery.type"</font><font>, </font><font>"single-node"</font><font>)
 .withExposedPorts(9200)
 .waitingFor(
   Wait
   .forHttp(</font><font>"/_cat/health?v&pretty"</font><font>)
   .forStatusCode(200)
 );
</font>

我们可以看到使用withEnv方法向容器提供环境变量相当容易。在这个案例中,设置了变量discovery.type是单节点。

接下来,我们通过对/_cat/healthAPI 进行HTTP调用并具有200代码响应来确保我们的容器已启动。

还有其他策略断言容器正在运行:

  • Wait.forLogMessage等待日志消息,
  • Wait.forListeningPort等待侦听端口
  • Wait.forHealthcheck允许使用 docker中的HEALTHCHECK 功能。

要完成容器配置,我们的容器将公开内部端口9200,并使用该方法显式设置withExposedPorts。这意味着Testcontainers会将此容器的端口映射到随机端口。可以使用该方法检索映射端口,getMappedPort否则我们可以使用该方法定义端口绑定setPortBindings。在这里,我们将端口9200从容器暴露到端口9200:

container.setPortBindings(Arrays.asList(“9200:9200”));

我们的Elasticsearch服务器已准备好使用。要启动它,我们只需要执行start方法:

container.start();

在启动时,Testcontainers将运行一系列检查,如docker版本或与已注册Docker Registry的连接。如果您在公司代理后面工作,这可能会阻塞,因此可以通过使用以下内容在tests资源目录中创建文件testcontainers.properties来禁用这些检查:

check.disable=<b>true</b>

最后,我们可以使用stop方法停止我们的容器。

container.stop();

这将停止容器并移除附加的卷。这很棒,因为它可以防止悬空卷。

在测试期间

Testcontainers的一大优势在于它与JUnit框架的集成。实际上,GenericContainer对象是 JUnit规则 。这意味着它们的生命周期直接与测试生命周期绑定。因此,通过使用@Rule或@ClassRuleJUnit注释,我们的容器将在测试启动之前初始化,并在测试执行结束时停止。

@ClassRule
<b>public</b> <b>static</b> GenericContainer redis = <b>new</b> GenericContainer(<font>"redis:3.0.2"</font><font>)
 .withExposedPorts(6379);
</font>

尽管如此,这意味着Testcontainers将带有JUnit 4依赖项,如果您的测试使用 JUnit 5 运行,则会很烦人。实际上,JUnit已经用 Extension扩展 了Rule规则。从2018年11月发布的1.10.0版本开始,Testcontainers  现在支持JUnit 5 ,并且可以在专用库junit-jupiter 的帮助@Testcontainers和@Container注释中使用扩展:

<dependency>
 <groupId>testcontainers</groupId>
 <artifactId>junit-jupiter</artifactId>
 <version>1.10.2</version>
</dependency>

预配置的容器

像Docker一样,Testcontainers生态系统非常丰富。您可以找到预配置的容器,如MySQL,PostgreSQL,Oracle数据库,Kafka,Neo4j,Elasticsearch等。

@Rule
<b>public</b> KafkaContainer kafka = <b>new</b> KafkaContainer();

您可以直接从 maven存储库 浏览列表。

具体案例

让我们看一下使用 Spring PetClinic应用程序 使用Testscontainers的具体示例。这是一个基于Spring Boot,Spring MVC和Spring JPA等几个Spring组件的演示项目。该应用程序旨在管理宠物诊所与宠物,宠物主人和兽医。

控制器层公开HTTP端点以创建和读取实体。然后,持久层与关系数据库通信。可以将应用程序配置为与HSQLDB或 MySQL 数据库通信。

持久层使用集成测试进行测试,它们使用内存中的HSQL数据库,而持久层本身使用MySQL数据库。

要求

首先,我们必须在要执行测试的机器上安装Docker。然后,我们需要将Testcontainers依赖项添加到项目中。在这种情况下,我们只需将以下内容添加到pom.xml文件中:

<dependency>
  <groupId>org.testcontainers</groupId>
  <artifactId>testcontainers</artifactId>
  <version>1.10.2</version>
  <scope>test</scope>
</dependency>

数据库配置

默认数据库配置在application.properties文件中完成。

database=hsqldb
spring.datasource.schema=classpath*:db/${database}/schema.sql
spring.datasource.data=classpath*:db/${database}/data.sql

我们可以看到,这是一个使用schema.sql文件中的模式初始化的内存中HSQLDB数据库。然后,使用data.sql文件填充数据库。这是默认的项目配置。

我们需要创建application-test.properties文件来配置与MySQL数据库的连接。

spring.datasource.url=jdbc:mysql:<font><i>//localhost/petclinic</i></font><font>
spring.datasource.username=petclinic
spring.datasource.password=petclinic
spring.datasource.driver-<b>class</b>-name=com.mysql.jdbc.Driver
</font>

接下来,让我们参加测试类ClinicServiceTests.java。此类包含持久层的所有集成测试。首先,我们需要更改Spring测试配置以确保测试将使用我们的数据库连接。

@RunWith(SpringRunner.<b>class</b>)
@DataJpaTest(includeFilters = @ComponentScan.Filter(Service.<b>class</b>))
@TestPropertySource(locations=<font>"classpath:application-test.properties"</font><font>)
@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE)
<b>public</b> <b>class</b> ClinicServiceTests {
...
}
</font>

TestPropertySource注释能够载入我们的文件application-test.properties和AutoConfigureTestDatabase与NONE值可防止Spring创建一个嵌入式数据库。

MySQL容器

让我们创建一个匹配测试要求的MySQL数据库。在这种情况下,我们使用Testcontainers的功能从动态创建的Dockerfile创建Docker镜像。作为第一步,我们从Docker Hub中提取了 MySQL官方图像

@ClassRule
<b>public</b> <b>static</b> GenericContainer mysql = <b>new</b> GenericContainer(
  <b>new</b> ImageFromDockerfile(<font>"mysql-petclinic"</font><font>)
    .withDockerfileFromBuilder(dockerfileBuilder -> {
       dockerfileBuilder.from(</font><font>"mysql:5.7.8"</font><font>)
    }
);
</font>

现在,我们必须创建我们的数据库和连接的用户。这是通过使用Docker镜像中的环境变量来完成的。

@ClassRule
<b>public</b> <b>static</b> GenericContainer mysql = <b>new</b> GenericContainer(
  <b>new</b> ImageFromDockerfile(<font>"mysql-petclinic"</font><font>)
   .withDockerfileFromBuilder(dockerfileBuilder -> {
      dockerfileBuilder.from(</font><font>"mysql:5.7.8"</font><font>)
      </font><font><i>// root password is mandatory</i></font><font>
      .env(</font><font>"MYSQL_ROOT_PASSWORD"</font><font>, </font><font>"root_password"</font><font>)
      .env(</font><font>"MYSQL_DATABASE"</font><font>, </font><font>"petclinic"</font><font>)
      .env(</font><font>"MYSQL_USER"</font><font>, </font><font>"petclinic"</font><font>)
      .env(</font><font>"MYSQL_PASSWORD"</font><font>, </font><font>"petclinic"</font><font>)
 })
</font>

接下来,我们必须创建一个数据库模式并填充数据库。镜像文件中的目录/docker-entrypoint-initdb.d在启动时被扫描,所有带有 .sh ,.sql 或  .sql.gz扩展名的文件都被执行  。所以,我们只要把我们的文件schema.sql文件和data.sql此目录中。

@ClassRule
<b>public</b> <b>static</b> GenericContainer mysql = <b>new</b> GenericContainer(
  <b>new</b> ImageFromDockerfile(<font>"mysql-petclinic"</font><font>)
    .withDockerfileFromBuilder(dockerfileBuilder -> {
      dockerfileBuilder.from(</font><font>"mysql:5.7.8"</font><font>)
     .env(</font><font>"MYSQL_ROOT_PASSWORD"</font><font>, </font><font>"root_password"</font><font>)
     .env(</font><font>"MYSQL_DATABASE"</font><font>, </font><font>"petclinic"</font><font>)
     .env(</font><font>"MYSQL_USER"</font><font>, </font><font>"petclinic"</font><font>)
     .env(</font><font>"MYSQL_PASSWORD"</font><font>, </font><font>"petclinic"</font><font>)
     .add(</font><font>"a_schema.sql"</font><font>, </font><font>"/docker-entrypoint-initdb.d"</font><font>)
     .add(</font><font>"b_data.sql"</font><font>, </font><font>"/docker-entrypoint-initdb.d"</font><font>);
 })
 .withFileFromClasspath(</font><font>"a_schema.sql"</font><font>, </font><font>"db/mysql/schema.sql"</font><font>)
 .withFileFromClasspath(</font><font>"b_data.sql"</font><font>, </font><font>"db/mysql/data.sql"</font><font>))
</font>

通过使用 withClasspathResourceMapping ,文件schema.sql文件和data.sql被放置在类路径从而进入容器作为它的一个卷。然后,我们可以在我们的Dockerfile构造中访问它。

最后一件事,我们必须公开默认的MySQL端口:3306。

@ClassRule
<b>public</b> <b>static</b> GenericContainer mysql = <b>new</b> GenericContainer(
  <b>new</b> ImageFromDockerfile(<font>"mysql-petclinic"</font><font>)
    .withDockerfileFromBuilder(dockerfileBuilder -> {
      ....
    })
  .withExposedPorts(3306)
  .withCreateContainerCmdModifier(
    <b>new</b> Consumer<CreateContainerCmd>() {   
     @Override
     <b>public</b> <b>void</b> accept(CreateContainerCmd createContainerCmd) {
       createContainerCmd.withPortBindings(
         <b>new</b> PortBinding(Ports.Binding.bindPort(3306), <b>new</b> ExposedPort(3306))
       );
    }
 })
 .waitingFor(Wait.forListeningPort());
</font>

不幸的是,我们无法直接使用该方法设置端口绑定setPortBindings。我们必须在创建时使用withCreateContainerCmdModifier方法 自定义容器 。最后,我们正在等待监听端口以确保我们的容器已启动。

瞧!只需几行代码,我们就可以轻松地为我们的测试设置MySQL数据库,而无需管理容器生命周期。该@ClassRule注释使我们的容器,所有的测试启动一次。您可能想知道:我们是否延长了测试执行时间?实际上,使用HSQLDB内存数据库时,Docker容器只需要907毫秒,而860毫秒。本节中显示的源代码可在 github上找到


以上就是本文的全部内容,希望本文的内容对大家的学习或者工作能带来一定的帮助,也希望大家多多支持 码农网

查看所有标签

猜你喜欢:

本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们

硅谷之谜

硅谷之谜

吴军 / 人民邮电出版社 / 2015-12-1 / 59.00

这是一本颠覆人们对信息时代的认识、对创新和创业的理解的好书。作者吴军通过介绍硅谷成功的秘诀,揭示了信息时代的特点和方法论。 近年来,吴军从技术和管理人员变成了投资人,他对IT领域,尤其是对科技创新因而有了更深入的了解。他根据这些年在硅谷所获得的第一手资料,结合自己的思考,回答了长期以来令大家深感困惑的一个不解之谜,那就是—为什么硅谷在全世界其他地区难以复制? 《硅谷之谜》从某种意义上讲......一起来看看 《硅谷之谜》 这本书的介绍吧!

JS 压缩/解压工具
JS 压缩/解压工具

在线压缩/解压 JS 代码

RGB HSV 转换
RGB HSV 转换

RGB HSV 互转工具

HEX HSV 转换工具
HEX HSV 转换工具

HEX HSV 互换工具