容器与云原生 / 系统课时
手动扩缩容
手动扩缩容
手动扩缩容用于在流量变化、演练或维护前直接修改工作负载的期望副本数。本课将分别用 kubectl scale 和资源清单调整 Deployment、StatefulSet,并验证控制器是否真正完成扩容或缩容。
学习目标
- 理解副本数变化如何驱动控制器创建或删除 Pod
- 使用命令快速调整 Deployment 与 StatefulSet 副本数
- 用资源清单固化目标副本数并排查扩缩容未完成的问题
先确认扩缩容对象
扩缩容应作用于 Deployment、StatefulSet 等控制器,而不是直接创建或删除受控 Pod。控制器持续比较 spec.replicas 与实际副本数,并执行收敛;手工删除某个 Pod 只会触发补建,不能长期减少副本。
先确认对象名称、命名空间和当前状态:
kubectl get deployment/web statefulset/db -n demo预期输出:
NAME READY UP-TO-DATE AVAILABLE AGE
deployment.apps/web 2/2 2 2 <TIME>
NAME READY AGE
statefulset.apps/db 2/2 <TIME><TIME> 会随资源创建时间变化。如果出现 NotFound,应先检查命名空间和对象名称,而不是直接执行扩缩容。
使用命令立即调整
kubectl scale 通过工作负载的 scale 子资源修改期望副本数。Deployment 通常可并行创建多个同构 Pod;StatefulSet 默认按序号管理 Pod,扩容从较小的新序号开始,缩容优先移除较大的序号,因此完成时间更依赖 Pod 的就绪状态。

将 Deployment 扩到 4 个副本、StatefulSet 扩到 3 个副本:
kubectl scale deployment/web --replicas=4 -n demo
kubectl scale statefulset/db --replicas=3 -n demo预期输出:
deployment.apps/web scaled
statefulset.apps/db scaled命令返回只表示 API 已接受新目标,不代表 Pod 已全部就绪。等待控制器完成并读取期望值、就绪值:
kubectl rollout status deployment/web -n demo --timeout=180s
kubectl rollout status statefulset/db -n demo --timeout=300s
kubectl get deployment/web -n demo -o jsonpath='desired={.spec.replicas} ready={.status.readyReplicas}{"\n"}'
kubectl get statefulset/db -n demo -o jsonpath='desired={.spec.replicas} ready={.status.readyReplicas}{"\n"}'预期输出:
deployment "web" successfully rolled out
statefulset rolling update complete 3 pods at revision <REVISION>
desired=4 ready=4
desired=3 ready=3<REVISION> 的实际值由 StatefulSet 控制器生成。若超时,说明期望副本已修改,但调度、镜像拉取、探针或应用启动仍未完成。
用资源清单固化目标
命令行修改的是集群中的现场状态。如果 GitOps、流水线或后续 kubectl apply 仍使用旧副本数,现场值可能被重新覆盖。长期配置应回写到版本库中的完整资源清单。
下面是需要修改的关键片段;它依赖原清单中已有的 selector、Pod 模板和 StatefulSet 的 serviceName,不能单独应用:
apiVersion: v1
kind: List
items:
- apiVersion: apps/v1
kind: Deployment
metadata:
name: web
namespace: demo
spec:
replicas: 4
- apiVersion: apps/v1
kind: StatefulSet
metadata:
name: db
namespace: demo
spec:
serviceName: db
replicas: 3保存完整清单后应用:
kubectl apply -f workloads.yaml预期输出:
deployment.apps/web configured
statefulset.apps/db configured如果对象内容未变化,输出可能是 unchanged。应用后仍应检查 spec.replicas 与 status.readyReplicas,不要只依赖命令返回。
缩容边界与失败处理
缩容会终止 Pod,应先确认 Service 能把流量移出未就绪实例,并为应用保留合理的优雅终止时间。StatefulSet 缩容还要检查有状态应用的主从关系、数据复制和 PVC 保留策略,不能把“删除最高序号 Pod”误认为“数据已经安全迁移”。
常见异常可按以下顺序判断:
- 期望值正确但 Pod 为
Pending:节点资源、亲和性、污点或存储条件不满足。 - Deployment 长时间未就绪:检查镜像、启动日志和 readinessProbe。
- StatefulSet 卡在某个序号:先修复前一个未 Ready 的 Pod,再等待顺序创建继续。
- 副本数很快被改回:检查 HPA、GitOps 控制器或流水线是否同时管理
spec.replicas。
需要与 HPA 配合时,不要把手动副本数当作长期策略;HPA 会继续根据指标写入同一个 scale 子资源。