Set default Docker image for Datasource Dev Services

Author: wjglerum

docs/src/main/asciidoc/_attributes.adoc

@@ -11,6 +11,11 @@
 :mandrel-flavor: ${mandrel.image-tag-for-documentation}
 :surefire-version: ${version.surefire.plugin}
 :gradle-version: ${gradle-wrapper.version}
+:db2-image: ${db2.image}
+:mariadb-image: ${mariadb.image}
+:mssql-image: ${mssql.image}
+:oracle-image: ${oracle.image}
+:postgres-image: ${postgres.image}
 :elasticsearch-version: ${elasticsearch-server.version}
 :elasticsearch-image: ${elasticsearch.image}
 :opensearch-image: ${opensearch.image}

docs/src/main/asciidoc/databases-dev-services.adoc

@@ -55,9 +55,10 @@ By default, Quarkus uses the default image for the current version of Testcontai
 An example file is shown below:
 
 .src/main/resources/container-license-acceptance.txt
+[source,subs=attributes+]
 ----
-ibmcom/db2:11.5.0.0a
-mcr.microsoft.com/mssql/server:2022-latest
+{db2-image}
+{mssql-image}
 ----
 
 === Capturing Logs
@@ -249,14 +250,14 @@ psql -h localhost -p <random port> -U quarkus
 
 The random port can be found with `docker ps`
 
-[source, bash]
+[source, bash, subs=attributes+]
 ----
 docker ps
 
 # returns something like this:
 
 CONTAINER ID   IMAGE           [..]    PORTS                                         [..]
-b826e3a168c4   postgres:14.2   [..]    0.0.0.0:49174->5432/tcp, :::49174->5432/tcp   [..] <1>
+b826e3a168c4   {postgres-image}   [..]    0.0.0.0:49174->5432/tcp, :::49174->5432/tcp   [..] <1>
 ----
 <1> The random port is `49174`.
 
@@ -283,10 +284,10 @@ docker ps --format "table {{.ID}}\t{{.Image}}\t{{.Labels}}\t{{.Ports}}
 
 An example output using Dev Services for PostgreSQL is the following:
 
-[source, bash]
+[source, bash, subs=attributes+]
 ----
 CONTAINER ID   IMAGE          LABELS                                                                        PORTS
-a7034c91a392   postgres:14    org.testcontainers.sessionId=xyz,datasource=default,org.testcontainers=true   0.0.0.0:49154->5432/tcp, :::49154->5432/tcp
+a7034c91a392   {postgres-image}     org.testcontainers.sessionId=xyz,datasource=default,org.testcontainers=true   0.0.0.0:49154->5432/tcp, :::49154->5432/tcp
 ----
 
 In the labels tab, we see that Quarkus added the datasource label, which can be very useful in differentiating containers when multiple
@@ -299,20 +300,20 @@ Dev Services have been started.
 The Database Dev Services supports xref:compose-dev-services.adoc[Compose Dev Services].
 It relies on a `compose-devservices.yml`, such as:
 
-[source,yaml]
+[source,yaml,subs=attributes+]
 ----
 name: <application name>
 services:
   postgresql:
-    image: docker.io/postgres:17
+    image: {postgres-image}
     ports:
       - "5432"
     environment:
       POSTGRES_USER: quarkus
       POSTGRES_PASSWORD: quarkus
       POSTGRES_DB: quarkus
   oracle:
-    image: docker.io/gvenzl/oracle-free:23-slim-faststart
+    image: {oracle-image}
     ports:
       - "1521"
     environment:
@@ -323,7 +324,7 @@ services:
     labels:
       io.quarkus.devservices.compose.wait_for.logs: .*DATABASE IS READY TO USE.*
   mssql:
-    image: mcr.microsoft.com/mssql/server:2022-latest
+    image: {mssql-image}
     ports:
       - "1433"
     environment:

docs/src/main/asciidoc/getting-started-dev-services.adoc

@@ -225,8 +225,9 @@ If you like, use your container tool to see what containers are running.
 For example, if you're using Docker, run `docker ps`, and for podman, run `podman ps`.
 You should see something like the following:
 
+[source,bash,subs=attributes+]
 ----
-ff88dcedd899  docker.io/library/postgres:14  postgres -c fsync...  20 minutes ago  Up 20 minutes  0.0.0.0:34789->5432/tcp  nostalgic_bassi
+ff88dcedd899  {postgres-image}  postgres -c fsync...  20 minutes ago  Up 20 minutes  0.0.0.0:34789->5432/tcp  nostalgic_bassi
 ----
 
 Stop Quarkus and run `docker ps` again.

docs/src/main/asciidoc/getting-started-reactive.adoc

@@ -300,12 +300,12 @@ To run the application, don’t forget to start a database and provide the confi
 
 For example, you can use Docker to run your database:
 
-[source, bash]
+[source, bash, subs=attributes+]
 ----
 docker run -it --rm=true \
     --name postgres-quarkus -e POSTGRES_USER=quarkus \
     -e POSTGRES_PASSWORD=quarkus -e POSTGRES_DB=fruits \
-    -p 5432:5432 postgres:14.1
+    -p 5432:5432 {postgres-image}
 ----
 
 Then, launch the application using:

docs/src/main/asciidoc/getting-started-testing.adoc

@@ -1392,7 +1392,7 @@ The Testcontainers library usually return connection strings without respecting
 
 The following example illustrates the use with PostgreSQL, but the approach is applicable to all containers.
 
-[source,java]
+[source,java,subs=attributes+]
 ----
 import io.quarkus.test.common.DevServicesContext;
 import io.quarkus.test.common.QuarkusTestResourceLifecycleManager;
@@ -1417,7 +1417,7 @@ public class CustomResource implements QuarkusTestResourceLifecycleManager, DevS
     @Override
     public Map<String, String> start() {
         // start a container making sure to call withNetworkMode() with the value of containerNetworkId if present
-        container = new PostgreSQLContainer<>("postgres:latest").withLogConsumer(outputFrame -> {});
+        container = new PostgreSQLContainer<>("{postgres-image}").withLogConsumer(outputFrame -> {});
 
         // apply the network to the container
         containerNetworkId.ifPresent(container::withNetworkMode);

docs/src/main/asciidoc/quartz.adoc

@@ -319,7 +319,7 @@ http {
 
 In the root directory, create a `docker-compose.yml` file with the following content:
 
-[source,yaml]
+[source,yaml,subs=attributes+]
 ----
 version: '3'
 
@@ -337,7 +337,7 @@ services:
       - postgres
 
   nginx: <2>
-    image: nginx:1.17.6
+    image: nginx:latest
     volumes:
       - ./nginx.conf:/etc/nginx/nginx.conf:ro
     depends_on:
@@ -347,8 +347,8 @@ services:
     networks:
       - tasks-network
 
-  postgres: <3>
-    image: postgres:14.1
+  db: <3>
+    image: {postgres-image}
     container_name: quarkus_test
     environment:
       - POSTGRES_USER=quarkus_test

docs/src/main/asciidoc/reactive-sql-clients.adoc

@@ -81,9 +81,9 @@ If you start the application in dev mode, Quarkus provides you with a https://qu
 
 You might also start a database up front:
 
-[source,bash]
+[source,bash,subs=attributes+]
 ----
-docker run -it --rm=true --name quarkus_test -e POSTGRES_USER=quarkus_test -e POSTGRES_PASSWORD=quarkus_test -e POSTGRES_DB=quarkus_test -p 5432:5432 postgres:14.1
+docker run -it --rm=true --name quarkus_test -e POSTGRES_USER=quarkus_test -e POSTGRES_PASSWORD=quarkus_test -e POSTGRES_DB=quarkus_test -p 5432:5432 {postgres-image}
 ----
 ====
 

docs/src/main/asciidoc/security-getting-started-tutorial.adoc

@@ -308,7 +308,7 @@ You can configure it to use plain text or custom passwords.
 * For custom iterations: `BcryptUtil.bcryptHash(password, iterationCount)` where higher iterations (12-14) provide more security but slower performance.
 ====
 
-- For more information about configuring passwords and roles, see xref:configure-the-application[Configure the application]. 
+- For more information about configuring passwords and roles, see xref:configure-the-application[Configure the application].
 - For more information on hashing passwords and available options, see xref:security-jpa.adoc#password-storage-and-hashing[Password storage and hashing].
 
 [NOTE]
@@ -534,11 +534,11 @@ Then, compile and run your application in either JVM or native mode.
 
 === Start the PostgreSQL server
 
-[source,bash]
+[source,bash,subs=attributes+]
 ----
 docker run --rm=true --name security-getting-started -e POSTGRES_USER=quarkus \
            -e POSTGRES_PASSWORD=quarkus -e POSTGRES_DB=quarkus \
-           -p 5432:5432 postgres:17
+           -p 5432:5432 {postgres-image}
 ----
 
 === Compile and run the application

docs/src/main/asciidoc/spring-data-jpa.adoc

@@ -139,9 +139,9 @@ This configuration assumes that PostgreSQL will be running locally.
 
 A very easy way to accomplish that is by using the following Docker command:
 
-[source,bash]
+[source,bash,subs=attributes+]
 ----
-docker run -it --rm=true --name quarkus_test -e POSTGRES_USER=quarkus_test -e POSTGRES_PASSWORD=quarkus_test -e POSTGRES_DB=quarkus_test -p 5432:5432 postgres:14.1
+docker run -it --rm=true --name quarkus_test -e POSTGRES_USER=quarkus_test -e POSTGRES_PASSWORD=quarkus_test -e POSTGRES_DB=quarkus_test -p 5432:5432 {postgres-image}
 ----
 
 If you plan on using a different setup, please change your `application.properties` accordingly.

docs/src/main/asciidoc/spring-data-rest.adoc

@@ -158,9 +158,9 @@ This configuration assumes that PostgreSQL will be running locally.
 
 A very easy way to accomplish that is by using the following Docker command:
 
-[source,bash]
+[source,bash,subs=attributes+]
 ----
-docker run -it --rm=true --name quarkus_test -e POSTGRES_USER=quarkus_test -e POSTGRES_PASSWORD=quarkus_test -e POSTGRES_DB=quarkus_test -p 5432:5432 postgres:14.1
+docker run -it --rm=true --name quarkus_test -e POSTGRES_USER=quarkus_test -e POSTGRES_PASSWORD=quarkus_test -e POSTGRES_DB=quarkus_test -p 5432:5432 {postgres-image}
 ----
 
 If you plan on using a different setup, please change your `application.properties` accordingly.