Document usage of Docker Compose support in tests

Closes gh-40171
This commit is contained in:
Scott Frederick
2024-04-22 16:47:29 -05:00
parent 3a9ee9f1a7
commit 08bc0460ed

View File

@@ -38,9 +38,6 @@ When this module is included as a dependency Spring Boot will do the following:
If the Docker Compose services are already running when starting the application, Spring Boot will only create the service connection beans for each supported container.
It will not call `docker compose up` again and it will not call `docker compose stop` when the application is shutdown.
NOTE: By default, Spring Boot's Docker Compose support is disabled when running tests.
To enable it, set configprop:spring.docker.compose.skip.in-tests[] to `false`.
[[features.docker-compose.prerequisites]]
@@ -256,3 +253,23 @@ If you want to activate a specific Docker Compose profile you can use the config
profiles:
active: "myprofile"
----
[[features.docker-compose.tests]]
=== Using Docker Compose in Tests
By default, Spring Boot's Docker Compose support is disabled when running tests.
To enable Docker Compose support in tests, set configprop:spring.docker.compose.skip.in-tests[] to `false`.
When using Gradle, you also need to change the configuration of the `spring-boot-docker-compose` dependency from `developmentOnly` to `testAndDevelopmentOnly`:
.Gradle
[source,gradle,indent=0,subs="verbatim"]
----
dependencies {
testAndDevelopmentOnly("org.springframework.boot:spring-boot-docker-compose")
}
----