Windows 调试技巧

节点级故障排除

我的 Pod 停留在“容器正在创建”状态或反复重启
确保您的 pause 镜像与您的 Windows 操作系统版本兼容。请参见暂停容器以查看最新的/推荐的 pause 镜像，或获取更多信息。
注意
如果使用 containerd 作为容器运行时，则 pause 镜像在 config.toml 配置文件中的 plugins.plugins.cri.sandbox_image 字段中指定。
我的 Pod 状态显示为 ErrImgPull 或 ImagePullBackOff
确保您的 Pod 已调度到与兼容的 Windows 节点。
有关如何为您的 Pod 指定兼容节点的更多信息，请参阅本指南。

网络故障排除

我的 Windows Pod 无法连接到网络
如果您使用虚拟机，请确保所有 VM 网络适配器上都 **启用了** MAC 欺骗。
我的 Windows Pod 无法 ping 外部资源
Windows Pod 没有为 ICMP 协议编程出站规则。但是，支持 TCP/UDP。当尝试演示与集群外部资源的连接时，请将 ping <IP> 替换为相应的 curl <IP> 命令。
如果您仍然遇到问题，很可能是您在 cni.conf 中的网络配置需要特别注意。您可以随时编辑此静态文件。配置更新将应用于任何新的 Kubernetes 资源。
Kubernetes 网络要求之一（参见 Kubernetes 模型）是集群通信在内部不发生 NAT。为了满足这一要求，对于所有您不希望发生出站 NAT 的通信，有一个例外列表。但是，这也意味着您需要将您尝试查询的外部 IP 从 例外列表 中排除。只有这样，来自您的 Windows Pod 的流量才能被正确地 SNAT，从而从外部世界接收响应。在这方面，您在 cni.conf 中的 例外列表 应如下所示
```
"ExceptionList": [
                "10.244.0.0/16",  # Cluster subnet
                "10.96.0.0/12",   # Service subnet
                "10.127.130.0/24" # Management (host) subnet
            ]
```
我的 Windows 节点无法访问 NodePort 类型的服务
节点本身的本地 NodePort 访问失败。这是一个已知的限制。NodePort 访问可从其他节点或外部客户端进行。
容器的 vNIC 和 HNS 终结点正在被删除
当未将 hostname-override 参数传递给 kube-proxy 时，可能会出现此问题。要解决此问题，用户需要将主机名传递给 kube-proxy，如下所示
```
C:\k\kube-proxy.exe --hostname-override=$(hostname)
```
我的 Windows 节点无法使用服务 IP 访问我的服务
这是 Windows 上的网络堆栈的已知限制。但是，Windows Pod 可以访问服务 IP。
在启动 kubelet 时未找到网络适配器
Windows 网络堆栈需要一个虚拟适配器才能使 Kubernetes 网络正常工作。如果以下命令没有返回任何结果（在管理员 shell 中），则虚拟网络创建（kubelet 正常工作的前提条件）失败
```
Get-HnsNetwork | ? Name -ieq "cbr0"
Get-NetAdapter | ? Name -Like "vEthernet (Ethernet*"
```
通常情况下，修改 InterfaceName 参数 start.ps1 脚本，在主机网络适配器不是“以太网”的情况下。否则，请查看 start-kubelet.ps1 脚本的输出，查看虚拟网络创建过程中是否存在错误。
DNS 解析无法正常工作
查看本部分中的 Windows DNS 限制。
kubectl port-forward 失败，显示“无法执行端口转发：未找到 wincat”
这是在 Kubernetes 1.15 中实现的，方法是在 pause 基础架构容器 mcr.microsoft.com/oss/kubernetes/pause:3.6 中包含 wincat.exe。确保使用支持的 Kubernetes 版本。如果您想构建自己的 pause 基础架构容器，请确保包含 wincat。

我的 Kubernetes 安装失败，因为我的 Windows Server 节点位于代理后面

如果您位于代理后面，则必须定义以下 PowerShell 环境变量

[Environment]::SetEnvironmentVariable("HTTP_PROXY", "http://proxy.example.com:80/", [EnvironmentVariableTarget]::Machine)
[Environment]::SetEnvironmentVariable("HTTPS_PROXY", "http://proxy.example.com:443/", [EnvironmentVariableTarget]::Machine)

Flannel 故障排除

使用 Flannel 时，我的节点在重新加入集群后出现问题
每当以前删除的节点重新加入集群时，flannelD 都会尝试为该节点分配一个新的 Pod 子网。用户应删除以下路径中的旧 Pod 子网配置文件
```
Remove-Item C:\k\SourceVip.json
Remove-Item C:\k\SourceVipRequest.json
```
Flanneld 卡在“等待创建网络”状态
有大量关于此问题的报告；最可能的原因是 flannel 网络管理 IP 设置的时机问题。解决方法是重新启动 start.ps1，或手动重新启动，如下所示
```
[Environment]::SetEnvironmentVariable("NODE_NAME", "<Windows_Worker_Hostname>")
C:\flannel\flanneld.exe --kubeconfig-file=c:\k\config --iface=<Windows_Worker_Node_IP> --ip-masq=1 --kube-subnet-mgr=1
```
我的 Windows Pod 由于缺少 /run/flannel/subnet.env 而无法启动
这表明 Flannel 未能正确启动。您可以尝试重新启动 flanneld.exe，也可以从 Kubernetes 主节点上的 /run/flannel/subnet.env 手动复制文件到 Windows 工作节点上的 C:\run\flannel\subnet.env，并将 FLANNEL_SUBNET 行修改为不同的数字。例如，如果需要节点子网 10.244.4.1/24
```
FLANNEL_NETWORK=10.244.0.0/16
FLANNEL_SUBNET=10.244.4.1/24
FLANNEL_MTU=1500
FLANNEL_IPMASQ=true
```

进一步调查

如果这些步骤无法解决您的问题，您可以通过以下方式获得在 Kubernetes 中运行 Windows 容器的帮助

StackOverflow Windows Server Container 主题
Kubernetes 官方论坛 discuss.kubernetes.io
Kubernetes Slack #SIG-Windows 频道

上次修改时间：2023 年 12 月 24 日晚上 9:00 PST：修复错别字 (d536e46dbd)

Windows 调试技巧

节点级故障排除

注意

网络故障排除

Flannel 故障排除

进一步调查

反馈