grpc/java-example-hostname Docker 镜像 - 轩辕镜像

grpc-java 主机名示例服务镜像

镜像概述

本镜像基于 grpc-java 的示例实现，提供一个 Greeter 服务，其核心功能是响应客户端请求并返回服务器的主机名。该服务主要用于测试负载均衡场景，同时内置健康检查服务和反射服务，便于服务监控与调试。

核心功能和特性

• 主机名返回：作为 Greeter 服务的核心能力，可向客户端返回当前服务器的主机名，用于识别请求分发目标
• 健康服务：内置健康检查接口，支持监控服务运行状态
• 反射服务：提供 gRPC 反射功能，便于客户端动态发现服务接口定义，简化调试和集成流程

使用场景和适用范围

• 负载均衡测试：在分布式部署环境中，验证负载均衡策略（如轮询、加权等）是否正常工作，通过主机名区分不同后端实例
• 服务部署验证：检查服务实例是否正确部署并可被访问，确认主机名与预期部署环境一致
• 服务监控集成：配合健康检查服务，实现对服务可用性的实时监控

使用方法和配置说明

获取镜像

该服务基于 grpc-java 示例实现，可通过以下方式获取或构建镜像：

1. 从源码构建：访问 源码仓库，按照说明构建 Docker 镜像
2. 从容器仓库拉取：若已发布至容器仓库，可直接拉取（具体镜像名称需参考实际仓库信息）

启动服务

使用 docker run 命令启动容器，默认暴露 gRPC 服务端口（通常为 50051）：

bash
docker run -d -p 50051:50051 --name grpc-hostname-service [镜像名称]:[标签]

• -p 50051:50051：将容器内的 gRPC 服务端口映射到主机，允许外部客户端访问
• --name：指定容器名称，便于管理

服务调用示例

使用 gRPC 客户端工具（如 grpcurl）调用 Greeter 服务：

bash
grpcurl -plaintext localhost:50051 helloworld.Greeter/SayHello

预期响应将包含当前服务器的主机名信息。

健康检查

通过健康服务接口检查服务状态：

bash
grpcurl -plaintext localhost:50051 grpc.health.v1.Health/Check

配置参数

当前版本暂无特殊环境变量或配置参数，服务启动后即可按默认配置运行。

源码参考

服务源码及更多实现细节可参考：grpc-java 示例仓库