在 Kubernetes 系统中，Kubernetes 对象是持久化的实体。 Kubernetes 使用这些实体去表示整个集群的状态。具体而言，它们描述了如下信息：

哪些容器化应用正在运行（以及在哪些节点上运行）
可以被应用使用的资源
关于应用运行时行为的策略，比如重启策略、升级策略以及容错策略

Kubernetes 对象是一种“意向表达（Record of Intent）”。一旦创建该对象， Kubernetes 系统将不断工作以确保该对象存在。通过创建对象，你本质上是在告知 Kubernetes 系统，你想要的集群工作负载状态看起来应是什么样子的，这就是 Kubernetes 集群所谓的期望状态（Desired State）。

操作 Kubernetes 对象 —— 无论是创建、修改或者删除 —— 需要使用 Kubernetes API。比如，当使用 kubectl 命令行接口（CLI）时，CLI 会调用必要的 Kubernetes API；也可以在程序中使用客户端库，来直接调用 Kubernetes API。

1.1 创建一次部署

kubectl create deploy nginx01 --image=nginx

1.2 获取部署信息，并以yaml文件查看

kubectl get deploy nginx01 -oyaml

apiVersion: apps/v1 # Kubernetes API 的版本
kind: Deployment #Deployment 资源对象
metadata: #元数据信息
  annotations:
    deployment.kubernetes.io/revision: "1"
  creationTimestamp: "2024-08-22T15:35:31Z"
  generation: 1
  labels: #标签 标签选择器
    app: nginx01
  managedFields: #管理字段
  - apiVersion: apps/v1
    fieldsType: FieldsV1
    fieldsV1:
      f:metadata:
        f:labels:
          .: {}
          f:app: {}
      f:spec:
        f:progressDeadlineSeconds: {}
        f:replicas: {}
        f:revisionHistoryLimit: {}
        f:selector: {}
        f:strategy:
          f:rollingUpdate:
            .: {}
            f:maxSurge: {}
            f:maxUnavailable: {}
          f:type: {}
        f:template:
          f:metadata:
            f:labels:
              .: {}
              f:app: {}
          f:spec:
            f:containers:
              k:{"name":"nginx"}:
                .: {}
                f:image: {}
                f:imagePullPolicy: {}
                f:name: {}
                f:resources: {}
                f:terminationMessagePath: {}
                f:terminationMessagePolicy: {}
            f:dnsPolicy: {}
            f:restartPolicy: {}
            f:schedulerName: {}
            f:securityContext: {}
            f:terminationGracePeriodSeconds: {}
    manager: kubectl-create
    operation: Update
    time: "2024-08-22T15:35:31Z"
  - apiVersion: apps/v1
    fieldsType: FieldsV1
    fieldsV1:
      f:metadata:
        f:annotations:
          .: {}
          f:deployment.kubernetes.io/revision: {}
      f:status:
        f:availableReplicas: {}
        f:conditions:
          .: {}
          k:{"type":"Available"}:
            .: {}
            f:lastTransitionTime: {}
            f:lastUpdateTime: {}
            f:message: {}
            f:reason: {}
            f:status: {}
            f:type: {}
          k:{"type":"Progressing"}:
            .: {}
            f:lastTransitionTime: {}
            f:lastUpdateTime: {}
            f:message: {}
            f:reason: {}
            f:status: {}
            f:type: {}
        f:observedGeneration: {}
        f:readyReplicas: {}
        f:replicas: {}
        f:updatedReplicas: {}
    manager: kube-controller-manager
    operation: Update
    time: "2024-08-22T15:37:47Z"
  name: nginx01
  namespace: default
  resourceVersion: "1526989"
  uid: 1422de0f-5d16-468c-89fc-8981620e786c
spec: #期望 定义了 Deployment 的期望状态
  progressDeadlineSeconds: 600  #超时之前 Deployment 进度的超时时间
  replicas: 1 #期望运行的 Pod 副本数量
  revisionHistoryLimit: 10 # 保留旧版本的 Pod 的最大数量
  selector: #用于选择要管理的 Pod 的标签选择器
    matchLabels:
      app: nginx01
  strategy: #定义更新策略，这里是 RollingUpdate，指定了最大可用性和最大不可用性的比例。当更新 Deployment 时，Kubernetes 会逐步替换旧版本的 Pod
    rollingUpdate:
      maxSurge: 25%
      maxUnavailable: 25%
    type: RollingUpdate
  template:
    metadata:
      creationTimestamp: null
      labels:
        app: nginx01
    spec:
      containers:
      - image: nginx #镜像名称
        imagePullPolicy: Always #镜像拉取策略
        name: nginx
        resources: {}
        terminationMessagePath: /dev/termination-log
        terminationMessagePolicy: File
      dnsPolicy: ClusterFirst #Pod 的 DNS 策略 ClusterFirst 是默认设置，表示 Pod 将使用 Kubernetes 集群内部的 DNS 服务
      restartPolicy: Always #Pod 的重启策略，这里是 Always，表示总是尝试重启 Pod
      schedulerName: default-scheduler #Pod 的调度器名称
      securityContext: {}
      terminationGracePeriodSeconds: 30
status: #状态
  availableReplicas: 1 #当前集群可用的 当前可用的 Pod 数量
  conditions:
  - lastTransitionTime: "2024-08-22T15:37:47Z"
    lastUpdateTime: "2024-08-22T15:37:47Z"
    message: Deployment has minimum availability.
    reason: MinimumReplicasAvailable
    status: "True"
    type: Available
  - lastTransitionTime: "2024-08-22T15:35:31Z"
    lastUpdateTime: "2024-08-22T15:37:47Z"
    message: ReplicaSet "nginx01-67fdf8d7c7" has successfully progressed.
    reason: NewReplicaSetAvailable
    status: "True"
    type: Progressing
  observedGeneration: 1 #控制器观察到的 Deployment 元数据的代数
  readyReplicas: 1 #就绪的 Pod 数量
  replicas: 1 #当前运行的 Pod 总数
  updatedReplicas: 1 #已更新到最新版本的 Pod 数量

spec和status最终是要一致的

1.3 对象规约（Spec）与状态（Status）

几乎每个 Kubernetes 对象包含两个嵌套的对象字段，它们负责管理对象的配置：对象 spec（规约） 和对象 status（状态）。对于具有 spec 的对象，你必须在创建对象时设置其内容，描述你希望对象所具有的特征： 期望状态（Desired State）。

status 描述了对象的当前状态（Current State），它是由 Kubernetes 系统和组件设置并更新的。在任何时刻，Kubernetes 控制平面都一直在积极地管理着对象的实际状态，以使之达成期望状态。

例如，Kubernetes 中的 Deployment 对象能够表示运行在集群中的应用。当创建 Deployment 时，你可能会设置 Deployment 的 spec，指定该应用要有 3 个副本运行。 Kubernetes 系统读取 Deployment 的 spec，并启动我们所期望的应用的 3 个实例 —— 更新状态以与规约相匹配。如果这些实例中有的失败了（一种状态变更），Kubernetes 系统会通过执行修正操作来响应 spec 和 status 间的不一致 —— 意味着它会启动一个新的实例来替换。

1.4 获取yaml方式

kubectl get xxx -oyaml
kubectl create deploy xxxxx --dry-run=client -oyaml
kubectl explain pod.spec.xx

不会写yaml可以通过这些方式来获取

kubectl get pod doris-app -oyaml #直接获取集群内pod的yaml信息，然后基于这个基础自己修改创造

kubectl run my-nginx --image=nginx --dry-run=client -oyaml 不启动部署直接获取他的yaml信息

2.1 以不实际执行的方式预览将要创建的 Deployment 的 YAML 定义

--dry-run 的可用值：

none：这是默认值，表示不进行任何预览，实际执行命令。
server：服务器端预览。在这种模式下，kubectl 命令会发送到 Kubernetes 服务器，服务器将处理请求并返回操作的结果，但不会持久化资源。这允许你看到操作的结果，而不会真正更改任何东西。
client：客户端预览。在这种模式下，kubectl 命令仅在客户端执行，不会与服务器通信。它将打印将要发送到服务器的对象，但不会实际发送请求。

kubectl run my-nginx --image=nginx --dry-run=client -oyaml

apiVersion: v1 # Kubernetes API 的版本 根据kubectl api-resources 查看的具体版本
kind: Pod  #资源对象或类型，代表这是一个pod
metadata:
  creationTimestamp: null #删除系统自己生成
  labels:
    run: mynginx
  name: mynginx
spec:  #期望的
  containers:
  - image: nginx #镜像
    name: my-nginx  #容器名字
    resources: {}
  dnsPolicy: ClusterFirst #DNS 策略 ClusterFirst 是默认设置，表示 Pod 将使用 Kubernetes 集群内部的 DNS 服务
  restartPolicy: Always #Pod 的重启策略，这里是 Always，表示总是尝试重启 Pod
status: {}

2.2获取到所有的资源

kubectl api-resources

2.3 创建yaml文件编写内容，启动一个pod

vi  my-nginx.yaml 


kubectl apply -f ./my-nginx.yaml  内容参照 3.1 yaml

#appy -f  如果有就更新，没有就创建

我们自己的pod启动成功

2.3.1 删除yaml执行部署的所有相关资源

kubectl delete  -f ./my-nginx.yaml

再次查看，刚刚部署的pod已经删除

2.4 获取名称空间

不同名称空间网络可以共享，资源不能共享

kubectl get namespace

2.4.1 创建名称空间 namespace 简称ns

kubetcl create ns lqf

获取yaml形式

kubectl create ns awk --dry-run=client -oyaml


apiVersion: v1
kind: Namespace
metadata:
  name: awk

----------

apiVersion: v1
kind: Namespace
metadata:
  creationTimestamp: null
  name: awk
spec: {}
status: {}

2.4.2 当前请求设置命名空间，使用 --namespace 参数

默认情况下，安装Kubernetes集群时，会初始化一个 default 名称空间，用来将承载那些未指定名称

空间的 Pod、Service、Deployment等对象

kubectl create deploy nginx02 --image=nginx --namespace=lqf

2.5 标签和选择器

apiVersion: v1 # Kubernetes API 的版本 根据kubectl api-resources 查看的具体版本
kind: Pod  #资源对象，代表这是一个pod
metadata:
  labels:
    version: latest #打上标签
  name: mynginx #pod名字
  namespace: lqf #名称空间
spec:  #期望的
  containers:
  - image: nginx #镜像
    name: my-nginx02  #容器名字
  dnsPolicy: ClusterFirst #DNS 策略 ClusterFirst 是默认设置，表示 Pod 将使用 Kubernetes 集群内部的 DNS 服务
  restartPolicy: Always #Pod 的重启策略，这里是 Always，表示总是尝试重启 Pod

2.5.1 添加标签

kubectl label pods mynginx  abc=123 -n=lqf

2.5.2 删除标签

kubectl label pods mynginx  abc- -n=lqf
3.5.3 其他命令 --help

自己查看学习

kubectl labels --help

Examples:
  # Update pod 'foo' with the label 'unhealthy' and the value 'true'.
  kubectl label pods foo unhealthy=true
  
  # Update pod 'foo' with the label 'status' and the value 'unhealthy', overwriting any existing value.
  kubectl label --overwrite pods foo status=unhealthy
  
  # Update all pods in the namespace
  kubectl label pods --all status=unhealthy
  
  # Update a pod identified by the type and name in "pod.json"
  kubectl label -f pod.json status=unhealthy
  
  # Update pod 'foo' only if the resource is unchanged from version 1.
  kubectl label pods foo status=unhealthy --resource-version=1
  
  # Update pod 'foo' by removing a label named 'bar' if it exists.
  # Does not require the --overwrite flag.
  kubectl label pods foo bar-
  3.6 命令行命令自动补全

tab提示

# 安装
yum install bash-completion
# 将 bash 的 kubectl 补全代码加载到当前 shell 中
echo 'source <(kubectl completion bash)' >>~/.bashrc
kubectl completion bash >/etc/bash_completion.d/kubectl
source /usr/share/bash-completion/bash_completion