排查ArgoCD中Ingress卡在“Progressing”状态的问题

1. 深挖ArgoCD同步细节 #

• 通过命令行查看应用的完整资源状态：argocd app get <app-name> --show-resources，重点关注Ingress资源的Sync Status和Health Status字段，命令行往往会展示UI中隐藏的警告或进度细节。
• 查看应用的事件记录：argocd app events <app-name>，过滤Ingress相关条目，排查是否存在未在主界面显示的同步重试、资源隐性冲突等记录。
• 检查ArgoCD核心组件日志：
  • 查看repo-server日志：oc logs -n argocd deployment/argocd-repo-server
  • 查看application-controller日志：oc logs -n argocd deployment/argocd-application-controller
    过滤Ingress名称、域名等关键词，定位同步过程中未触发错误的异常逻辑。

2. 检查OpenShift Ingress/Route资源状态 #

• 查看Ingress资源详情：oc describe ingress <ingress-name> -n <namespace>，重点看Events段的负载均衡器分配、证书绑定、路由同步信息；同时检查Status.LoadBalancer字段，确认IP/域名是否已完成分配（云厂商LB创建常存在延迟）。
• 关联Route资源排查：OpenShift中Ingress会自动转换为Route，执行oc describe route <route-name> -n <namespace>，查看Status.Ingress字段，确认路由器是否已接收该路由，以及是否存在健康检查相关提示。
• 查看路由器日志：oc logs -n openshift-ingress deployment/router-default，过滤目标域名或Route名称，检查路由器加载配置时是否存在失败、冲突等情况。

3. 验证后端服务可用性 #

• 检查后端Service状态：oc describe service <service-name> -n <namespace>，确认Endpoints字段是否有就绪的Pod节点，若后端无可用端点，Ingress会持续处于Progressing状态等待后端就绪。
• 排查后端Pod状态：oc get pods -n <namespace>确认Pod是否处于Running且就绪状态，再通过oc logs <pod-name> -n <namespace>检查服务启动日志，排查端口不匹配、服务启动失败等问题——后端服务异常会阻塞Ingress的配置完成。

4. 排查基础设施层面延迟或故障 #

• 确认Ingress控制器状态：oc get deployment -n openshift-ingress检查router-default的Pod是否全部就绪，控制器本身故障会导致Ingress配置无法及时生效。
• 验证DNS解析：在集群内部Pod中执行nslookup <ingress-domain>，确认域名是否能正常解析到LB IP，DNS传播延迟可能让Ingress看似一直处于Progressing状态。
• 检查自定义证书状态：若使用cert-manager等工具管理证书，执行oc get certificates -n <namespace>确认证书是否处于Ready状态，证书未颁发会阻碍Ingress完成配置。

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