文档中心

容器服务

请输入

网络组件

ingress-nginx

ingress-nginx 组件为基于开源 Nginx 代理实现的七层流量接入和路由网关组件。本文介绍如何安装和升级 ingress-nginx 组件以及相关的注意事项。

注意

Nginx Ingress 功能即将下线，详情请参见【产品公告】NGINX Ingress 停止维护公告。

组件概述

ingress-nginx 是容器服务提供的集群流量网关组件，主要负责读取集群里的 Ingress 路由规则，并自动把这些规则转换成 Nginx 的配置文件，并通过 Nginx 来接收外部的访问请求，然后再分发给集群内部对应的业务应用。相比其他网关，它有着极高的社区普及度，非常适合大部分通用 Web 业务场景。

在集群中安装 ingress-nginx 组件后，系统会在 kube-system 命名空间下创建如下 Kubernetes 资源。

资源名称	资源类型	资源说明
ingress-nginx-controller	Deployment	控制器核心 Pod，包含 Nginx 代理和控制器逻辑，用于接收外部请求，并解析规则后，根据规则完成后端转发。
ingress-nginx-controller	Service	控制器的统一访问入口，LoadBalancer 类型，用于与负载均衡器对接，将外部流量引入到控制器中。
ingress-nginx-controller-admission	Service	控制器准入控制服务，用于 Kubernetes 的准入控制（Admission Webhook）验证。在创建或修改 Ingress 时，预先校验 Nginx 语法，防止错误配置导致网关崩溃。
ingress-nginx-controller-metrics	Service	控制器监控服务，用于暴露组件运行状态和指标数据。

说明

容器服务支持在集群中同时部署多套独立的 Nginx Ingress Controller 服务，各服务之间互不影响，允许您基于实际业务需求或场景，对外提供不同的服务访问。详情请参见部署多套 Nginx Ingress Controller。

上表中仅罗列出了该组件的主要资源，以及配置组件或对应功能时可能使用到的资源，方便您了解该组件的主要组成。其他的组件相关资源（例如 ConfigMap、Secret 等）不多做介绍，请以集群中的实际为准。

组件版本

关于组件的历史发布记录、各版本新增特性及优化说明等信息，详情请参见组件发布记录。

安装组件

登录容器服务控制台。

在左侧导航栏中，选择集群，单击目标集群名称，进入集群管理页面。

在左侧导航栏中，选择组件管理，并选择网络页签。

将鼠标移动到组件卡片上，单击部署，配置组件相关参数。

nginx 配置

参数	描述
部署方式	组件的部署方式。当前该参数已固定，不可配置。
部署形态	仅已安装了 vci-virtual-kubelet 组件的集群显示该参数。部署组件的节点类型，包括：云服务器部署：表示在集群中的云服务器节点（Node）上部署该组件。弹性容器部署：表示在集群中的弹性容器实例（VCI），即虚拟节点（VirtualNode）上部署该组件。在弹性容器实例上部署组件，会产生费用，详细的费用说明，请参见弹性容器实例产品计费。
实例个数	配置 nginx 实例个数。
节点标签选择	开启后，可设置节点标签，组件的核心工作负载会被调度到带有该指定标签的节点上。
节点污点调度	开启后，可设置污点容忍值，组件的核心工作负载允许被调度到带有指定污点的节点。
Nginx 配置	配置 nginx 实例的资源配额，包括： CPU 请求：容器需要使用的最小 CPU 值。 CPU 上限：允许容器使用的 CPU 最大值。如果超过，容器会被终止。内存请求：容器需要使用的最小内存值。内存上限：允许容器使用的内存最大值。如果超过，容器会被终止。

CLB 基础信息

参数	描述
负载均衡类型	CLB 实例的网络类型，包括：公网和私网。
可用区	CLB 实例的可用区，包括：主可用区和备可用区。
计费类型	CLB 实例的计费类型，当前仅支持按量计费。
计费方式	CLB 实例的计费方式，包括：按规格计费：指定实例规格，并按照实例的使用时长计费。按使用量计费：无需指定实例规格，按照实例实际消耗的性能容量计费。
实例规格	当计费方式为按规格计费时需要配置。选择 CLB 实例的规格类型，不同规格类型拥有不同的规格限制。规格参数如下：最大连接数：CLB 实例能够同时处理的最大连接数量。当实例上的连接超过规格定义的最大连接数时，新建连接请求将被丢弃。新建连接数（CPS）：CLB 实例能够承载的每秒新建连接的速率。当每秒新建连接的速率超过规格定义的新建连接数时，新建连接请求将被丢弃。每秒查询数（QPS）：CLB 实例每秒可以完成的 HTTP/HTTPS 的查询（请求）的数量。当查询速率超过规格定义的每秒查询数时，新建连接请求将被丢弃。带宽（Mbps）：CLB 实例在处理网络流量时，能够支持的最大数据传输速率。说明更新组件配置时，需要首先开启更新实例开关，才能更新 CLB 实例规格。为避免实际业务流量受损，更新 CLB 实例规格前建议首先登录 CLB 控制台确认负载均衡实例当前配置的规格，与更新页面上已选择的实例规格对比，确认更新后的实例规格能够满足需求。
修改保护	是否开启 CLB 实例的修改保护功能：开启：无法在 CLB 控制台上修改或删除集群创建的 CLB 实例。关闭：可以在 CLB 控制台上修改或删除集群创建的 CLB 实例。

网络配置

参数
描述
子网
选择 CLB 实例的子网。
IP 版本
选择 CLB 实例子网的 IP 版本，当前仅支持 IPv4 类型的网络地址。

绑定公网 IP

说明

仅当负载均衡类型为公网时，需要配置该参数。

参数	描述
线路类型	配置负载均衡的线路类型，包括：BGP（多线）、融合 BGP、中国移动、中国电信和中国联通。注意除 BGP（多线）外，其他线路类型均为 EIP 产品的邀测功能，如需使用，请提交工单或联系客户经理申请。
计费方式	配置 CLB 实例绑定 EIP 的计费方式，包括：按量计费-按带宽上限：指定带宽上限后，将按照使用时长计费，与实际流量无关。按量计费-按实际流量：指定带宽上限后，将按照实际使用的出公网流量计费，与使用时长无关。
带宽上限	配置 CLB 实例绑定 EIP 的带宽上限。
共享带宽包	勾选开启共享带宽包功能，并选择已有的共享带宽包。说明共享带宽包是一种支持复用和共享带宽的云资源。将单个地域内多个公网 IP 或 IPv6 公网带宽添加到一个共享带宽包实例中，共享一条带宽，可以帮助您降低公网带宽的使用成本。详情请参见什么是共享带宽包。

单击确认，完成配置。

升级组件

组件会不定期发布新版本以提供新特性或修复已知问题。当组件卡片提示有可用更新时，建议您及时进行升级。为确保业务平稳过渡，升级前请尽量安排在业务低峰期执行操作。关于升级的操作步骤和注意事项，请参见升级组件。

参数	描述
子网	选择 CLB 实例的子网。
IP 版本	选择 CLB 实例子网的 IP 版本，当前仅支持 IPv4 类型的网络地址。