n3-Kubernets对象字段描述一览

[TOC]

0x00 前言简述

什么是Kubernetes对象? 答：Kubernetes对象指的是Kubernetes系统的持久化实体，所有这些对象合起来代表了你集群的实际情况。创建一个k8s对象就是告诉Kubernetes，您需要的集群中的工作负载是什么（集群的目标状态）, 因为一个Kubernetes对象代表着用户的一个意图（a record of intent），一旦您创建了一个Kubernetes对象，Kubernetes将持续工作以尽量实现此用户的意图。

常规的应用里我们把应用程序的数据存储在数据库中，Kubernetes将其数据以Kubernetes对象的形式通过 api server 存储在 etcd 中； Kubernetes对象数据描述的信息:

集群中运行了哪些容器化应用程序（以及在哪个节点上运行）
集群中对应用程序可用的资源
应用程序相关的策略定义，例如，重启策略、升级策略、容错策略
其他Kubernetes管理应用程序时所需要的信息

如何进行Kubernetes对象的CURD呢? 答:自带的kubectl命令或者一些管理k8s的图形化界面工具比如Kuboard或者Kubedash;

PS:kubectl、kuboard 最终都通过调用 kubernetes API 来实现对 Kubernetes 对象的操作。您也可以直接在自己的程序中调用 Kubernetes API，此时您可能要有用到 Client Libraries

0x01 对象字段

描述: 每个K8s控制器对象都包含了两个重要的字段，即 spec 和 status 字段, Kubernetes通过对应的控制器，不断地使实际状态趋向于您期望的目标状态。

spec 必须由您来提供，描述了您对该对象所期望的目标状态
status 只能由 Kubernetes 系统来修改，描述了该对象在 Kubernetes 系统中的 实际状态

例如,一个 Kubernetes Deployment 对象可以代表一个应用程序在集群中的运行状态。当您创建 Deployment 对象时，您可以通过 Deployment 的 spec 字段指定需要运行应用程序副本数（replicas假设为3）。Kubernetes 从 Deployment 的 spec 中读取这些信息，并为您创建指定容器化应用程序的 3 个副本，再将实际的状态更新到 Deployment 的 status 字段。Kubernetes 系统将不断地比较实际状态 staus 和目标状态 spec 之间的差异，并根据差异做出对应的调整。例如,如果任何一个副本运行失败了，Kubernetes 将启动一个新的副本，以替代失败的副本。

apiVersion - 必须

描述: 用来创建对象时所使用的Kubernetes API版本,可通过kubectl api-versions命令查询可用API版本;

#常用
apiVersion: apps/v1

# API版本
apps/v1
v1
admissionregistration.k8s.io/v1
admissionregistration.k8s.io/v1beta1
apiextensions.k8s.io/v1
apiextensions.k8s.io/v1beta1
apiregistration.k8s.io/v1
apiregistration.k8s.io/v1beta1
authentication.k8s.io/v1
authentication.k8s.io/v1beta1
authorization.k8s.io/v1
authorization.k8s.io/v1beta1
autoscaling/v1
autoscaling/v2beta1
autoscaling/v2beta2
batch/v1
batch/v1beta1
certificates.k8s.io/v1beta1
coordination.k8s.io/v1
coordination.k8s.io/v1beta1
crd.projectcalico.org/v1
discovery.k8s.io/v1beta1
events.k8s.io/v1beta1
extensions/v1beta1
networking.k8s.io/v1
networking.k8s.io/v1beta1
node.k8s.io/v1beta1
policy/v1beta1
rbac.authorization.k8s.io/v1
rbac.authorization.k8s.io/v1beta1
scheduling.k8s.io/v1
scheduling.k8s.io/v1beta1
storage.k8s.io/v1
storage.k8s.io/v1beta1

kind - 必须

描述:被创建对象的类型常用的有Deployment(部署)、Service(服务端口)

metadata - 必须

描述:用于唯一确定该对象的元数据,包括 name 和 namespace，如果 namespace 为空，则默认值为 default;

metadata:
  name: nginx-deployment   # 应用 + 绑定类型
  namespace: nginx-app     # 名称空间默认为default

spec - 必须

描述:您对该对象的期望状态但是需注意不同类型的 Kubernetes，其 spec 对象的格式不同（含有不同的内嵌字段），通过 API 手册可以查看 Kubernetes 对象的字段和描述;

例如，假设您想了解 Pod 的 spec 定义，可以在这里找到，Deployment 的 spec 定义可以在这里找到;

0x02 编写示例

apiVersion: apps/v1        # apiserver版本
kind: Deployment           # 绑定动作
metadata:
  name: nginx-deployment   # 应用 + 绑定类型 
  namespace: nginx-app     # 名称空间
  labels:
    app: nginx
spec:
  selector:
    matchLabels:
      app: nginx
      role: master
      tier: backend
  replicas: 2 # 运行 2 个容器化应用程序副本
  template:
    metadata:
      labels:
        app: nginx
        role: master
        tier: backend
    spec:
      containers:
      - name: nginx
        image: nginx:1.7.9
        resources:
          requests:
            cpu: 100m
            memory: 100Mi
        ports:
        - containerPort: 8080

Yaml 配置文件相关操作:

#1.使用 kube apply 命令可以创建该 .yaml 文件中的 Deployment 对象
kubectl apply -f deployment.yaml
kubectl apply -f https://weiyigeek.top/k8s/deployment.yaml