Kubernetes 对象详解：声明式管理的核心

📌 前言

Kubernetes 对象是 K8s 系统中的持久实体 ，也是理解 Kubernetes 声明式管理模式的关键入口。

本文将带你全面了解：

✅ 什么是 K8s 对象
✅ 对象的两个核心字段：Spec 与 Status
✅ 如何用 YAML 描述对象
✅ 必填字段与操作方式

一、什么是 Kubernetes 对象？

📖 定义

Kubernetes 对象是系统中的持久实体 ，本质是一个 "Record of Intent"（意图记录）。

你告诉 K8s "我想要什么"，K8s 负责让它变成现实。

📦 对象可以描述的内容

类别	具体内容
应用运行状态	哪些容器化应用在运行、在哪些节点上
资源	应用可用的 CPU、内存等资源
策略	重启策略、升级策略、容错策略

💡 核心承诺

一旦创建对象，Kubernetes 会持续确保对象的期望状态存在。

二、核心机制：Spec 与 Status

每个 Kubernetes 对象都包含两个关键嵌套字段：

字段	含义	由谁定义/更新
Spec	期望状态（Desired State）	用户创建时定义
Status	实际状态（Actual State）	K8s 系统提供并持续更新

🔄 工作流程示例（Deployment）

假设你要运行一个应用，要求 3 个副本 ：

用户创建 Deployment，在 spec 中定义：replicas: 3

↓

K8s 系统读取 spec，启动 3 个实例 → 更新 status 为 3

↓

如果某个实例失败（status 变为 2）

↓

系统检测到 spec 与 status 的差异

↓

系统自动启动一个新实例，使 status 重新匹配 spec

text

这就是 Kubernetes 声明式（Declarative） 工作机制的核心：你只管声明"要什么"，系统负责"怎么达成"。

三、如何操作 Kubernetes 对象？

🔧 操作方式

方式	说明
kubectl CLI	命令行工具，底层调用 Kubernetes API
直接调用 API	可编程调用，官方提供 Golang 客户端库

💻 常用命令

bash 复制代码

# 创建对象
kubectl create -f nginx-deployment.yaml --record

# 查看对象
kubectl get deployments
kubectl get pods

# 查看对象详情
kubectl describe deployment nginx-deployment

# 删除对象
kubectl delete -f nginx-deployment.yaml
四、YAML 文件示例
📄 nginx-deployment.yaml
yaml
apiVersion: apps/v1beta1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  replicas: 3
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.7.9
        ports:
        - containerPort: 80
        -

📋 字段解析

字段值说明

apiVersion apps/v1beta1 使用 apps 组的 v1beta1 版本

kind Deployment 对象类型为 Deployment

metadata.name nginx-deployment 对象名称

spec.replicas 3 期望 3 个副本

spec.template Pod 模板定义要创建的 Pod 规格

containers.image nginx:1.7.9 使用 nginx 1.7.9 镜像

🚀 创建命令及输出

bash

$ kubectl create -f nginx-deployment.yaml --record

deployment "nginx-deployment" created

五、YAML 必填字段

每个 Kubernetes 对象的 YAML 文件必须包含以下字段：

字段说明示例

apiVersion 创建对象使用的 Kubernetes API 版本 apps/v1beta1

kind 对象的类型 Deployment、Pod、Service

metadata 唯一标识对象的数据 name: nginx-deployment

spec 对象的期望状态格式 replicas: 3

📌 注意事项

metadata 中 name 是必填，namespace 可选（默认 default）

每种对象类型的 spec 格式不同，需查阅 Kubernetes API Reference

六、总结

📊 核心概念回顾

概念要点

对象是什么持久实体，描述集群期望状态

本质 Record of Intent（意图记录）

Spec 期望状态（用户定义）

Status 实际状态（系统更新）

工作机制声明式：系统持续使 Status 匹配 Spec

操作方式 YAML 文件 + kubectl（或直接调用 API）

必填字段 apiVersion、kind、metadata、spec

🎯 一句话记忆

Kubernetes 对象 = 用户用 YAML 声明 Spec（想要什么），K8s 系统持续维持 Status（实际是什么）与 Spec 一致。

七、速记口诀

text

对象是意图记录，Spec 想要 Status 报

YAML 必备四件套：apiVersion、kind、metadata、spec 不能少

kubectl create -f 创建，系统自动帮你调

八、下一步学习建议

📖 学习常用对象类型：Pod、Deployment、Service、ConfigMap、Secret

✍️ 实践编写 YAML 文件，用 kubectl apply -f 创建对象

🔍 熟悉 kubectl get、kubectl describe、kubectl edit 等命令

📚 查阅 Kubernetes API Reference 了解各对象的 spec 格式

📚 参考资料

Kubernetes 官方文档 - Understanding Kubernetes Objects

Kubernetes API Conventions