GKE Ingress配置时Secret不存在错误及LoadBalancer无法创建问题的原因排查与修复咨询

Hey there, let's dig into why you're seeing this "secret does not exist" error and why your Load Balancer isn't spinning up—this is a super common gotcha with GKE Ingress, so let's break it down:

常见错误原因 #

• Ingress引用的Secret未创建或命名空间不匹配：GKE要求Ingress和它引用的TLS Secret必须处于同一个命名空间。很多人不小心在默认命名空间创建了Secret，但Ingress在另一个命名空间（比如prod），导致Ingress找不到它。
• Secret名称拼写错误：检查Ingress YAML里的secretName字段，是不是和实际创建的Secret名称大小写、字符不一致？比如你写了my-tls-secret但实际创建的是my-tls-secret-prod，这种小错误很容易忽略。
• Secret创建失败：如果是用命令创建Secret，可能因为证书格式不对（比如不是PEM格式）、密钥文件权限问题，或者命令参数写错，导致Secret根本没成功生成。
• 混淆了Managed Cert和自定义Secret：如果你想用GCP的托管证书（Managed Certificate），不需要在Ingress里指定secretName—误加这个字段会让Ingress去寻找不存在的Secret，自然报错。

分步修复方案 #

1. 先检查Ingress的TLS配置
   打开你的Ingress YAML文件，找到TLS配置段，确认secretName的准确值：

   tls:
   - hosts:
     - your-domain.com
     secretName: my-tls-secret  # 重点看这个名称
   

   同时确认Ingress所在的命名空间（YAML里的metadata.namespace字段）。

2. 验证目标命名空间里的Secret是否存在
   执行命令检查对应命名空间的Secret列表：

   kubectl get secrets -n <你的Ingress命名空间>
   

   如果列表里没有你要找的Secret，那就是它没创建或者在错的命名空间里了。

3. 创建缺失的Secret（如果需要）

   • 如果是用自定义证书文件（自签或第三方证书），执行以下命令创建TLS Secret：

     kubectl create secret tls my-tls-secret \
       --cert=/path/to/your-cert.crt \
       --key=/path/to/your-private.key \
       -n <你的Ingress命名空间>
     

   • 如果是用GCP托管证书，删除Ingress里的tls.secretName字段，添加托管证书的注解：

     metadata:
       annotations:
         networking.gke.io/managed-certificates: your-managed-cert-name
     

     确保你已经提前创建了ManagedCertificate资源。

4. 检查Secret的类型是否正确
   如果Secret已经存在但还是报错，检查它的类型是否是kubernetes.io/tls：

   kubectl describe secret my-tls-secret -n <你的Ingress命名空间>
   

   看输出里的Type字段，必须是kubernetes.io/tls，否则Ingress无法识别它作为TLS证书源。

5. 重新应用Ingress配置并验证
   修改完配置或创建好Secret后，重新应用Ingress：

   kubectl apply -f your-ingress.yaml
   

   然后查看Ingress的事件日志，确认错误是否消失：

   kubectl describe ingress <你的Ingress名称> -n <你的Ingress命名空间>
   

   当Secret问题解决后，GKE会自动开始创建LoadBalancer，你可以用kubectl get ingress跟踪状态，直到ADDRESS字段出现负载均衡的IP地址。

备注：内容来源于stack exchange，提问作者Martin rudez