容器环境

使用前提

CLI README 给出的镜像示例为 ccr.ccs.tencentyun.com/grpc-kit/cli:0.5.0。该示例比当前 CLI 源码 VERSION 0.5.1 更早,不能据此断言镜像与新模板、Go 1.25.13 或 MCP 功能一致。本轮未拉取镜像验证;优先按本机环境完成当前模板验证。

若团队使用容器工具链,先确认镜像中的 CLI、Go、protoc 和插件版本,并记录镜像 digest:

docker run --rm ccr.ccs.tencentyun.com/grpc-kit/cli:0.5.0 grpc-kit-cli version --short
docker run --rm ccr.ccs.tencentyun.com/grpc-kit/cli:0.5.0 go version

创建项目示例

以下沿用 CLI README 的镜像,不代表当前版本推荐或可用性验证:

docker run --rm -v "$PWD:/usr/local/src" -w /usr/local/src   ccr.ccs.tencentyun.com/grpc-kit/cli:0.5.0   grpc-kit-cli new -t service -p opsaid -s test1

在 test1 目录准备开发配置与 Proto include,然后执行生成、测试和构建。挂载目录中的文件归属可能取决于容器用户。

网络与交付

Linux host 网络示例不能直接套用到 macOS/Windows Docker Desktop。桥接网络下,容器中的 127.0.0.1 指向容器自身;数据库地址、HTTP/gRPC 监听与端口映射必须相应调整。

工具链容器与生产应用容器应分别构建。生产镜像固定构建物和 digest,验证监听、依赖就绪、SIGTERM 与回滚流程,参见部署检查。