namely/grpc-cli

grpc_cli Docker镜像文档

镜像概述和主要用途

本镜像捆绑了来自https://github.com/grpc/grpc/blob/master/doc/command_line_tool.md%E7%9A%84%E6%A0%87%E5%87%86%60grpc_cli%60%E5%B7%A5%E5%85%B7%E3%80%82%60grpc_cli%60%E6%98%AF%E4%B8%80%E4%B8%AA%E5%91%BD%E4%BB%A4%E8%A1%8C%E5%B7%A5%E5%85%B7%EF%BC%8C%E7%94%A8%E4%BA%8E%E4%B8%8EgRPC%E6%9C%8D%E5%8A%A1%E8%BF%9B%E8%A1%8C%E4%BA%A4%E4%BA%92%EF%BC%8C%E5%8F%AF%E5%8F%91%E9%80%81%E8%AF%B7%E6%B1%82%E3%80%81%E6%9F%A5%E7%9C%8B%E6%9C%8D%E5%8A%A1%E5%AE%9A%E4%B9%89%E5%B9%B6%E8%B0%83%E8%AF%95gRPC%E6%8E%A5%E5%8F%A3%E3%80%82%E6%9C%AC%E9%95%9C%E5%83%8F%E6%97%A0%E9%9C%80%E5%9C%A8%E6%9C%AC%E5%9C%B0%E5%AE%89%E8%A3%85%60grpc_cli%60%EF%BC%8C%E9%80%9A%E8%BF%87Docker%E5%AE%B9%E5%99%A8%E5%8D%B3%E5%8F%AF%E5%BF%AB%E9%80%9F%E4%BD%BF%E7%94%A8%E8%AF%A5%E5%B7%A5%E5%85%B7%E3%80%82

核心功能和特性

• 包含官方标准grpc_cli工具，支持所有grpc_cli命令（如call、ls、describe等）
• 支持挂载本地目录到容器内/defs路径，便于读取本地.proto文件
• 轻量级设计，简化gRPC服务调试流程
• 跨平台兼容，支持通过特定主机名访问宿主机服务

使用场景和适用范围

• 开发环境中快速测试gRPC服务接口功能
• 调试gRPC服务端与客户端之间的通信问题
• 验证.proto文件定义与服务实现的一致性
• 在没有本地安装grpc_cli的环境中临时使用该工具

详细使用方法和配置说明

基本使用方法

1. 挂载本地目录：将当前工作目录挂载到容器内/defs路径，以便grpc_cli读取本地.proto文件：

bash
docker run -v `pwd`:/defs --rm -it namely/grpc-cli [命令]

2. 访问宿主机服务：由于命令在容器内运行，需使用以下主机名访问宿主机的gRPC服务：
   • macOS：docker.for.mac.localhost
   • Windows：docker.for.win.localhost

示例：调用gRPC服务

以下示例演示如何调用LinkShortener服务的ResolveShortLink方法：

bash
docker run -v `pwd`:/defs --rm -it namely/grpc-cli call docker.for.mac.localhost:50051 \
  LinkShortener.ResolveShortLink "short_link:'asdf'" --protofiles=link_shortener.proto

创建命令别名（推荐）

为简化重复使用，可定义别名：

bash
alias grpc_cli='docker run -v `pwd`:/defs --rm -it namely/grpc-cli'

注意：使用单引号避免pwd参数在定义别名时被提前展开

定义别名后，可直接使用：

bash
grpc_cli call docker.for.mac.localhost:50051 LinkShortener.ResolveShortLink "short_link:'asdf'" --protofiles=link_shortener.proto