grpc-health-probe-rs

是grpc-health-probe的Rust实现。它允许您查询通过gRPC健康检查协议公开其状态的gRPC服务的健康状态。

此命令行工具会对/grpc.health.v1.Health/Check执行RPC调用。如果它返回SERVING状态，则grpc_health_probe将成功退出，否则它将以非零退出代码退出（下面有文档说明）。

此端口不提供跳过TLS验证的方法，并且配置TLS的选项有限。

安装

从二进制文件安装

您可以直接下载grpc_health_probe可执行文件。

从crates.io安装

cargo install grpc_health_probe

手动构建

克隆仓库并运行

cargo install --path .

或者，运行

cargo build --release

然后将生成的target/release/grpc_health_probe可执行文件添加到您的PATH中。

示例

$ grpc_health_probe --addr=https://127.0.0.1:5000
status: Serving

$ grpc_health_probe --addr=https://127.0.0.1:9999 --connect-timeout=250 --rpc-timeout=100
error: health rpc failed: Timeout expired

示例：Kubernetes上的gRPC健康检查

您可以将grpc_health_probe二进制文件打包到您的容器镜像中，并使用exec探针定义您的gRPC服务器Pod的生命周期和/或就绪性检查。

spec:
  containers:
  - name: server
    image: "[YOUR-DOCKER-IMAGE]"
    ports:
    - containerPort: 5000
    readinessProbe:
      exec:
        command: [
          "/bin/grpc_health_probe",
          "--addr=https://0.0.0.0:5000",
          "--service=queries.v1.QueriesAPI",
          "--tls",
          "--tls-server-name=deployment.namespace.svc.cluster.local"
        ]
      initialDelaySeconds: 5
    livenessProbe:
      exec:
        command: [
          "/bin/grpc_health_probe",
          "--addr=https://0.0.0.0:5000",
          "--service=queries.v1.QueriesAPI",
          "--tls",
          "--tls-server-name=deployment.namespace.svc.cluster.local"
        ]
      initialDelaySeconds: 10

健康检查TLS服务器

其他可用标志

退出代码

不建议依赖于特定的退出状态。任何失败都将是一个非零退出代码。