Kubernetes从v1.23版本开始引入了内置的gRPC健康检查功能,v1.23和v1.24如果要使用内置的gRPC健康检查功能的话,需要先启用GRPCContainerProbe feature gate,自v1.25起默认启内置的gRPC健康检查功能。
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-0
command: [ "/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: 2379
livenessProbe:
grpc:
port: 2379
initialDelaySeconds: 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-0
command: [ "/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: 2379
livenessProbe:
exec:
command: ["/bin/grpc_health_probe", "-addr=:2379"]
initialDelaySeconds: 10
服务健康的话,命令行执行后返回的code为0,否则code为非0值。命令行执行一条命令后返回0代表执行成功,非0代表执行失败。