website/content/zh/docs/tasks/run-application/scale-stateful-set.md

approvers, title, content_template

approvers	title	content_template
bprashanth enisoc erictune foxish janetkuo kow3ns smarterclayton	弹缩StatefulSet	templates/task

{{% capture overview %}} 本文介绍如何弹缩StatefulSet. {{% /capture %}}

{{% capture prerequisites %}}

• StatefulSets仅适用于Kubernetes1.5及以上版本.
• 不是所有Stateful应用都适合弹缩. 在弹缩前您的应用前. 您必须充分了解您的应用, 不适当的弹缩StatefulSet或许会造成应用自身功能的不稳定.
• 仅当您确定该Stateful应用的集群是完全健康才可执行弹缩操作.

{{% /capture %}}

{{% capture steps %}}

使用 kubectl 弹缩StatefulSets

弹缩请确认 kubectl 已经升级到Kubernetes1.5及以上版本. 如果不确定, 执行 kubectl version 命令并检查使用的 Client Version.

kubectl 弹缩

首先, 找到您想要弹缩的StatefulSet. 记住, 您需先清楚是否能弹缩该应用.

kubectl get statefulsets <stateful-set-name>

改变StatefulSet副本数量:

kubectl scale statefulsets <stateful-set-name> --replicas=<new-replicas>

可使用其他命令: kubectl apply / kubectl edit / kubectl patch

另外, 您可以 in-place updates StatefulSets.

如果您的StatefulSet开始由 kubectl apply 或 kubectl create --save-config 创建,更新StatefulSet manifests中的 .spec.replicas, 然后执行命令 kubectl apply:

kubectl apply -f <stateful-set-file-updated>

除此之外, 可以通过命令 kubectl edit 编辑该字段:

kubectl edit statefulsets <stateful-set-name>

或使用 kubectl patch:

kubectl patch statefulsets <stateful-set-name> -p '{"spec":{"replicas":<new-replicas>}}'

排查故障

缩容工作不正常

当Stateful管理下的任何一个Pod不健康时您不能缩容该StatefulSet. 仅当Stateful下的所有Pods都处于运行和ready状态后才可缩容.

当一个StatefulSet的size > 1, 如果有一个Pod不健康, 没有办法让Kubernetes知道是否是由于永久性故障还是瞬态(升级/维护/节点重启)导致. 如果该Pod不健康是由于永久性 故障导致, 则在不纠正该故障的情况下进行缩容可能会导致一种状态， 即StatefulSet下的Pod数量低于应正常运行的副本数. 这也许会导致StatefulSet不可用.

如果由于瞬态故障而导致Pod不健康,并且Pod可能再次可用，那么瞬态错误可能会干扰您对 StatefulSet的扩容/缩容操作. 一些分布式数据库在节点加入和同时离开时存在问题. 在 这些情况下，最好是在应用级别进行弹缩操作, 并且只有在您确保Stateful应用的集群是完全健康时才执行弹缩.

{{% /capture %}}

{{% capture whatsnext %}}

了解更多 deleting a StatefulSet.

{{% /capture %}}