Skip to content

配置中心灰度规则扩展讨论:支持基于 labels 的通用匹配能力 #14695

Closed

Description

@1lck

背景

目前 Nacos 配置中心已经具备灰度发布的基础设施,也已经支持 beta/tag 等内置灰度规则。

不过现有规则类型整体还是偏固定,更多是围绕单一 IP 或单一 tag 的匹配场景。在一些实际使用场景里,灰度分流可能更希望依赖多个请求标签组合来判断,例如:

  • region == 'hz'
  • env == 'prod' && appVersion == '2.3.1'
  • cluster == 'canary' || tenant == 'vip'

问题

在当前规则模型下,这类基于 labels 的组合匹配能力不太容易复用现有灰度规则框架来表达,扩展性也相对有限。

这可能会限制:

  • 更灵活的配置灰度分流策略
  • 后续新增灰度规则类型时的扩展方式
  • 对现有灰度规则基础设施的复用能力

想讨论的方向

我想先讨论一下,是否可以在兼容现有 beta/tag 行为的前提下,扩展一类更通用的基于 labels 的灰度规则能力。

目前的初步想法是:

  1. 保留现有 GrayRule 抽象以及当前灰度发布、查询主链路
  2. 新增一种基于标签表达式的规则类型
  3. 在查询链路中透传请求 labels,并参与灰度匹配
  4. 延续当前按优先级进行规则匹配的方式
  5. 保证既有 beta/tag 灰度能力不受影响

预期收益

如果这个方向可行,我理解它的价值主要在于:

  • 让灰度配置匹配能够支持更灵活的多标签场景
  • 在不破坏现有能力的前提下增强灰度规则体系的扩展性
  • 为后续新增更多规则类型提供统一的扩展入口

这里先提 issue 讨论一下这个方向是否合适。

Activity

  1. shiyiyue1102 commented on Mar 23, 2026

    @shiyiyue1102
    Collaborator

    基于自定义标签灰度的能力在之前灰度模型重构的时候考虑过,可以基于现有的GrayRule进行扩展并且注册API扩展,另外面向客户端侧已经支持设置自定义标签,可以参考下java,python,go版本代码,保证可以无缝适配

  2. 1lck commented on Mar 23, 2026

    @1lck
    ContributorAuthor

    @shiyiyue1102 是的 实现方式与您提出意见一致 请看此PR #14685

  3. KomachiSion commented on Mar 24, 2026

    @KomachiSion
    Collaborator

    自定义实现是否应该以插件形式,而不是嵌入到请求处理流程里? PR的改动甚至修改了入参的内容,这是否意味着未来如果需要其他的gray类型,又得修改入参对象了?

  4. 1lck commented on Mar 24, 2026

    @1lck
    ContributorAuthor

    这次实现里,我是尽量复用现有 GrayRule 体系,所以规则解析和匹配本身是希望沿着现有扩展点做的,label_expr 也是通过 SPI 注册进去的。
    不过您提到的问题很关键:当前 PR 在请求接入层确实还是有一定耦合,尤其是通过扩展入参对象来透传 labels / grayType。
    如果未来继续支持更多 gray 类型,而每次都通过给入参对象加字段来承载规则特有信息,这种方式确实可能会带来扩展性问题。相比之下,更合理的方向可能是:

    1. 保留 GrayRule 作为规则实现扩展点
    2. 请求侧只提供更通用的上下文信息,而不是面向某一种规则增加专用字段
    3. 规则所需的附加信息通过统一的扩展结构承载,而不是持续修改入参对象
  5. added this to the 3.2.2 milestone on May 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions