使用Helm安装cert-manager时出现等待条件超时错误

先排查集群基础状态 #

• 查看cert-manager命名空间下的Pod运行状态：

  kubectl get pods -n cert-manager
  

  若有Pod启动失败，通过日志定位具体原因：

  kubectl logs <目标Pod名称> -n cert-manager
  

• 检查CRD资源是否正常创建：

  kubectl get crds | grep cert-manager
  

延长Helm安装超时时间 #

默认post-install钩子的等待时长可能不足以完成资源初始化，安装时添加--timeout参数延长等待时间，例如设置为10分钟：

helm install cert-manager jetstack/cert-manager \
  --namespace cert-manager \
  --create-namespace \
  --version v1.13.0 \
  --set installCRDs=true \
  --timeout 10m

手动分步完成安装（针对超时后部分资源已创建的场景） #

1. 先清理失败的Release：

   helm uninstall cert-manager -n cert-manager
   

2. 手动创建cert-manager所需CRDs：

   kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.13.0/cert-manager.crds.yaml
   

3. 重新执行Helm安装（无需再指定--set installCRDs=true）：

   helm install cert-manager jetstack/cert-manager \
     --namespace cert-manager \
     --create-namespace \
     --version v1.13.0 \
     --timeout 10m
   

检查集群网络与镜像拉取 #

• 确认集群节点可正常访问quay.io（cert-manager镜像仓库）：
  在节点上执行：

  curl -I https://quay.io
  

• 若镜像拉取缓慢或失败，可手动拉取对应版本镜像到节点，或配置集群内部镜像仓库代理。

验证安装结果 #

安装完成后，运行以下命令验证API可用性：

kubectl apply -f - <<EOF
apiVersion: v1
kind: Pod
metadata:
  name: cert-manager-test
  namespace: cert-manager
spec:
  containers:
    - name: cert-manager-test
      image: quay.io/jetstack/cert-manager-tools:v1.13.0
      command: ["certs", "check", "api"]
      env:
        - name: CERT_MANAGER_TEST_NAMESPACE
          value: cert-manager
EOF

查看测试Pod日志确认结果：

kubectl logs cert-manager-test -n cert-manager

若输出cert-manager API is ready，则安装成功。

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