Deploying on Kubernetes

Discover ways to deploy Hazelcast clusters in Kubernetes (K8s) environments.

important

For production-grade Kubernetes deployments, we recommend you use Hazelcast Platform Operator.

Quickstart

Hazelcast Platform Operator

bash

helm repo add hazelcast https://hazelcast-charts.s3.amazonaws.com/
helm repo update
helm install operator hazelcast/hazelcast-platform-operator --set installCRDs=true
cat << EOF | kubectl apply -f -
apiVersion: hazelcast.com/v1alpha1
kind: Hazelcast
metadata:
  name: hazelcast
EOF

Helm

bash

helm repo add hazelcast https://hazelcast-charts.s3.amazonaws.com/
helm repo update
helm install hazelcast hazelcast/hazelcast

Kubectl

bash

kubectl apply -f https://raw.githubusercontent.com/hazelcast/hazelcast-kubernetes/master/rbac.yaml

kubectl run hazelcast-0 --image=hazelcast/hazelcast:{os-version} -l "role=hazelcast"
kubectl run hazelcast-1 --image=hazelcast/hazelcast:{os-version} -l "role=hazelcast"
kubectl run hazelcast-2 --image=hazelcast/hazelcast:{os-version} -l "role=hazelcast"

kubectl create service clusterip hz-hazelcast --tcp=5701 -o yaml --dry-run=client | kubectl set selector --local -f - "role=hazelcast" -o yaml | kubectl create -f -

Hazelcast Platform Operator for Kubernetes/OpenShift

Kubernetes Operators are software extensions to Kubernetes which help you create and manage your applications. Hazelcast Platform Operator automates common management tasks such as configuring, creating, and scaling Hazelcast clusters on Kubernetes and Red Hat OpenShift. By taking care of manual deployment and life-cycle management, Hazelcast Platform Operator makes it simpler to work with Hazelcast clusters.

See the Hazelcast Platform Operator Documentation for more information and find details about deploying a Hazelcast cluster in Kubernetes and also connecting clients outside Kubernetes.

Helm Chart

Helm is a package manager for Kubernetes. Hazelcast is distributed in a form of Helm Charts:

• hazelcast/hazelcast
• hazelcast/hazelcast-enterprise

See the Hazelcast Helm Charts documentation for more details.

Guides

Explore some step-by-step guides about how to use Hazelcast in Kubernetes.

Getting Started

• Deploy Hazelcast using Kubernetes

Hazelcast Platform Operator

• Connect to Hazelcast from Outside Kubernetes
• Restore a Cluster from Cloud Storage
• Replicate Data between Two Hazelcast Clusters

Hazelcast Features

• Connect External Hazelcast Client to Kubernetes
• Deploy Hazelcast Cluster with Kubernetes HPA
• Enable SSL between Hazelcast Members and Clients on Kubernetes
• Use Hazelcast WAN Replication on Kubernetes

Embedded and Sidecar Topologies

• Deploy Hazelcast Applications on Kubernetes
• Use Hazelcast as Sidecar Container

Service Meshes

• Use Hazelcast with Istio Environment
• Use Hazelcast with Linkerd Environment