Lattice Hub 文档

Kubernetes Service 到 Lattice Hub 的同步模型

全量同步、按需同步、annotation 与服务别名的使用场景。

Kubernetes Controller 让 Lattice Hub 可以接入 K8s 生态。核心问题是:哪些 Service 应该同步,如何映射命名空间和服务名,以及如何处理多集群。

全量同步

all 模式适合希望把集群中的 Service 全部纳入服务治理控制面的场景。它部署简单,但需要更谨慎地处理命名空间、噪声服务和权限边界。

按需同步

demand 模式默认不同步,需要通过 Namespace 或 Service annotation 显式开启,更适合渐进接入。

常用注解:

注解作用
polarismesh.cn/synctrue 同步 / false 不同步
polarismesh.cn/aliasService同步时创建的服务别名
polarismesh.cn/aliasNamespace别名所在控制面 Namespace

服务别名

polarismesh.cn/aliasServicepolarismesh.cn/aliasNamespace 可以在同步时创建服务别名,适合兼容历史命名或跨团队访问习惯。别名应有团队约定,避免与真实服务名互相覆盖。

Namespace 语义

控制面 Namespace 表示运行环境,不要把每个 Kubernetes Namespace 直接当成租户。常见做法是把集群 Namespace 映射到业务名,再落到 dev/prod 等环境。

相关文档

On this page