Kubernetes(k8s)的Pod资源清单常用属性介绍

1. Pod的介绍

每个Pod中都包含一个或多个容器，容器分为两类：

1. 用户程序所在的容器，数量为一个或多个
2. Pause容器，每个Pod都有的一个根容器，它的作用有两个：
   1. 可以以它为依据，评估整个Pod的健康状况
   2. 可以在根容器上设置IP地址，其它容器都共享此IP(Pod的IP)，以实现Pod内部的网络通信(Pod之间的通讯采用虚拟网络技术来实现，我们当前环境使用的是Calico)

2. Pod的常用资源清单

apiVersion: v1                             # 必选，版本号v1
kind: Pod                                  # 必选，资源类型Pod
metadata:       　                         # 必选，元数据
  name: string                             # 必选，Pod名称
  namespace: string                        # Pod所属的命名空间, 默认为"default"
  labels:       　　                       # 自定义标签列表
    - name: string      　          
spec:                                      # 必选，Pod中容器的详细定义
  containers:                              # 必选，Pod中容器列表
  - name: string                           # 必选，容器名称
    image: string                          # 必选，容器的镜像名称
    imagePullPolicy: [Always|Never|IfNotPresent]          # 获取镜像的策略 
    command: [string]                      # 容器的启动命令列表，默认是打包时使用的启动命令
    args: [string]                         # 容器的启动命令参数列表
    workingDir: string                     # 容器的工作目录
    volumeMounts:                          # 挂载到容器内部的存储卷配置
    - name: string                         # 引用pod定义的共享存储卷的名称，需用volumes[]部分定义的的卷名
      mountPath: string                    # 存储卷在容器内mount的绝对路径，应少于512字符
      readOnly: boolean                    # 是否为只读模式
    ports:                                 # 需要暴露的端口号列表
    - name: string                         # 端口的名称
      containerPort: int                   # 容器需要监听的端口号
      hostPort: int                        # 容器所在主机需要监听的端口号，默认与Container相同
      protocol: string                     # 端口协议，支持TCP和UDP，默认TCP
    env:                                   # 容器运行前需设置的环境变量列表
    - name: string                         # 环境变量名称
      value: string                        # 环境变量的值
    resources:                             # 资源限制和请求的设置
      limits:                              # 资源限制的设置
        cpu: string                        # Cpu的限制，单位为core数，将用于docker run --cpu-shares参数
        memory: string                     # 内存限制，单位可以为Mib/Gib，将用于docker run --memory参数
      requests:                            # 资源请求的设置
        cpu: string                        # Cpu请求，容器启动的初始可用数量
        memory: string                     # 内存请求,容器启动的初始可用数量
    lifecycle:                             # 生命周期钩子
		postStart:                         # 容器启动后立即执行此钩子,如果执行失败,会根据重启策略进行重启
		preStop:                           # 容器终止前执行此钩子,无论结果如何,容器都会终止
    livenessProbe:                         # 对Pod内各容器健康检查的设置，当探测无响应几次后将自动重启该容器
      exec:       　                       # 对Pod容器内检查方式设置为exec方式
        command: [string]                  # exec方式需要制定的命令或脚本
      httpGet:                             # 对Pod内个容器健康检查方法设置为HttpGet，需要制定Path、port
        path: string
        port: number
        host: string
        scheme: string
        HttpHeaders:
        - name: string
          value: string
      tcpSocket:                           # 对Pod内的容器健康检查方式设置为tcpSocket方式
         port: number
       initialDelaySeconds: 0              # 容器启动完成后首次探测的时间，单位为秒
       timeoutSeconds: 0    　　           # 对容器健康检查探测等待响应的超时时间，单位秒，默认1秒
       periodSeconds: 0     　　           # 对容器健康检查的定期探测时间设置，单位秒，默认10秒一次
       successThreshold: 0
       failureThreshold: 0
       securityContext:
         privileged: false
  restartPolicy: [Always|Never|OnFailure]          # Pod的重启策略
  nodeName:                        # 设置NodeName表示将该Pod调度到指定到名称的node节点上
  nodeSelector: obeject                    # 设置NodeSelector表示将该Pod调度到包含这个label的node上
  imagePullSecrets:                        # Pull镜像时使用的secret名称，以key：secretkey格式指定
  - name: string
  hostNetwork: false                       # 是否使用主机网络模式，默认为false，如果设置为true，表示使用宿主机网络
  volumes:                                 # 在该pod上定义共享存储卷列表
  - name: string                           # 共享存储卷名称 (volumes类型有很多种)
    emptyDir: {}                           # 类型为emtyDir的存储卷，与Pod同生命周期的一个临时目录。为空值
    hostPath: string                       # 类型为hostPath的存储卷，表示挂载Pod所在宿主机的目录
      path: string      　　               # Pod所在宿主机的目录，将被用于同期中mount的目录
    secret:       　　　                    # 类型为secret的存储卷，挂载集群与定义的secret对象到容器内部
      scretname: string  
      items:     
      - key: string
        path: string
    configMap:                             # 类型为configMap的存储卷，挂载预定义的configMap对象到容器内部
      name: string
      items:
      - key: string
        path: string

3. 查询Pod资源清单命令

[root@k8s-master ~]# kubectl explain pod.apiVersion
KIND:     Pod
VERSION:  v1

FIELD:    apiVersion 

DESCRIPTION:
     APIVersion defines the versioned schema of this representation of an
     object. Servers should convert recognized schemas to the latest internal
     value, and may reject unrecognized values. More info:
     https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
[root@k8s-master ~]# 

4. Pod资源清单一级属性和spec属性的简要说明

Kubernetes中基本所有资源的一级属性都包含5个部分：

• apiVersion: ：版本，由kubernetes内部定义，用kubectl api-versions命令查询
• kind: ：类型，由kubernetes内部定义，用kubectl api-resources命令查询
• metadata: ：元数据，主要是资源标识和说明，常用的有name、namespace、labels等
• spec: ：描述，这是配置中最重要的一部分，里面是对各种资源配置的详细描述
• status: ：状态信息，里面的内容不需要定义，由kubernetes自动生成

spec的常见子属性：

• containers: ：容器列表，用于定义容器的详细信息
• nodeName: ：根据nodeName的值将Pod调度到指定的Node节点上
• nodeSelector: ：根据NodeSelector中定义的信息选择该Pod调度到包含这些Label的Node上
• hostNetwork: ：是否使用主机网络模式，默认为false，如果设置为true，表示使用宿主机网络
• volumes: ：存储卷，用于定义Pod上面挂载的存储信息
• restartPolicy: ：重启策略，表示Pod在遇到故障的时候的处理策略