当前位置：首页 > news >正文

k8s概念-StatefulSet

news 2026/2/9 16:14:37

StatefulSet 是用来管理有状态应用的控制器

StatefulSet 用来管理某Pod集合的部署和扩缩，并为这些 Pod 提供持久存储和持久标识符
StatefulSet | KubernetesStatefulSet 运行一组 Pod，并为每个 Pod 保留一个稳定的标识。这可用于管理需要持久化存储或稳定、唯一网络标识的应用。https://kubernetes.io/zh/docs/concepts/workloads/controllers/statefulset/

yaml文件

StatefulSet 基础 | Kubernetes本教程介绍了如何使用 StatefulSet 来管理应用。演示了如何创建、删除、扩容/缩容和更新 StatefulSet 的 Pod。准备开始在开始本教程之前，你应该熟悉以下 Kubernetes 的概念：Pod Cluster DNS Headless Service PersistentVolumes PersistentVolume Provisioning StatefulSet kubectl 命令行工具说明：本教程假设你的集群被配置为动态制备 PersistentVolume 卷。如果没有这样配置，在开始本教程之前，你需要手动准备 2 个 1 GiB 的存储卷。教程目标 StatefulSet 旨在与有状态的应用及分布式系统一起使用。然而在 Kubernetes 上管理有状态应用和分布式系统是一个宽泛而复杂的话题。为了演示 StatefulSet 的基本特性，并且不使前后的主题混淆，你将会使用 StatefulSet 部署一个简单的 Web 应用。在阅读本教程后，你将熟悉以下内容：如何创建 StatefulSet StatefulSet 怎样管理它的 Pod 如何删除 StatefulSet 如何对 StatefulSet 进行扩容/缩容如何更新一个 StatefulSet 的 Pod 创建 StatefulSet 作为开始，使用如下示例创建一个 StatefulSet。它和 StatefulSet 概念中的示例相似。它创建了一个 Headless Service nginx 用来发布 StatefulSet web 中的 Pod 的 IP 地址。https://kubernetes.io/zh/docs/tutorials/stateful-application/basic-stateful-set/

#statefulset部分
apiVersion: apps/v1
kind: StatefulSet
metadata:name: web											# statefulset的名称
spec:serviceName: "nginx"replicas: 3										# 3个副本updateStrategy:								#更新策略type: RollingUpdate					#滚动更新rollingUpdate:							#滚动更新分区数partition: 3selector:matchLabels:						#匹配pod标签为app=nginxapp: nginxtemplate:									#pod模板metadata:labels:app: nginx					#标签为app=nginx，statefulset和上面service标签选择器与之对应spec:containers:- name: nginximage: nginx:1.15-alpineports:- containerPort: 80name: webvolumeMounts:		#存储卷定义- name: www			#存储卷名称mountPath: /usr/share/nginx/html #位置volumeClaimTemplates:  #存储卷- metadata:name: www      #上面valumemounts须相同spec:accessModes: [ "ReadWriteOnce" ]  #读写权限storageClassName: "nfs-client"		# 与前面定义的storageclass名称对应resources:requests:storage: 1Gi

查看

kubectl get statefulset

或者简写 kubectl get sts

[root@k8s-master ~]# kubectl get sts -n nacos
NAME    READY   AGE
nacos   1/1     20d

扩容缩容

# 扩容缩容，指定副本数大则扩容，小则缩容
kubectl scale statefulset web --replicas=5# 扩容缩容
kubectl patch statefulset web -p '{"spec":{"replicas":3}}'

当然，修改yaml文件中的replicas后再执行kubectl apply -f yaml-name也可以

删除

级联删除

# 级联删除：删除 statefulset 时会同时删除 pods
kubectl delete statefulset web

非级联删除 --cascade=false

# 非级联删除：删除 statefulset 时不会删除 pods，删除 sts 后，pods 就没人管了，此时再删除 pod 不会重建的
#1.删除statefulset
kubectl deelte sts web --cascade=false
#2.删除service
kubectl delete service nginx
#3.删除pod
kubectl delete pod nginx

删除pvc

# StatefulSet删除后PVC还会保留着，数据不再使用的话也需要删除
$ kubectl delete pvc www-web-0 www-web-1

镜像更新

两个方式

RollingUpdate

滚动更新，同样是修改 pod template 属性后会触发更新，但是由于 pod 是有序的，在 StatefulSet 中更新时是基于 pod 的顺序倒序更新的

利用滚动更新中的 partition 属性，可以实现简易的灰度发布的效果

参考：StatefulSet | Kubernetes
onDelete

当pod被删除后更新

更新镜像版本

kubectl set image sts/web nginx=nginx:latest

灰度发布

例如我们有 5 个 pod，如果当前 partition 设置为 3，那么此时滚动更新时，只会更新那些序号 >= 3 的 pod

利用该机制，我们可以通过控制 partition 的值，来决定只更新其中一部分 pod，确认没有问题后再主键增大更新的 pod 数量，最终实现全部 pod 更新