ArgoCD中kube-prometheus-stack从Out of Sync转为Unknown状态求助

针对你在单节点k3s集群中使用ArgoCD v2.6.5部署Helm应用时出现的「初始Out of Sync、同步后变为Unknown」问题，以下是几个大概率的遗漏配置及解决方法：

1. 未创建目标命名空间 #

你的Application指定部署到observability命名空间，但ArgoCD默认不会自动创建该命名空间，这会导致同步时资源无法落地，最终状态异常。

• 解决方法：
  要么提前手动创建命名空间：

  kubectl create namespace observability
  

  要么在Application的spec中添加同步配置，让ArgoCD自动创建：

  spec:
    syncPolicy:
      syncOptions:
        - CreateNamespace=true
  

2. ArgoCD控制器权限不足 #

默认安装的ArgoCD中，argocd-application-controller这个ServiceAccount的权限有限，在k3s的RBAC规则下可能无法完成资源的创建、更新操作，导致同步后状态无法被正确识别。

• 解决方法（测试环境可直接绑定集群管理员权限，生产环境需按需缩小权限）：

  kubectl create clusterrolebinding argocd-application-controller-cluster-admin \
    --clusterrole=cluster-admin \
    --serviceaccount=argocd:argocd-application-controller
  

3. Helm仓库拉取失败 #

ArgoCD无法正常拉取Helm仓库的索引或Chart包时，会无法计算应用的期望状态，进而显示Unknown。

• 解决方法：
  1. 先在ArgoCD UI的「Settings」→「Repositories」中确认https://prometheus-community.github.io/helm-charts仓库状态正常
  2. 也可以进入ArgoCD的repo-server Pod手动测试拉取：

  kubectl exec -n argocd deployment/argocd-repo-server -- helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
  kubectl exec -n argocd deployment/argocd-repo-server -- helm pull prometheus-community/kube-prometheus-stack --version 44.4.1
  

  如果拉取失败，检查集群网络是否能访问外部，或者配置代理。

4. 缺少同步策略与健康检查配置 #

你的Application配置没有设置同步策略和健康检查，ArgoCD不仅不会自动同步，也无法判断应用是否部署成功，最终状态会停留在Unknown。

• 解决方法：给Application添加同步策略和健康检查规则：

  spec:
    syncPolicy:
      automated:
        prune: true
        selfHeal: true
      syncOptions:
        - CreateNamespace=true
    healthChecks:
      - apiVersion: apps/v1
        kind: Deployment
        name: kube-prometheus-stack-operator
        namespace: observability
      - apiVersion: apps/v1
        kind: StatefulSet
        name: kube-prometheus-stack-prometheus
        namespace: observability
  

5. k3s存储类配置问题 #

kube-prometheus-stack需要持久化存储，若k3s的默认存储类未正确配置，会导致PVC创建失败，进而应用状态异常。

• 解决方法：
  1. 先检查k3s的存储类情况：

  kubectl get storageclass
  

  2. 如果没有默认存储类，确认k3s自带的local-path-provisioner是否正常运行；或者在Helm参数中指定存储类：

  spec:
    source:
      helm:
        parameters:
          - name: prometheus.prometheusSpec.storageSpec.volumeClaimTemplate.spec.storageClassName
            value: "local-path"
          - name: alertmanager.alertmanagerSpec.storageSpec.volumeClaimTemplate.spec.storageClassName
            value: "local-path"
  

内容的提问来源于stack exchange，提问作者Nora