有奖捉虫:云通信与企业服务文档专题,速来> HOT

简介

StatefulSet 主要用于管理有状态的应用,可以创建具有持久性标识符的 Pod。Pod 迁移或销毁重启后,标识符仍会保留。在需要持久化存储时,您可以通过标识符对存储卷进行一一对应。如果应用程序不需要持久的标识符,建议您使用 Deployment 部署应用程序。

StatefulSet 控制台操作指引

创建 StatefulSet

1. 登录容器服务控制台,选择左侧导航栏中的 集群
2. 单击需要创建 StatefulSet 的集群 ID,进入待创建 StatefulSet 的集群管理页面。
3. 选择工作负载 > StatefulSet,进入 StatefulSet 管理页面。如下图所示:


4. 单击新建,进入 “新建Workload” 页面。 根据实际需求,设置 StatefulSet 参数。关键参数信息如下:
工作负载名:输入自定义名称。
Labels:一个键 - 值对(Key-Value),用于对资源进行分类管理。
命名空间:根据实际需求进行选择。
类型:选择StatefulSet(有状态集的运行Pod)
数据卷(选填):为容器提供存储,目前支持临时路径、主机路径、云硬盘数据卷、文件存储 NFS、配置文件、PVC,还需挂载到容器的指定路径中。
实例内容器:根据实际需求,为 StatefulSet 的一个 Pod 设置一个或多个不同的容器。
名称:自定义。
镜像:根据实际需求进行选择。
镜像版本(Tag):根据实际需求进行填写。
镜像拉取策略:提供以下3种策略,请按需选择。 若不设置镜像拉取策略,当镜像版本为空或 latest 时,使用 Always 策略,否则使用 IfNotPresent 策略。
Always:总是从远程拉取该镜像。
IfNotPresent:默认使用本地镜像,若本地无该镜像则远程拉取该镜像。
Never:只使用本地镜像,若本地没有该镜像将报异常。
CPU/内存限制:可根据 Kubernetes 资源限制 进行设置 CPU 和内存的限制范围,提高业务的健壮性。
GPU 资源:配置该工作负载使用的最少 GPU 资源。
高级设置:可设置 “工作目录”、“运行命令”、“运行参数”、“容器健康检查”和“特权级”等参数。
镜像访问凭证:容器镜像默认私有,在创建工作负载时,需选择实例对应的镜像访问凭证。
实例数量:根据实际需求选择调节方式,设置实例数量。
节点调度策略:可根据调度规则,将 Pod 调度到符合预期的 Label 的节点中。
访问设置:根据实际需求,设置 Service 参数。详情见 服务访问方式
5. 单击创建Workload,完成创建。

更新 StatefulSet

更新 YAML

1. 登录容器服务控制台,选择左侧导航栏中的 集群
2. 单击需要更新 YAML 的集群 ID,进入待更新 YAML 的集群管理页面。
3. 选择工作负载 > StatefulSet,进入 StatefulSet 信息页面。如下图所示:


4. 在需要更新 YAML 的 StatefulSet 行中,选择更多 > 编辑YAML,进入更新 StatefulSet 页面。
5. 在 “更新StatefulSet” 页面编辑 YAML,并单击完成即可更新 YAML。

更新 Pod 配置

1. 在集群管理页面,单击需要更新 Pod 配置的 StatefulSet 的集群 ID,进入待更新 Pod 配置的 StatefulSet 的集群管理页面。
2. 在需要更新 Pod 配置的 StatefulSet 行中,单击更新Pod配置。如下图所示:


3. 在 “更新Pod配置” 页面,根据实际需求修改更新方式,设置参数。如下图所示:


4. 单击完成,即可更新 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

1. 参考 YAML 示例,准备 StatefulSet YAML 文件。
2. 安装 Kubectl,并连接集群。操作详情请参考 通过 Kubectl 连接集群
3. 执行以下命令,创建 StatefulSet YAML 文件。
kubectl create -f StatefulSet YAML 文件名称
例如,创建一个文件名为 web.yaml 的 StatefulSet YAML 文件,则执行以下命令:
kubectl create -f web.yaml
4. 执行以下命令,验证创建是否成功。
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官方指引