容器与云原生 / 系统课时

配置入口控制器基础能力

配置入口控制器基础能力

本课以 ingress-nginx 为实验入口控制器,完成控制器部署、IngressClass 绑定和基本可用性检查。完成后,集群中的 Ingress 才有实际的控制器接管者,并能进入后续请求验证。

学习目标

  • 能安装并确认 ingress-nginx Controller 正常运行。
  • 能理解 IngressClass 与控制器之间的绑定关系。
  • 能用 Kubernetes 对象状态和控制器日志完成基础健康检查。

选择控制器与安装方式

Ingress 本身只是规则对象,真正负责监听 Ingress、生成代理配置并处理请求的是 Ingress Controller。实验环境使用 ingress-nginx,安装方式采用 Helm,便于重复部署和调整参数。

单实例实验环境可以把 nginx IngressClass 设为默认类。这样显式使用 spec.ingressClassName: nginx 的 Ingress 会明确交给该控制器处理;默认类主要解决遗漏类名时的接管问题。

bash
helm upgrade --install ingress-nginx ingress-nginx \
  --repo https://kubernetes.github.io/ingress-nginx \
  --namespace ingress-nginx \
  --create-namespace \
  --set controller.ingressClassResource.default=true

预期结果

text
Release "ingress-nginx" has been installed or upgraded.
The release is deployed in namespace ingress-nginx.

实际 Helm 输出会随版本变化,重点不是逐字匹配提示,而是命令成功返回且 Release 状态正常。

验证 Controller 与 IngressClass

先检查 Controller Pod。只有 Pod 已进入 Running 且 Ready,才适合继续验证入口规则。再检查 IngressClass,确认类名和控制器标识能够对应起来。

bash
kubectl get pods -n ingress-nginx
kubectl get ingressclass nginx -o jsonpath='{.metadata.name}{" controller="}{.spec.controller}{" default="}{.metadata.annotations.ingressclass\.kubernetes\.io/is-default-class}{"\n"}'

预期结果

text
NAME                                        READY   STATUS    RESTARTS   AGE
ingress-nginx-controller-<ID>              1/1     Running   0          <TIME>
nginx controller=k8s.io/ingress-nginx default=true

其中 Pod 名称、年龄和实例标识会因环境不同而变化。关键检查点是 Controller 已 Ready,且 IngressClass 的 spec.controller 与 ingress-nginx 使用的控制器类一致。

建立最小接管配置

控制器安装完成后,实际的 Ingress 应显式声明 ingressClassName: nginx,不要依赖历史的 kubernetes.io/ingress.class 注解。IngressClass 是 Kubernetes 用来把 Ingress 与具体控制器关联起来的正式资源。

yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: demo
  namespace: default
spec:
  ingressClassName: nginx
  rules:
    - host: demo.localdev.me
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: demo
                port:
                  number: 80

这是片段示例,前提是 default 命名空间中已经存在名为 demo、端口为 80 的 Service。它的作用是验证控制器能够识别目标 IngressClass,并获得一条可处理的入口规则。

基础故障检查

如果 Controller 一直没有 Ready,先不要排查业务 Service。优先检查 Pod 状态、事件和控制器日志;如果 Controller 正常而 Ingress 没有被处理,再检查 ingressClassName、IngressClass 和 Ingress 本身的事件。

bash
kubectl describe pod -n ingress-nginx -l app.kubernetes.io/component=controller
kubectl logs -n ingress-nginx deployment/ingress-nginx-controller --tail=50
kubectl describe ingress demo

预期结果

text
Pod: Ready=True
Controller log: no fatal startup error
Ingress: ingressClassName=nginx
Events: no persistent configuration error

这些结果不要求日志内容逐字一致。基础能力成立的判断标准是:控制器进程正常、Ready 探针通过、目标 Ingress 使用正确的类,并且控制器没有持续报告无法解析或应用入口配置的错误。

配置入口控制器时,真正的验收点不是“Helm 命令成功”,而是形成完整的接管关系:Controller 运行 → IngressClass 指向 Controller → Ingress 指定 IngressClass。这条关系成立后,后续才能从客户端请求一路验证到入口规则和后端服务。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

配置入口控制器基础能力

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通