Skip to content

StatefulSet

一句话解释

StatefulSet 管理有状态应用 — 每个 pod 有稳定身份和持久存储。用于数据库、队列等有状态工作负载。

用大白话说

StatefulSet 是 Kubernetes 中管理有状态应用的资源。不同于 Deployment(将 pod 视为可互换),StatefulSet 给每个 pod 稳定的持久身份。与 Deployment 的关键区别:1. 稳定身份 — pod 名为 app-0、app-1、app-2(非随机名)

  1. 稳定存储 — 每个 pod 有自己的持久卷,重启后保留
  2. 有序部署 — pod 按顺序创建(0、1、2)并逆序终止
  3. 稳定网络 — 每个 pod 有稳定 DNS 名(app-0.my-service)

何时用 StatefulSet:1. 数据库 — 每个实例有自己的数据(MySQL 主从、Cassandra 节点)

  1. 消息队列 — 每个 broker 有自己的队列状态(Kafka、RabbitMQ)
  2. 分布式系统 — 节点需要稳定身份(Elasticsearch、ZooKeeper)
  3. 遗留应用 — 期望稳定主机名或 IP 的应用何时不用 StatefulSet:
  • 无状态 Web 应用 — 用 Deployment
  • 不需要持久存储的应用 — 用 Deployment
  • pod 真正可互换 — 用 Deployment

StatefulSet 比 Deployment 更难管理 — 扩展更慢、更新更复杂。只在需要稳定身份或存储时使用。

示例

yaml
# StatefulSet — 3 节点 PostgreSQL 集群
apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: postgres
spec:
  serviceName: postgres  # headless service 用于稳定 DNS
  replicas: 3
  selector:
    matchLabels:
      app: postgres
  template:
    metadata:
      labels:
        app: postgres
    spec:
      containers:
        - name: postgres
          image: postgres:15
          ports:
            - containerPort: 5432
          volumeMounts:
            - name: data
              mountPath: /var/lib/postgresql/data
  volumeClaimTemplates:  # 每个 pod 有自己的 PVC
    - metadata:
        name: data
      spec:
        accessModes: ["ReadWriteOnce"]
        resources:
          requests:
            storage: 10Gi

# Pod 按顺序创建:# postgres-0 → 稳定 DNS: postgres-0.postgres
# postgres-1 → 稳定 DNS: postgres-1.postgres
# postgres-2 → 稳定 DNS: postgres-2.postgres
# 每个有自己的 10Gi 持久卷,重启后保留。

StatefulSet 创建 3 个 PostgreSQL pod,有稳定名(postgres-0、-1、-2),每个有自己的 10Gi 持久卷。Pod 按顺序创建,有稳定 DNS 名用于集群通信。

工作原理

  1. StatefulSet 按顺序创建 pod:pod-0,然后 pod-1,然后 pod-2。2. 每个 pod 获得稳定名和 DNS:pod-0.service.namespace.svc.cluster.local。3. 每个 pod 获得自己的持久卷(来自 volumeClaimTemplates)。4. 如果 pod-1 死亡,以 pod-1 重建并使用相同卷(数据保留)。5. 扩展创建 pod-3(下一个)。缩容移除 pod-2(最高优先)。6. 更新有序 — 先更新 pod-0,然后 pod-1,然后 pod-2。

常见混淆

  • 容易混淆的对象: Deployment

    关键区别: Deployment 用于无状态应用 — pod 可互换、随机名、共享存储。StatefulSet 用于有状态应用 — pod 有稳定身份、唯一存储、有序操作。Web 服务器用 Deployment(无状态);数据库用 StatefulSet(有状态)。pod 可互换用 Deployment;需要身份用 StatefulSet。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表