Consul Configuration Store
The Consul Configuration Store extends the Vert.x Configuration Retriever and provides the way to retrieve configuration from a Consul.
Using the Consul Configuration Store
To use the Consul Configuration Store, add the following dependency to the dependencies section of your build descriptor:
-
Maven (in your
pom.xml
):
<dependency>
<groupId>io.vertx</groupId>
<artifactId>vertx-config-consul</artifactId>
<version>3.6.0.CR1</version>
</dependency>
<dependency>
<groupId>io.vertx</groupId>
<artifactId>vertx-config</artifactId>
<version>3.6.0.CR1</version>
</dependency>
-
Gradle (in your
build.gradle
file):
compile 'io.vertx:vertx-config:3.6.0.CR1'
compile 'io.vertx:vertx-config-consul:3.6.0.CR1'
Configuring the store
Once added to your classpath or dependencies, you need to configure the `ConfigRetriever`to use this store:
require 'vertx-config/config_retriever'
store = {
'type' => "consul",
'config' => {
'host' => "localhost",
'port' => 8500,
'prefix' => "foo"
}
}
retriever = VertxConfig::ConfigRetriever.create(vertx, {
'stores' => [
store
]
})
The store configuration is used to create an instance of
ConsulClient
. Check the documentation of the Vert.x Consul Client
for further details. And this is the parameters specific to the Consul Configuration Store:
prefix
-
A prefix that will not be taken into account when building the configuration tree. Defaults to empty.
delimiter
-
Symbol that used to split keys in the Consul storage to obtain levels in the configuration tree. Defaults to "/".