hazelcast-heroku-discovery

Hazelcast Discovery Plugin for Heroku Private Spaces

License	MIT
Categories	Hazelcast Application Layer Libs Distributed Applications Heroku Container PaaS Providers
GroupId	com.github.jkutner
ArtifactId	hazelcast-heroku-discovery
Last Version	3.7.2
Release Date	Mar 9, 2017
Type	jar
Description	hazelcast-heroku-discovery Hazelcast Discovery Plugin for Heroku Private Spaces
Project URL	https://github.com/jkutner/hazelcast-heroku-discovery
Source Code Management	https://github.com/jkutner/hazelcast-heroku-discovery

Download hazelcast-heroku-discovery

Filename	Size
hazelcast-heroku-discovery-3.7.2.pom
hazelcast-heroku-discovery-3.7.2.jar	6 KB
hazelcast-heroku-discovery-3.7.2-sources.jar	3 KB
hazelcast-heroku-discovery-3.7.2-javadoc.jar	28 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.jkutner/hazelcast-heroku-discovery/ -->
<dependency>
    <groupId>com.github.jkutner</groupId>
    <artifactId>hazelcast-heroku-discovery</artifactId>
    <version>3.7.2</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.jkutner/hazelcast-heroku-discovery/
implementation 'com.github.jkutner:hazelcast-heroku-discovery:3.7.2'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.jkutner/hazelcast-heroku-discovery/
implementation ("com.github.jkutner:hazelcast-heroku-discovery:3.7.2")

Apache Buildr

'com.github.jkutner:hazelcast-heroku-discovery:jar:3.7.2'

Apache Ivy

<dependency org="com.github.jkutner" name="hazelcast-heroku-discovery" rev="3.7.2">
  <artifact name="hazelcast-heroku-discovery" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.jkutner', module='hazelcast-heroku-discovery', version='3.7.2')
)

Scala SBT

libraryDependencies += "com.github.jkutner" % "hazelcast-heroku-discovery" % "3.7.2"

Leiningen

[com.github.jkutner/hazelcast-heroku-discovery "3.7.2"]

Dependencies

compile (1)

Group / Artifact	Type	Version
com.hazelcast : hazelcast	jar	3.7

test (3)

Group / Artifact	Type	Version
junit : junit	jar	4.12
org.slf4j : slf4j-simple	jar	1.7.21
com.github.stefanbirkner : system-rules	jar	1.16.0

Project Modules

There are no modules declared in this project.

Hazelcast Heroku Discovery

This Hazelcast Discovery Plugin will lookup IP addresses of other members by resolving service names against the Heroku DNS Discovery in Heroku Private Spaces.

Usage

In Maven:

<dependency>
  <groupId>com.github.jkutner</groupId>
  <artifactId>hazelcast-heroku-discovery</artifactId>
  <version>3.7.0</version>
</dependency>

In Gradle:

dependencies {
    compile('com.github.jkutner:hazelcast-heroku-discovery:3.7.0')
}

A minimal hazelcast.xml looks like this:

<?xml version="1.0" encoding="UTF-8"?>
<hazelcast xsi:schemaLocation="http://www.hazelcast.com/schema/config hazelcast-config-3.7.xsd"
           xmlns="http://www.hazelcast.com/schema/config"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <properties>
    <property name="hazelcast.discovery.enabled">true</property>
  </properties>
  <network>
    <join>
      <!-- deactivate normal discovery -->
      <multicast enabled="false"/>
      <tcp-ip enabled="false" />

      <!-- activate the Heroku DNS Discovery -->
      <discovery-strategies>
        <discovery-strategy
          enabled="true"
          class="com.github.jkutner.hazelcast.HerokuDiscoveryStrategy">
        </discovery-strategy>
      </discovery-strategies>
    </join>
  </network>
</hazelcast>

Hazelcast Discovery SPI

Hazelcast, since 3.6, offers a, so called, Discovery SPI to integrate external discovery mechanisms into the system. For more information please rely on the official documentation, available here.

Configuration

No configuration is required by default. The plugin will detect the service name from the $HEROKU_DNS_FORMATION_NAME environment variable set by Heroku.

If you want to configure the hazelcast.merge.first.run.delay.seconds, set the following in your hazelcast.xml:

<discovery-strategy
  enabled="true"
  class="com.github.jkutner.hazelcast.HerokuDiscoveryStrategy">
    <properties>
      <property name="mergeDelay">30</property>
    </properties>
</discovery-strategy>

If you want to configure the service names (i.e. the process types) that will be discovered, you can set a ; delimited list like this:

<discovery-strategy
  enabled="true"
  class="com.github.jkutner.hazelcast.HerokuDiscoveryStrategy">
    <properties>
      <property name="serviceNames">web;worker;job</property>
    </properties>
</discovery-strategy>

License

MIT

Versions

Version
3.7.2 Mar 9, 2017
3.7.1 Aug 30, 2016
3.7.0 Aug 29, 2016