MSE Nacos自定义标签灰度

1. 为不同应用设置各自的标签：给应用A的所有服务器分配nacos.config.gray.label=A的标签；给应用B的所有服务器分配nacos.config.gray.label=B。

2. 初步灰度部署：首先，仅针对带有nacos.config.gray.label=A标签的应用A进行新版本的灰度测试。

3. 扩展灰度范围：当确认新版本在应用A上运行良好后，可以通过修改灰度规则（如改为nacos.config.gray.label=A,B），将应用B也纳入到灰度测试中。

1. 将生产环境中的机器划分为多个小组，并分别为这些小组指定不同的标签值，例如nacos.config.gray.label=gray1,nacos.config.gray.label=gray2,nacos.config.gray.label=gray3等。同时，保持未参与灰度测试的正式环境使用nacos.config.gray.label=online作为其标签。

2. 通过调整配置文件中的标签值来控制哪些特定环境或分组能够接收到最新的灰度版本更新。

3. 在每个阶段结束后，根据实际表现逐渐增加更多具有相同标签属性的服务器进入灰度测试流程，直到最终覆盖整个目标群体。

客户端设置应用标签

和设置单个标签类似，客户端可以在properties及JVM参数，环境变量中设置多个标签。

1. 使用Properties属性设置标签：nacos.app.conn.labels=k1=v1,k2=v2,k3=v3

   //1.properties形式传入
   Properties properties = new Properties();
   properties.put(PropertyKeyConst.SERVER_ADDR, "your endpoint");
   properties.put("project.name", "your app name");
   properties.put("nacos.app.conn.labels","app=demo,site=hangzhou-c,otherkey=othervaue");

2. 通过JVM参数设置标签：nacos.app.conn.labels=k1=v1,k2=v2,k3=v3

   //2.JVM参数设置
   设置启动参数-Dnacos.app.conn.labels=app=demo,site=hangzhou-c,otherkey=othervaue

3. 通过环境变量设置标签：nacos_app_conn_labels=k1=v1,k2=v2,k3=v3

   //3.env环境变量指定
   设置环境变量 nacos_app_conn_labels=app=demo,site=hangzhou-c,otherkey=othervaue
   
   NacosConfigService configService = new NacosConfigService(properties);
   
   String dataId = "gray_test_dataid";
   String group = "test-group";
           
   configService.addListener(dataId, group, new Listener() {
           @Override
           public Executor getExecutor() {
               return null;
           }
               
           @Override
           public void receiveConfigInfo(String configInfo) {
               System.out.println("receiveConfig:" + configInfo);
           }
   });

4. 除了通过上述三种参数设置之外，对于较为复杂的标签读取逻辑，还可以选择实现SPI接口来配置标签。Nacos-Client 提供了一个定义自定义应用标签的 SPI 机制。您需要实现 com.alibaba.nacos.common.labels.LabelsCollector 接口，并将其实现类通过在 META-INF/services/ 目录下发布为服务提供者（Service Provider Interface, SPI）。这样做的好处是能够更加灵活地控制和扩展标签的收集与处理逻辑，以适应不同应用场景下的需求。

   自定义配置标签代码示例

   package your.demo.test;
   
   import com.alibaba.nacos.common.labels.LabelsCollector;
   
   import java.util.HashMap;
   import java.util.Map;
   import java.util.Properties;
   
   /**
    * TestLabelsCollector.
    *
    * @author yourname
    */
   public class TestLabelsCollector implements LabelsCollector {
       
       @Override
       public String getName() {
           return "testlables";
       }
       
       @Override
       public Map<String, String> collectLabels(Properties properties) {
           Map<String, String> labels = new HashMap<>();
           labels.put("test", "implements your lables logic");
           return labels;
       }
   
     
       @Override
       public int getOrder() {
           return 1;
       }
   }

注意事项：

为了确保应用程序在使用标签进行灰度发布时能够平稳运行，Nacos对标签的键值做了一些约束：

• 允许字符：标签的键（key）与值（value）部分仅支持使用英文大小写字母、数字、下划线_、短横线-以及点.。任何包含非上述字符的标签将被系统忽略。

• 格式要求：当通过nacos.app.conn.labels参数指定多个键值对时，请确保它们按照k1=v1,k2=v2,k3=v3的格式排列。例如，若输入为k1=v1,k2，则只有k1=v1会被识别，而k2因缺少对应的值而被忽略。

• 数量限制：对于每个应用节点而言，最多可以配置10个标签键值对。一旦超出此数目，系统将随机移除多余的标签。因此，在规划应用所需标签时，请考虑这一上限因素。

此外，在设定灰度发布的匹配规则方面：

当前版本支持基于多个不同的标签值来筛选符合条件的节点列表，但为了降低功能的复杂度，暂不支持在同一灰度规则内同时指定多个标签键进行复合匹配。即，无法直接利用类似k1=v1&&k2=v2或者k1=v1||k2=v2这样的逻辑表达式来精确控制或扩展灰度测试范围。