Consul KV在Kubernetes集群重启后数据丢失问题求助

一、核心问题分析 #

1. 数据丢失原因：原StatefulSet未挂载持久卷（Persistent Volume），Consul数据仅存储在容器本地存储中，集群重启或Pod重建时数据会被清空。
2. UI无法启动原因：自定义启动参数时缺少必要配置：未启用UI组件、未允许外部访问Consul客户端接口、单节点服务器模式未设置集群初始化参数。

二、修复后的完整配置 #

替换原有Consul相关配置为以下内容，实现数据持久化+UI正常访问：

apiVersion: v1
kind: Service
metadata:
  name: consul
  labels:
    app: consul
spec:
  clusterIP: None
  ports:
    - port: 8500
      name: consul
    - port: 8300
      name: server
    - port: 8301
      name: serflan
    - port: 8302
      name: serfwan
    - port: 8600
      name: dns
  selector:
    app: consul
    
---
    
apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: consul
spec:
  serviceName: consul
  replicas: 1
  selector:
    matchLabels:
      app: consul
  # 自动为每个Pod创建持久卷声明
  volumeClaimTemplates:
  - metadata:
      name: consul-data
    spec:
      accessModes: ["ReadWriteOnce"]
      resources:
        requests:
          storage: 1Gi
  template:
    metadata:
      labels:
        app: consul
    spec:
      containers:
      - name: consul
        image: hashicorp/consul:latest
        imagePullPolicy: Always
        ports:
        - containerPort: 8500
        - containerPort: 8300
        - containerPort: 8301
        - containerPort: 8302
        - containerPort: 8600
        args:
          - "agent"
          - "-server"
          - "-bootstrap-expect=1" # 单节点集群必须设置，指定初始化所需服务器数量
          - "-ui" # 显式启用UI组件
          - "-client=0.0.0.0" # 允许外部访问Consul API/UI（默认仅绑定127.0.0.1）
          - "-data-dir=/consul/data" # 使用镜像默认数据目录，避免权限问题
        volumeMounts:
        - name: consul-data
          mountPath: /consul/data # 将持久卷挂载到Consul数据目录
---

apiVersion: v1
kind: Service
metadata:
  name: consul-lb
  labels:
    app: consul
spec:
  selector:
    app: consul
  type: NodePort
  ports:
  - port: 80
    targetPort: 8500

关键配置说明 #

• volumeClaimTemplates：StatefulSet会自动为每个Pod创建对应的PVC，数据存储在PV中，即使Pod删除/集群重启，数据也会保留。
• 启动参数补充：
  • -bootstrap-expect=1：单节点服务器模式下必须配置，确保Consul完成集群初始化。
  • -ui：启用Consul UI组件，自定义args时需显式声明。
  • -client=0.0.0.0：开放客户端端口，允许外部访问UI和API。

三、Helm部署Consul作为StatefulSet（支持静态URL访问） #

HashiCorp官方Consul Helm Chart默认使用StatefulSet部署服务器节点，只需简单配置即可实现持久化+静态访问：

1. 基础配置（values.yaml） #

server:
  enabled: true
  replicas: 1
  statefulSet:
    enabled: true # 强制使用StatefulSet（默认已启用）
  storage:
    enabled: true
    storageClass: "" # 留空使用集群默认存储类，或指定自定义类
    size: 1Gi
  service:
    type: ClusterIP # 提供集群内部静态访问地址

ui:
  enabled: true
  service:
    type: NodePort # 外部访问UI用的Service

2. 部署命令 #

helm repo add hashicorp https://helm.releases.hashicorp.com
helm install consul hashicorp/consul -f values.yaml

3. 静态URL访问 #

集群内其他服务可通过固定域名访问Consul：

• Headless Service：consul.default.svc.cluster.local（default为命名空间，可根据实际修改）
• ClusterIP Service：consul-server.default.svc.cluster.local

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