# 就绪探针（Readiness Probe）
一个新Pod创建后，Service就能立即选择到它，并会把请求转发给Pod，那问题就来了，通常一个Pod启动是需要时间的，如果Pod还没准备好（可能需要时间来加载配置或数据，或者可能需要执行一个预热程序之类），这时把请求转给Pod的话，Pod也无法处理，造成请求失败。
为解决上述问题，Kubernetes提供了就绪探针（Readiness Probe）的功能。就绪探针是针对Pod中的每个容器单独配置的，只有所有配置就绪探针的容器都探测成功，Pod才会被标记为"就绪（Ready）"状态。在此状态下，Pod才会被加入到Service的Endpoints列表中，开始接收流量。
Readiness Probe同样是周期性的检测容器，然后根据容器的响应来判断Pod是否就绪，与[Liveness Probe：健康检查机制](https://support.huaweicloud.com/basics-cce/kubernetes_0010.html)相同，就绪探针也支持如下三种类型。
- Exec：通过在容器内执行指定命令，并根据其退出状态码判断容器是否就绪。如果命令执行成功并返回状态码0，则认为容器已就绪；否则视为未就绪。
- HTTP GET：当使用HTTP GET类型的探针时，kubelet会定期向"Pod IP:容器端口"发送HTTP GET请求。若返回的状态码为2xx 或 3xx，则探测成功，容器被视为就绪，可接收流量。否则，容器将被视为未就绪，Service 不会将流量转发给该容器。
- TCP Socket：尝试与容器建立TCP连接，如果能建立连接说明容器已经就绪。
#### Readiness Probe的工作原理
通过Endpoints就可以实现Readiness Probe的效果，当Pod还未就绪时，将Pod的IP:Port从Endpoints中删除，Pod就绪后再加入到Endpoints中，如下图所示。
图1Readiness Probe的实现原理   
![](https://support.huaweicloud.com/basics-cce/zh-cn_image_0259536449.png "点击放大")
#### Exec
Exec方式与HTTP GET方式一致，如下所示，这个探针执行**ls /ready**命令，如果这个文件存在，则返回0，说明Pod就绪了，否则返回其他状态码。
使用以下YAML文件创建Deployment。假设使用的nginx镜像中缺少/ready文件，验证该Deployment中的Pod是否能够就绪。
```
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx
spec:
  replicas: 3
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - image: nginx:alpine
        name: container-0
        resources:
          limits:
            cpu: 100m
            memory: 200Mi
          requests:
            cpu: 100m
            memory: 200Mi
        readinessProbe:      # Readiness Probe
          exec:              # 定义 ls /ready 命令
            command:
            - ls
            - /ready
      imagePullSecrets:
      - name: default-secret
```
将上面Deployment的定义保存到deploy-ready.yaml文件中，删除之前创建的Deployment，用deploy-ready.yaml创建这个Deployment。
```
# kubectl delete deploy nginx
deployment.apps "nginx" deleted
# kubectl create -f deploy-ready.yaml
deployment.apps/nginx created
```
如下所示，nginx镜像不包含/ready这个文件，所以在创建的Pod不在Ready状态，即READY这一列的值为0/1。
```
# kubectl get po
NAME                     READY     STATUS    RESTARTS   AGE
nginx-7955fd7786-686hp   0/1       Running   0          7s
nginx-7955fd7786-9tgwq   0/1       Running   0          7s
nginx-7955fd7786-bqsbj   0/1       Running   0          7s
```
创建Service。
```
apiVersion: v1
kind: Service
metadata:
  name: nginx        
spec:
  selector:          
    app: nginx
  ports:
  - name: service0
    targetPort: 80   
    port: 8080       
    protocol: TCP    
  type: ClusterIP
```
查看Service，发现Endpoints一行的值为空，表示没有Endpoints。
```
$ kubectl describe svc nginx
Name:              nginx
......
Endpoints:         
......
```
如果此时给容器中创建一个/ready的文件，让Readiness Probe成功，则容器会处于Ready状态。再查看Pod和Endpoints，发现创建了/ready文件的容器已经Ready，Endpoints也已经添加。
```
# kubectl exec nginx-7955fd7786-686hp -- touch /ready
# kubectl get po -o wide
NAME                     READY     STATUS    RESTARTS   AGE       IP
nginx-7955fd7786-686hp   1/1       Running   0          10m       192.168.93.169 
nginx-7955fd7786-9tgwq   0/1       Running   0          10m       192.168.166.130
nginx-7955fd7786-bqsbj   0/1       Running   0          10m       192.168.252.160
# kubectl get endpoints
NAME       ENDPOINTS           AGE
nginx      192.168.93.169:80   14d
```
#### HTTP GET
Readiness Probe的配置与[存活探针（liveness probe）](https://support.huaweicloud.com/basics-cce/kubernetes_0010.html)一样，在Pod Template的containers中进行配置。如下所示，该工作负载中涉及3个Pod，且每个Pod中仅涉及一个容器。当每个Pod中的容器探测成功后，Pod将被标记为"就绪（Ready）"状态。
```
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx
spec:
  replicas: 3
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - image: nginx:alpine
        name: container-0
        resources:
          limits:
            cpu: 100m
            memory: 200Mi
          requests:
            cpu: 100m
            memory: 200Mi
        readinessProbe:           # readinessProbe
          httpGet:                # HTTP GET定义
            path: /read
            port: 80
      imagePullSecrets:
      - name: default-secret
```
#### TCP Socket
同样，TCP Socket类型的探针如下所示。
```
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx
spec:
  replicas: 3
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - image: nginx:alpine
        name: container-0
        resources:
          limits:
            cpu: 100m
            memory: 200Mi
          requests:
            cpu: 100m
            memory: 200Mi
        readinessProbe:             # readinessProbe
          tcpSocket:                # TCP Socket定义
            port: 80
      imagePullSecrets:
      - name: default-secret
```
#### Readiness Probe高级配置
与Liveness Probe相同，Readiness Probe也有同样的高级配置选项，上面nginx Pod的describe命令回显如下：
```
Readiness: exec [ls /var/ready] delay=0s timeout=1s period=10s #success=1 #failure=3
```
这一行表示Readiness Probe的具体参数配置，其含义如下：
- delay=0s 表示容器启动后立即开始探测，没有延迟时间
- timeout=1s 表示容器必须在1s内做出相应反馈给probe，否则视为1次探测失败
- period=10s 表示每10s探测一次
- #success=1 探测连续1次成功表示成功
- #failure=3 探测连续3次失败表示失败
这些是创建时默认设置的，您也可以手动配置，如下所示。
```
readinessProbe:      # Readiness Probe
          exec:              # 定义 ls /readiness/ready 命令
            command:
            - ls
            - /readiness/ready
          initialDelaySeconds: 10    # 容器启动后多久开始探测
          timeoutSeconds: 2          # 表示容器必须在2s内做出相应反馈给probe，否则视为探测失败
          periodSeconds: 30          # 探测周期，每30s探测一次
          successThreshold: 1        # 连续探测1次成功表示成功
          failureThreshold: 3        # 连续探测3次失败表示失败
```