容器与云原生 / 系统课时

声明式管理资源

声明式管理资源

本课用一个可运行的 Deployment 完成创建、更新、验证和删除,帮助你把“提交期望状态”落实为可重复的资源管理流程。完成后,你将能通过同一份 YAML 持续维护资源,而不是依赖难以追踪的一串临时命令。

学习目标

  • 解释声明式管理与命令式操作的核心差异。
  • 使用 kubectl apply 创建并更新资源。
  • 通过状态查询验证收敛结果,并安全删除资源。

从期望状态理解声明式管理

命令式操作强调“现在执行什么动作”,例如直接要求创建一个副本;声明式管理强调“资源最终应该是什么样子”。你把期望状态写进清单,API Server 保存对象,控制器持续比较 spec 与实际状态,并不断修正差异,直到资源收敛。

Kubernetes 声明式资源管理闭环

声明式管理的价值不在于减少命令数量,而在于让期望状态可审查、可版本控制、可重复执行。同一份清单再次应用时,Kubernetes 只处理实际存在的差异;没有差异的字段保持不变。

编写并首次应用清单

先创建独立命名空间,再保存 Deployment 清单。示例使用两个 Nginx Pod,并通过稳定标签建立 Deployment 与 Pod 模板之间的对应关系。

yaml
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,在能够访问测试集群的终端中执行以下命令。示例假设命名空间尚不存在。

bash
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 可能先打印等待信息,但成功时会出现相同的结束行。

text
namespace/declarative-demo created
deployment.apps/declarative-web created
deployment "declarative-web" successfully rolled out
2 2

最后一行左侧是期望副本数,右侧是已就绪副本数。两者相等,说明控制器已经把实际状态收敛到清单声明的状态。

修改清单并更新资源

把清单中的 replicas: 2 改为 replicas: 3,保存后再次应用同一文件。不要另外执行 kubectl scale,否则期望状态会分散在文件与命令历史中。

bash
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"}'

预期输出如下。

text
deployment.apps/declarative-web configured
deployment "declarative-web" successfully rolled out
3 3

configured 表示已存在对象发生了有效变更。若输出 unchanged,说明集群中的相关字段已与清单一致,不需要重新创建资源。

删除资源并处理典型失败

资源不再需要时,应依据清单删除工作负载,再清理测试命名空间。这样能保持创建来源与删除范围一致。

bash
set -euo pipefail
# 先删除清单内资源,再删除练习命名空间
kubectl delete -f declarative-web.yaml
kubectl delete namespace declarative-demo

预期输出如下。

text
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。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

声明式管理资源

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通