Open Source Projects:
Back to top

Hazelcast Helm Chart

November 05, 2018

Hazelcast was recently published in a form of Helm Chart. It means that now deploying a fully-functional Hazelcast cluster on Kubernetes is easier than ever.


To use Helm Charts you need to:

  • Install Helm tool
  • Install Tiller (server side of Helm), just execute “$ helm init

Installing Hazelcast Helm Chart

To install Hazelcast Helm Chart, run the following command.

$ helm install stable/hazelcast 

That’s all! Your cluster Hazelcast is already deployed and running. You can check it with the following command:

$ kubectl get all
NAME                           READY     STATUS    RESTARTS   AGE
pod/altered-swan-hazelcast-0   1/1       Running   0          1m
pod/altered-swan-hazelcast-1   1/1       Running   0          1m

NAME                             TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)    AGE
service/altered-swan-hazelcast   ClusterIP           5701/TCP   1m
service/kubernetes               ClusterIP             443/TCP    1d

NAME                                      DESIRED   CURRENT   AGE
statefulset.apps/altered-swan-hazelcast   2         2         1m

If you want to confirm that the Hazelcast members really formed a cluster, you check the logs of any Hazelcast POD.

$ kubectl logs pod/altered-swan-hazelcast-1
Members {size:2, ver:2} [
        Member []:5701 - 46f5815a-a892-4091-b4d3-bb6940a80663
        Member []:5701 - e9244db3-f305-4377-8a81-ef4e89f6add6 this

Note that you can add some configuration to your Hazelcast cluster. For example, if you wanted 3 Hazelcast members instead of 2, you could run:

$ helm install stable/hazelcast --set cluster.memberCount=3

For all parameters, please check the documentation.

Using Hazelcast Cluster

When the Hazelcast cluster is up and running, you can use it by a sample application deployed on Kubernetes. Here’s how Hazelcast Client could be configured in Java.

public ClientConfig clientConfig() {
    ClientConfig config = new ClientConfig();
    return config;

Note that you need to have the latest Maven/Gradle dependencies: “com.hazelcast:hazelcast-client“, “com.hazelcast:hazelcast“, and “com.hazelcast:hazelcast-kubernetes“.

Management Center and Hazelcast Enterprise

There are also additional Helm Charts hosted in the Hazelcast Helm Chart repository:

If you want to deploy Hazelcast with Management Center, all you need to do is to add Hazelcast repository to your Helm tool and install Hazelcast.

$ helm repo add hazelcast 
$ helm repo update
$ helm install hazelcast/hazelcast 

Then, you should see your Hazelcast cluster and the Management Center application.

$ kubectl get all
NAME                                                        READY     STATUS    RESTARTS   AGE
pod/lovely-greyhound-hazelcast-0                            1/1       Running   0          8m
pod/lovely-greyhound-hazelcast-1                            1/1       Running   0          7m
pod/lovely-greyhound-hazelcast-mancenter-7d6c7c4f67-929mq   1/1       Running   0          8m

NAME                                           TYPE           CLUSTER-IP      EXTERNAL-IP      PORT(S)          AGE
service/kubernetes                             ClusterIP                443/TCP          1d
service/lovely-greyhound-hazelcast             ClusterIP              5701/TCP         8m
service/lovely-greyhound-hazelcast-mancenter   LoadBalancer   8080:31029/TCP   8m

NAME                                                         DESIRED   CURRENT   UP-TO-DATE   AVAILABLE   AGE
deployment.extensions/lovely-greyhound-hazelcast-mancenter   1         1         1            1           8m

NAME                                                                    DESIRED   CURRENT   READY     AGE
replicaset.extensions/lovely-greyhound-hazelcast-mancenter-7d6c7c4f67   1         1         1         8m

NAME                                                   DESIRED   CURRENT   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/lovely-greyhound-hazelcast-mancenter   1         1         1            1           8m

NAME                                                              DESIRED   CURRENT   READY     AGE
replicaset.apps/lovely-greyhound-hazelcast-mancenter-7d6c7c4f67   1         1         1         8m

NAME                                          DESIRED   CURRENT   AGE
statefulset.apps/lovely-greyhound-hazelcast   2         2         8m

You can access Management Center by the URL specified in LoadBalancer: “http://<EXTERNAL-IP>:8080/hazelcast-mancenter“.

For the instructions on how to deploy Hazelcast Enterprise, please check this.

About the Author

About the Author

Rafal Leszko

Rafal Leszko

Cloud Software Engineer

Rafał is a passionate software engineer, trainer, conference speaker, and author of the book, Continuous Delivery with Docker and Jenkins. He specializes in Java development, cloud environments, and continuous delivery. Prior to joining Hazelcast, Rafał worked with a variety of companies and scientific organizations, including Google, CERN, and AGH University of Science and Technology.

Latest Blogs

Where Is My Cache? Architectural Patterns for Caching Microservices

Where Is My Cache? Architectural Patterns for Caching Microservices

Rolling Upgrade Hazelcast IMDG on Kubernetes

Rolling Upgrade Hazelcast IMDG on Kubernetes

Hazelcast Sidecar Container Pattern

Hazelcast Sidecar Container Pattern

View all blogs by the author

Free Hazelcast Online Training Center

Whether you're interested in learning the basics of in-memory systems, or you're looking for advanced, real-world production examples and best practices, we've got you covered.