amothic/grpc-health-probe

docker-grpc-health-probe 镜像文档

镜像概述

基于Scratch的轻量级Docker镜像，仅包含grpc-health-probe工具，用于对gRPC服务进行健康状态检查。Scratch基础镜像确保镜像体积最小化，适合在容器化环境中高效部署和使用。

核心功能和特性

• 轻量级设计：基于Scratch镜像构建，无多余依赖，镜像体积极小
• 专注功能：仅包含grpc-health-probe工具，专注于gRPC服务健康检查
• 简单易用：通过命令行参数直接指定目标gRPC服务地址即可执行检查

使用场景和适用范围

适用于需要对gRPC服务进行健康状态监控的场景，包括但不限于：

• 容器化gRPC服务的健康检查
• Kubernetes环境中gRPC服务的存活探针（liveness probe）和就绪探针（readiness probe）配置
• 本地开发和测试环境中验证gRPC服务可用性

使用方法和配置说明

基本使用

通过docker run命令运行镜像，指定目标gRPC服务地址：

console
$ docker run --rm amothic/grpc-health-probe -addr=localhost:5000

连接宿主机服务

在容器中检查宿主机上运行的gRPC服务时，可使用host.docker.internal作为主机名：

console
$ docker run --rm amothic/grpc-health-probe -addr=host.docker.internal:5000

命令行参数说明

• -addr：必选参数，指定目标gRPC服务的地址（格式为host:port）

许可证

MIT License