Kubernetes中Eureka Server StatefulSet部署问题排查与配置建议

针对你用StatefulSet部署Eureka Server、绑定固定名称保障重启后客户端通信的需求，结合提供的配置，以下是具体修改建议：

1. PersistentVolume（PV）配置修正 #

你的PV配置存在两处关键错误：

• hostpath拼写错误，正确写法为**hostPath**（P大写）
• PV是集群级资源，不属于任何Namespace，需删除metadata中的namespace: rtb字段
• 建议添加storageClassName，确保与PVC匹配（集群有默认存储类可省略，否则需指定具体存储类名称）

修正后的PV配置：

apiVersion: v1
kind: PersistentVolume
metadata:
  name: my-pv
spec:
  capacity:
    storage: 2Gi
  accessModes:
    - ReadWriteOnce
  hostPath:
    path: /run/desktop/mnt/host/c/Users/User/Documents/kubernetesbkp
  storageClassName: "" # 留空表示使用无类存储，或指定集群存在的存储类名称

2. StatefulSet 存储卷配置优化 #

StatefulSet的最佳实践是用volumeClaimTemplates自动为每个Pod创建专属PVC，而非直接引用固定PVC。这种方式即使后续扩容副本，每个Eureka实例也能拥有独立存储。

修改后的StatefulSet配置（替换原volumes部分）：

apiVersion: apps/v1
kind: StatefulSet
metadata:
  namespace: rtb
  name: eureka
spec:
  serviceName: "eureka"
  replicas: 1
  selector:
    matchLabels:
      app: eureka
  # 添加volumeClaimTemplates自动生成PVC
  volumeClaimTemplates:
    - metadata:
        name: service-registry-persistent-storage
        labels:
          app: eureka
      spec:
        accessModes:
          - ReadWriteOnce
        resources:
          requests:
            storage: 1Gi
        # 需要指定存储类则添加：storageClassName: "your-storage-class"
  template:
    metadata:
      labels:
        app: eureka
    spec:
      containers:
        - name: eureka
          image: my-image
          imagePullPolicy: Always # 生产环境建议改为IfNotPresent并指定镜像版本
          ports:
            - containerPort: 8761
          env:
            - name: EUREKA_SERVER_ADDRESS
              valueFrom:
                configMapKeyRef:
                  name: eureka-cm
                  key: eureka_service_address
          volumeMounts:
            - name: service-registry-persistent-storage
              mountPath: /var/lib/eureka
  # 移除原volumes字段，改用volumeClaimTemplates

3. Eureka 客户端与服务端配置调整 #

服务端（application.yml） #

当前单实例配置没问题，但如果未来要扩容Eureka集群，需修改以下参数：

eureka:
  client:
    register-with-eureka: true
    fetch-registry: true
    serviceUrl:
      defaultZone: http://eureka-0.eureka:8761/eureka,http://eureka-1.eureka:8761/eureka

客户端配置 #

你当前客户端hostname写死为eureka-0，实例重启或扩容后可能导致连接失败。建议改用Headless Service域名，保障高可用性：

eureka:
  instance:
    preferIpAddress: true
  client:
    serviceUrl:
      defaultZone: http://eureka.rtb.svc.cluster.local:8761/eureka # 自动解析到所有Eureka实例

4. 其他细节优化 #

• NodePort Service：如需固定外部访问端口，可添加nodePort: 30087（端口范围30000-32767），避免随机分配端口
• 资源限制：在StatefulSet的container中添加资源限制，防止Pod占用过多集群资源：

  resources:
    requests:
      cpu: "100m"
      memory: "256Mi"
    limits:
      cpu: "500m"
      memory: "512Mi"
  

• 镜像版本：image: my-image建议指定具体版本（如my-image:v1.0.0），避免拉取不稳定的最新镜像

修正后的完整部署YAML #

apiVersion: v1
kind: PersistentVolume
metadata:
  name: my-pv
spec:
  capacity:
    storage: 2Gi
  accessModes:
    - ReadWriteOnce
  hostPath:
    path: /run/desktop/mnt/host/c/Users/User/Documents/kubernetesbkp
  storageClassName: ""

---
apiVersion: v1
kind: ConfigMap
metadata:
  namespace: rtb
  name: eureka-cm
data:
  eureka_service_address: http://eureka-0.eureka:8761/eureka

---
apiVersion: v1
kind: Service
metadata:
  namespace: rtb
  name: eureka
  labels:
    app: eureka
spec:
  clusterIP: None
  ports:
    - port: 8761
      name: eureka
  selector:
    app: eureka

---
apiVersion: apps/v1
kind: StatefulSet
metadata:
  namespace: rtb
  name: eureka
spec:
  serviceName: "eureka"
  replicas: 1
  selector:
    matchLabels:
      app: eureka
  volumeClaimTemplates:
    - metadata:
        name: service-registry-persistent-storage
        labels:
          app: eureka
      spec:
        accessModes:
          - ReadWriteOnce
        resources:
          requests:
            storage: 1Gi
  template:
    metadata:
      labels:
        app: eureka
    spec:
      containers:
        - name: eureka
          image: my-image:v1.0.0 # 指定具体镜像版本
          imagePullPolicy: IfNotPresent
          ports:
            - containerPort: 8761
          env:
            - name: EUREKA_SERVER_ADDRESS
              valueFrom:
                configMapKeyRef:
                  name: eureka-cm
                  key: eureka_service_address
          volumeMounts:
            - name: service-registry-persistent-storage
              mountPath: /var/lib/eureka
          resources:
            requests:
              cpu: "100m"
              memory: "256Mi"
            limits:
              cpu: "500m"
              memory: "512Mi"

---
apiVersion: v1
kind: Service
metadata:
  namespace: rtb
  name: eureka-lb
  labels:
    app: eureka
spec:
  selector:
    app: eureka
  type: NodePort
  ports:
    - port: 80
      targetPort: 8761
      nodePort: 30087 # 可选固定端口

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