Microservices Engine：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這樣的邏輯運算式來精確控制或擴充灰階測試範圍。