Kubernetes：修复 Docker Desktop 的 Ingress-Nginx v1.12.0-beta.0 中的 404 Nginx 错误

解决方案 1：在 Kubernetes 中重新配置 Ingress Controller

使用 Kubernetes YAML 配置正确设置入口控制器并避免常见的 404 错误。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: example-ingress
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /
spec:
  rules:
    - host: example.com
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: example-service
                port:
                  number: 80

解决方案 2：Kubernetes Ingress 故障排除脚本

用于调试 Docker Desktop Kubernetes 中 Ingress 设置的 Shell 脚本。

#!/bin/bash
# Check if ingress-nginx controller is running correctly
kubectl get pods -n ingress-nginx
# Restart the ingress-nginx controller if any issues are found
kubectl rollout restart deployment/ingress-nginx-controller -n ingress-nginx
# Check for any potential errors in the logs
kubectl logs -l app.kubernetes.io/name=ingress-nginx -n ingress-nginx --tail 50
# Display ingress resource details
kubectl describe ingress
# Suggest removing and redeploying if issues persist
echo "If issues persist, delete ingress-nginx and reinstall the correct version."

解决方案 3：Kubernetes Ingress 端点的 Node.js 后端测试

用于验证 Ingress 路由的后端响应和状态的 Node.js 脚本。

const axios = require('axios');
// Endpoint URL to be tested
const testUrl = 'http://example.com/';
// Function to test endpoint response
async function testIngress() {
  try {
    const response = await axios.get(testUrl);
    if (response.status === 200) {
      console.log('Ingress is working. Received status 200.');
    } else {
      console.log('Unexpected status:', response.status);
    }
  } catch (error) {
    console.error('Error connecting to Ingress:', error.message);
  }
}
testIngress();

解决方案4：用于降级Ingress-Nginx的YAML配置

用于将 Ingress-Nginx 降级到稳定版本的配置脚本。

apiVersion: v1
kind: ConfigMap
metadata:
  name: nginx-configuration
  namespace: ingress-nginx
data:
  use-forwarded-headers: "true"
--- 
apiVersion: apps/v1
kind: Deployment
metadata:
  name: ingress-nginx-controller
  namespace: ingress-nginx
spec:
  replicas: 1
  selector:
    matchLabels:
      app.kubernetes.io/name: ingress-nginx
  template:
    metadata:
      labels:
        app.kubernetes.io/name: ingress-nginx
    spec:
      containers:
      - name: controller
        image: k8s.gcr.io/ingress-nginx/controller:v1.11.0

有关 Ingress-Nginx 404 错误的常见问题

1. 为什么更新 Ingress-Nginx 后出现 404 错误？
2. 由于入口控制器配置的更改或新版本的兼容性问题，通常会出现 404 错误。降级到稳定版本或检查新注释可以帮助解决此问题。
3. 如何将 Ingress-Nginx 控制器降级到之前的版本？
4. 你可以使用命令 kubectl apply -f 后跟先前版本的 YAML 文件的 URL 以重新安装旧版本。例如，运行 kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/controller-v1.11.0/deploy/static/provider/cloud/deploy.yaml。
5. 重写目标注释的目的是什么？
6. 这 nginx.ingress.kubernetes.io/rewrite-target 注解修改URL路径，确保请求匹配正确的后端服务路由。当路径未自动重定向时，这有助于避免 404 错误。
7. 为什么建议在生产中使用稳定版本？
8. 稳定版本针对生产环境进行了彻底的测试和优化，与可能存在错误或兼容性问题的测试版本不同。使用稳定版本可以最大限度地减少意外错误。
9. 如何检查入口控制器的日志是否有错误？
10. 要查看日志，您可以运行 kubectl logs -l app.kubernetes.io/name=ingress-nginx -n ingress-nginx。此命令检索最近的日志条目，这可以揭示错误或错误配置。
11. 对于 Kubernetes 路由，是否有 Ingress-Nginx 的替代方案？
12. 是的，其他入口控制器（如 Traefik 和 HAProxy）可以用作替代方案，每个控制器在 Kubernetes 环境中都具有独特的功能和优势。
13. 如何重启 Kubernetes 中的入口控制器？
14. 使用命令 kubectl rollout restart deployment/ingress-nginx-controller -n ingress-nginx 重新启动控制器，对当前设置应用新的更改。
15. 有没有办法通过简单的 HTTP 请求检查入口路由？
16. 是的，一个简单的 Node.js 脚本使用 axios.get() 可以发出请求来验证路由路径，这有助于确保请求到达预期的服务。
17. 在不影响生产的情况下测试 Beta 版本的最佳方法是什么？
18. 设置单独的 Kubernetes 环境或命名空间进行测试。这使您可以验证测试版中的功能，而不会影响主应用程序的功能。
19. 如何确认入口资源配置正确？
20. 跑步 kubectl describe ingress 查看资源详细信息，包括注释和路径规则，这有助于确认正确的配置。
21. 不正确的路径会导致 404 错误吗？
22. 是的，路径不匹配会阻止流量到达预期服务，从而导致 404 错误。始终确保在入口资源中正确设置路径规则。

避免 Kubernetes Ingress 中出现 404 错误的关键要点

在 Kubernetes 部署中，入口配置错误导致的 404 错误可能是一个挑战。通过了解兼容性问题以及注释如何影响路由，您可以主动解决这些错误。降级到稳定版本并使用 Node.js 脚本等工具进行测试可以简化您的故障排除过程。

对于生产环境，使用稳定的 Ingress-Nginx 版本而不是 beta 版本可以最大限度地降低意外中断的风险。请记住，精确的配置和保持官方版本的更新是避免未来出现与入口相关的问题的重要步骤。遵循这些步骤有助于确保 Kubernetes 部署更加顺利。 🌐