Files
deprecated-helm-charts/stable/hazelcast

Hazelcast

Hazelcast IMDG is the most widely used in-memory data grid with hundreds of thousands of installed clusters around the world. It offers caching solutions ensuring that data is in the right place when its needed for optimal performance.

Quick Start

$ helm install stable/hazelcast

Introduction

This chart bootstraps a Hazelcast and Management Center deployments on a Kubernetes cluster using the Helm package manager.

Prerequisites

  • Kubernetes 1.9+

Installing the Chart

To install the chart with the release name my-release:

$ helm install --name my-release stable/hazelcast

The command deploys Hazelcast on the Kubernetes cluster in the default configuration. The configuration section lists the parameters that can be configured during installation.

Tip

: List all releases using helm list

Uninstalling the Chart

To uninstall/delete the my-release deployment:

$ helm delete my-release

The command removes all the Kubernetes components associated with the chart and deletes the release.

Configuration

The following table lists the configurable parameters of the Hazelcast chart and their default values.

Parameter Description Default
image.repository Hazelcast Image name hazelcast/hazelcast-kubernetes
image.tag Hazelcast Image tag {VERSION}
image.pullPolicy Image pull policy IfNotPresent
image.pullSecrets Specify docker-registry secret names as an array nil
cluster.memberCount Number of Hazelcast members 2
hazelcast.rest Enable REST endpoints for Hazelcast member true
hazelcast.javaOpts Additional JAVA_OPTS properties for Hazelcast member nil
hazelcast.existingConfigMap ConfigMap which contains Hazelcast configuration file(s) that are used instead hazelcast.yaml embedded into values.yaml nil
hazelcast.yaml Hazelcast YAML Configuration (hazelcast.yaml embedded into values.yaml) {DEFAULT_HAZELCAST_YAML}
hazelcast.configurationFiles Hazelcast configuration files nil
nodeSelector Hazelcast Node labels for pod assignment nil
hostPort Port under which Hazelcast PODs are exposed on the host machines nil
gracefulShutdown.enabled Turn on and off Graceful Shutdown true
gracefulShutdown.maxWaitSeconds Maximum time to wait for the Hazelcast POD to shut down 600
livenessProbe.enabled Turn on and off liveness probe true
livenessProbe.initialDelaySeconds Delay before liveness probe is initiated 30
livenessProbe.periodSeconds How often to perform the probe 10
livenessProbe.timeoutSeconds When the probe times out 5
livenessProbe.successThreshold Minimum consecutive successes for the probe to be considered successful after having failed 1
livenessProbe.failureThreshold Minimum consecutive failures for the probe to be considered failed after having succeeded. 3
readinessProbe.enabled Turn on and off readiness probe true
readinessProbe.initialDelaySeconds Delay before readiness probe is initiated 30
readinessProbe.periodSeconds How often to perform the probe 10
readinessProbe.timeoutSeconds When the probe times out 1
readinessProbe.successThreshold Minimum consecutive successes for the probe to be considered successful after having failed 1
readinessProbe.failureThreshold Minimum consecutive failures for the probe to be considered failed after having succeeded. 3
resources.limits.cpu CPU resource limit default
resources.limits.memory Memory resource limit default
resources.requests.cpu CPU resource requests default
resources.requests.memory Memory resource requests default
service.type Kubernetes service type ('ClusterIP', 'LoadBalancer', or 'NodePort') ClusterIP
service.port Kubernetes service port 5701
rbac.create Enable installing RBAC Role authorization true
serviceAccount.create Enable installing Service Account true
serviceAccount.name Name of Service Account, if not set, the name is generated using the fullname template nil
securityContext.enabled Enables Security Context for Hazelcast and Management Center true
securityContext.runAsUser User ID used to run the Hazelcast and Management Center containers 65534
securityContext.fsGroup Group ID associated with the Hazelcast and Management Center container 65534
metrics.enabled Turn on and off JMX Prometheus metrics available at /metrics false
metrics.service.type Type of the metrics service ClusterIP
metrics.service.port Port of the /metrics endpoint and the metrics service 8080
metrics.service.annotations Annotations for the Prometheus discovery
customVolume Configuration for a volume mounted as '/data/custom' (e.g. to mount a volume with custom JARs) nil
mancenter.enabled Turn on and off Management Center application true
mancenter.image.repository Hazelcast Management Center Image name hazelcast/management-center
mancenter.image.tag Hazelcast Management Center Image tag (NOTE: must be the same or one minor release greater than Hazelcast image version) {VERSION}
mancenter.image.pullPolicy Image pull policy IfNotPresent
mancenter.image.pullSecrets Specify docker-registry secret names as an array nil
mancenter.javaOpts Additional JAVA_OPTS properties for Hazelcast Management Center nil
mancenter.licenseKey License Key for Hazelcast Management Center, if not provided, can be filled in the web interface nil
mancenter.licenseKeySecretName Kubernetes Secret Name, where Management Center License Key is stored (can be used instead of licenseKey) nil
mancenter.nodeSelector Hazelcast Management Center node labels for pod assignment nil
mancenter.resources CPU/Memory resource requests/limits nil
mancenter.persistence.enabled Enable Persistent Volume for Hazelcast Management true
mancenter.persistence.existingClaim Name of the existing Persistence Volume Claim, if not defined, a new is created nil
mancenter.persistence.accessModes Access Modes of the new Persistent Volume Claim ReadWriteOnce
mancenter.persistence.size Size of the new Persistent Volume Claim 8Gi
mancenter.service.type Kubernetes service type ('ClusterIP', 'LoadBalancer', or 'NodePort') LoadBalancer
mancenter.service.port Kubernetes service port 5701
mancenter.livenessProbe.enabled Turn on and off liveness probe true
mancenter.livenessProbe.initialDelaySeconds Delay before liveness probe is initiated 30
mancenter.livenessProbe.periodSeconds How often to perform the probe 10
mancenter.livenessProbe.timeoutSeconds When the probe times out 5
mancenter.livenessProbe.successThreshold Minimum consecutive successes for the probe to be considered successful after having failed 1
mancenter.livenessProbe.failureThreshold Minimum consecutive failures for the probe to be considered failed after having succeeded. 3
mancenter.readinessProbe.enabled Turn on and off readiness probe true
mancenter.readinessProbe.initialDelaySeconds Delay before readiness probe is initiated 30
mancenter.readinessProbe.periodSeconds How often to perform the probe 10
mancenter.readinessProbe.timeoutSeconds When the probe times out 1
mancenter.readinessProbe.successThreshold Minimum consecutive successes for the probe to be considered successful after having failed 1
mancenter.readinessProbe.failureThreshold Minimum consecutive failures for the probe to be considered failed after having succeeded. 3
mancenter.ingress.enabled Enable ingress for the management center false
mancenter.ingress.annotations Any annotations for the ingress {}
mancenter.ingress.hosts List of hostnames for ingress, see values.yaml for example []
mancenter.ingress.tls List of TLS configuration for ingress, see values.yaml for example []

Specify each parameter using the --set key=value[,key=value] argument to helm install. For example,

$ helm install --name my-release \
  --set cluster.memberCount=3,hazelcast.rest=false \
    stable/hazelcast

The above command sets number of Hazelcast members to 3 and disables REST endpoints.

Alternatively, a YAML file that specifies the values for the parameters can be provided while installing the chart. For example,

$ helm install --name my-release -f values.yaml stable/hazelcast

Tip

: You can use the default values.yaml

Custom Hazelcast configuration

Custom Hazelcast configuration can be specified inside values.yaml, as the hazelcast.yaml property.

hazelcast:
   yaml:
    hazelcast:
      network:
        join:
          multicast:
            enabled: false
          kubernetes:
            enabled: true
            service-name: ${serviceName}
            namespace: ${namespace}
            resolve-not-ready-addresses: true
        <!-- Custom Configuration Placeholder -->