A newer version of Hazelcast Operator is available.

View latest

Configuring Maps

Hazelcast maps are used to distribute data across a cluster and make it easy to scale your applications while protecting data against member failures. You can create and configure maps using the Map resource.

Configuring the Map Resource

Below are the configuration options for the Map resource. You can find more detailed information in API Reference page.

Field Description


Name of the map config to be created. If empty, the CR name will be used. It cannot be updated after the map config is created successfully.


HazelcastResourceName defines the name of the Hazelcast resource.


Count of synchronous backups.


Maximum time in seconds for each entry to stay in the map.


Maximum time in seconds for each entry to stay idle in the map.


Configuration for removing data from the map when it reaches its max size.

  • evictionPolicy: Eviction policy to be applied when map reaches its max size according to the max size policy.

  • maxSize: Max size of the map.

  • maxSizePolicy: Policy for deciding if the maxSize is reached.


Indexes to be created for the map data.


When enabled, map data will be persisted.

Persistence should be enabled for Hazelcast before enabling it for the map. You can learn about enabling persistence for Hazelcast in Persistence, Backup and Restore.


Configuration options when you want to load/store the map entries from/to a persistent data store such as a relational database. You can learn more at Working With External Data.

  • className: Name of your class implementing MapLoader and/or MapStore interface.

  • initialMode: Sets the initial entry loading mode.

  • writeDelaySeconds: Policy for deciding if the maxSize is reached.

  • writeBatchSize: Used to create batches when writing to map store.

  • writeCoealescing: It is meaningful if you are using write behind in MapStore. When it is set to true, only the latest store operation on a key during the write-delay-seconds will be reflected to MapStore.

  • propertiesSecretName: Name of the secret holding the properties for the MapStore classes implementing the MapLoaderLifecycleSupport interface.


Configuration options for listening for the map-level or entry-based events using the listeners provided by the Hazelcast’s eventing framework. You can learn more at Distributed Object Events.

  • className: Name of your class implementing a MapListener sub-interface.

  • includeValues: An optional attribute that indicates whether the map event should contains the map value.

  • local: An optional attribute that indicates whether you can listen to the map on the local member.

Example Configuration

The following Map resource creates a map configuration for the Hazelcast custom resource that is defined in the hazelcastResourceName field.

Example configuration
apiVersion: hazelcast.com/v1alpha1
kind: Map
  name: map-sample
  hazelcastResourceName: hazelcast-sample
  backupCount: 1
  timeToLiveSeconds: 0
  maxIdleSeconds: 0
    evictionPolicy: NONE
    maxSize: 0
    maxSizePolicy: PER_NODE
    - type: HASH
      name: index1
        - "name"
        - "age"
    - type: BITMAP
        - "name"
        uniqueKey: id
        uniqueKeyTransition: RAW
  persistenceEnabled: true
    - className: com.example.MyListener
      includeValues: true
      local: false

After creating the Map resource, you can learn about its status with the following command

kubectl get map map-sample -o wide
map-sample    Success