Knative Serving 部署中 IngressNotConfigured 问题的排查与解决

在 Kubernetes 上部署 Knative Serving 时，很多开发者会遇到 IngressNotConfigured 的问题。本文将以一个典型的多节点环境（Multipass + k3s）为例，深入分析该问题的成因和解决方案。

问题现象

当开发者按照官方文档部署 Knative Serving 后，创建 helloworld-go 服务时出现异常：

• 服务状态显示为 Unknown，原因为 IngressNotConfigured
• 查看 default-domain 相关 Pod 发现频繁重启或处于 Error 状态
• 日志中显示 webhook 调用失败的错误信息

根本原因分析

经过深入排查，发现该问题主要由两个关键因素导致：

1. 网络层配置不完整：虽然 Kourier 作为网络层已部署，但缺少必要的配置步骤，导致 Ingress 无法正常工作。

2. 默认域名配置失败：default-domain 任务未能正确执行，导致系统无法为服务分配正确的域名。

解决方案

1. 完整配置 Kourier 网络层

确保在部署 kourier.yaml 后执行以下关键步骤：

• 验证 Kourier 服务是否获得外部 IP
• 检查 kourier-system 命名空间下的相关 Pod 是否正常运行
• 确认网络策略允许必要的流量

2. 手动配置默认域名

当 default-domain 任务失败时，可以手动配置域名：

kubectl patch configmap/config-domain \
  --namespace knative-serving \
  --type merge \
  --patch '{"data":{"<your-ip>.sslip.io":""}}'

3. 验证 Webhook 服务

确保 webhook 服务正常运行：

• 检查 webhook Pod 的状态
• 验证服务端点是否可用
• 检查相关网络策略是否允许内部通信

最佳实践建议

1. 部署顺序：严格按照组件依赖关系部署，先完成核心组件再配置网络层。

2. 日志监控：部署后立即检查各组件的日志，特别是 webhook 和 default-domain 相关 Pod。

3. 分步验证：每完成一个部署步骤就进行验证，不要一次性部署所有组件。

4. 环境准备：确保 Kubernetes 集群满足 Knative 的最低要求，特别是网络插件要兼容。

总结

Knative Serving 的 IngressNotConfigured 问题通常源于网络层配置不完整或默认域名设置失败。通过系统性地检查网络组件状态、手动配置域名以及验证 webhook 服务，可以有效解决这类问题。对于初学者来说，理解 Knative 各组件间的依赖关系至关重要，这有助于快速定位和解决问题。