文档首页 > > 用户指南> 插件管理> nginx-ingress

nginx-ingress

分享
更新时间: 2020/01/22 GMT+08:00

插件简介

Nginx Ingress Controller插件是一款围绕Kubernetes Ingress资源构建的Nginx控制器,通过和kubernetes api交互,动态的去感知集群中ingress规则变化,根据规则生成一段nginx配置,控制器会把生成的nginx配置写入/etc/nginx.conf文件中。通过该插件您可以获得基本的负载平衡,SSL/TLS termination,对URI重写的支持以及上游SSL/TLS加密等,也可以在安装插件时,修改默认的配置信息来增强插件的功能。

使用约束

  • 仅支持1.13版本的集群安装此插件。
  • 通过api调接口创建的Ingress annotation必须添加kubernetes.io/ingress.class: "nginx",如果是对接老的Ingress,annotation需添加为kubernetes.io/ingress.class: "cce"。

安装插件

  1. CCE控制台中,单击左侧导航栏的插件管理,在插件市场中,单击nginx-ingress插件下的“安装插件”
  2. 在安装插件页面,在“基本信息”步骤中选择集群和插件版本,单击“下一步:规格配置”
  3. “规格配置”步骤中,参照表1设置服务选型参数,其中带“*”的参数为必填参数。

    表1 Nginx Ingress插件参数配置

    参数

    参数说明

    插件规格

    请根据业务需求选择插件规格,可单实例部署、多实例部署或自定义资源规格部署。

    实例数

    选择上方插件规格后,显示插件中的实例数,此处仅作显示。

    容器

    选择插件规格后,显示插件容器的CPU和内存配额,此处仅作显示。

    Worker进程数

    定义了nginx对外提供web服务时的worker进程数,默认 auto。

    此参数的最优值取决于许多因素,包括(但不限于)CPU核的数量、存储数据的硬盘数量及负载模式。不能确定时,可将其设置为可用的CPU内核数(设置为“auto”将尝试自动检测它)。

    最大并发数

    单个后台Worker进程的最大并发链接数,默认 16384。

    长连接超时

    长连接超时时间,单位秒,默认 60s。

    该功能是使客户端到服务器端的连接在设定的时间内持续有效,当出现对服务器的后继请求时,该功能避免了建立或者重新建立连接。切记这个参数也不能设置过大!否则会导致许多无效的http连接占据着nginx的连接数,终nginx崩溃。

    定义nginx配置

    Nginx Ingress Controller通过ConfigMap来修改更新nginx.conf里的配置,全局的设置,直接配置nginx.conf的生成,影响管理的全部Ingress,如需配置可通过configmap查找。

    自定义请求头

    nginx默认会将用户自定义的header过滤掉,此参数允许重新定义或者添加发往后端服务器的请求头。

    开启默认404服务

    该插件默认提供了404后端服务,如果是用户自定义的404服务,输入格式示例如下:<namespace/serviceName>。

    负载均衡

    可选择已创建的公网或私网负载均衡实例,该功能可让公网或者私网的流量能转发到该插件的service上。

    负载均衡实例需与当前集群处于相同VPC ,需要拥有至少两个监听器配额,且端口80和443没有被监听器占用。

  4. 完成配置后单击“安装”按钮,待插件安装完成后,单击“返回插件管理”

    图1 安装nginx-ingress插件成功

  5. “插件实例”页签中单击右上角的集群选择框,选择安装的集群后可查看到运行中的插件,这表明该插件已在当前集群中安装成功。

    图2 查看安装的插件

卸载插件

  1. CCE控制台中,单击左侧导航栏的“插件管理”,在“插件实例”页签中,选择对应的集群,单击nginx-ingress下的“卸载”
  2. 在弹出的窗口中,单击“确认”,可卸载该插件。
分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区