声明性集群配置

流程

1. 在 Web 控制台的 Administrator 视角中，进入 Operators → Installed Operators。
2. 从已安装的 Operator 点 Red Hat OpenShift GitOps，再进入 Argo CD 选项卡。
3. 点击您要启用 循环 分片算法的 Argo CD 实例，如 openshift-gitops。

4. 点击 YAML 选项卡并编辑 YAML 文件，如下例所示：

   启用循环分片算法的 Argo CD 实例示例

   apiVersion: argoproj.io/v1beta1
   kind: ArgoCD
   metadata:
     name: openshift-gitops
     namespace: openshift-gitops
   spec:
     controller:
       sharding:
         enabled: true 1
         replicas: 3 2
       env: 3
         - name: ARGOCD_CONTROLLER_SHARDING_ALGORITHM
           value: round-robin
       logLevel: debug 4

   1

   将 shard.enabled 参数设置为 true 以启用分片。

   2

   将副本数量设置为所需的值，例如 3。

   3

   将分片算法设置为 round-robin。

   4

   将日志级别设置为 debug，以便您可以验证每个集群附加的分片。

5. 点击 Save。

   此时会出现一个成功通知警报 openshift-gitops 更新至 <version&gt; 版本。

   注意

   如果您编辑了默认的 openshift-gitops 实例，则会显示 Managed resource 对话框。再次单击 Save 以确认更改。

6. 通过执行以下步骤验证分片是否以 round-robin 作为分片算法启用：

   1. 进入 Workloads → StatefulSets。
   2. 从 Project 下拉列表中选择安装 Argo CD 实例的命名空间。
   3. 点 <instance_name>-application-controller，如 openshift-gitops-application-controller，然后进入 Pods 选项卡。
   4. 观察创建的应用控制器 pod 的数量。它应该与集合副本数对应。

   5. 点您要检查的控制器 pod，并进入 Logs 选项卡来查看 pod 日志。

      控制器 pod 日志片断示例

      time="2023-12-13T09:05:34Z" level=info msg="ArgoCD Application Controller is starting" built="2023-12-01T19:21:49Z" commit=a3vd5c3df52943a6fff6c0rg181fth3248976299 namespace=openshift-gitops version=v2.9.2+c5ea5c4
      time="2023-12-13T09:05:34Z" level=info msg="Processing clusters from shard 1"
      time="2023-12-13T09:05:34Z" level=info msg="Using filter function:  round-robin" 1
      time="2023-12-13T09:05:34Z" level=info msg="Using filter function:  round-robin"
      time="2023-12-13T09:05:34Z" level=info msg="appResyncPeriod=3m0s, appHardResyncPeriod=0s"

      1

      查找 "Using filter function: round-robin" 信息。

   6. 在日志搜索字段中，搜索 分片处理 以验证跨分片的集群分布是否正常，如下例所示。

      重要

      确保将日志级别设置为 debug 以观察这些日志。

      控制器 pod 日志片断示例

      time="2023-12-13T09:05:34Z" level=debug msg="ClustersList has 3 items"
      time="2023-12-13T09:05:34Z" level=debug msg="Adding cluster with id= and name=in-cluster to cluster's map"
      time="2023-12-13T09:05:34Z" level=debug msg="Adding cluster with id=068d8b26-6rhi-4w23-jrf6-wjjfyw833n23 and name=in-cluster2 to cluster's map"
      time="2023-12-13T09:05:34Z" level=debug msg="Adding cluster with id=836d8b53-96k4-f68r-8wq0-sh72j22kl90w and name=in-cluster3 to cluster's map"
      time="2023-12-13T09:05:34Z" level=debug msg="Cluster with id= will be processed by shard 0" 1
      time="2023-12-13T09:05:34Z" level=debug msg="Cluster with id=068d8b26-6rhi-4w23-jrf6-wjjfyw833n23 will be processed by shard 1" 2
      time="2023-12-13T09:05:34Z" level=debug msg="Cluster with id=836d8b53-96k4-f68r-8wq0-sh72j22kl90w will be processed by shard 2" 3

      1 2 3

      在本例中，3 个集群会持续附加到分片 0、分片 1 和 shard 2。

      注意

      如果集群"C"数量是分片副本"R"的数量，则每个分片必须具有相同数量的分配集群 "N"，这等同于"C"除以 "R"。以上示例显示了 3 个集群和 3 个副本，因此每个分片都分配有 1 个集群。

流程

1. 运行以下命令，启用分片并将副本数设置为所需的值：

   $ oc patch argocd <argocd_instance> -n <namespace> --patch='{"spec":{"controller":{"sharding":{"enabled":true,"replicas":<value>}}}}' --type=merge

   输出示例

   argocd.argoproj.io/<argocd_instance> patched

2. 运行以下命令，将分片算法配置为 循环 ：

   $ oc patch argocd <argocd_instance> -n <namespace> --patch='{"spec":{"controller":{"env":[{"name":"ARGOCD_CONTROLLER_SHARDING_ALGORITHM","value":"round-robin"}]}}}' --type=merge

   输出示例

   argocd.argoproj.io/<argocd_instance> patched

3. 运行以下命令，验证 Argo CD Application Controller pod 的数量是否与设置副本数对应：

   $ oc get pods -l app.kubernetes.io/name=<argocd_instance>-application-controller -n <namespace>

   输出示例

   NAME                                        READY   STATUS    RESTARTS   AGE
   <argocd_instance>-application-controller-0   1/1     Running   0          11s
   <argocd_instance>-application-controller-1   1/1     Running   0          32s
   <argocd_instance>-application-controller-2   1/1     Running   0          22s

4. 运行以下命令，使用 round-robin 作为分片算法验证分片是否已启用：

   $ oc logs <argocd_application_controller_pod> -n <namespace>

   输出片断示例

   time="2023-12-13T09:05:34Z" level=info msg="ArgoCD Application Controller is starting" built="2023-12-01T19:21:49Z" commit=a3vd5c3df52943a6fff6c0rg181fth3248976299 namespace=<namespace> version=v2.9.2+c5ea5c4
   time="2023-12-13T09:05:34Z" level=info msg="Processing clusters from shard 1"
   time="2023-12-13T09:05:34Z" level=info msg="Using filter function:  round-robin" 1
   time="2023-12-13T09:05:34Z" level=info msg="Using filter function:  round-robin"
   time="2023-12-13T09:05:34Z" level=info msg="appResyncPeriod=3m0s, appHardResyncPeriod=0s"

   1

   查找 "Using filter function: round-robin" 信息。

5. 通过执行以下步骤验证跨分片的集群分布是否：

   1. 运行以下命令，将日志级别设置为 debug ：

      $ oc patch argocd <argocd_instance> -n <namespace> --patch='{"spec":{"controller":{"logLevel":"debug"}}}' --type=merge

      输出示例

      argocd.argoproj.io/<argocd_instance> patched

   2. 运行以下命令，查看由分片处理 的日志，以观察每个集群附加到的分片：

      $ oc logs <argocd_application_controller_pod> -n <namespace> | grep "processed by shard"

      输出片断示例

      time="2023-12-13T09:05:34Z" level=debug msg="Cluster with id= will be processed by shard 0" 1
      time="2023-12-13T09:05:34Z" level=debug msg="Cluster with id=068d8b26-6rhi-4w23-jrf6-wjjfyw833n23 will be processed by shard 1" 2
      time="2023-12-13T09:05:34Z" level=debug msg="Cluster with id=836d8b53-96k4-f68r-8wq0-sh72j22kl90w will be processed by shard 2" 3

      1 2 3

      在本例中，3 个集群会持续附加到分片 0、分片 1 和 shard 2。

      注意

      如果集群"C"数量是分片副本"R"的数量，则每个分片必须具有相同数量的分配集群 "N"，这等同于"C"除以 "R"。以上示例显示了 3 个集群和 3 个副本，因此每个分片都分配有 1 个集群。

流程

1. 在 OpenShift Container Platform Web 控制台的 Administator 视角中，进入 Operators → Installed Operators。
2. 在 Installed Operators 列表中，选择 Red Hat OpenShift GitOps Operator，然后点 ArgoCD 选项卡。
3. 选择您要为其启用动态扩展分片的 Argo CD 实例名称，如 openshift-gitops。

4. 点 YAML 选项卡，然后编辑并配置 spec.controller.sharding 属性，如下所示：

   启用动态扩展的 Argo CD YAML 文件示例

   apiVersion: argoproj.io/v1beta1
   kind: ArgoCD
   metadata:
     name: openshift-gitops
     namespace: openshift-gitops
   spec:
     controller:
       sharding:
         dynamicScalingEnabled: true 1
         minShards: 1 2
         maxShards: 3 3
         clustersPerShard: 1 4

   1

   将 dynamicScalingEnabled 设置为 true 以启用动态扩展。

   2

   将 minShards 设置为您要具有的最小分片数量。该值必须设置为 1 或更高。

   3

   将 maxShards 设置为您要具有的最大分片数。该值必须大于 minShards 的值。

   4

   将 clusterPerShard 设置为您要为每个分片具有的集群数量。该值必须设置为 1 或更高。

5. 点击 Save。

   此时会出现一个成功通知警报 openshift-gitops 更新至 <version&gt; 版本。

   注意

   如果您编辑了默认的 openshift-gitops 实例，则会显示 Managed resource 对话框。再次单击 Save 以确认更改。

1. 进入 Workloads → StatefulSets。
2. 从 Project 下拉列表中选择部署 Argo CD 实例的命名空间，如 openshift-gitops。
3. 点 Argo CD 实例名称的 StatefulSet 对象的名称，如 openshift-gitops-apllication-controller。
4. 点 Pods 选项卡，然后验证 pod 的数量等于或大于您在 Argo CD YAML 文件中设置的 minShards 值。

流程

1. 以具有 cluster-admin 权限的用户身份登录 oc 工具。

2. 运行以下命令来启用动态扩展：

   $ oc patch argocd <argocd_instance> -n <namespace> --type=merge --patch='{"spec":{"controller":{"sharding":{"dynamicScalingEnabled":true,"minShards":<value>,"maxShards":<value>,"clustersPerShard":<value>}}}}'

   示例命令

   $ oc patch argocd openshift-gitops -n openshift-gitops --type=merge --patch='{"spec":{"controller":{"sharding":{"dynamicScalingEnabled":true,"minShards":1,"maxShards":3,"clustersPerShard":1}}}}' 1

   1

   示例命令为 openshift-gitops 命名空间中的 openshift-gitops Argo CD 实例启用动态扩展，并将最小分片数量设置为 1，将分片的最大数量设置为 3，以及每个分片的集群数量 1。minShard 和 clusterPerShard 的值必须设置为 1 或更高。maxShard 的值必须等于或大于 minShard 的值。

   输出示例

   argocd.argoproj.io/openshift-gitops patched

验证

1. 检查 Argo CD 实例的 spec.controller.sharding 属性：

   $ oc get argocd <argocd_instance> -n <namespace> -o jsonpath='{.spec.controller.sharding}'

   示例命令

   $ oc get argocd openshift-gitops -n openshift-gitops -o jsonpath='{.spec.controller.sharding}'

   启用分片动态扩展时的输出示例

   {"dynamicScalingEnabled":true,"minShards":1,"maxShards":3,"clustersPerShard":1}

2. 可选：通过检查 OpenShift Container Platform web 控制台中的 Argo CD 实例的配置 YAML 文件中的 spec.controller.sharding 属性来验证是否启用了动态扩展。

3. 检查 Argo CD Application Controller pod 的数量：

   $ oc get pods -n <namespace> -l app.kubernetes.io/name=<argocd_instance>-application-controller

   示例命令

   $ oc get pods -n openshift-gitops -l app.kubernetes.io/name=openshift-gitops-application-controller

   输出示例

   NAME                                           READY   STATUS    RESTARTS   AGE
   openshift-gitops-application-controller-0      1/1     Running   0          2m  1

   1

   Argo CD Application Controller pod 的数量必须等于或大于 minShard 的值。