文档首页/云容器引擎 CCE/API参考/API/插件实例字段说明/NGINX Ingress控制器
更新时间：2026-03-16 GMT+08:00
查看PDF
分享

NGINX Ingress控制器

插件介绍

NGINX Ingress控制器能根据Service中Pod的变化动态地调整配置，结合Nginx的高稳定性、高性能、高并发处理能力等特点，对容器化应用具有灵活的应用层管理能力。

字段说明

表1 参数描述

参数

是否必选

参数类型

描述

basic

否

object

插件基础配置参数，无需指定。

flavor

是

表2 object

插件规格参数

custom

是

表3 object

插件自定义参数

表2 flavor

参数

是否必选

参数类型

描述

replicas

是

String

实例数，默认为：1

resources

是

resources object

容器资源（CPU、内存）配额。

表3 custom

参数

是否必选

参数类型

描述

ingressClass

是

String

控制器名称，默认nginx。

namespace

是

String

插件部署的命名空间，默认kube-system。

service

是

表8

对外访问service配置

config

否

Map<String>String

nginx配置参数，参考社区说明https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/configmap/

admissionWebhooks

否

表7

Ingress资源准入校验配置。

metrics

否

表9

监控指标配置。

defaultBackendService

否

String

默认404服务，按 <namespace>/<service_name> 格式。

extraArgs

否

表10

拓展参数配置

multiAZEnable

否

bool

插件中deployment组件多可用部署是否采用强制模式，默认：false。强制模式下插件Deployment实例强制调度到不同可用区的节点上，如集群下节点不满足多可用区，插件实例将无法全部运行。若multiAZEnable与multiAZBalance配置也同时为true，则以multiAZBalance为准使用多可用部署均分模式。

multiAZBalance

否

bool

插件中deployment组件多可用部署是否采用均分模式，默认：false。插件Deployment实例均匀调度到当前集群下各可用区，增加新的可用区后建议扩容插件实例以实现跨可用区高可用部署；均分模式限制不同可用区间插件实例数相差不超过1，单个可用区资源不足会导致后续其他实例无法调度。

tolerations

否

Array of 表5

污点容忍配置

node_match_expressions

否

Array of 表6

插件实例亲和性配置

表4 resources字段数据结构说明

参数

是否必选

参数类型

描述

limitsCpu

是

String

CPU大小限制，单位：m

limitsMem

是

String

内存大小限制，单位：Mi

name

是

String

插件名称，固定为：nginx-ingress

requestsCpu

是

String

申请的CPU大小，单位：m

requestsMem

是

String

申请的内存大小，单位：Mi

表5 tolerations污点

参数

是否必选

参数类型

描述

key

否

String

污点键

effect

否

String

污点策略

operator

否

String

操作符

tolerationSeconds

否

Int

容忍时间窗

表6 nodeMatchExpression节点亲和配置

参数

是否必选

参数类型

描述

key

否

String

污点键

values

否

List<String>

节点亲和的名称

operator

否

String

操作符

表7 admissionWebhook配置

参数

是否必选

参数类型

描述

enable

否

bool

是否开启Ingress资源准入校验，默认true。

表8 service配置

参数

是否必选

参数类型

描述

annotations

否

Map<String>String

对外service的Annotations配置。主要配置ELB相关选项，如"kubernetes.io/elb.class"，"kubernetes.io/elb.id"，"kubernetes.io/elb.pass-through"

loadBalancerIP

否

String

service对接ELB时的ELB IP。

表9 metrics配置

参数

是否必选

参数类型

描述

enable

否

bool

是否指标监控，默认true。

excludeSocketMetrics

否

String

屏蔽的监控指标，默认值为"nginx_ingress_controller_success,nginx_ingress_controller_header_duration_seconds,nginx_ingress_controller_ingress_upstream_latency_seconds"

表10 extraArg扩展参数配置

参数

是否必选

参数类型

描述

default-ssl-certificate

否

String

默认证书配置，见Default SSL Certificate。

请求示例

{
	"kind": "Addon",
	"apiVersion": "v3",
	"metadata": {
		"annotations": {
			"addon.install/type": "install"
		}
	},
	"spec": {
		"clusterID": "2292498e-**************ac1001ba",
		"version": "2.2.52",
		"addonTemplateName": "nginx-ingress",
		"values": {
                        "basic": {
				"basickey":"val"
			},
			"flavor": {
				"replicas": 2,
				"resources": [{
					"limitsCpu": "8000m",
					"limitsMem": "4000Mi",
					"name": "nginx-ingress",
					"requestsCpu": "8000m",
					"requestsMem": "4000Mi"
				}]
			},
			"custom": {
				"config": {
					"keep-alive-requests": "100"
				},
				"defaultBackend": {
					"enabled": true
				},
				"defaultBackendService": "",
				"extraArgs": {
					"default-ssl-certificate": ""
				},
				"ingressClass": "nginx",
				"multiAZBalance": false,
				"multiAZEnabled": false,
				"namespace": "kube-system",
				"node_match_expressions": [],
				"service": {
					"annotations": {
						"kubernetes.io/elb.class": "performance",
						"kubernetes.io/elb.id": "8d6bd485-d8ac-4693-815d-9d54d79b0666"
					},
					"loadBalancerIP": ""
				},
				"tolerations": [{
					"key": "node.kubernetes.io/not-ready",
					"operator": "Exists",
					"effect": "NoExecute",
					"tolerationSeconds": 60
				},
				{
					"key": "node.kubernetes.io/unreachable",
					"operator": "Exists",
					"effect": "NoExecute",
					"tolerationSeconds": 60
				}]
			}
		}
	}
}
父主题： 插件实例字段说明

相关文档