Kubernetes

12、Pod深入掌握Pod定义YAML文件分析

Linux · 3月28日 · 2020年

 

一、YAML格式定义文件完整内容如下:

apiVersion: v1                    
kind: Pod                     
metadata:                     
  name: string                    
  namespace: string               
  labels:                     
    - name: string                 
  annotations:                    
    - name: string
spec:                        
  containers:                   
  - name: string                  
    image: string                 
    imagePullPolicy: [ Always|Never|IfNotPresent ]  
    command: [string]              
    args: [string]                 
    workingDir: string               
    volumeMounts:                
    - name: string                
      mountPath: string              
      readOnly: boolean              
    ports:                     
    - name: string                
      containerPort: int             
      hostPort: int                
      protocol: string               
    env:                       
    - name: string                 
      value: string                
    resources:                     
      limits:                    
        cpu: string                
        memory: string               
      requests:                    
        cpu: string                
        memory: string               
    livenessProbe:                 
      exec:                    
        command: [string]            
      httpGet:                   
        path: string
        port: number
        host: string
        scheme: string
        HttpHeaders:
        - name: string
          value: string
      tcpSocket:            
         port: number
       initialDelaySeconds: 0     
       timeoutSeconds: 0        
       periodSeconds: 0         
       successThreshold: 0
       failureThreshold: 0
       securityContext:
         privileged: false
    restartPolicy: [Always | Never | OnFailure] 
    nodeSelector: obeject        
    imagePullSecrets:          
    - name: string
    hostNetwork: false           
    volumes:                 
    - name: string             
      emptyDir: {}             
      hostPath: string           
        path: string             
      secret:                
        scretname: string  
        items:     
        - key: string
          path: string
      configMap:               
        name: string
        items:
        - key: string
          path: string

二、对以上各属性说明

属性名称 取值说明
apiVersion 版本号、例如v1
Kind Pod
Metadata 元数据
Metadata.name Pod的名称,命令规范需符合RFC1035规范
Metadata.namespace Pod所属的命令空间,默认值为default
Metadata.lablels[] 自定义标签列
Metadata.annotations[] 自定义注解列表
Spec Pod中容器的详细定义
Spec.containers Pod中的容器列表
Spec.containers[].name 容器的名称,需符合RFC1305规范
Spec.containers[].image 容器的镜像名称
Spec.containers[].imagePullPolicy 镜像拉取策略,可选值包括:

⑴、Always:表示每次都尝试重新拉取镜像

⑵、ifNotPresent:表示如果本地没有镜像,则使用本地镜像,本地不存在时拉取镜像

⑶、Never:表示仅使用本地镜像另外,如果包含如下设置,系统将默认设置

imagePullPolicy=Always,如下选择:

⑴、不设置imagePullPolicy,也未指定镜像的Tag

⑵、不设置imagePullPolicy,镜像tag为latest

⑶、启用名为:AlwaysPullimages的准入控制器(Admission Controller

spec.containers.command 容器启动命令列表,如果不指定,则使用镜像打包时使用的启动命令
spec.containers.args 容器的启动命令参数列表
spec.containers.workingDir 容器的工作目录
spec.containers.volumeMounts 挂载到容器内部的存储卷配置
spec.containers.volumeMounts.name 引用Pod定义的共享存储卷的名称,需使用volumes[]部分定义的共享存储卷名
spec.containers.volumeMounts.mountPath 存储卷容器内Mount的绝对路径,应少于512个字符
spec.containers.volumeMounts.readOnly 是否只读模式,默认为读写模式
spec.containers.ports 容器需要暴露的端口列表
spec.containers.ports.name 端口的名称
spec.containers.ports.containerPort 容器需要监听的端口号
spec.containers.ports.hostPort 容器所在主机需要监听的端口号,默认与containerPort相同,设置hostPort时,同一台宿主机将无法启动该容器的第2份副本。
spec.containers.ports.protocol 端口协议,支持TCP和UDP,默认值为TCP
spec.containers.env 容器运行前需要设置的环境变量列表
spec.containers.env.name 环境变量名称
spec.containers.env.value 环境变量的值
spec.containers.resources 资源限制和资源请求的设置
spec.containers.resources.limits 资源限制的设置
spec.containers.resources.limits.cpu CPU限制,单位为core数,将用于docker run –cpu-shares参数
spec.containers.resources.limits.memory 内存限制,单位为为MiB\GIB等,将用于docker runmemory参数
spec.containers.resources.requests 资源限制的设置
spec.containers.resources.requests.cpu Cpu请求,单位为core,容器启动初始可用数量
spec.containers.resources.requests.memory 内存限制,单位为为MiB\GIB等,容器启动可启用数量。
spec.volumes 在该pod上定义的共享存储列表
spec.volumes.name 共享存储卷的名称,在一个pod中每个存储卷定义一个名称,应符合RFC1035G规范。容器定义部分的spec.volumes.name将引用该共享存储卷的名称vloume的类型包括:emptyDir、hostPath、gcePersistentDisk、awsElasticBlockStore、gitRepo、secret、nfs、iscsi、glusterfs、persistentVolumeClaim、rbd、flexVolume、cinder、cephfs、flocker、downwardAPI、fc、azureFile、configMAP、vsphereVolume,可定多个volume,每个volume的name保持唯一。
spec.volumes.emptyDir 类型为emptyDir的存储卷,表示Pod同生命周期的一个临时目录,其值为一个空对象:emptyDir:{}
spec.volumes.hostPath 类型为hostPath 的存储卷,表示挂载Pod所在的宿主机的目录,通过volumes.hostPath.path指定
spec.volumes.hostPath.path Pod所在主机的目录,将被用于容器中mount的目录
spec.volumes.secret 类型为secret的存储卷,表示挂载集群预定义的secret对象到内部
spec.volumes.configMap 类型为configMap 的存储卷,表示挂载集群预定义的configMap对象到内部
spc.vloumes.livenessProbe 对pod内各容器的健康检查的设置,当探测无响应几次之后,系统将自动重启该容器。可以设置的方法包括:exec、httpGet和tcpSocket。对一个容器仅需设置一种健康检查方法
spc.vloumes.livenessProbe.exec. 对pod内各容器健康检查的设置,exec方式
spc.vloumes.livenessProbe.exec.command exec方式需要指定的命令或脚本。
spc.vloumes.livenessProbe.httpGet 对pod内各容器健康检查设置,httpget方式。需指定path、port
spc.vloumes.livenessProbe.tcpSocket 对pod内各容器健康检查的设置,tcpSocket 方式
spc.vloumes.livenessProbe.initialDelaySeconds 容器启动完成后首次探测的时间,单位为s
spc.vloumes.livenessProbe.timeoutSeconds 对容器健康检查的探测等待响应的超时时间设置,单位为s,默认值为1s,若超过该超时时间设置,则认为该容器不健康,会重启该容器
spc.vloumes.livenessProbe.periodSeconds 对容器健康检查定期探测时间设置,单位为s,默认为10s探测一次。
spec.restartPolicy Pod重启策略,可选值为Always,OnFailure,默认值为Always.

1、Always:Pod一旦终止运行,则无论容器是如何终止的,kubelet都将重启它。

2、OnFailure:只有Pod以非零退出吗终止时,kubelet才会被重启该容器。如果容器正常结束(退出码为0),则kubelet将不会重启它。

3、Never:Pod终止后,kubelet将退出码报告给Master,不会重启该pod

spec.nodeSelector 设置node的label,以key:vlaue格式指定,pod将被调度到具有这些label的node上
spec.imagePullSecrets pull镜像时使用的Secrets名称,以name:secretkey格式指定
spec.hostNetwork 是否使用主机网络模式,默认值为false。设置为true表示容器使用宿主机网络,不在使用docker网桥,该pod将无法在同一台宿主机上启动第二个副本。
0 条回应