本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
App Mesh Kubernetes 故障排除
终止支持通知:2026 年 9 月 30 日, Amazon 将停止对的支持。 Amazon App Mesh 2026 年 9 月 30 日之后,您将无法再访问 Amazon App Mesh 控制台或 Amazon App Mesh 资源。有关更多信息,请访问这篇博客文章从 Amazon App Mesh 亚马逊ECS服务连接迁移
本主题详细介绍了在 Kubernetes 中使用 App Mesh 时可能遇到的常见问题。
在 App Mesh 中找不到在 Kubernetes 中创建的应用网格资源
症状
您已经使用 Kubernetes 自定义资源定义 (CRD) 创建了应用网格资源,但是当您使用或 API 时,您创建的资源在 App Mesh 中不可见。 Amazon Web Services 管理控制台
解决方案
可能的原因是 App Mesh 的 Kubernetes 控制器出现错误。有关更多信息,请参阅上的
kubectl logs -n appmesh-system -f \ $(kubectl get pods -n appmesh-system -o name | grep controller)
如果您的问题仍未解决,请考虑提出GitHub 问题
注入 Envoy sidecar 后,容器组 (pod) 无法进行就绪和活跃度检查
症状
您的应用程序的 pod 之前已成功运行,但是在 Envoy sidecar 注入容器组 (pod) 后,就绪和活跃度检查开始失败。
解决方案
确保注入到容器组 (pod) 的 Envoy 容器已通过 App Mesh 的 Envoy 管理服务进行引导。您可以通过参考 Envoy 已断开与 App Mesh Envoy 管理服务的连接, 中的错误代码来验证任何错误。您可以使用以下命令检查相关容器组 (pod) 的 Envoy 日志。
kubectl logs -n appmesh-system -f \ $(kubectl get pods -n appmesh-system -o name | grep controller) \ | grep "gRPC config stream closed"
如果您的问题仍未解决,请考虑提出GitHub 问题
Pod 未注册或取消注册为 Amazon Cloud Map 实例
症状
您的 Kubernetes Pod 在生命周期中没有注册或注销其注册。 Amazon Cloud Map 容器组 (pod) 可能成功启动并准备好提供流量,但无法接收任何流量。当容器组 (pod) 终止时,客户端仍可能保留其 IP 地址并尝试向其发送流量,但失败了。
解决方案
这是一个已知问题。有关更多信息,请参阅 Kubernetes 中的 Pod 无法自动 registered/deregistered 启动时出现问题。 Amazon Cloud Map
为了缓解这个问题:
-
确保您运行的是适用于 Kubernetes 的最新版本的 App Mesh 控制器。
-
确保虚拟节点定义
serviceName中的 Amazon Cloud MapnamespaceName和正确无误。 -
在删除虚拟节点定义之前,请务必删除所有关联的容器组 (pod)。如果您需要帮助来确定哪些容器组 (pod) 与虚拟节点相关联,请参阅 无法确定 App Mesh 资源的容器组 (pod) 在何处运行。
-
如果问题仍然存在,请运行以下命令来检查控制器日志中是否存在可能有助于揭示潜在问题的错误。
kubectl logs -n appmesh-system \ $(kubectl get pods -n appmesh-system -o name | grep appmesh-controller) -
考虑使用以下命令重启控制器容器组 (pod)。这可能会修复同步问题。
kubectl delete -n appmesh-system \ $(kubectl get pods -n appmesh-system -o name | grep appmesh-controller)
如果您的问题仍未解决,请考虑提出GitHub 问题
无法确定 App Mesh 资源的容器组 (pod) 在何处运行
症状
当您在 Kubernetes 集群上运行 App Mesh 时,操作员无法确定给定的 App Mesh 资源的工作负载或容器在哪里运行。
解决方案
Kubernetes 容器组 (pod) 资源使用与其关联的网格和虚拟节点进行注释。您可以使用以下命令查询哪些容器组 (pod) 正在为给定的虚拟节点名称运行。
kubectl get pods --all-namespaces -o json | \ jq '.items[] | { metadata } | select(.metadata.annotations."appmesh.k8s.aws/virtualNode" == "virtual-node-name")'
如果您的问题仍未解决,请考虑提出GitHub 问题
无法确定容器组 (pod) 以哪个 App Mesh 资源运行
症状
在 Kubernetes 集群上运行 App Mesh 时,操作员无法确定给定的容器组 (pod) 以什么形式运行 App Mesh 资源。
解决方案
Kubernetes 容器组 (pod) 资源使用与其关联的网格和虚拟节点进行注释。您可以使用以下命令直接查询容器组 (pod) 来输出网格和虚拟节点的名称。
kubectl get podpod-name-nnamespace-o json | \ jq '{ "mesh": .metadata.annotations."appmesh.k8s.aws/mesh", "virtualNode": .metadata.annotations."appmesh.k8s.aws/virtualNode" }'
如果您的问题仍未解决,请考虑提出GitHub 问题
禁用 imdsV1 后,客户 Envoy 无法与 App Mesh Envoy 管理服务通信
症状
禁用 IMDSv1 后,客户 Envoy 无法与 App Mesh 控制面板(Envoy 管理服务)通信。v1.24.0.0-prod之前的 App Mesh Envoy 版本不提供支持 IMDSv2。
解决方案
要解决这个问题,你可以做这三件事之一。
-
升级到 App Mesh Envoy 版本
v1.24.0.0-prod或更高版本,该版本有IMDSv2支持。 -
Re-enable
IMDSv1在运行 Envoy 的实例上。有关恢复的说明IMDSv1,请参阅配置实例元数据选项。 -
如果您的服务在 Amazon EKS 上运行,建议使用服务账户的 IAM 角色 (IRSA) 来获取凭证。有关启用 IRSA 的说明,请参阅服务账户https://docs.amazonaws.cn/eks/latest/userguide/iam-roles-for-service-accounts.html的 IAM 角色。
如果您的问题仍未解决,请考虑提出GitHub 问题
启用 App Mesh 并注入 Envoy 后 IRSA 无法在应用程序容器上运行
症状
在 Amazon EKS 的 App Mesh 控制器的帮助下,在 Amazon EKS 集群上启用 App Mesh 时,Envoy 和 proxyinit 容器将注入到应用程序容器组 (pod) 中。应用程序无法假设 IRSA,而是假设 node
role。当我们描述容器组 (pod) 的详细信息时,我们会看到应用程序容器中不包含 AWS_WEB_IDENTITY_TOKEN_FILE 或 AWS_ROLE_ARN 环境变量。
解决方案
如果定义了 AWS_WEB_IDENTITY_TOKEN_FILE 或 AWS_ROLE_ARN 环境变量,则 webhook 将跳过容器组 (pod)。不要提供这两个变量中的任何一个,webhook 会为您注入它们。
reservedKeys := map[string]string{ "AWS_ROLE_ARN": "", "AWS_WEB_IDENTITY_TOKEN_FILE": "", } ... for _, env := range container.Env { if _, ok := reservedKeys[env.Name]; ok { reservedKeysDefined = true }
如果您的问题仍未解决,请考虑提出GitHub 问题