容器与云原生 / 系统课时
声明式管理资源
声明式管理资源
本课用一个可运行的 Deployment 完成创建、更新、验证和删除,帮助你把“提交期望状态”落实为可重复的资源管理流程。完成后,你将能通过同一份 YAML 持续维护资源,而不是依赖难以追踪的一串临时命令。
学习目标
- 解释声明式管理与命令式操作的核心差异。
- 使用
kubectl apply创建并更新资源。 - 通过状态查询验证收敛结果,并安全删除资源。
从期望状态理解声明式管理
命令式操作强调“现在执行什么动作”,例如直接要求创建一个副本;声明式管理强调“资源最终应该是什么样子”。你把期望状态写进清单,API Server 保存对象,控制器持续比较 spec 与实际状态,并不断修正差异,直到资源收敛。

声明式管理的价值不在于减少命令数量,而在于让期望状态可审查、可版本控制、可重复执行。同一份清单再次应用时,Kubernetes 只处理实际存在的差异;没有差异的字段保持不变。
编写并首次应用清单
先创建独立命名空间,再保存 Deployment 清单。示例使用两个 Nginx Pod,并通过稳定标签建立 Deployment 与 Pod 模板之间的对应关系。
apiVersion: apps/v1
kind: Deployment
metadata:
name: declarative-web
namespace: declarative-demo
labels:
app: declarative-web
spec:
replicas: 2
# 选择器必须与 Pod 模板标签完全一致
selector:
matchLabels:
app: declarative-web
template:
metadata:
labels:
app: declarative-web
spec:
containers:
- name: nginx
# 固定镜像标签,避免 latest 造成不可追踪变化
image: nginx:1.27-alpine
ports:
- name: http
containerPort: 80将文件保存为 declarative-web.yaml,在能够访问测试集群的终端中执行以下命令。示例假设命名空间尚不存在。
set -euo pipefail
# 创建隔离环境并提交期望状态
kubectl create namespace declarative-demo
kubectl apply -f declarative-web.yaml
# 等待滚动发布完成,再读取期望与就绪副本数
kubectl rollout status deployment/declarative-web -n declarative-demo --timeout=120s
kubectl get deployment declarative-web -n declarative-demo -o jsonpath='{.spec.replicas}{" "}{.status.readyReplicas}{"\n"}'预期输出如下。拉取镜像期间,rollout status 可能先打印等待信息,但成功时会出现相同的结束行。
namespace/declarative-demo created
deployment.apps/declarative-web created
deployment "declarative-web" successfully rolled out
2 2最后一行左侧是期望副本数,右侧是已就绪副本数。两者相等,说明控制器已经把实际状态收敛到清单声明的状态。
修改清单并更新资源
把清单中的 replicas: 2 改为 replicas: 3,保存后再次应用同一文件。不要另外执行 kubectl scale,否则期望状态会分散在文件与命令历史中。
set -euo pipefail
# 修改 replicas 后仍由同一份清单提交变更
kubectl apply -f declarative-web.yaml
kubectl rollout status deployment/declarative-web -n declarative-demo --timeout=120s
kubectl get deployment declarative-web -n declarative-demo -o jsonpath='{.spec.replicas}{" "}{.status.readyReplicas}{"\n"}'预期输出如下。
deployment.apps/declarative-web configured
deployment "declarative-web" successfully rolled out
3 3configured 表示已存在对象发生了有效变更。若输出 unchanged,说明集群中的相关字段已与清单一致,不需要重新创建资源。
删除资源并处理典型失败
资源不再需要时,应依据清单删除工作负载,再清理测试命名空间。这样能保持创建来源与删除范围一致。
set -euo pipefail
# 先删除清单内资源,再删除练习命名空间
kubectl delete -f declarative-web.yaml
kubectl delete namespace declarative-demo预期输出如下。
deployment.apps "declarative-web" deleted
namespace "declarative-demo" deleted遇到 connection refused 时,先检查当前 context 与集群连通性;遇到 forbidden 时,检查账号是否具有目标命名空间的写权限;Pod 长时间未就绪时,使用 kubectl describe pod -n declarative-demo <POD_NAME> 查看事件,其中 <POD_NAME> 为实际 Pod 名称。
Deployment 的
spec.selector通常不能在创建后修改。应在首次提交前确认它与template.metadata.labels完全匹配,否则更新会被拒绝或控制器无法正确管理 Pod。