AWS EKS集群中通过Helm安装Portainer后无Pod可见的问题求助

这种情况在Kubernetes环境里并不少见，咱们一步步拆解可能的原因和对应的排查思路：

1. 先确认Helm Release的真实状态 #

Helm返回的STATUS: deployed只是表面状态，实际可能存在资源部署不完整的情况，建议先查看Release的全部细节：

• 执行命令查看Release的所有资源和配置：

  helm get all -n sandbox portainer
  

  重点看输出里的MANIFEST部分，确认是否包含Deployment/StatefulSet这类Pod控制器资源；同时检查VALUES部分，有没有误设置replicaCount: 0这类会阻止Pod创建的参数。
• 查看Helm安装历史，确认过程中有没有隐藏错误：

  helm history -n sandbox portainer
  

2. 检查命名空间下的所有K8s资源 #

不要只局限于Pod，先看看sandbox命名空间里的所有资源，确认Pod控制器是否存在：

• 列出命名空间内所有资源：

  kubectl get all -n sandbox
  

  如果能看到Portainer的Deployment/StatefulSet，但没有对应的Pod，就需要深入查看控制器的状态：

  kubectl describe deployment portainer -n sandbox
  

  重点看Events字段，这里会显示Pod创建失败的具体原因——比如镜像拉取失败、节点资源不足、亲和性规则不匹配等。

3. 验证AWS EKS环境的特殊限制 #

AWS集群有一些独有的配置可能影响Pod创建：

• 镜像拉取权限：如果Portainer镜像托管在公共镜像仓库（比如Docker Hub），检查EKS节点是否有外网访问权限，或者节点的IAM角色是否允许拉取公共镜像；如果是ECR镜像，确认节点有权限访问对应ECR仓库。
• 安全策略限制：检查集群是否启用了Pod安全策略（PSP）或者OPA规则，这些规则可能会阻止Portainer Pod的创建（比如Portainer需要的权限被策略禁止）。
• 节点可用性：确认EKS集群的节点处于Ready状态，没有被 cordon/drain，且节点资源（CPU、内存）足够容纳Portainer Pod。

4. 确认Kubectl上下文的正确性 #

虽然你提到已确认上下文是sandbox，但还是建议再做一次验证，避免上下文名称与实际集群不匹配的情况：

• 查看当前上下文：

  kubectl config current-context
  

• 查看当前上下文对应的集群信息：

  kubectl config view --minify
  

  确认集群地址、命名空间等信息是否与目标AWS集群一致。

5. 检查命名空间是否存在 #

如果sandbox命名空间不存在，Helm 3+默认不会自动创建（除非添加了--create-namespace参数），这种情况下Helm的部署其实是失败的，只是返回信息有误导性。验证命名空间是否存在：

kubectl get namespaces sandbox

如果不存在，先创建命名空间再重新部署：

kubectl create namespace sandbox
helm upgrade -i -n sandbox portainer portainer/portainer --set service.type=ClusterIP

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