route-ingress-troubleshooting

Diagnose OpenShift Route and Ingress connectivity failures across layers.

71|88|Updated Nov 8, 2023
One-click install
npx skills add https://github.com/openshift/lightspeed-service --skill route-ingress-troubleshooting
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: route-ingress-troubleshooting
Source: https://github.com/openshift/lightspeed-service/tree/main/skills/route-ingress-troubleshooting
Command: npx skills add https://github.com/openshift/lightspeed-service --skill route-ingress-troubleshooting

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenShift Route and Ingress connectivity can fail with 502, 503, TLS errors, or become unreachable. This skill provides a structured, cross-layer diagnostic approach to identify the root cause.

Core Features & Use Cases

  • Trace the request path from Route/Ingress to backend services and pods to locate the first failing layer.
  • Validate Route admission, service existence and configuration, endpoints, pod readiness, and TLS termination types.
  • Provide actionable remediation recommendations and common pitfalls in OpenShift networking scenarios.

Quick Start

Troubleshoot a failing Route or Ingress by tracing the request path and report the first failing layer with actionable fixes.

Frequently Asked Questions about route-ingress-troubleshooting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot an OpenShift Route returning a 503 error?

To troubleshoot an OpenShift Route 503 error, trace the request path from the Route to backend services and pods to locate the first failing layer, validating endpoint availability and pod readiness to identify the root cause.

Why does my OpenShift Ingress fail with TLS termination errors?

OpenShift Ingress TLS termination errors occur when certificate configurations mismatch. Validate Route admission and TLS termination types across your routes to ensure accurate assessment and resolve connectivity failures.

How do I locate the first failing layer when an OpenShift Route is unreachable?

To locate the first failing layer for an unreachable OpenShift Route, apply a structured cross-layer diagnostic approach to trace the request path across services, endpoints, and pods in any namespace.

Can I use this diagnostic approach to check service existence and endpoints across any namespace?

Yes, you can apply this cross-layer diagnostic approach across routes, services, endpoints, and pods in any namespace to validate service existence, endpoint availability, and pod readiness for accurate assessment.

What is the best way to resolve 502 connectivity failures in OpenShift networking?

The best way to resolve 502 connectivity failures in OpenShift networking is to diagnose Route admission and endpoint availability, then apply the provided concrete remediation steps and common pitfalls to fix the configuration.