搜索结果: "statefulset"

title: StatefulSet 完全指南 — 稳定网络标识 / 独立存储 / 有序部署

tags: [kubernetes, statefulset, deployment, storage, networking, production]

sources: [raw/articles/k8s-statefulset-guide.md]

# StatefulSet 完全指南

> StatefulSet 是 Kubernetes 专门管理"有状态服务"的控制器。

tags: [kubernetes, database, deployment, production, architecture, mysql, statefulset]

| 通用避雷 | ❗ 禁止 | 不要只用 StatefulSet + 普通 PVC 硬扛生产数据库 |

| 全容器化应用 / 已有 K8s 平台 | ✅ 可评估 — 使用成熟 Operator，非裸写 StatefulSet |

只靠 StatefulSet 部署，只是把数据库"装进了容器"，没有解决任何有状态难题。

- [[k8s-statefulset-guide]] — StatefulSet 是数据库上 K8s 的基础，但单独用 StatefulSet 不够（需 Operator）

用户请求 → Gateway (HTTPRoute) → 各 Jenkins Master (StatefulSet)

每个 Jenkins Master 部署为一个独立的 StatefulSet，包含：

### 4.1 StatefulSet 定义

使用 StatefulSet 而非 Deployment，因为 Jenkins 需要**稳定的网络标识**和**独立的持久化存储**：

kind: StatefulSet

tags: [kubernetes, architecture, deployment, pod, service, statefulset, networking, storage]

### StatefulSet — 有状态应用

| 特性 | Deployment | StatefulSet |

详见 [[k8s-statefulset-guide]]（StatefulSet 完全指南）。

<statefulset-pod>...svc.cluster.local # StatefulSet 稳定 DNS

### 法则 15：StatefulSet 的稳定标识是优点，也是恢复时最易踩的坑

StatefulSet 保证固定 Pod 名称和稳定存储绑定，意味着 **删 Pod 不等于换数据**。真实误判：mysql-0 所挂 PVC 数据损坏 → 运维删除 mysql-0 → 新 Pod 起来继续挂同一个坏卷 → 故障毫无改善。因为设计核心就是「身份稳定」（名称 + 卷绑定关系），不能用无状态「删掉重建」思路。

恢复必须回到数据层面：通过快照恢复 PVC；或在明确风险后调整 StatefulSet 管理方式。工程习惯：先确认故障发生在「Pod」还是「数据」；对 StatefulSet 维护明确备份/恢复/演练流程；不把「重建 Pod」当状态服务的默认修复动作。

详见 [[k8s-statefulset-guide]]。

**状态服务异常：** 问题在 Pod、PVC、CSI 还是底层存储拓扑？StatefulSet 对应数据是否有备份和恢复路径？是否误把「删 Pod」当作状态数据恢复手段？

## [2026-05-11] ingest | Kubernetes 面试必问：StatefulSet

- Created raw: raw/articles/k8s-statefulset-guide.md

- Created concepts: k8s-statefulset-guide

- 交叉引用：k8s-statefulset-guide, k8s-persistent-storage-guide, k8s-probes-guide 等

- Updated: k8s-statefulset-guide（StatefulSet vs Deployment 滚动更新对比）

| 11 | StatefulSet vs Deployment？ | StatefulSet 管理有状态应用，Pod 有固定身份；Deployment 管理无状态应用 | [[k8s-statefulset-guide]] |

| 54 | 有状态应用部署？ | StatefulSet + Headless Service + PVC | [[k8s-statefulset-guide]] |

| 70 | 高可用数据库？ | StatefulSet + 数据库集群（主从/副本集）+ Operator | [[database-on-kubernetes-debate]] |

| [[k8s-statefulset-guide]] | StatefulSet 完全指南 |

3. **根因：** StatefulSet 的 `serviceName` 和 Headless Service 名称**不一致**

**修复：** StatefulSet 的 `serviceName` 必须和 Headless Service 名称完全一致，否则 Pod 的 DNS 记录不会生成。

# 检查 StatefulSet 的 serviceName

kubectl get statefulset mysql -n database \

tags: [kubernetes, storage, pvc, statefulset, production]

| [[node-troubleshooting]] | Node 排障与 k8s-statefulset-guide 的 Pod 行为交叉 |

| [[jenkins-multi-master-k8s-deployment]] | Jenkins 多 Master 部署中的 StatefulSet + PVC 实际案例 |

| 32 | StatefulSet 和 DaemonSet？ | StatefulSet：有状态应用（稳定网络标识+持久存储）；DaemonSet：每个节点一个 Pod | [[k8s-statefulset-guide]] |

| [[k8s-statefulset-guide]] | StatefulSet 完全指南 |

流程：验证 SC 存在 → 找出 PVC → 创建新 PVC → 停 Pod → rsync 拷贝数据 → 切换 PVC → 恢复 Pod。仅支持 StatefulSet 和 Deployment，建议维护窗口操作。

- [[k8s-statefulset-guide]] — StatefulSet 完全指南

- [[jenkins-multi-master-k8s-deployment]] — Jenkins 多 Master 架构部署：K8S + Gateway API / StatefulSet / JCasC / 动态 Agent / VictoriaMetrics 监控

- [[k8s-statefulset-guide]] — StatefulSet 完全指南：稳定网络标识/独立存储/有序部署/数据库应用

- statefulset: 有状态应用

业务接入层 → Deployment / StatefulSet / Job / Argo Rollout

| [[k8s-statefulset-guide]] | StatefulSet 有序滚动更新策略对比 |

- [[k8s-statefulset-guide]] — StatefulSet 与有状态应用调度

📖 深度排查 → [[storage-troubleshooting]] | [[k8s-persistent-storage-guide]] | [[k8s-statefulset-guide]]

tags: [kubernetes, troubleshooting, storage, pvc, statefulset]