k8s 中存在哪些资源

什么是资源?

K8s 中所有的内容都抽象为资源, 资源实例化之后,叫做对象。

名称空间级别

工作负载型资源 ( workload ): Pod、ReplicaSet、Deployment、StatefulSet、DaemonSet、Job、
CronJob ( ReplicationController 在 v1.11 版本被废弃 )

服务发现及负载均衡型资源 ( ServiceDiscovery LoadBalance ): Service、Ingress、…

配置与存储型资源: Volume( 存储卷 )、CSI( 容器存储接口,可以扩展各种各样的第三方存储卷 )

特殊类型的存储卷:ConfigMap ( 当配置中心来使用的资源类型 )、Secret(保存敏感数据)、DownwardAPI(把外部环境中的信息输出给容器)

集群级资源:Namespace、Node、Role、ClusterRole、RoleBinding、ClusterRoleBinding

元数据型资源:HPA、PodTemplate、LimitRange

资源清单

资源清单含义

在 k8s 中,一般使用 yaml 格式的文件来创建符合我们预期期望的 pod ,这样的 yaml 文件我们一般称为资源清单。

资源清单格式

  1. apiVersion: group/apiversion # 如果没有给定 group 名称,那么默认为 core,可以使用 kubectl api-versions # 获取当前 k8s 版本上所有的 apiVersion 版本信息( 每个版本可能不同 )
  2. kind: #资源类别
  3. metadata #资源元数据
  4. name
  5. namespace
  6. lables
  7. annotations # 主要目的是方便用户阅读查找
  8. spec: # 期望的状态 (disired state)
  9. status:# 当前状态,本字段有 Kubernetes 自身维护,用户不能去定义


常用字段的解释

参数名 字段类型 说明
version String 这里是指的是K8S API的版本,目前基本上是v1,可以用kubectl api- versions命令查询
kind String 这里指的是 yaml 文件定义的资源类型和角色,比如:Pod
metadata Object 元数据对象,固定值就写metadata
metadata.name String 元数据对象的名字,这里由我们编写,比如命名Pod的名字
metadata.namespace String 元数据对象的命名空间,甶我们自身定义
spec Object 详细走义对象,固定值就写 Spec
spec.containers[] list 这里是 Spec 对象的容器列表定义,是个列表
spec.containers[].name String 这里定义容器的名字
spec.containers[].innage String 这里定义要用到的镜像名称
spec.containers[].name String 定义容器的名字
spec.containers[].image String 定义要用到的镜像名称
spec.containers[].imagePullPolicy String 定义镜像拉取策略,有 Always、Never、 ifNotPresent 三个值可选
(1)Always:意思是每次都尝试重新拉取镜像
(2)Never:表示仅 使用本地镜像
(3)ifNotPresent:如栗本地有镜像就使用本地镜像,没有就拉取在线镜像. 上面三个值都没设置的话,默认是Always。
spec.containers[].command[] List 指定容器启动命令,因为是数组可以指定多个,不指定则使用镜像打包时使用的启动命令
spec.containers[].args[] List 指定容器启动命令参数,因为是数组可以指定多个
spec.containers[].workingDir String 指定容器的工作目录
spec.containers[].volumeMounts[] List 指定容器内部的存储卷配置
spec.containers[].volumeMounls[].name String 指定可以被容器挂载的存储卷的名称
spec.containers[].volumeMounts[].mountPath String 指定可以被容器挂载的存储卷的路径
spec.containers[].volumeMounts[].readOnly String 设置存储卷路径的读写模式,ture 或者 false, 默认为读写模式
spec.containers[].ports[] List 指定容器需要用到的端口列表
spec.containers[].ports[].name String 指定端口名称
spec.containers[].ports[].containerPort String 指定容器需要监听的端口号
spec.containers[].ports[].hostPort String 指定容器所在主机需要监听的端口号,默认跟上面containerPort相同,注意设置了 hostPort 同一台主机无法启动该容器的相同副本(因为主机的端口号不能相同,这样会冲突)
spec.containers[].ports[].protocol String 指走揣口协议,支持 TCP 和 UDP,默认值为 TCP
spec.containers[].env[] List 指定容器运行前需设置的环境变量列表
spec.containers[].env[].name String 指定环墳变量名称
spec.containers[].env[].value String 指定环境变量值
spec.containers[].resources Object 指定资源限制和资源请求的值(这里幵始就是设罝容器的资源上限)
spec.containers[].resources.limits Object 指定设置容器运行时资源的运行上限
spec.containers[].resources.limits.cpu String 指定CPU的限制,单位为core数,将用于 docker run

—cpu-shares参数 | | spec.containers[].resources.limits.memory | String | 指走MEM内存的限制,单位为MIB、GiB | | spec.containers[].resources.requests | Object | 指定容器启动和调度时的限制设置 | | spec.containers[].resources.requests.cpu | String | CPU请求,单位core数,容器启动时初始化可用数量 | | spec.containers[].resources.requests.memory | String | 内存请求,单位为MIB、GiB,容器启动的初始化可用数量 | | spec.restartPolicy | String | 定义Pod的重启策略,可选值为Always、OnFailure,默认值为 Always。
(1)Always:Pod —旦终止运行,则无论容器是如何终止的,kubelet服务都将重启它。
(2)OnFailure:只有Pod以非零退出码终止时,kubelet才会重启该容 器。如果容器正常结束(退出码为0),则kubelet将不会重启它。
(3)Never:Pod终止后,kubelet将退出码报告给Master,不会重启该Pod。 | | spec.nodeSelector | Object | 定义Node的Label过滤标签,以key: value格式指走 | | spec.imagePuilSecrets | Object | 定义 pull 镜像时使用secret名称,以name:secretkey格式指走 | | spec hostNetwork | Boolean | 定义是否使用主机网络模式,默认值为false。设置true表示使用宿主机网络,不使用docker网桥,同时设罝了true将无法在同一台宿主机上启动第二个副本。 |

生命周期

k8s 资源清单 - 图1

Init 容器

Pod 能够具有多个容器,应用运行在容器里面,但是它也可能有一个或多个先于应用容器启动的 Init
容器

Init 容器与普通的容器非常像,除了如下两点:

  • Init 容器总是运行到成功完成为止
  • 每个 Init 容器都必须在下一个 Init 容器启动之前成功完成

如果 Pod 的 Init 容器失败,Kubernetes 会不断地重启该 Pod,直到 Init 容器成功为止。然而,
如果 Pod 对应的 restartPolicy 为 Never,它不会重新启动

Init 容器的作用

因为 Init 容器具有与应用程序容器分离的单独镜像,所以它们的启动相关代码具有如下优势:

  • 它们可以包含并运行实用工具,但是出于安全考虑,是不建议在应用程序容器镜像中包含这

    1. 些实用工具的
  • 它们可以包含使用工具和定制化代码来安装,但是不能出现在应用程序镜像中。例如,创建

    1. 镜像没必要 FROM 另一个镜像,只需要在安装过程中使用类似 sed awk python dig <br /> 这样的工具。
  • 应用程序镜像可以分离出创建和部署的角色,而没有必要联合它们构建一个单独的镜像。

  • Init 容器使用 Linux Namespace,所以相对应用程序容器来说具有不同的文件系统视图。因

    1. 此,它们能够具有访问 Secret 的权限,而应用程序容器则不能。
  • 它们必须在应用程序容器启动之前运行完成,而应用程序容器是并行运行的,所以 Init 容

    1. 器能够提供了一种简单的阻塞或延迟应用容器的启动的方法,直到满足了一组先决条件。

Init 案例

在下面……

特殊说明

  • 在 Pod 启动过程中,Init 容器会按顺序在网络和数据卷初始化之后启动。每个容器必须在下一个

    容器启动之前成功退出

  • 如果由于运行时或失败退出,将导致容器启动失败,它会根据 Pod 的 restartPolicy 指定的策略

    进行重试。然而,如果 Pod 的 restartPolicy 设置为 Always,Init 容器失败时会使用
    RestartPolicy 策略

  • 在所有的 Init 容器没有成功之前,Pod 将不会变成 Ready 状态。Init 容器的端口将不会在

    Service 中进行聚集。 正在初始化中的 Pod 处于 Pending 状态,但应该会将 Initializing 状
    态设置为 true

  • 如果 Pod 重启,所有 Init 容器必须重新执行

  • 对 Init 容器 spec 的修改被限制在容器 image 字段,修改其他字段都不会生效。更改 Init

    容器的 image 字段,等价于重启该 Pod

  • Init 容器具有应用容器的所有字段。除了 readinessProbe,因为 Init 容器无法定义不同于完成

    (completion)的就绪 (readiness)之外的其他状态。这会在验证过程中强制执行

  • 在 Pod 中的每个 app 和 Init 容器的名称必须唯一;与任何其它容器共享同一个名称,会在验证

    时抛出错误

Init 案例

init 容器

init 模板

  1. # # init-pod.yaml
  2. apiVersion: v1
  3. kind: Pod
  4. metadata:
  5. name: myapp-pod
  6. labels:
  7. app: myapp
  8. spec:
  9. containers:
  10. - name: myapp-container
  11. image: busybox
  12. command: ['sh', '-c', 'echo The app is running! && sleep 3600']
  13. initContainers:
  14. - name: init-myservice
  15. image: busybox
  16. command: ['sh', '-c', 'until nslookup myservice; do echo waiting for myservice; sleep 2; done;']
  17. - name: init-mydb
  18. image: busybox
  19. command: ['sh', '-c', 'until nslookup mydb; do echo waiting for mydb; sleep 2; done;']
  1. # # myservice.yaml
  2. kind: Service
  3. apiVersion: v1
  4. metadata:
  5. name: myservice
  6. spec:
  7. ports:
  8. - protocol: TCP
  9. port: 80
  10. targetPort: 9376
  1. # # mydb.yaml
  2. kind: Service
  3. apiVersion: v1.0
  4. metadata:
  5. name: mydb
  6. spec:
  7. ports:
  8. - protocol: TCP
  9. port: 80
  10. targetPort: 9377

测试操作命令

  1. # kubectl create -f init-pod.yaml
  2. pod/myapp-pod created
  3. # kubectl get pod
  4. NAME READY STATUS RESTARTS AGE
  5. myapp-pod 0/1 Init:0/2 0 49s
  6. # # 查看详细日志 pod
  7. # kubectl describe pod myapp-pod
  8. # # 查看详细日志 initC
  9. # kubectl logs myapp-pod -c init-myservice
  10. # kubectl create -f myservice.yaml
  11. # kubectl create -f mydb.yaml

检测探针 - 就绪检测

readinessProbe - httpget

  1. # # read.yaml
  2. apiVersion: v1
  3. kind: Pod
  4. metadata:
  5. name: readiness-httpget-pod
  6. namespace: default
  7. spec:
  8. containers:
  9. - name: readiness-httpget-container
  10. image: hub.yangguoxiang.com/library/myapp:v1.0
  11. imagePullPolicy: IfNotPresent
  12. readinessProbe:
  13. httpGet:
  14. port: 80
  15. path: /index1.html
  16. initialDelaySeconds: 1
  17. periodSeconds: 3

测试操作命令

  1. # kubectl create -f read.yaml
  2. # # 未能就绪(缺少index1.html不能通过检测)
  3. # kubectl get pods
  4. NAME READY STATUS RESTARTS AGE
  5. readiness-httpget-pod 0/1 Running 0 3m43s
  6. # # 进入容器增加 index1.html 文件
  7. # kubectl exec readiness-httpget-pod -it -- /bin/sh
  8. # cd /usr/share/nginx/html/
  9. # echo "hello world" >> index1.html
  10. # exit
  11. # # 已就绪
  12. # kubectl get pods
  13. NAME READY STATUS RESTARTS AGE
  14. readiness-httpget-pod 1/1 Running 0 10m

检测探针 - 存活检测

livenessProbe-exec

  1. # # live-exec.yaml
  2. apiVersion: v1
  3. kind: Pod
  4. metadata:
  5. name: liveness-exec-pod
  6. namespace: default
  7. spec:
  8. containers:
  9. - name: liveness-exec-container
  10. image: busybox
  11. imagePullPolicy: IfNotPresent
  12. command: ["/bin/sh","-c","touch /tmp/live ; sleep 60; rm -rf /tmp/live; sleep 3600"]
  13. livenessProbe:
  14. exec:
  15. command: ["test","-e","/tmp/live"]
  16. initialDelaySeconds: 1
  17. periodSeconds: 3

测试操作命令

  1. # kubectl create -f live-exec.yaml
  2. # kubectl get pods
  3. NAME READY STATUS RESTARTS AGE
  4. liveness-exec-pod 1/1 Running 6 12h
  5. # # 观察到发生异常后会重启

livenessProbe-httpget

  1. # # live-http.yaml
  2. apiVersion: v1
  3. kind: Pod
  4. metadata:
  5. name: liveness-httpget-pod
  6. namespace: default
  7. spec:
  8. containers:
  9. - name: liveness-httpget-container
  10. image: hub.yangguoxiang.com/library/myapp:v1.0
  11. imagePullPolicy: IfNotPresent
  12. ports:
  13. - name: http
  14. containerPort: 80
  15. livenessProbe:
  16. httpGet:
  17. port: http
  18. path: /index.html
  19. initialDelaySeconds: 1
  20. periodSeconds: 3
  21. timeoutSeconds: 10

测试操作命令

  1. # kubectl create -f live-http.yaml
  2. # # 进入容器删除 index.html 文件
  3. # kubectl exec readiness-httpget-pod -it -- /bin/sh
  4. # cd /usr/share/nginx/html/
  5. # rm -f index.html
  6. # exit
  7. # # 当检测到 index.html 请求不存在时,则删除 container 重新创建
  8. # kubectl get pod
  9. NAME READY STATUS RESTARTS AGE
  10. liveness-httpget-pod 1/1 Running 1 6m28s

livenessProbe-tcp

  1. # # live-tcp.yaml
  2. apiVersion: v1
  3. kind: Pod
  4. metadata:
  5. name: probe-tcp
  6. spec:
  7. containers:
  8. - name: nginx
  9. image: hub.yangguoxiang.com/library/myapp:v1.0
  10. livenessProbe:
  11. initialDelaySeconds: 5
  12. periodSeconds: 3
  13. timeoutSeconds: 1
  14. tcpSocket:
  15. port: 8888

测试操作命令

  1. # kubectl create -f live-tcp.yaml
  2. # # 进入容器删除 index.html 文件
  3. # kubectl exec readiness-httpget-pod -it -- /bin/sh
  4. # cd /usr/share/nginx/html/
  5. # rm -f index.html
  6. # exit
  7. # # 当检测到 index.html 请求不存在时,则删除 container 重新创建
  8. # kubectl get pod -w
  9. NAME READY STATUS RESTARTS AGE
  10. probe-tcp 1/1 Running 0 11s
  11. probe-tcp 1/1 Running 1 45s
  12. probe-tcp 1/1 Running 2 86s

启动、退出

  1. # #
  2. apiVersion: v1
  3. kind: Pod
  4. metadata:
  5. name: lifecycle-demo
  6. spec:
  7. containers:
  8. - name: lifecycle-demo-container
  9. image: nginx
  10. lifecycle:
  11. postStart:
  12. exec:
  13. command: ["/bin/sh", "-c", "echo Hello from the postStart handler > /usr/share/message"]
  14. preStop:
  15. exec:
  16. command: ["/bin/sh", "-c", "echo Hello from the poststop handler > /usr/share/message"]