1. 项目概述在容器化应用部署的实践中Kubernetes已经成为事实上的标准编排平台。而Ingress作为Kubernetes中管理外部访问的核心资源其重要性不言而喻。其中Ingress-Nginx作为最流行的Ingress控制器实现之一被广泛应用于生产环境。本文将从CKA认证考试的实际需求出发详细讲解如何在Kubernetes集群中部署和配置Ingress-Nginx控制器为备考CKA认证的工程师提供一个完整的练习环境搭建指南。提示虽然本文以CKA备考为背景但所介绍的内容完全适用于生产环境的部署需求区别仅在于配置的复杂度和安全考量。2. 环境准备与基础概念2.1 前置条件检查在开始部署Ingress-Nginx前我们需要确保以下条件已经满足一个正常运行的Kubernetes集群可以是Minikube、Kind或生产级集群配置正确的kubectl命令行工具能够与集群交互足够的集群资源建议至少2个CPU和4GB内存集群网络插件已正确安装并运行验证集群状态的常用命令kubectl get nodes kubectl get pods -n kube-system2.2 Ingress-Nginx架构解析Ingress-Nginx控制器主要由三个组件构成Nginx进程实际处理HTTP/HTTPS流量的核心引擎控制器监听Kubernetes API动态更新Nginx配置Admission Webhook验证Ingress资源的有效性这种架构设计使得Ingress-Nginx能够实时响应Kubernetes集群中的Ingress资源变更而无需手动重新加载配置。3. 部署Ingress-Nginx控制器3.1 官方部署方案选择Ingress-Nginx项目提供了多种部署方式我们需要根据环境特点选择最合适的方案裸机部署使用NodePort或HostNetwork模式云环境部署利用云厂商的LoadBalancer服务开发环境部署适合Minikube或Kind的简化方案对于CKA备考练习环境我们推荐使用裸机部署方案因为它最接近考试环境的要求。3.2 详细部署步骤以下是使用官方manifest文件部署Ingress-Nginx的具体步骤# 下载官方部署清单 wget https://raw.githubusercontent.com/kubernetes/ingress-nginx/controller-v1.8.1/deploy/static/provider/baremetal/deploy.yaml # 修改NodePort范围可选 sed -i s/type: NodePort/type: NodePort\n nodePorts:\n http: 30080\n https: 30443/ deploy.yaml # 应用部署清单 kubectl apply -f deploy.yaml # 验证部署状态 kubectl get pods -n ingress-nginx -w3.3 关键配置解析在部署过程中有几个关键配置项需要特别注意controller.service.type设置为NodePort以便外部访问controller.hostNetwork在特定环境下可能需要启用controller.watchNamespace限定控制器监视的命名空间对于考试环境我们通常保持默认配置即可但在生产环境中这些参数需要根据实际需求仔细调整。4. Ingress资源配置实践4.1 基本Ingress示例下面是一个最简单的Ingress资源配置示例它将流量路由到后端服务apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: example-ingress spec: ingressClassName: nginx rules: - host: example.com http: paths: - path: / pathType: Prefix backend: service: name: web-service port: number: 804.2 高级路由配置在实际应用中我们经常需要更复杂的路由规则基于路径的路由将不同路径映射到不同服务基于主机的路由根据域名分发流量默认后端处理不匹配任何规则的请求TLS终止配置HTTPS访问以下是一个包含这些高级特性的示例apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: advanced-ingress annotations: nginx.ingress.kubernetes.io/rewrite-target: / spec: tls: - hosts: - example.com secretName: example-tls rules: - host: example.com http: paths: - path: /v1 pathType: Prefix backend: service: name: api-v1 port: number: 80 - path: /v2 pathType: Prefix backend: service: name: api-v2 port: number: 80 defaultBackend: service: name: default-service port: number: 805. 常见问题排查与调试5.1 诊断工具与技术当Ingress-Nginx出现问题时可以使用以下方法进行排查查看控制器日志kubectl logs -n ingress-nginx deployment/ingress-nginx-controller检查生成的Nginx配置kubectl exec -n ingress-nginx -it deployment/ingress-nginx-controller -- cat /etc/nginx/nginx.conf验证网络连通性kubectl run -it --rm debug --imagebusybox --restartNever -- sh5.2 典型问题与解决方案Ingress资源创建但无法访问检查控制器Pod是否正常运行验证Service的NodePort是否正确暴露确认网络策略没有阻止流量TLS证书不生效检查Secret是否存在于正确的命名空间验证证书和私钥格式是否正确确保域名与证书匹配路由规则不生效检查IngressClass是否正确指定验证路径匹配规则是否符合预期查看Nginx配置是否包含预期的路由6. CKA考试特别注意事项在准备CKA认证考试时关于Ingress-Nginx需要特别注意以下几点考试环境限制可能没有互联网访问权限资源有限需优化配置时间紧迫需熟悉常用命令关键操作速查快速部署Ingress-Nginx的命令常用kubectl参数-n, -o wide, --watch等常见问题的一分钟修复方案考试重点范围Ingress资源的基本配置简单的路由规则定义基本的故障排查方法考试技巧在考试环境中可以预先准备好常用命令的文本片段以便快速粘贴使用节省宝贵时间。7. 性能优化与安全加固7.1 性能调优建议虽然考试环境通常不需要考虑性能问题但在实际工作中我们可以通过以下方式优化Ingress-Nginx调整Worker进程controller: config: worker-processes: 4启用Gzip压缩controller: config: gzip: on gzip-types: text/plain text/css application/json连接池优化controller: config: upstream-keepalive-connections: 1007.2 安全配置指南限制访问IPmetadata: annotations: nginx.ingress.kubernetes.io/whitelist-source-range: 192.168.1.0/24禁用不必要的方法metadata: annotations: nginx.ingress.kubernetes.io/limit-whitelist: GET, POST启用HSTSmetadata: annotations: nginx.ingress.kubernetes.io/hsts: true8. 实际应用场景扩展8.1 蓝绿部署支持通过Ingress-Nginx可以实现无缝的蓝绿部署apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: blue-green-ingress annotations: nginx.ingress.kubernetes.io/canary: true nginx.ingress.kubernetes.io/canary-weight: 20 spec: rules: - host: example.com http: paths: - path: / backend: service: name: green-service port: number: 80 - path: / backend: service: name: blue-service port: number: 808.2 灰度发布实现利用注解可以实现基于Header或Cookie的灰度发布metadata: annotations: nginx.ingress.kubernetes.io/canary: true nginx.ingress.kubernetes.io/canary-by-header: X-Canary nginx.ingress.kubernetes.io/canary-by-header-value: true8.3 自定义错误页面可以配置自定义的错误页面提升用户体验metadata: annotations: nginx.ingress.kubernetes.io/custom-http-errors: 404,500 nginx.ingress.kubernetes.io/default-backend: custom-error-pages9. 维护与监控9.1 健康检查配置确保Ingress-Nginx控制器的健康状态controller: livenessProbe: httpGet: path: /healthz port: 10254 initialDelaySeconds: 10 periodSeconds: 10 readinessProbe: httpGet: path: /healthz port: 10254 initialDelaySeconds: 10 periodSeconds: 109.2 监控指标暴露Ingress-Nginx内置了Prometheus指标端点controller: metrics: enabled: true service: annotations: prometheus.io/scrape: true prometheus.io/port: 102549.3 日志收集建议配置结构化日志以便分析controller: config: log-format-upstream: {time: $time_iso8601, remote_addr: $remote_addr, x-forward-for: $http_x_forwarded_for, request_id: $req_id, remote_user: $remote_user, bytes_sent: $bytes_sent, request_time: $request_time, status: $status, vhost: $host, request_proto: $server_protocol, path: $uri, request_query: $args, request_length: $request_length, duration: $request_time, method: $request_method, http_referrer: $http_referer, http_user_agent: $http_user_agent, upstream_addr: $upstream_addr, upstream_response_length: $upstream_response_length, upstream_response_time: $upstream_response_time, upstream_status: $upstream_status}10. 版本升级与回滚10.1 升级策略Ingress-Nginx控制器的升级需要谨慎操作查看当前版本kubectl get deploy -n ingress-nginx ingress-nginx-controller -o jsonpath{.spec.template.spec.containers[0].image}升级到指定版本kubectl set image -n ingress-nginx deployment/ingress-nginx-controller controllerregistry.k8s.io/ingress-nginx/controller:v1.8.1sha256:e5c4824e7375fcf2a393e1c03c293b69759af37a9ca6abdb91b13d78a93da8bd10.2 回滚操作如果升级后出现问题可以快速回滚kubectl rollout undo -n ingress-nginx deployment/ingress-nginx-controller查看回滚历史kubectl rollout history -n ingress-nginx deployment/ingress-nginx-controller11. 资源清理在练习完成后可以清理Ingress-Nginx相关资源kubectl delete -f deploy.yaml或者删除整个命名空间包含所有相关资源kubectl delete ns ingress-nginx12. 学习资源推荐为了更深入地掌握Ingress-Nginx可以参考以下资源官方文档https://kubernetes.github.io/ingress-nginx/GitHub仓库https://github.com/kubernetes/ingress-nginxKubernetes官方文档https://kubernetes.io/docs/concepts/services-networking/ingress/社区最佳实践https://www.nginx.com/blog/kubernetes-ingress-controllers-nginx-how-to-choose/