From eb9077df8605e44dc248ff87f08733323fd3cd6a Mon Sep 17 00:00:00 2001
From: Moritz Halbritter <mkammerer@vmware.com>
Date: Fri, 26 May 2023 13:28:40 +0200
Subject: [PATCH] Document how to customize the JDBC parameters when using
 Docker Compose

Closes gh-35636
---
 .../src/docs/asciidoc/howto.adoc              |  2 ++
 .../docs/asciidoc/howto/docker-compose.adoc   | 28 +++++++++++++++++++
 2 files changed, 30 insertions(+)
 create mode 100644 spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto/docker-compose.adoc

diff --git a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto.adoc b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto.adoc
index 708efabab5..3a94bf4a84 100644
--- a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto.adoc
+++ b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto.adoc
@@ -52,3 +52,5 @@ include::howto/build.adoc[]
 include::howto/aot.adoc[]
 
 include::howto/traditional-deployment.adoc[]
+
+include::howto/docker-compose.adoc[]
diff --git a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto/docker-compose.adoc b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto/docker-compose.adoc
new file mode 100644
index 0000000000..7d18533974
--- /dev/null
+++ b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto/docker-compose.adoc
@@ -0,0 +1,28 @@
+[[howto.docker-compose]]
+== Docker Compose
+
+This section includes topics relating to the Docker Compose support in Spring Boot.
+
+[[howto.docker-compose.jdbc-url]]
+=== Customizing the JDBC URL
+
+When using `JdbcConnectionDetails` with Docker Compose, the parameters of the JDBC URL
+can be customized by applying the `org.springframework.boot.jdbc.parameters` label to the
+service. For example:
+
+[source,yaml,indent=0]
+----
+services:
+  postgres:
+    image: 'postgres:15.3'
+    environment:
+      - 'POSTGRES_USER=myuser'
+      - 'POSTGRES_PASSWORD=secret'
+      - 'POSTGRES_DB=mydb'
+    ports:
+      - '5432:5432'
+    labels:
+      org.springframework.boot.jdbc.parameters: 'ssl=true&sslmode=require'
+----
+
+With this Docker Compose file in place, the JDBC URL used is `jdbc:postgresql://127.0.0.1:5432/mydb?ssl=true&sslmode=require`.