kubernetes中的gRPC服务健康检查

kubernetes中配置gRPC服务健康检查主要是配置gRPC服务的livenessProbe（存活探针）。Kubernetes从v1.23版本开始引入了内置的gRPC健康检查功能，v1.23和v1.24如果要使用内置的gRPC健康检查功能的话，需要先启用GRPCContainerProbe feature gate，自v1.25起默认启内置的gRPC健康检查功能。在v1.23版本之前需要借助grpc-health-probe这款社区开发的工具来实现gRPC服务的livenessProbe配置。

接下来就分别演示一下使用内置的gRPC健康检查工具和使用grpc-health-probe配置livenessProbe的方法，前提是你的gRPC服务实现了gRPC健康检查协议（具体方法可以参考我之前的文章



《gRPC服务健康检查（一）：Golang项目集成服务健康检查代码》



）。

使用内置的gRPC健康检查工具配置livenessProbe

看一个示例

apiVersion: v1
kind: Pod
metadata:
  name: etcd-with-grpc
spec:
  containers:
  - name: etcd
    image: registry.k8s.io/etcd:3.5.1-0command: [ "/usr/local/bin/etcd", "--data-dir",  "/var/lib/etcd", "--listen-client-urls", "http://0.0.0.0:2379", "--advertise-client-urls", "http://127.0.0.1:2379", "--log-level", "debug"]
    ports:
    - containerPort: 2379livenessProbe:
      grpc:
        port: 2379initialDelaySeconds: 10

配置gRPC服务的livenessProbe的话，port是必须配置的。一定要确保配置的端口和检查的服务是正确的，确保gRPC服务实现了gRPC健康检查协议。

可以使用如下命令来创建一个pod体验下gRPC健康检查功能：

kubectl apply -f https://k8s.io/examples/pods/probe/grpc-liveness.yaml

使用grpc-health-probe工具配置livenessProbe

grpc-health-probe（

https://github.com/grpc-ecosystem/grpc-health-probe/



）是一个开源的用于gRPC服务健康检查的工具。

使用grpc-health-probe的话，需要把这个工具的二进制文件打到容器镜像里面，可以到release页面下载要使用的版本（

https://github.com/grpc-ecosystem/grpc-health-probe/releases



）。

看个例子：

apiVersion: v1
kind: Pod
metadata:
  name: etcd-with-grpc
spec:
  containers:
  - name: etcd
    image: registry.k8s.io/etcd:3.5.1-0command: [ "/usr/local/bin/etcd", "--data-dir",  "/var/lib/etcd", "--listen-client-urls", "http://0.0.0.0:2379", "--advertise-client-urls", "http://127.0.0.1:2379", "--log-level", "debug"]
    ports:
    - containerPort: 2379livenessProbe:
      exec:
        command: ["/bin/grpc_health_probe", "-addr=:2379"]
      initialDelaySeconds: 10

服务健康的话，命令行执行后返回的code为0，否则code为非0值。命令行执行一条命令后返回0代表执行成功，非0代表执行失败。