consul-api

Java client for Consul HTTP API (http://consul.io)

Supports all API endpoints (http://www.consul.io/docs/agent/http.html), all consistency modes and parameters (tags, datacenters etc.)

Latest releases

[1.2.1] (https://github.com/Ecwid/consul-api/milestone/5?closed=1) - 9 Oct 2016

[1.2.0] (https://github.com/Ecwid/consul-api/milestone/4?closed=1) - 6 Oct 2016

[1.1.11] (https://github.com/Ecwid/consul-api/milestone/3?closed=1) - 11 Jul 2016

How to use

ConsulClientclient = newConsulClient("localhost");
// KVbyte[] binaryData = newbyte[] {1,2,3,4,5,6,7};
client.setKVBinaryValue("someKey", binaryData);
//list known datacentersResponse<List<String>> response = client.getCatalogDatacenters();
System.out.println("Datacenters: " + response.getValue());
// register new serviceNewServicenewService = newNewService();
newService.setId("myapp_01");
newService.setName("myapp");
newService.setPort(8080);
client.agentServiceRegister(newService);
// register new service with associated health checkNewServicenewService = newNewService();
newService.setId("myapp_01");
newService.setName("myapp");
newService.setPort(8080);
NewService.CheckserviceCheck = newNewService.Check();
serviceCheck.setScript("/usr/bin/some-check-script");
serviceCheck.setInterval("10s");
newService.setCheck(serviceCheck);
client.agentServiceRegister(newService);

How to add consul-api into your project

Gradle

compile "com.ecwid.consul:consul-api:1.2.1"

Maven

<dependency>
<groupId>com.ecwid.consul</groupId>
<artifactId>consul-api</artifactId>
<version>1.2.1</version>
</dependency>

How to build from sources

• Checkout the sources
• ./gradlew build

Gradle will compile sources, package classes (sources and javadocs too) into jars and run all tests. The build results will located in build/libs/ folder