前提條件

• 已開啟艦隊管理功能。具體操作，請參見開啟艦隊管理功能。

• 艦隊實例已添加多個關聯集群。具體操作，請參見管理關聯集群。

• 已從ACK One控制臺獲取Fleet實例的KubeConfig，并通過kubectl連接至Fleet實例。

• 已授予RAM用戶AliyunAdcpFullAccess權限。具體操作，請參見為RAM用戶授權。

• 已安裝AMC命令行工具。具體操作，請參見AMC命令行幫助。

步驟一（可選）：在艦隊實例中創建命名空間

如果待分發的應用所在的命名空間在艦隊中不存在，您需要先在艦隊實例中創建命名空間，如已存在則跳過此步驟。

使用艦隊實例的KubeConfig連接艦隊實例，執行以下命令，創建示例命名空間demo。

kubectl create namespace demo

步驟二：在艦隊實例中創建應用

此處應用支持ConfigMap、Deployment、Service等資源，本文以分發單獨一個Nginx Deployment為例介紹。

1. 使用以下內容，創建weighted-deployment.yaml文件。

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     namespace: demo  # 分發的應用所在的命名空間。
     name: weighted-deployment
   spec:
     replicas: 3
     selector:
       matchLabels:
         app: weighted-deployment
     template:
       metadata:
         labels:
           app: weighted-deployment
       spec:
         containers:
         - name: nginx
           image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
           ports:
           - containerPort: 80

2. 執行以下命令部署應用。

   kubectl apply -f weighted-deployment.yaml

步驟三：在艦隊實例中創建分發策略為多集群分發應用

您可以通過定義分發策略（PropagationPolicy）選擇需要分發的應用以及對應的集群。創建分發策略后會將匹配到的應用分發到對應集群中。

本文示例：以復制（Duplicated）方式將Deployment weighted-deployment分發到cluster1和cluster2中，兩集群副本數一致，均為3個。

1. 使用以下內容，創建propagationpolicy.yaml文件。

   apiVersion: one.alibabacloud.com/v1alpha1
   kind: PropagationPolicy
   metadata:
     name: weighted-pp
     namespace: demo
   spec:
     resourceSelectors:
     - apiVersion: apps/v1
       kind: Deployment
       name: weighted-deployment
     placement:
       clusterAffinity:
         clusterIds:
         - ${cluster1-id} # 您的集群ID。
         - ${cluster2-id} # 您的集群ID。
       replicaScheduling:
         replicaSchedulingType: Duplicated

   主要參數說明如下，詳細參數說明請參見分發策略。

   參數	說明	參數值
   resourceSelectors	選擇一個或多個待分發的K8s資源。	apiVersion：指定待分發資源的apiVersion，必選。 kind：指定待分發資源的類型，必選。 name：指定待分發資源的名稱。 namespace：指定待分發資源的命名空間。 說明 PropagationPolicy只可以選擇其本身所在命名空間的資源。 labelSelector：通過標簽選擇資源。
   placement	clusterAffinity：指定資源要分發的集群。	通過clusterIds數組直接指明集群ID。更多其他選擇方式請參見分發策略。 說明 此處需填寫集群ID，不是集群名稱。
   	replicaScheduling：指定有副本數資源的調度策略。例如Deployment、StatefulSet、Job。	replicaSchedulingType值為Duplicated，表示會將每個資源都復制到集群中，即每個集群都會有spec.Replicas個副本數。更多說明請參見分發策略。

2. 執行以下命令，創建分發策略。

   kubectl apply -f propagationpolicy.yaml

步驟四（可選）：在艦隊實例中創建差異化策略

您可以通過定義差異化策略（OverridePolicy）選擇需要差異化部署的集群以及資源。創建差異化策略后會將相應的資源進行定制化修改后再部署到選中的集群中。

本文示例：將部署到cluster2的應用進行一些差異化修改，將replicas數修改為1，且將鏡像的registry修改為阿里云的registry。

1. 使用以下內容，創建overridepolicy.yaml文件。

   apiVersion: one.alibabacloud.com/v1alpha1
   kind: OverridePolicy
   metadata:
     name: example
     namespace: demo
   spec:
     resourceSelectors:
       - apiVersion: apps/v1
         kind: Deployment
         name: weighted-pp
     overrideRules:
       - targetCluster:
           clusterNames:
             - ${cluster2-id}   # 需要差異化部署的集群ID。
         overriders:
           plaintext:
             - operator: replace
               path: /spec/replicas
               value: 1
           imageOverrider:
             - component: Registry
               operator: replace
               value: registry.cn-hangzhou.aliyuncs.com

   主要參數說明如下，詳細參數說明請參見差異化策略。

   參數	說明	參數值
   resourceSelector	選擇需要差異化修改的資源。	apiVersion：指定需要差異化修改資源的apiVersion，必選。 kind：指定需要差異化修改的資源類型，必選。 name：指定需要差異化修改的資源名稱。 namespace：指定需要差異化修改的命名空間。 說明 PropagationPolicy只可以選擇其本身所在命名空間的資源。 labelSelector：通過標簽來選擇資源。
   overrideRules	通過一組覆蓋規則修改應用模板。	plaintext：使用JSON Patch的方式修改模板。 imageOverrider：可以修改鏡像的registry、repository、version。

2. 執行以下命令，創建差異化策略。

   kubectl apply -f overridepolicy.yaml

步驟五：查看多集群中應用的狀態

您可以通過以下AMC命令查看應用的多集群分發狀態，也可以直接去關聯集群中查看應用的運行狀態，以確認艦隊應用分發成功。

執行以下命令，查看應用狀態。

kubectl amc get deploy -n demo

預期輸出：

NAME                  CLUSTER          READY   UP-TO-DATE   AVAILABLE   AGE    ADOPTION
weighted-deployment   cxxxxxxxxxxxxx   3/3     3            3           3d4h   Y
weighted-deployment   cxxxxxxxxxxxxx   3/3     3            3           3d4h   Y

預期輸出表明，應用已經分發至指定的集群中。

相關文檔

• 如需對多集群中分發的應用進行統一監控，請參見監控管理。

• 如需實現同城容災功能，請參見基于多集群網關實現同城容災。

• 關于應用分發策略參數詳細信息，請參見分發策略與差異化策略。