Kubernetes部署Ingress控制器教程

云明君_9781

云明君_9781

2026-09-09

292人浏览

原创

helm 部署 ingress-nginx 是首选,因其内置版本校验、rbac 自动配置、admission webhook 证书生成及 --dry-run 预览能力,避免手动部署时镜像拉取失败、证书 job 卡住、crashloopbackoff 等高频问题;traefik 适合动态路由验证,但默认 ingressclass 名与 ingress-nginx 不兼容,混用易致流量丢失。

kubernetes部署ingress控制器教程

直接说结论:别从零写 YAML 部署 ingress-nginx,Helm 是当前最稳、最易维护的生产路径;Traefik 适合快速验证或微服务动态路由场景,但它的 ingressClass 默认名和行为与社区版 ingress-nginx 不兼容,混用会丢流量。

为什么 Helm 部署 ingress-nginx 是首选

手动 apply 官方 deploy.yaml 看似简单,实际踩坑密集:镜像拉取失败(尤其国内)、ValidatingWebhook 证书生成 Job 卡住、controller Pod 启动后反复 CrashLoopBackOff(常因 ServiceAccount 权限或 RBAC 缺失)、NodePort 端口冲突未提示。Helm chart 内置了版本校验、依赖管理、默认安全上下文、自动生成 admission webhook 证书等逻辑,且支持 --dry-run 预览生成内容。

  • 必须用 https://kubernetes.github.io/ingress-nginx 这个 Helm 仓库,不是 nginx-stable(后者是旧版 Nginx Inc. 维护的商业分支,已归档)
  • 务必加 --create-namespace,否则 namespace 不存在时命令静默失败
  • 若集群启用了 PodSecurityPolicy 或 PodSecurity,需显式设置 controller.podSecurityContext.enabled=false 和 controller.securityContext.capabilities.drop

ingressClass 名称不匹配会导致 Ingress 资源完全不生效

这是最隐蔽的故障点——kubectl get ingress 显示正常,kubectl describe ingress 里却看不到任何 Events,ingress-nginx-controller 日志里也没有对应日志。根本原因是:Ingress 资源没声明 ingressClassName,或声明的名称和控制器启动参数里的 --ingress-class 不一致。

Kubernetes Network Policy Generator
Kubernetes Network Policy Generator

使用加权评分卡在12项标准上评估和比较隐私解决方案供应商。适用于选择隐私管理软件、比较数据保护方案等场景。

下载
  • 使用 Helm 部署时,--set controller.ingressClass.name=nginx 会同时创建 ingressclass.networking.k8s.io/nginx 资源,并让控制器只处理该类 Ingress
  • 你的 Ingress YAML 必须包含:
    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      name: my-app
    spec:
      ingressClassName: nginx  # ← 必须和 Helm 设置的 name 严格一致
      rules: ...
  • 旧版 YAML 部署方式常漏掉这步,或误设为 nginx-ingress,导致控制器直接忽略该资源

Traefik 和 ingress-nginx 混用时的路由冲突风险

两者可以共存,但不能共享同一个 ingressClass 名。若你用 Helm 同时部署了 traefik(默认 ingressClass.name=traefik)和 ingress-nginx(默认 ingressClass.name=nginx),看似隔离,但问题出在全局默认行为上:

  • Kubernetes 1.22+ 默认禁用无 ingressClassName 的 Ingress;低于此版本则可能被任一控制器“抢走”处理权
  • Traefik 的 providers.kubernetesIngress.ingressClass 参数若未显式设为空字符串,它会监听所有 Ingress(包括没设 ingressClassName 的)
  • ingress-nginx 默认只处理明确指定 ingressClassName: nginx 的资源,更守规矩;Traefik 更“主动”,容易造成非预期接管
  • 验证方法:kubectl get ingressclass 看是否多于一个,再检查每个 Ingress 的 ingressClassName 字段是否唯一指向某一个

真正麻烦的从来不是部署命令本身,而是控制器和 Ingress 资源之间那层看不见的契约——ingressClassName 就是钥匙,缺了它,再完整的 YAML 也打不开流量大门。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Golang云原生微服务Kubernetes_Golang怎么集成Kubernetes开发云原生服务
Golang云原生微服务Kubernetes_Golang怎么集成Kubernetes开发云原生服务

Golang云原生微服务Kubernetes (K8s) 是指 使用 Go 语言(Golang)编写的云原生微服务,并利用 Kubernetes 平台进行容器化部署、自动化管理、弹性伸缩和高效编排的一整套现代应用架构方案。

2025.12.22

116

5

Go云原生应用与Kubernetes服务部署实战
Go云原生应用与Kubernetes服务部署实战

本专题围绕 Go 语言在云原生环境中的应用展开,讲解容器化部署、Kubernetes 编排、服务发现、健康检查与弹性扩缩容机制。通过真实云端案例,帮助开发者构建可扩展的云原生微服务架构。

2026.06.29

188

19

Playwright 测试失败怎么办
Playwright 测试失败怎么办

Playwright测试失败专题汇集超时、定位器匹配、浏览器提前关闭、依赖与插件配置、文件上传、SSL及Docker启动等故障文章,并介绍通过截图、报告和Trace定位错误。

2026.10.21

20

15

Playwright 页面操作指南
Playwright 页面操作指南

Playwright页面操作专题汇集元素定位、点击与输入、等待响应、多页面切换、Iframe、事件监听及文件处理的已审核文章,便于按操作场景查阅示例与常见问题。

2026.10.21

0

16

Playwright 入门教程
Playwright 入门教程

Playwright入门专题汇集测试框架安装、VS Code配置、录制脚本、编写首个用例、运行调试及查看报告的已审核文章,帮助初学者搭建端到端测试流程。

2026.10.21

0

16

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

2026.10.16

120

10

OpenJDK怎么配置Java开发环境
OpenJDK怎么配置Java开发环境

怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

2026.10.16

80

10

OpenJDK怎么部署Java应用
OpenJDK怎么部署Java应用

Java项目开发完成后,怎样部署到目标环境并正常运行?本专题介绍OpenJDK应用部署流程,涵盖运行环境准备、版本兼容检查、应用打包、启动参数配置和日志查看,帮助你理清部署前后的操作顺序,减少环境差异造成的运行问题。

2026.10.16

60

10

Revel框架模板渲染与表单验证
Revel框架模板渲染与表单验证

本专题围绕Revel框架视图层开发,介绍模板语法、变量输出、布局复用、表单提交、参数绑定与验证规则,帮助开发者完成安全规范的页面交互。

2026.10.16

40

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kubernetes官方教程手册
Kubernetes官方教程手册

共0课时 | 0人学习

Kubernetes官方中文文档
Kubernetes官方中文文档

共0课时 | 0人学习