k8s-envoy-gateway-troubleshooting
Use when Envoy Gateway (the Gateway API implementation by the Envoy project) does not route traffic in Kubernetes: a Gateway that is not Programmed ("AddressNotAssigned"), an HTTPRoute that is not Accepted ("NoMatchingListenerHostname", "NotAllowedByListeners") or whose ResolvedRefs is False ("BackendNotFound", "RefNotPermitted" without a ReferenceGrant), clients getting 404, 500 or 503 "no healthy upstream" from the gateway, a GatewayClass that is not Accepted, or BackendTrafficPolicy, ClientTrafficPolicy, SecurityPolicy and EnvoyProxy resources that do not apply. Investigates with kubectl get, describe, events and logs, and proposes fixes. Reads first and asks before changing anything.
- License
- Apache-2.0
Pinned to revision ce7de97330d7, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/k8s-envoy-gateway-troubleshooting/SKILL.md
- skills/k8s-envoy-gateway-troubleshooting/.claude-plugin/plugin.json
- skills/k8s-envoy-gateway-troubleshooting/references/gateways-and-policies.md
- skills/k8s-envoy-gateway-troubleshooting/references/routes.md
Every link opens the file at its source, pinned to the revision this page describes.