19.17. GitOps ZTP 故障排除

流程

1. 使用以下命令之一检查 SiteConfig 到 hub 集群的同步：

   $ oc get siteconfig -A

   或者

   $ oc get siteconfig -n clusters-sub

   如果缺少 SiteConfig，则出现以下情况之一：

   • clusters 应用程序无法将 CR 从 Git 存储库同步到 hub。使用以下命令验证以下内容：

     $ oc describe -n openshift-gitops application clusters

     检查 Status: Synced 并且 Revision: 是推送到订阅的存储库的提交的 SHA。

   • 预同步 hook 失败，可能是因为拉取容器镜像失败。检查 ArgoCD 仪表板，了解 clusters 应用程序中预同步作业的状态。

2. 验证 post hook 作业是否运行：

   $ oc describe job -n clusters-sub siteconfig-post

   • 如果成功，返回的输出表示 succeeded: 1。
   • 如果作业失败，ArgoCD 会重试它。在某些情况下，第一次通过将失败，第二次通过将指示作业通过。

3. 检查 post hook 任务中的错误：

   $ oc get pod -n clusters-sub

   请注意 siteconfig-post-xxxxx pod 的名称：

   $ oc logs -n clusters-sub siteconfig-post-xxxxx

   如果日志指出错误，请更正条件，并将更正的 SiteConfig 或 PolicyGenTemplate 推送到 Git 存储库。

流程

1. 检查 PolicyGenTemplate 到 hub 集群的同步：

   $ oc get policygentemplate -A

   或者

   $ oc get policygentemplate -n $NS

   如果没有同步 PolicyGenTemplate，会出现以下情况之一：

   • 集群应用程序无法将 CR 从 Git 存储库同步到 hub。使用以下命令验证以下内容：

     $ oc describe -n openshift-gitops application clusters

     检查 Status: Synced 并且 Revision: 是推送到订阅的存储库的提交的 SHA。

   • 预同步 hook 失败，可能是因为拉取容器镜像失败。检查 ArgoCD 仪表板，了解 clusters 应用程序中预同步作业的状态。

2. 确保策略已复制到集群命名空间中。当 ACM 识别策略应用到 ManagedCluster 时，ACM 将策略 CR 对象应用到集群命名空间：

   $ oc get policy -n <cluster_name>

   ACM 在此处复制所有适用的通用、组和站点策略。策略名称为 <policyNamespace> 和 <policyName>。

3. 检查放置规则中是否有没有复制到集群命名空间中的策略。这些策略的 PlacementRule 中的 matchSelector 应该与 ManagedCluster 上的标签匹配：

   $ oc get placementrule -n $NS

4. 记录缺少的 common、group 或 site 策略的 PlacementRule 名称：

    oc get placementrule -n $NS <placmentRuleName> -o yaml

   • status decisions 值应包含您的集群名称。

   • spec 中 matchSelector 的键值 应与受管集群上的标签匹配。检查 ManagedCluster 上的标签：

      oc get ManagedCluster $CLUSTER -o jsonpath='{.metadata.labels}' | jq

     示例

     apiVersion: apps.open-cluster-management.io/v1
     kind: PlacementRule
     metadata:
       name: group-test1-policies-placementrules
       namespace: group-test1-policies
     spec:
       clusterSelector:
         matchExpressions:
         - key: group-test1
           operator: In
           values:
           - ""
     status:
       decisions:
       - clusterName: <cluster_name>
         clusterNamespace: <cluster_name>

5. 确保所有策略都合规：

    oc get policy -n $CLUSTER

   如果 Namespace、OperatorGroup 和 Subscription 策略兼容，但 Operator 配置策略不兼容，则 operator 可能不会安装。