使用Nginx Ingress 优雅显示错误页面

 更新时间:2023年09月24日 10:41:36   作者:moon  
这篇文章主要为大家介绍了使用Nginx Ingress 优雅显示错误页面实现示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪

一. Nginx Ingress 优雅显示错误页面

官网

  • 让所有经过 Nginx Ingress 暴露出去的域名,在请求到错误页面的时候(状态码为:4xx,5xx等)给用户一个优雅的页面显示,而不直接显示4xx或5xx的报错,避免给用户不好的使用体验

1. 镜像制作

  • 将显示的页面全部放在 www 目录中
[root@yunwei-k8s-addon1-test custom-error]# ll www/
-rw-r--r--. 1 yeemiao yeemiao 415 3月  13 2019 403.html
-rw-r--r--. 1 yeemiao yeemiao 412 3月  13 2019 404.html
-rw-r--r--. 1 root    root    412 8月  16 13:40 500.html
-rw-r--r--. 1 root    root    412 8月  16 13:40 501.html
-rw-r--r--. 1 yeemiao yeemiao 415 3月  13 2019 502.html
-rw-r--r--. 1 yeemiao yeemiao 409 3月  13 2019 503.html
-rw-r--r--. 1 root    root    412 8月  16 13:40 504.html

# 目录结构
[root@yunwei-k8s-addon1-test custom-error]# ll
-rw-r--r--. 1 root root  72 8月  16 13:37 Dockerfile
drwxr-xr-x. 2 root root 118 8月  16 13:41 www
FROM registry.k8s.io/ingress-nginx/nginx-errors:v20230505
COPY www /www

2. nginx-error

  • 放在和 Nginx-Ingress 控制器同样的名称空间中
apiVersion: v1
kind: Service
metadata:
  name: nginx-errors
  namespace: ingress-nginx 
  labels:
    app.kubernetes.io/name: nginx-errors
    app.kubernetes.io/part-of: ingress-nginx
spec:
  selector:
    app.kubernetes.io/name: nginx-errors
    app.kubernetes.io/part-of: ingress-nginx
  ports:
  - port: 80
    targetPort: 8080
    name: http
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-errors
  namespace: ingress-nginx 
  labels:
    app.kubernetes.io/name: nginx-errors
    app.kubernetes.io/part-of: ingress-nginx
spec:
  replicas: 1
  selector:
    matchLabels:
      app.kubernetes.io/name: nginx-errors
      app.kubernetes.io/part-of: ingress-nginx
  template:
    metadata:
      labels:
        app.kubernetes.io/name: nginx-errors
        app.kubernetes.io/part-of: ingress-nginx
    spec:
      containers:
      - name: nginx-error-server
        image: harbor.yeemiao.com:8443/library/custom-nginx-error:20230816
        ports:
        - containerPort: 8080

配置

  • 修改Nginx-Ingress 的启动参数
# 加入参数,如果 nginx-error 和 Nginx-Ingress在同一名称空间,直接加入参数即可,如果 nginx-error 服务不在 Nginx-Ingress 控制器同样的 Namespace,请将 POD_NAMESPACE 改为他所在的名称
- --default-backend-service=$(POD_NAMESPACE)/nginx-errors
# 修改 Nginx-Ingress 控制器的configmap
[root@k8s-alone-1 manifest]# kubectl  -n ingress-nginx edit cm nginx-configuration
apiVersion: v1
data:
  allow-snippet-annotations: "true"
  custom-http-errors: 403,404,413,500,501,502,503,504    # 增加这个配置

3. 验证

  • 进入 nginx-ingress的控制器查看nginx 配置文件 /etc/nginx/nginx.conf, 过滤 error_page 是否有相关配置
error_page 403 = @custom_upstream-default-backend_403;                                                           
        error_page 404 = @custom_upstream-default-backend_404;                                                           
        error_page 413 = @custom_upstream-default-backend_413;                                                           
        error_page 500 = @custom_upstream-default-backend_500;                                                           
        error_page 502 = @custom_upstream-default-backend_502;                                                           
        error_page 503 = @custom_upstream-default-backend_503;                                                           
        error_page 504 = @custom_upstream-default-backend_504;

以上就是使用Nginx Ingress 优雅显示错误页面的详细内容,更多关于Nginx Ingress显示错误页面的资料请关注脚本之家其它相关文章!

相关文章

  • nginx服务器实现上传下载文件的实例代码

    nginx服务器实现上传下载文件的实例代码

    这篇文章主要介绍了nginx服务器实现上传下载文件的实例代码,本文通过代码给大家介绍的非常详细,对大家的学习或工作有一定的帮助,需要的朋友可以参考下
    2024-02-02
  • Nginx中的root&alias文件路径及索引目录配置详解

    Nginx中的root&alias文件路径及索引目录配置详解

    这篇文章主要介绍了Nginx中的root&alias文件路径及索引目录配置,顺带讲解了root和alias命令的用法,需要的朋友可以参考下
    2016-01-01
  • Nginx报错host not found in upstream的解决办法

    Nginx报错host not found in upstream的解决办法

    本文主要介绍了Nginx报错host not found in upstream的解决办法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-08-08
  • 详解nginx如何配置HTTPS

    详解nginx如何配置HTTPS

    本篇文章主要介绍了详解nginx如何配置HTTPS,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-05-05
  • 升级nginx支持HTTP/2服务端推送的方法

    升级nginx支持HTTP/2服务端推送的方法

    这篇文章主要介绍了升级nginx支持HTTP/2服务端推送的方法,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-05-05
  • Nginx+Tomcat高性能负载均衡集群搭建教程

    Nginx+Tomcat高性能负载均衡集群搭建教程

    这篇文章主要为大家详细介绍了Nginx+Tomcat高性能负载均衡集群搭建教程,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2018-04-04
  • Nginx中IF、AND、OR语句用法实例

    Nginx中IF、AND、OR语句用法实例

    这篇文章主要介绍了Nginx中IF、AND、OR语句用法实例,本文讲解的是Ningx中的逻辑判断语句用法,需要的朋友可以参考下
    2015-02-02
  • nginx 伪静态Rewrite正则资源汇总

    nginx 伪静态Rewrite正则资源汇总

    本文给大家汇总介绍了nginx中使用rewrite伪静态正则表达式的资源,非常的全面详细,有需要的小伙伴可以参考下
    2016-08-08
  • 浅谈一下Nginx性能优化

    浅谈一下Nginx性能优化

    这篇文章主要介绍了Nginx性能优化,Nginx (engine x) 是一个高性能的HTTP和反向代理web服务器,同时也提供了IMAP/POP3/SMTP服务,需要的朋友可以参考下
    2023-04-04
  • Nginx中proxy_pass使用小结

    Nginx中proxy_pass使用小结

    本文详细介绍了Nginx中proxy_pass指令的基本用法、配置示例及高级用法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2025-01-01

最新评论