简介
StatefulSet 主要用于管理有状态的应用,创建的 Pod 拥有根据规范创建的持久型标识符。Pod 迁移或销毁重启后,标识符仍会保留。 在需要持久化存储时,您可以通过标识符对存储卷进行一一对应。如果应用程序不需要持久的标识符,建议您使用 Deployment 部署应用程序。
StatefulSet 控制台操作指引
创建 StatefulSet
- 登录容器服务控制台 ,选择左侧导航栏中的 集群。
- 单击需要创建 StatefulSet 的集群 ID,进入待创建 StatefulSet 的集群管理页面。
- 选择工作负载 > StatefulSet,进入 StatefulSet 管理页面。如下图所示:
- 单击新建,进入 “新建Workload” 页面。
根据实际需求,设置 StatefulSet 参数。关键参数信息如下:- 工作负载名:输入自定义名称。
- 标签:一个键 - 值对(Key-Value),用于对资源进行分类管理。
- 命名空间:根据实际需求进行选择。
- 类型:选择StatefulSet(有状态集的运行Pod)。
- 数据卷(选填):为容器提供存储,目前支持临时路径、主机路径、云硬盘数据卷、文件存储 NFS、配置文件、PVC,还需挂载到容器的指定路径中。
- 实例内容器:根据实际需求,为 StatefulSet 的一个 Pod 设置一个或多个不同的容器。
- 名称:自定义。
- 镜像:根据实际需求进行选择。
- 镜像版本(Tag):根据实际需求进行填写。
- 镜像拉取策略:提供以下3种策略,请按需选择。
若不设置镜像拉取策略,当镜像版本为空或latest
时,使用 Always 策略,否则使用 IfNotPresent 策略。- Always:总是从远程拉取该镜像。
- IfNotPresent:默认使用本地镜像,若本地无该镜像则远程拉取该镜像。
- Never:只使用本地镜像,若本地没有该镜像将报异常。
- CPU/内存限制:可根据 Kubernetes 资源限制 进行设置 CPU 和内存的限制范围,提高业务的健壮性。
- GPU 资源:配置该工作负载使用的最少 GPU 资源。
- 高级设置:可设置 “工作目录”、“运行命令”、“运行参数”、“容器健康检查”和“特权级”等参数。
- 镜像访问凭证:容器镜像默认私有,在创建工作负载时,需选择实例对应的镜像访问凭证。
- 实例数量:根据实际需求选择调节方式,设置实例数量。
- 节点调度策略:可根据调度规则,将 Pod 调度到符合预期的 Label 的节点中。
- 访问设置:根据实际需求,设置 Service 参数。详情见 服务访问方式。
- 单击创建Workload,完成创建。
更新 StatefulSet
更新 YAML
- 登录容器服务控制台 ,选择左侧导航栏中的 集群。
- 单击需要更新 YAML 的集群 ID,进入待更新 YAML 的集群管理页面。
- 选择工作负载 > StatefulSet,进入 StatefulSet 信息页面。如下图所示:
- 在需要更新 YAML 的 StatefulSet 行中,选择更多 > 编辑YAML,进入更新 StatefulSet 页面。
- 在 “更新StatefulSet” 页面编辑 YAML,并单击完成即可更新 YAML。
更新 Pod 配置
- 在集群管理页面,单击需要更新 Pod 配置的 StatefulSet 的集群 ID,进入待更新 Pod 配置的 StatefulSet 的集群管理页面。
- 在需要更新 Pod 配置的 StatefulSet 行中,单击更新Pod配置。如下图所示:
- 在 “更新Pod配置” 页面,根据实际需求修改更新方式,设置参数。如下图所示:
- 单击完成,即可更新 Pod 配置。
Kubectl 操作 StatefulSet 指引
YAML 示例
apiVersion: v1
kind: Service ## 创建一个 Headless Service,用于控制网络域
metadata:
name: nginx
namespace: default
labels:
app: nginx
spec:
ports:
- port: 80
name: web
clusterIP: None
selector:
app: nginx
---
apiVersion: apps/v1
kind: StatefulSet ### 创建一个 Nginx的StatefulSet
metadata:
name: web
namespace: default
spec:
selector:
matchLabels:
app: nginx
serviceName: "nginx"
replicas: 3 # by default is 1
template:
metadata:
labels:
app: nginx
spec:
terminationGracePeriodSeconds: 10
containers:
- name: nginx
image: nginx:latest
ports:
- containerPort: 80
name: web
volumeMounts:
- name: www
mountPath: /usr/share/nginx/html
volumeClaimTemplates:
- metadata:
name: www
spec:
accessModes: [ "ReadWriteOnce" ]
storageClassName: "cbs"
resources:
requests:
storage: 10Gi
- kind:标识 StatefulSet 资源类型。
- metadata:StatefulSet 的名称、Label等基本信息。
- metadata.annotations:对 StatefulSet 的额外说明,可通过该参数设置腾讯云 TKE 的额外增强能力。
- spec.template:StatefulSet 管理的 Pod 的详细模板配置。
- spec.volumeClaimTemplates:提供创建 PVC&PV 的模板。
更多参数详情可查看 Kubernetes StatefulSet 官方文档。
创建 StatefulSet
- 参考 YAML 示例,准备 StatefulSet YAML 文件。
- 安装 Kubectl,并连接集群。操作详情请参考 通过 Kubectl 连接集群。
- 执行以下命令,创建 StatefulSet YAML 文件。
例如,创建一个文件名为 web.yaml 的 StatefulSet YAML 文件,则执行以下命令:kubectl create -f StatefulSet YAML 文件名称
kubectl create -f web.yaml
- 执行以下命令,验证创建是否成功。
返回类似以下信息,即表示创建成功。kubectl get StatefulSet
NAME DESIRED CURRENT AGE test 1 1 10s
更新 StatefulSet
执行以下命令,查看 StatefulSet 的更新策略类型。
kubectl get ds/<daemonset-name> -o go-template='{{.spec.updateStrategy.type}}{{"\n"}}'
StatefulSet 有以下两种更新策略类型:
- OnDelete:默认更新策略。该更新策略在更新 StatefulSet 后,需手动删除旧的 StatefulSet Pod 才会创建新的 StatefulSet Pod。
- RollingUpdate:支持 Kubernetes 1.7或更高版本。该更新策略在更新 StatefulSet 模板后,旧的 StatefulSet Pod 将被终止,并且以滚动更新方式创建新的 StatefulSet Pod(Kubernetes 1.7或更高版本)。
方法一
执行以下命令,更新 StatefulSet。
kubectl edit StatefulSet/[name]
此方法适用于简单的调试验证,不建议在生产环境中直接使用。您可以通过此方法更新任意的 StatefulSet 参数。
方法二
执行以下命令,更新指定容器的镜像。
kubectl patch statefulset <NAME> --type='json' -p='[{"op": "replace", "path": "/spec/template/spec/containers/0/image", "value":"<newImage>"}]'
建议保持 StatefulSet 的其他参数不变,业务更新时,仅更新容器镜像。
如果更新的 StatefulSet 是滚动更新方式的策略,可执行以下命令查看更新状态:
kubectl rollout status sts/<StatefulSet-name>
删除 StatefulSet
执行以下命令,删除 StatefulSet。
kubectl delete StatefulSet [NAME] --cascade=false
--cascade=false 参数表示 Kubernetes 仅删除 StatefulSet,且不删除任何 Pod。如需删除 Pod,则执行以下命令:kubectl delete StatefulSet [NAME]
更多 StatefulSet 相关操作可查看 Kubernetes官方指引。