Connecting to Infinispan instances that run inside Docker for Mac using the Java Hot Rod client can be tricky. In this blog post we'll be analyzing what makes this environment tricky and how to get around the issue.
The tricky thing about Docker for Mac is that internal container IP addresses are not accessible externally. This is a known issue and it can be hard to workaround it. In container orchestrators such as Openshift, you can use Routes to allow external access to the containers. However, if running vanilla Docker for Mac, the simplest option is to map ports over to the local machine.
Why is this important? When someone connects using the Hot Rod protocol, the server returns the current topology to the client. When Infinispan runs inside of Docker, this topology by default contains internal IP addresses. Since those are not accessible externally in Docker for Mac, the client won't be able to connect.
To workaround the issue, Infinispan server Hot Rod endpoint can be configured with external host/port combination, but doing this would require modifying the server's configuration. A simpler method to get around the issue is to configure the client's intelligence to be Basic. By doing this the server won't send topology updates nor will the client be able to locate where keys are located using hashing. This has a negative performance impact since all requests to Infinispan single server or server cluster would need to go over the same IP+port. However, for demo or sample applications on Mac environments, this is reasonable thing to do.
So, how do we do all of this?
First, start Infinispan server and map Hot Rod's default port 11222 to the local 11222 port:
docker run -it -p 11222:11222 jboss/infinispan-server:9.2.0.Final
Open your IDE and create a project with this dependencies:
Finally, create a class that connects to Infinispan and does a simple put/get sequence:
Cheers,
Galder
The tricky thing about Docker for Mac is that internal container IP addresses are not accessible externally. This is a known issue and it can be hard to workaround it. In container orchestrators such as Openshift, you can use Routes to allow external access to the containers. However, if running vanilla Docker for Mac, the simplest option is to map ports over to the local machine.
Why is this important? When someone connects using the Hot Rod protocol, the server returns the current topology to the client. When Infinispan runs inside of Docker, this topology by default contains internal IP addresses. Since those are not accessible externally in Docker for Mac, the client won't be able to connect.
To workaround the issue, Infinispan server Hot Rod endpoint can be configured with external host/port combination, but doing this would require modifying the server's configuration. A simpler method to get around the issue is to configure the client's intelligence to be Basic. By doing this the server won't send topology updates nor will the client be able to locate where keys are located using hashing. This has a negative performance impact since all requests to Infinispan single server or server cluster would need to go over the same IP+port. However, for demo or sample applications on Mac environments, this is reasonable thing to do.
So, how do we do all of this?
First, start Infinispan server and map Hot Rod's default port 11222 to the local 11222 port:
docker run -it -p 11222:11222 jboss/infinispan-server:9.2.0.Final
Open your IDE and create a project with this dependencies:
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
<dependencyManagement> | |
<dependencies> | |
<dependency> | |
<groupId>org.infinispan</groupId> | |
<artifactId>infinispan-bom</artifactId> | |
<version>9.2.0.Final</version> | |
<scope>import</scope> | |
<type>pom</type> | |
</dependency> | |
</dependencies> | |
</dependencyManagement> | |
<dependencies> | |
<dependency> | |
<groupId>org.infinispan</groupId> | |
<artifactId>infinispan-client-hotrod</artifactId> | |
</dependency> | |
</dependencies> |
Finally, create a class that connects to Infinispan and does a simple put/get sequence:
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
package main; | |
import org.infinispan.client.hotrod.RemoteCache; | |
import org.infinispan.client.hotrod.RemoteCacheManager; | |
import org.infinispan.client.hotrod.configuration.ClientIntelligence; | |
import org.infinispan.client.hotrod.configuration.ConfigurationBuilder; | |
public class Maint { | |
public static void main(String[] args) { | |
ConfigurationBuilder builder = new ConfigurationBuilder(); | |
builder | |
.addServer().host("127.0.0.1").port(11222) | |
.clientIntelligence(ClientIntelligence.BASIC); | |
RemoteCacheManager cacheContainer = new RemoteCacheManager(builder.build()); | |
RemoteCache<String, String> cache = cacheContainer.getCache(); | |
cache.put("hello", "world"); | |
final String value = cache.get("hello"); | |
System.out.printf("Value is: %s%n", value); | |
} | |
} |
Cheers,
Galder
No comments:
Post a Comment