kubenetes - 学习笔记（二）资源清单

1、资源清单

k8s 中所有内容都抽象为资源，所有资源实例化之后叫做抽象

1.1 名称空间级别

工作负载资源（workload）：Pod、ReplicaSet、Deployment、StatefulSet、DaemonSet、Job、CronJob（ReolicationController 在v1.11版本被废弃）

服务发现及负载均衡型资源（ServiceDiscovery LoadBalance）：Service、Ingress、…

配置与存储型资源：Volume（存储卷）、CSI（容器存储接口，可以扩展各种第三方存储卷）

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

1.2 资源清单

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

1.3 常用字段解释说明

参数	字段类型	说明
version	String	这里指的是K8S API的版本，目前基本上是V1，可以用kubectl api-versions命令查询
kind	String	这里指的是yaml文件定义的资源类型和角色，比如Pod
metadata	Object	元数据对象，固定值就写metadat
metadata.name	String	元数据对象的名字，这里由我们编写，比如命名Pod的名字
metadata.namespace	String	元数据对象的命名空间，由我们自身定义
Spec	Object	详细定义对象，固定值就写Spec
spec.containers[]	List	这里是Spec对象的容器列表定义，是个列表
spec.containers[].name	String	这里定义容器的名字
spec.containers[].image	String	这里定义要用到的镜像名称
spec.containers[].imagePullPolicy	String	定义镜像拉去策略，有Always、Nerver、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	String	设置存储卷路径的读写模式，true或者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.limiits	Object	指设置容器运行时资源的运行上限
spec.containers[].resources.limiits.cpu	String	指定CPU的限制，单位为core数，将用于docker run --cpu-shares参数（这里前面文章Pod资源限制中提到过）
spec.containers[].resources.requests	Object	指定容器启动和调度时的限制设置
spec.containers[].resources.requests.cpu	String	CPU请求，单位为core数，容器启动时初始化可用数量
spec.containers[].resources.requests.memory	String	内存请求，单位为MIB、GIB，容器启动的初始化可用数量
spec.restartPoliy	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.imagePullSecrets	Object	定义pull镜像时使用secret名称，以name:secretkey格式指定
spec.hostNetwork	Boolean	定义是否使用主机网络模式，默认值false，这只true表示使用宿主机网络，不使用docker零网桥，同时设置true将无法在同一台宿主机上启动第二个副本

1.4 容器的生命周期

Readiness: 就绪检测、Liveness：生存检测

Init 容器（初始化容器）

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

Init容器与普通的容器非常像，处理如下两点：

• Init容器总是运行到成功完成为止；

• 每个Init容器都必须在下一个Init容器启动之前成功完成；

如果Pod的Init容器失败，kubernetes会不断的重启改Pod，直到Init容器成功为止。然而如果Pod对应的restartPolicy为Never，则不会重新启动；

Init 容器的作用

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

• 他们可以包含并运行实用工具，但是出于安全考虑，是不建议在应用程序容器镜像中包含这些工具的；
• 他们可以包含使用工具和定制化代码来安装，但是不能出现现在应用程序镜像中。例如，创建镜像没有必要FROM另一个镜像，只需要在安装过程中使用雷速sed、awk、python 或 dig 这样的工具；
• 应用镜像可以分离创建和部署的角色，而没有必要联合它们构建一个单独的镜像；
• Init 容器使用Linux NameSpace 的权限，所以相对应用程序容器来说具有不同的文件系统视图。因此，它们能够具有访问 Secret 的权限，而应用程序容器则不能
• 它们必须在应用程序容器启动之前运行完成，而应用程序容器是并行运行的，所以 Init 容器能够提供一种简单的阻塞或延迟应用容器的启动发发，知道满足了一组先决条件；

# init 模板 init-pod.yaml
apiVersion: v1
kind： Pod
metadata:
  name: myapp-pod
  labels:
    app: myapp
spec:
  containers:
  	- name: myapp-container
  	  image: busybox
  	  command: ['sh', '-c', 'echo The app is running ! && sleep 3600']
  initContainers:
    - name: init-myservice
      image: busybox
      command: ['sh', '-c', 'until nslookup myservice; do echo waiting for myservice; sleep 2; done;']
    - name: init-mydb
      image: busybox
      command: ['sh', '-c', 'until nslookup mydb; do echo waiting for mydb; sleep 2; done;']

[root@k8s-master ~]# kubectl create -f init-pod.yaml 
[root@k8s-master ~]# kubectl get pod
NAME        READY   STATUS     RESTARTS   AGE
myapp-pod   0/1     Init:0/2   0          8s

# 查看启动日志
[root@k8s-master ~]# kubectl log myapp-pod -c init-myservice
log is DEPRECATED and will be removed in a future version. Use logs instead.
Server:		10.96.0.10
Address:	10.96.0.10:53

** server can't find myservice.default.svc.cluster.local: NXDOMAIN

*** Can't find myservice.svc.cluster.local: No answer
*** Can't find myservice.cluster.local: No answer
*** Can't find myservice.default.svc.cluster.local: No answer
*** Can't find myservice.svc.cluster.local: No answer
*** Can't find myservice.cluster.local: No answer

waiting for myservice
Server:		10.96.0.10
Address:	10.96.0.10:53

** server can't find myservice.default.svc.cluster.local: NXDOMAIN

*** Can't find myservice.svc.cluster.local: No answer
*** Can't find myservice.cluster.local: No answer
*** Can't find myservice.default.svc.cluster.local: No answer
*** Can't find myservice.svc.cluster.local: No answer
*** Can't find myservice.cluster.local: No answer
# 轮询启动

# myservice.yaml
kind: Service
apiVersion: v1
metadata:
  name: myservice
spec:
  ports:
  - protocol: TCP
    port: 80
    targetPort: 9376

[root@k8s-master ~]# kubectl create -f myservice.yaml 
service/myservice created
[root@k8s-master ~]# kubectl get pod
NAME        READY   STATUS     RESTARTS   AGE
myapp-pod   0/1     Init:1/2   0          16m
[root@k8s-master ~]# kubectl get svc
NAME         TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)   AGE
kubernetes   ClusterIP   10.96.0.1       <none>        443/TCP   12d
myservice    ClusterIP   10.100.161.29   <none>        80/TCP    68s

# ------
# init-mydb.yaml
kind: Service
apiVersion: v1
metadata:
  name: mydb
spec:
  ports:
  - protocol: TCP
    port: 80
    targetPort: 9377

[root@k8s-master ~]# kubectl create -f mydb.yaml 
^C[root@k8s-master ~]# kubectl get pod
NAME        READY   STATUS    RESTARTS   AGE
myapp-pod   1/1     Running   0          30m

Init C 特殊说明

• 在 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 容器的名称必须唯一；与任何其他容器共享同一个名称，会在验证时抛出错误；

容器探针

探针是由 kubelet 对容器执行的定期诊断，要执行诊断，kubelet 调用由容器实现的 Handler。有三中类型的处理程序：

• ExecAction：在容器执行指定命令。如果命令退出时返回码为 0 则认为诊断成功；
• TCPSocketAction：对指定端口上的容器和路径上的容器的IP地址执行 HTTP Get 请求。如果响应状态码等于 200 且小于 400 ，则诊断被认为时成功的；

每次探测都将获得以下三种结果之一：

• 成功：容器通过诊断；
• 失败：容器未通过诊断；
• 未知：诊断失败，因此不会采取任何行动；

探针方式

LivenessProbe：指示容器是否正在运行。如果存活探测失败，则 kubelet 会杀死容器，并且容器将受到其重启策略的影响。如果容器不提供存活探针，则默认状态未success；

readinessProbe：指示容器是否准备好服务请求。如果就绪探测失败，端点控制器将从与 Pod 匹配的所有 Service 的端点中删除该 Pod 的 IP 地址。初始延迟之前的就绪状态默认 Failure。如果容器不提供就绪探针，则默认状态未success；

探针检测 - 就绪检测 （readinessProbe-httpget）

apiVersion: v1
kind: Pod
metadata:
	name: readiness-httpget
	namespace: default
spec:
	containers:
	- name: readiness-httpget
	  image: hub.atguigu.com/library/myapp:v1
      imagePullPolicy: IfNotPresent
      readinessProbe:
      	httpGet:
      		port: http
      		path: /index1.html
      	initalDelaySeconds: 1
        periodSeconds: 3	

[root@k8s-master ~]# kubectl create -f readness.yaml 
pod/readiness-httpget-pod created
[root@k8s-master ~]# kubectl get pod
NAME                    READY   STATUS    RESTARTS   AGE
myapp-pod               1/1     Running   11         3d20h
readiness-httpget-pod   0/1     Running   0          11s
# Running 未就绪状态 READY 0/1
# 查看describe
[root@k8s-master ~]# kubectl describe pod readiness-httpget-pod
Name:         readiness-httpget-pod
Namespace:    default
Priority:     0
Node:         k8s-node01/192.168.66.21
Start Time:   Mon, 19 Jul 2021 14:25:37 +0800
Labels:       <none>
Annotations:  <none>
Status:       Running
IP:           10.244.1.11
Containers:
  readiness-httpget-containers:
    Container ID:   docker://e6a1998a7e52382e2c0c276d4eeec6da37ed338e1d6e43a85c67b9e0020744ec
    Image:          hub.atguigu.com/library/myapp:v1
    Image ID:       docker-pullable://hub.atguigu.com/library/myapp@sha256:9eeca44ba2d410e54fccc54cbe9c021802aa8b9836a0bcf3d3229354e4c8870e
    Port:           <none>
    Host Port:      <none>
    State:          Running
      Started:      Mon, 19 Jul 2021 14:25:39 +0800
    Ready:          False
    Restart Count:  0
    Readiness:      http-get http://:80/index1.html delay=1s timeout=1s period=3s #success=1 #failure=3
    Environment:    <none>
    Mounts:
      /var/run/secrets/kubernetes.io/serviceaccount from default-token-8j4bm (ro)
Conditions:
  Type              Status
  Initialized       True 
  Ready             False 
  ContainersReady   False 
  PodScheduled      True 
Volumes:
  default-token-8j4bm:
    Type:        Secret (a volume populated by a Secret)
    SecretName:  default-token-8j4bm
    Optional:    false
QoS Class:       BestEffort
Node-Selectors:  <none>
Tolerations:     node.kubernetes.io/not-ready:NoExecute for 300s
                 node.kubernetes.io/unreachable:NoExecute for 300s
Events:
  Type     Reason     Age                 From                 Message
  ----     ------     ----                ----                 -------
  Normal   Scheduled  93s                 default-scheduler    Successfully assigned default/readiness-httpget-pod to k8s-node01
  Normal   Pulled     92s                 kubelet, k8s-node01  Container image "hub.atguigu.com/library/myapp:v1" already present on machine
  Normal   Created    92s                 kubelet, k8s-node01  Created container readiness-httpget-containers
  Normal   Started    91s                 kubelet, k8s-node01  Started container readiness-httpget-containers
  Warning  Unhealthy  26s (x22 over 89s)  kubelet, k8s-node01  Readiness probe failed: HTTP probe failed with statuscode: 404
# 显示 statuscode：404
# 进入容器添加index1.html 文件
[root@k8s-master ~]# kubectl exec readiness-httpget-pod -it  -- /bin/sh
/ # cd /usr/share/nginx/
/usr/share/nginx # cd html/
/usr/share/nginx/html # ls
50x.html    index.html
/usr/share/nginx/html # echo "12345" >> index1.html
/usr/share/nginx/html # exit
[root@k8s-master ~]# kubectl get pod
NAME                    READY   STATUS    RESTARTS   AGE
readiness-httpget-pod   1/1     Running   0          2m58s
# 添加index1.html文件后 READY 1/1（就绪检测）

检测探针 - 存活检测（livenessProbe-exec）

apiVersion: v1
kind: Pod
metadata:
  name: liveness-exec-pod
  namespace: default
spec:
  containers:
  - name: liveness-exec-container
    image: hub.atguigu.com/library/myapp:v1
    imagePullPolicy: IfNotPresent
    command: ["/bin/sh", "-c", "touch /tmp/live; sleep 60; rm -rf /tmp/live; sleep 3600"]
    livenessProbe:
      exec:
        command: ["test", "-e", "/tmp/live"]
      initialDelaySeconds: 1
      periodSeconds: 3	

[root@k8s-master ~]# kubectl create -f livenessProbe.yaml 
pod/liveness-exec-pod created
[root@k8s-master ~]# kubectl get pod
NAME                READY   STATUS    RESTARTS   AGE
liveness-exec-pod   1/1     Running   0          5s
[root@k8s-master ~]# kubectl get pod -w
NAME                READY   STATUS    RESTARTS   AGE
liveness-exec-pod   1/1     Running   0          12s
liveness-exec-pod   1/1     Running   1          98s
liveness-exec-pod   1/1     Running   2          3m18s

livenessProbe-httpget

apiVersion: v1
kind: Pod
metadata:
  name: liveness-httpget-pod
  namespace: default  # 名称空间 default
spec:
  containers:
  - name: liveness-httpget-container
    image: hub.atguigu.com/library/myapp:v1
    imagePullPolicy: IfNotPresent     #镜像下载策略，如果本地存在就不去下载
    ports:
    - name: http
      containerPort: 80
    livenessProbe:
      httpGet:
        port: http
        path: /index.html      # 检测文件是否存在
      initialDelaySeconds: 1   # 延迟一秒检测
      periodSeconds: 3                # 轮询三秒检测
      timeoutSeconds: 10

[root@k8s-master ~]# kubectl create -f liveness-httpget.yaml 
pod/liveness-httpget-pod created
[root@k8s-master ~]# kubectl get pod
NAME                   READY   STATUS    RESTARTS   AGE
liveness-httpget-pod   1/1     Running   0          6s
# 进入容器删除index.html文件
[root@k8s-master ~]# kubectl exec liveness-httpget-pod -it -- /bin/sh
/ # rm -rf /usr/local/
bin/    lib/    share/
/ # rm -rf /usr/share/nginx/html/index.html 
/ # exit
[root@k8s-master ~]# kubectl get pod -w
NAME                   READY   STATUS    RESTARTS   AGE
liveness-httpget-pod   1/1     Running   1          2m40s
# 重启数量变更

livenessProbe-tcp

apiVersion: v1
kind: Pod
metadata:
  name: probe-tcp
spec:
  containers:
  - name: nginx
    image: hub.atguigu.com/library/myapp:v1
    livenessProbe:
      initialDelaySeconds: 5 	# 延迟检测时间5秒
      timeoutSeconds: 1		# 超时时间
      periodSeconds: 3	# 重试时间3秒
      tcpSocket:
        port: 8080		# 检测8080端口错误的端口

启动、退出动作

apiVersion: v1
kind: Pod
metadata:
  name: lifecycle-demo
spec:
  containers:
  - name: lifecycle-demo-container
    image: nginx
    lifecycle:
      postStart:
        exec:
          command: ["bin/sh", "-c", "echo Hello from the postStart handler > /user/share/message"]
      proStop:
        exec:
          command: ["usr/sbin/nginx", "-s", "quit"]

Pod phase 可能存在的值
挂起（pending）：Pod 已被 kubernetes 系统接受，但有一个或者多个容器镜像尚未创建。等待时间包括调度Pod的时间和通过网络下载镜像的时间，这可能需要花点时间
运行中（running）：该Pod已经绑定到一个节点上，Pod 中所有的容器都已被创建。至少有一个容器正在运行，或者正处于启动或重启状态；
成功（Succeeded）：Pod 中的所有容器都被成功终止，并且不会再重启；
失败（Failed）: Pod 中的所有容器都已经终止，并且至少有一个容器时因为失败终止。也就是说容器非 0 状态瑞出或者被系统终止；
未知（Unknown）：因为某些原因无法取得Pod的状态，通常是因为与Pod所在主机通信失败；