如何为基于Helm部署的K8S Hazelcast集群定义MapStore配置

1. MapStore的Java实现部署位置 #

当你使用独立Hazelcast Server集群（即当前Helm部署的远程服务端模式）时，MapStore的Java实现必须放在Hazelcast服务端的类路径下。Map层面的持久化逻辑是由持有对应分区数据的服务端节点执行的，客户端仅负责发起Map读写请求，无需持有MapStore实现代码。 #

2. Helm配置MapStore参考样例 #

整体分为两步：首先将MapStore实现包注入服务端Pod，再通过Helm values配置MapStore规则。

第一步：注入MapStore Jar包 #

两种常用实现方式：

• 基于官方Hazelcast镜像构建自定义镜像，将打包好的MapStore Jar包复制到镜像内/opt/hazelcast/lib/目录，部署时在values中指定自定义镜像地址即可。
• 配置Init容器，从镜像或共享存储中将Jar包拉取到Hazelcast容器的对应lib目录，无需修改官方基础镜像。

第二步：Helm values配置示例 #

你可以直接通过hazelcast.configuration字段传入Hazelcast服务端配置，参考样例如下：

# values.yaml 核心配置片段
image:
  # 替换为你构建的自定义Hazelcast镜像地址
  repository: your-registry/hazelcast-custom
  tag: 5.3.0-mapstore-v1
  pullPolicy: IfNotPresent

hazelcast:
  # 注入环境变量存储数据库敏感信息
  extraEnv:
    - name: DB_USER
      valueFrom:
        secretKeyRef:
          name: db-access-secret
          key: username
    - name: DB_PASSWORD
      valueFrom:
        secretKeyRef:
          name: db-access-secret
          key: password
  # Hazelcast核心配置
  configuration:
    hazelcast:
      map:
        # 替换为你需要配置持久化的Map名称
        business_data_map:
          map-store:
            enabled: true
            # 替换为你自己的MapStore实现类全限定名
            class-name: com.yourcompany.project.CustomMapStore
            # 配置回写模式：0为写透（同步写入数据库），大于0为异步回写的延迟秒数
            write-delay-seconds: 5
            initial-load-mode: LAZY
            # 传入自定义配置参数
            properties:
              jdbcUrl: jdbc:mysql://mysql-svc.default.svc.cluster.local:3306/business_db
              dbUser: ${DB_USER}
              dbPassword: ${DB_PASSWORD}

3. 现有MapStore逻辑适配Helm部署方案 #

你之前在嵌入式、独立服务场景验证通过的MapStore代码可以完全复用，不需要做业务逻辑修改，只需要做以下适配：

• 确认你的MapStore实现中没有硬编码的本地资源依赖，所有外部配置（比如数据库连接、中间件地址）都通过参数/环境变量注入。
• 按上文的方式将MapStore Jar包注入到Helm部署的Hazelcast服务端Pod类路径下。
• 确认Hazelcast Pod的网络策略允许访问目标数据库：如果数据库部署在K8S集群内，直接用Service域名访问即可；如果在集群外，需要开通对应网络出口权限。
• 将原有的MapStore配置平移到Helm values的hazelcast.configuration配置块中，敏感配置通过K8S Secret存储注入即可。

内容的提问来源于stack exchange，提问作者Aksanth