文章目录
资源清单
资源清单含义:在 k8s 中,一般使用 yaml 格式的文件来创建符合我们预期期望的 pod等资源对象,这样的 yaml 文件我们一般 称为资源清单。
分类
-
名称空间级别:仅存此名称空间下生效
- 工作负载型资源(workload):
Pod: k8s中最小单元
ReplicaSet:调度器,通过标签控制 pod 的副本数目
Deployment:控制器,通过控制 rs 的创建来创建 pod
StatefulSet:为有状态服务创建的管理器
DaemonSet:可以在每个节点运行 pod 主键
Job:为批处理而生
CronJob(ReplicationController)在v1.11版本被废弃:为批处理而生 - 服务发现及负载均衡型资源(ServiceDiscoveryLoadBalance):Service、Ingress、…
- 配置与存储型资源:Volume(存储卷)、CSI(容器存储接口,可以扩展各种各样的第三方存储卷)
- 特殊类型的存储卷:
ConfigMap(当配置中心来使用的资源类型):通过他可以创建一些配置文件,达到热更新
Secret(保存敏感数据):加密方案存储数据,可以用它存储一些秘钥等
DownwardAPI(把外部环境中的信息输出给容器):下载文件的接口,可以下载、上传
- 工作负载型资源(workload):
-
集群级别:所有名称空间都可以使用
Namespace:名称空间
Node:工作节点
Role
ClusterRole
RoleBinding
ClusterRoleBinding -
元数据型资源
HPA
PodTemplate(pod模板)
LimitRange(资源限制)
Pod 资源清单常用字段解释
可以使用命令:kubectl explain
来查看详细属性
kubectl explain pod
kubectl explain pod.spec
kubectl explain pod.spec.containers
required就是必须要有的。
必须存在的属性
参数名 | 字段类型 | 说明 | 默认值 |
---|---|---|---|
apiVersion | String | 这里是指的是K8S API的版本,目前基本上是v1,可以用 kubectl api-versions 或者 kubectl explain pod 命令查询 | |
kind | String | 这里指的是yaml文件定义的资源类型和角色,比如: Pod | |
metadata | Object | 元数据对象,固定值就写metadata | |
metadata.name | String | 元数据对象的名字,这里由我们编写,比如命名Pod的名字 | |
metadata.namespace | String | 元数据对象的命名空间,由我们自身定义,用来逻辑上隔离集群资源,默认就是default命名空间 | default |
metadata.labels | map[string]string | 键值数据,常被用作挑选条件 | |
spec | Object | 详细定义对象,固定值就写Spec | |
spec.containers[] | List | 这里是Spec对象的容器列表定义,是个列表 | |
spec.containers[].name | String | 这里定义容器的名字 | |
spec.containers[].image | String | 这里定义要用到的镜像名称,如果镜像的标签是 latest,每次使用该镜像都会从远程下载 |
主要对象
参数名 | 字段类型 | 说明 | 默认值 |
---|---|---|---|
spec.containers[].name | String | 定义容器的名字 | 随机指定 |
spec.containers[].image | String | 定义要用到的镜像名称,如果镜像的标签是 latest,每次使用该镜像都会从远程下载 | |
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[].volumeMounts[].name | String | 指定可以被容器挂载的存储卷的名称 | |
spec.containers[].volumeMounts[].mountPath | String | 指定可以被容器挂载的存储卷的路径 | |
spec.containers[].volumeMounts[].readOnly | Boolean | 设置存储卷路径的读写模式,ture 或者 false | false |
spec.containers[].ports[] | List | 指定容器需要用到的端口列表 | |
spec.containers[].ports[].name | String | 指定端口名称 | |
spec.containers[].portsl].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参数 (这里前面文章Pod资源限制有讲过) | |
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、Never 1.AIways:Pod 一旦终止运行,则无论容器是如何终止的,kubelet服务都将重启它。 2.OnFailure:只有Pod以非零退出码终止时,kubelet才会重启该容器。如果容器正常结束(退出码为0),则kubelet将不会重启它。 3. Never:Pod终止后,kubelet将退出码报告给Master,不会重启该Pod | Always |
spec.nodeName | String | 将该Pod调度到指定名称的node节点上 | |
spec.nodeSelector | Object | 定义Node的Label过滤标签,以key:value格式指定 | |
spec.imagePullSecrets | Object | 定义pull镜像时使用secret名称,以name:secretkey格式指定 | |
spec.hostNetwork | Boolean | 定义是否使用主机网络模式。设置true表示使用宿主机网络,不使用docker网桥,同时设置了true将无法在同一台宿主机上启动第二个副本 | false |
spec.volumns | List | 在该pod上定义存储卷列表,声明周期和pod相同 | |
spec.affinity | Object | 亲和性,主要用于pod调度,有node亲和性、pod亲和性 |
YAML编写例子:
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: <string> # 设置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
案例和命令
apiVersion: v1
kind: Pod #类型
metadata:
name: myapp-pod #pod的名称
labels: #键值数据,常被用作挑选对象
app: myapp
version: v1
spec:
containers:
- name: app #容器名称
image: hub.zyx.com/library/myapp:v1 #镜像
- name: test
image: hub.zyx.com/library/myapp:v1
kubectl apply -f pod.yaml # 应用yaml
kubectl describe pod myapp-pod # describe 查看pod信息
kubectl logs myapp-pod test # 查看 pod 中指定容器的日志
kubectl get pod -o wide/json/yaml # 以指定的格式输出
kubectl delete podName # 删除pod
kubectl create -f pod.yaml
- kubectl create命令可创建新资源。 因此,如果再次运行该命令,则会抛出错误,因为资源名称在名称空间中应该是唯一的;
- kubectl apply命令将配置应用于资源。 如果资源不在那里,那么它将被创建。 kubectl apply命令可以第二次运行,因为它只是应用如下所示的配置。 在这种情况下,配置没有改变。 所以,pod没有改变。
比如上面的yaml文件就会因为占用同一个端口,其中一个就会报错:
kubectl describe pod myapp-pod
可以发现第二个 test容器报错了。
查看test容器的日志:
kubectl logs myapp-pod test
报错原因就是80端口被占用。
删除 test容器:
vim pod.yaml
apiVersion: v1
kind: Pod #类型
metadata:
name: myapp-pod #pod的名称
labels: #键值数据,常被用作挑选对象
app: myapp
version: v1
spec:
containers:
- name: app #容器名称
image: hub.zyx.com/library/myapp:v1 #镜像
删除正在运行的pod:
kubectl delete myapp-pod # 删除pod
再创建该pod:
kubectl create -f pod.yaml
Pod的生命周期
和一个个独立的应用容器一样,Pod 也被认为是相对临时性(而不是长期存在)的实体。 Pod 会被创建、赋予一个唯一的 ID(UID),并被调度到节点,并在终止(根据重启策略)或删除之前一直运行在该节点。
如果一个节点死掉了,调度到该节点 的 Pod 也被计划在给定超时期限结束后删除。
Pod 自身不具有自愈能力。如果 Pod 被调度到某节点 而该节点之后失效,或者调度操作本身失效,Pod 会被删除;与此类似,Pod 无法在节点资源 耗尽或者节点维护期间继续存活。Kubernetes 使用一种高级抽象,称作 控制器,来管理这些相对而言 可随时丢弃的 Pod 实例。
任何给定的 Pod (由 UID 定义)从不会被“重新调度(rescheduled)”到不同的节点; 相反,这一 Pod 可以被一个新的、几乎完全相同的 Pod 替换掉。 如果需要,新 Pod 的名字可以不变,但是其 UID 会不同。
如果某物声称其生命期与某 Pod 相同,例如存储卷, 这就意味着该对象在此 Pod (UID 亦相同)存在期间也一直存在。 如果 Pod 因为任何原因被删除,甚至某完全相同的替代 Pod 被创建时, 这个相关的对象(例如这里的卷)也会被删除并重建。
一般将pod对象从创建至结束的这段时间范围成为pod的生命周期,它主要包含下面的过程:
-
pod创建过程
-
运行初始化容器(init container)过程(可多可少,可有可无)
-
运行主容器(main container)过程
容器启动后执行的钩子函数(post start),容器终止前执行的钩子函数( pre stop)
容器的存活性探测(liveness probe)、就绪性探测(readiness probe) -
pod终止过程
Pod的创建过程
- 用户通过kubectl或APIServer提供的调用接口将要创建的pod信息提交给apiserver;
- APIServer通过鉴权等后,构建出完整的Pod信息,并将该信息存储到etcd中,然后返回确认信息至客户端;
- apiserver开始反映etcd中的pod对象的变化,其他组件使用watch(监听)机制来跟踪检查apiserver上的变动;
- Scheduler watch(监听)到pod的事件,发现有新的pod创建信息, 随即为该pod分配合适的node,然后调用APIServer的修改接口,将Pod与node绑定;
- node节点上的kubelet watch到pod事件,发现有pod调度过来,尝试调用docker启动容器,并将结果送至apiserver;
- apiserver将接收到的pod状态信息存入etcd中;
APIServer反复出现的原因是因为所有的组件都只和APIServer交互,除此之外并不两两交互
watch是个很重要的功能,Scheduler、Controller-Manager、kubelet组件都通过watch来检测变化做出响应。
运行初始化容器(init container)过程
Init Container就是用来做初始化工作的容器,可以是一个或者多个,如果有多个的话,这些容器会按定义的顺序依次执行,只有所有的Init Container执行完后,主容器才会被启动。我们知道一个Pod里面的所有容器可以共享数据卷和网络命名空间的,所以Init Container里面产生的数据可以被主容器使用到的。
- Pod 能够具有多个容器,应用运行在容器里面,但是它也可能有一个或多个先于应用容器启动的 Init 容器
- Init 容器与普通的容器非常像,除了如下两点:
- Init 容器总是运行到成功完成为止
- 每个 Init 容器都必须在下一个 Init 容器启动之前成功完成
- 不支持 lifecycle、livenessProbe、readinessProbe 和 startupProbe
- 可以访问 应用容器不能访问的 Secret 的权限
- 如果 Pod 的 Init 容器失败,Kubernetes 会不断地重启该 Pod,直到 Init 容器成功为止。然而,如果Pod 对应的 restartPolicy 为 Never,它不会重新启动
init容器作用
因为 Init 容器具有与应用程序容器分离的单独镜像,所以它们的启动相关代码具有如下优势:
- 它们可以包含并运行实用工具,但是出于安全考虑,是不建议在应用程序容器镜像中包含这些实用工具的;
- 它们可以包含使用工具和定制化代码来安装,但是不能出现在应用程序镜像中。例如,创建镜像没必要FROM另一个镜像,只需要在安装过程中使用类似sed、awk、python或dig这样的工具;
- 应用程序镜像可以分离出创建和部署的角色,而没有必要联合它们构建一个单独的镜像;
- Init 容器使用 Linux Namespace,所以相对应用程序容器来说具有不同的文件系统视图。因此,它们能够具有访问 Secret 的权限,而应用程序容器则不能;
- 它们必须在应用程序容器启动之前运行完成,而应用程序容器是并行运行的,所以Init容器能够提供了一种简单的阻塞或延迟应用容器的启动的方法,直到满足了一组先决条件。
Init容器特殊说明
在 Pod 启动过程中,Init 容器会按顺序在网络和数据卷初始化之后启动。每个容器必须在下一个容器启动之前成功退出(网络和数据卷初始化是在 pause)
如果由于运行时或失败退出,将导致容器启动失败,它会根据 Pod 的 restartPolicy 指定的策略进行重试。例如,如果 Pod 的 restartPolicy 设置为 Always,Init容器失败时会不断重试,直到达到他的最大上限为止
在所有的 Init 容器没有成功之前,Pod 将不会变成 Ready 状态。Init 容器的端口将不会在 Service 中进行聚集。正在初始化中的 Pod 处于 Pending 状态,但应该会将 Initializing 状态设置为true
如果 Pod 重启,所有 Init 容器必须重新执行
对 Init 容器 spec 的修改(kubectl edit pod)被限制在容器 image 字段,修改其他字段都不会生效(不会自动重启)。更改 Init 容器的image 字段,会自动重启该 Init 容器,相当于重启 Pod
Init 容器具有应用容器的所有字段。除了 readinessProbe(就绪检测),因为 Init 容器无法定义不同于完成(completion)的就绪(readiness)之外的其他状态。这会在验证过程中强制执行
在 Pod 中的每个 app 和 Init 容器的名称必须唯一;与任何其它容器共享同一个名称,会在验证时抛出错误(同一个 Pod 中 Init 的端口是可以相同的)
init容器实例
apiVersion: v1
kind: Pod
metadata:
name: myapp-pod
labels:
app: myapp
spec:
containers: # 这是主容器
- name: myapp-container
image: busybox # 如果镜像的标签是 latest 且下载策略是 Always,每次使用该镜像都会从远程下载
command: ['sh', '-c', 'echo The app is running! && sleep 3600']
initContainers: # 这是 init 容器
- name: init-myservice
image: busybox
# 循环检测 myservice 域名是否能被解析,如果可以解析,退出循环
command: ['sh', '-c', 'until nslookup myservice; do echo waiting for myservice; sleep 2; done;']
- name: init-mydb
image: busybox
# 循环检测 mydb 是否能被解析,如果可以解析,退出循环
command: ['sh', '-c', 'until nslookup mydb; do echo waiting for mydb; sleep 2; done;']
运行主容器(main container)过程
Start/Stop
Pod hook(钩子)是由 Kubernetes 管理的 kubelet 发起的,当容器中的进程启动前或者容器中的进程终止之前运行,这是包含在容器的生命周期之中。可以同时为 Pod 中的所有容器都配置 hook
Hook 的类型包括两种:①exec:执行一段命令;②HTTP:发送HTTP请求。
apiVersion: v1
kind: Pod
metadata:
name: lifecycle-start-stop-pod
namespace: default
spec:
containers:
- name: readiness-start-stop-container
image: nginx
imagePullPolicy: IfNotPresent
lifecycle:
postStart:
exec:
command: ["/bin/sh","-c","echo Hello from the postStart handler > /usr/share/message"]
preStop:
exec:
command: ["/bin/sh","-c","echo Hello from the postStop handler > /usr/share/message"]
探针
探针是由每一个 Node 上的 kubelet 对容器执行的定期诊断。要执行诊断,kubelet 调用由容器实现的 Handler。有三种类型的处理程序:
- ExecAction:在容器内执行指定命令。如果命令退出时返回码为 0 则认为诊断成功;
- TCPSocketAction:对指定容器端口的IP地址进行 TCP 检查。如端口打开,则诊断被认为是成功的;
- HTTPGetAction:对指定的端口和路径上的容器的IP地址执行 HTTPGet 请求。如果响应的状态码大于等于 200 且小于400,则诊断被认为是成功的。
每次探测都将获得以下三种结果之一:
- 成功:容器通过了诊断。
- 失败:容器未通过诊断。
- 未知:诊断失败,因此不会采取任何行动
探测方案也有两种:
-
readinessProbe: 就绪检测
指示容器是否准备好服务请求。如果就绪探测失败,端点控制器将从与 Pod 匹配的所有 Service 的端点中删除该 Pod 的 IP 地址。初始延迟之前的就绪状态默认为 Failure。如果容器不提供就绪探针,则默认状态为 Success
-
livenessProbe: 生存检测
指示容器是否正在运行。如果存活探测失败,则 kubelet 会杀死容器,并且容器将受到其重启策略的影响。如果容器不提供存活探针,则默认状态为 Success(会随着容器的生命周期一直存在)
区别:readinessProbe 检测成功之后,主容器才能宣布对外能够正常访问,否则状态都是 Failure。而 livenessProbe 跟随着容器的整个生命周期,会循环检测容器中的资源是否可用。
(1)就绪检测 - httpGet
就绪检测 nginx 的 index1.html 存在否,存在的话,就绪检测通过。
apiVersion: v1
kind: Pod
metadata:
name: readiness-httpget-pod
namespace: default
spec:
containers:
- name: readiness-httpget-container
image: wangyanglinux/myapp:v1
imagePullPolicy: IfNotPresent
readinessProbe: # 就绪检测
httpGet: # httpGet 检测方案
port: 80 # 端口 80
path: /index1.html # 请求文件
initialDelaySeconds: 1 # 初始化检测的延时,容器启动 1 之后再开始检测
periodSeconds: 3 # 重试的检测时间
可以看到,容器在运行(Running),但是没有 Ready:
[root@k8s-master01 ~]# kubectl get pod
NAME READY STATUS RESTARTS AGE
readiness-httpget-pod 0/1 Running 0 12s
# 查看日志信息,显示 HTTP 请求状态码为 404
[root@k8s-master01 ~]# kubectl describe pod readiness-httpget-pod
Type Reason Age From Message
---- ------ ---- ---- -------
Warning Unhealthy 75s (x22 over 2m18s) kubelet, localhost.localdomain Readiness probe failed: HTTP probe failed with statuscode: 404
手动进入容器,添加 index1.html 之后:
# 进入容器, 如果 POD 中有多个容器,则需要 -c 指定容器名
# kubectl exec (POD | TYPE/NAME) [-c CONTAINER] [flags] -- COMMAND [args...] [options]
kubectl exec readiness-httpget-pod -it -- /bin/sh
# 添加文件
cd /usr/share/nginx/html/
echo "123" > index1.html
exit
# 查看 Pod,已经 READY
[root@k8s-master01 ~]# kubectl get pod
NAME READY STATUS RESTARTS AGE
readiness-httpget-pod 1/1 Running 0 6m25s
(2)存活检测 - ExecAction
模板说明:pod 创建,容器初始化完成后,创建文件后休眠 60 秒后删除该文件,存活检测在容器创建后延时 1s 进行检测,重试时间间隔 3s。
apiVersion: v1
kind: Pod
metadata:
name: liveness-exec-pod
namespace: default
spec:
containers:
- name: liveness-exec-container
image: busybox
imagePullPolicy: IfNotPresent
# 创建一个文件,休眠 60s,然后把该文件删除
command: ["/bin/sh","-c","touch /temp/live ; sleep 60 ; rm -rf /temp/live; sleep 3600"]
livenessProbe: # 存活检测
exec:
# 检测该文件是还存在, 如果存在,返回值为 0
command: ["test","-e","/temp/live"]
initialDelaySeconds: 1 # 容器启动后延时 1s 再开始检测
periodSeconds: 3 # 每隔 3s 检测一次
容器启动时会创建 /temp/live
文件,60s 之后删除该文件。当 livenessProbe
发现文件不存在,就会重启容器,重启后的容器 60秒之后又会删除 /temp/live
文件,所以容器不断被重启。
(3) 存活检测 - HTTPGetAction
每隔一段时间(3s),检测 nginx 中的 index1.html 能否被访问,如果不能访问,就重启容器。
apiVersion: v1
kind: Pod
metadata:
name: liveness-httpget-pod
namespace: default
spec:
containers:
- name: liveness-httpget-container
image: wangyanglinux/myapp:v1
imagePullPolicy: IfNotPresent
ports:
- name: http
containerPort: 80
livenessProbe:
httpGet:
port: http # http 和 80 等价
path: /index1.html
initialDelaySeconds: 1
periodSeconds: 3
timeoutSeconds: 10 # 最大超时时间
(4) 存活检测 - TCPSocketAction
创建一个 pod,镜像文件是 nginx,存活检测镜像容器中的 nginx(80),使用 tcp 连接,端口指定8080,当探测结果失败时(不可访问),重启容器。
apiVersion: v1
kind: Pod
metadata:
name: liveness-tcp-pod
namespace: default
spec:
containers:
- name: liveness-tcp-container
image: wangyanglinux/myapp:v1
imagePullPolicy: IfNotPresent
livenessProbe:
initialDelaySeconds: 1
timeoutSeconds: 5
periodSeconds: 3
tcpSocket:
port: 8080 # nginx 是 80 端口
Pause容器
其实在初始化容器之前,已经创建了Pause容器,kubernetes中用pause容器来作为一个pod中所有容器的父容器,pause容器又叫Infra(infrastucture container)容器,有以下功能:
作为init pod存在,其他pod都会从pause 容器中fork出来。每个Pod里运行着一个特殊的被称之为Pause的容器,其他容器则为业务容器,这些业务容器共享Pause容器的网络栈和Volume挂载卷,因此他们之间通信和数据交换更为高效,在设计时我们可以充分利用这一特性将一组密切相关的服务进程放入同一个Pod中。
有以下功能:
- PID命名空间:Pod中的不同应用程序可以看到其他应用程序的进程ID,pause容器在每个pod中都作为PID为1进程,并回收僵尸进程
- 网络命名空间:Pod中的多个容器能够访问同一个IP和端口范围。
- IPC命名空间:Pod中的多个容器能够使用SystemV IPC或POSIX消息队列进行通信。
- UTS命名空间:Pod中的多个容器共享一个主机名、Volumes(共享存储卷):
- Pod中的各个容器可以访问在Pod级别定义的Volumes。
Pod的终止过程
-
用户向apiserver发送删除pod对象的命令
-
apiserver中的pod对象信息会随着时间的推移而更新,在宽限期内(默认是30s),pod被视为dead
-
将pod标记为terminating(正在删除)状态
-
kubelet在监控到pod对象转为terminating状态的同时启动pod关闭过程
-
端点控制器监控到pod对象的关闭行为时将其从所有匹配到此端点的service资源的端点列表中移除
-
如果当前pod对象定义了 preStop钩子处理器,则在其标记为terminating后即会以同步的方式启动执行
-
pod对象中的容器进程收到停止信号
-
宽限期结束后,若pod中还存在仍在运行的进程,那么pod对象会收到立即终止的信号
-
kubelet请求apiserver将此pod资源的宽限期设置为0,从而完成删除操作,此时pod对于用户已不可见
Pod状态(phase相位)
取值 | 描述 |
---|---|
Pending (悬决) | Pod 已被 Kubernetes 系统接受,但有一个或者多个容器尚未创建亦未运行。此阶段包括等待 Pod 被调度的时间和通过网络下载镜像的时间。 |
Running (运行中) | Pod 已经绑定到了某个节点,Pod 中所有的容器都已被创建。至少有一个容器仍在运行,或者正处于启动或重启状态。 |
Succeeded (成功) | Pod 中的所有容器都已成功执行并退出,且不会再重启。 |
Failed (失败) | Pod 中的所有容器都已终止,并且至少有一个容器是因为失败终止。也就是说,容器以非 0 状态退出或者被系统终止。 |
Unknown (未知) | 因为某些原因无法取得 Pod 的状态。这种情况通常是因为与 Pod 所在主机通信失败。 |
查看Pod状态:
$ kubectl get pod <pod-name> -o yaml | grep phase
phase: Running
Pod状况(Condition)
可以通过查看Pod
的Condition
列表了解更多信息,pod
的Condition
指示pod
是否已达到某个状态,以及为什么会这样,与状态相反,一个Pod
同时具有多个Conditions。
Pod Condition | 描述 |
---|---|
PodScheduled | 表示pod是否已调度到节点 |
Initialized | Pod的 init 容器都已成功完成 |
ContainersReady | Pod 中所有容器都已就绪 |
Ready | Pod 可以为请求提供服务,并且应该被添加到对应服务的负载均衡池中 |
显示pod的状况
$ kubectl describe po <pod-name> | grep Conditions: -A5
容器状态
Container State | 描述 |
---|---|
Waiting | 容器正在等待启动 |
Running | 容器已创建并且进程正在其中运行,startAt 字段指示此容器启动的时间 |
Terminated | 已在容器中运行的进程已终止,finishedAt 字段指示容器何时终止,主进程终止的退出代码位于exitCode 字段中 |
Unknown | 无法确定容器的状态 |
显示pod的容器状态
$ kubectl describe po <pod-name> | grep Containers: -A15
$ kubectl get po <pod-name> -o json | jq .status.containerStatuses
$ kubectl get po <pod-name> -o json | jq .status