Lattice Hub 文档

gRPC 接口

Discovery gRPC(8091)与 Config gRPC(8093)入口;契约细节指向 Specification。

控制面为客户端提供两组原生 gRPC 入口。消息类型与 RPC 定义在 pole-io/specification,本页只说明端口、用途与和 HTTP 的分工

入口

插件默认端口契约重心典型消费者
service-grpc8091DiscoverGRPC:注册、发现、心跳、治理/契约视图Rust SDK、其他 gRPC 客户端
config-grpc8093ConfigGRPC:配置文件创建、更新、发布与发现配置客户端 / SDK

TLS、连接限制等见各插件 optiontlsconnLimitenableCacheProto 等)。

与 HTTP API 的关系

能力HTTP(8090)gRPC(8091 / 8093)
Console 管理 CRUD/naming/v1/config/v1/core/v1不以 gRPC 暴露完整 Console 面
客户端 Discover / Register / Heartbeat/naming/v1/Discoverservice-grpc 主路径
配置客户端/config/v1 client 分组config-grpc 主路径
MCP / A2A Registry 管理/ai/mcp/v1/ai/a2a/v1管理 API 在 HTTP 侧

SDK 接入优先走 gRPC;自动化脚本与 Console 同源调用优先走 HTTP OpenAPI

契约模块(入口索引)

完整模块表见 Specification。与 gRPC 直接相关的包括:

  • api/v1/service_manageDiscoverGRPC、实例、客户端、服务契约
  • api/v1/config_manageConfigGRPC
  • api/v1/traffic_manage / fault_tolerance / security:Discover 可下发的治理与身份相关视图

Discover 可请求的资源类型包括 Namespaces、Services、Instances、Service Contracts、九类治理规则、Service Identity 等。

鉴权边界

gRPC 入口提取凭证后进入与 HTTP 相同的领域 Server + auth interceptor。管理鉴权与工作负载凭证分离;数据面凭证 Header 约定为 x-pole-workload-credential,不得与 Console/API 管理 token 混用。详见 鉴权链与资源映射 与 Specification 安全约定。

相关组件

On this page