Quarkus supports a feature called Dev Services that allows you to create various datasources without any config.
If you have docker running and have not configured quarkus.infinispan-client.hosts
,
Quarkus will automatically start an Infinispan container when running tests or dev mode, and automatically configure the connection.
Available properties to customize the Infinispan DevService.
When running the production version of the application, the Infinispan connection need to be configured as normal,
so if you want to include a production database config in your application.properties
and continue to use Dev Services
we recommend that you use the %prod.
profile to define your Infinispan settings.
Dev Services for Infinispan relies on Docker to start the server.
Connecting to the running Infinispan Server
You don’t need to configure anything in dev mode.
The server will be running in a random port.
If you need a fixed port, then configure quarkus.infinispan-client.devservices.port
property.
The running Infinispan Server has authentication enabled and a user with full admin role. The credentials of the user are admin/password. |
Accessing to the Infinispan Server Console
Infinispan Server provides a web console that can be accessed with a browser:
-
Open the Dev UI
-
You will see an Infinispan Client box. Click on Web Console and enter the credentials above.
If your environment does not support Docker, you will need to spin up an Infinispan Server manually, or connect to an already running server.
Overriding the Infinispan Server Image
The extension is updated regularly and the Dev Services will start the latest final version image of Infinispan.
Use quarkus.infinispan-client.devservices.image-name
property to specify another image that fits your needs.
Enabling / Disabling Dev Services for Infinispan
Dev Services for Infinispan is automatically enabled unless:
-
quarkus.infinispan-client.devservices.enabled
is set tofalse
-
the
quarkus.infinispan-client.server-list
is configured
Dev Services for Infinispan relies on Docker to start the broker.
If your environment does not support Docker, you will need to start the broker manually, or connect to an already running broker.
You can configure the broker address using quarkus.infinispan-client.server-list
.
Cross Site Replication
If you want run the Infinispan Server container with Cross Site Replication configuration, you need to provide a site name.
quarkus.infinispan-client.devservices.site=NYC (1)
quarkus.infinispan-client.devservices.mcast-port=46666 (2)
1 | Provides a site name for your Infinispan cluster |
2 | Eventually configure a mcastPort if you want to avoid creating a cluster with another container |
Learn more about Cross Site Replication in the Infinispan Cross Site Replication documentation guide and in the Infinispan Cross Site Replication simple code tutorial.
Tracing with OpenTelemetry
Infinispan supports instrumentation of the server via OpenTelemetry. Enable tracing setting quarkus.infinispan-client.devservices.tracing.enabled
to true.
The default otlp exporter endpoint is http://localhost:4317
.
If you are running Jaeger in a container as explained in the OpenTelemetry guide, since the containers
are running in the default network, Infinispan container won’t have access to localhost.
You need to get the IP running the following command and configure the quarkus.infinispan-client.devservices.tracing.exporter.otlp.endpoint
property.
docker inspect -f '{{range.NetworkSettings.Networks}}{{.IPAddress}}{{end}}' jaeger
Persistence layer for Infinispan
Infinispan caches provide several features that need to connect to a persistence layer using a particular SQL database driver such as persisting caches in a SQL database or off-loading database tables or queries with SQL cache stores.
Infinispan needs the SQL Java Driver depending on the database kind the application is using.
To spin up a container with a particular SQL driver, configure quarkus.infinispan-client.devservices.artifacts
.
Learn more about persistence and SQL Cache Stores check the SQL Store Demo + Quarkus Demo and the Infinispan Persistence Documentation guide. |
Shared server
Most of the time you need to share the server between applications. Dev Services for Infinispan implements a service discovery mechanism for your multiple Quarkus applications running in dev mode to share a single server.
Dev Services for Infinispan starts the container with the infinispan label which is used to identify the container.
|
If you need multiple (shared) servers, you can configure the quarkus.infinispan-client.devservices.service-name
attribute and indicate the server name.
It looks for a container with the same value, or starts a new one if none can be found.
The default service name is infinispan
.
Sharing is enabled by default in dev mode, but disabled in test mode.
You can disable the sharing with quarkus.infinispan-client.devservices.shared=false