产品动态
公告
产品发布记录
StatefulSet 管理
简介
StatefulSet 主要用于管理有状态的应用，可以创建具有持久性标识符的 Pod。Pod 迁移或销毁重启后，标识符仍会保留。在需要持久化存储时，您可以通过标识符对存储卷进行一一对应。如果应用程序不需要持久的标识符，建议您使用 Deployment 部署应用程序。
StatefulSet 控制台操作指引
创建 StatefulSet
1. 登录容器服务控制台，选择左侧导航栏中的 集群 。
2. 单击需要创建 StatefulSet 的集群 ID，进入待创建 StatefulSet 的集群管理页面。
3. 选择工作负载 > StatefulSet，进入 StatefulSet 管理页面。如下图所示：
4. 单击新建，进入新建 StatefulSet 页面。
根据实际需求，设置 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 参数。详情见 服务访问方式。
5. 单击创建 StatefulSet，完成创建。
更新 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: v1kind: Service ## 创建一个 Headless Service，用于控制网络域metadata:name: nginxnamespace: defaultlabels:app: nginxspec:ports:- port: 80name: webclusterIP: Noneselector:app: nginx---apiVersion: apps/v1kind: StatefulSet ### 创建一个 Nginx的StatefulSetmetadata:name: webnamespace: defaultspec:selector:matchLabels:app: nginxserviceName: "nginx"replicas: 3 # by default is 1template:metadata:labels:app: nginxspec:terminationGracePeriodSeconds: 10containers:- name: nginximage: nginx:latestports:- containerPort: 80name: webvolumeMounts:- name: wwwmountPath: /usr/share/nginx/htmlvolumeClaimTemplates:- metadata:name: wwwspec: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 的模板。
创建 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 AGEtest 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]
文档反馈