Debug Cluster

Automate debugging workflows for HyperShift hosted clusters using kubectl and operator logs.

536|544|Updated Jan 18, 2021
One-click install
npx skills add https://github.com/openshift/hypershift --skill debug-cluster
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Debug Cluster
Source: https://github.com/openshift/hypershift/tree/main/.claude/skills/debug-cluster
Command: npx skills add https://github.com/openshift/hypershift --skill debug-cluster

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill eliminates the frustration of debugging complex HyperShift hosted-cluster problems by providing structured workflows and expert troubleshooting methodologies.

Core Features & Use Cases

  • Structured Debugging: Step-by-step investigation processes for common cluster issues like stuck deletions and control plane problems.
  • Provider-Agnostic Workflows: Comprehensive debugging approaches that work across all cloud platforms.
  • Use Case: When your HyperShift cluster is stuck in deletion state, use this Skill to systematically identify whether the issue is with NodePools, HostedControlPlane resources, or namespace cleanup.

Quick Start

Use the Debug Cluster skill to investigate why my hosted-cluster named 'production-cluster' is stuck in deleting state.

Frequently Asked Questions about Debug Cluster

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

FAQPage Schema
How do I troubleshoot a HyperShift cluster stuck in deletion state?

Troubleshooting a stuck deletion uses systematic workflows to identify whether the issue originates in NodePools, HostedControlPlane resources, or namespace cleanup. The Skill applies provider-agnostic diagnostic steps with kubectl and operator logs across HostedCluster, HostedControlPlane, NodePool, and CAPI resources to isolate the root cause.

What debugging workflows does HyperShift cluster troubleshooting cover?

Debugging workflows address deletion issues, stuck resources and finalizers, control plane problems, and NodePool lifecycle events. The Skill enforces standardized command sequences and coordinated checks across cluster resources with hooks to provider-specific subskills for comprehensive problem diagnosis.

Can I debug HyperShift clusters across different cloud providers?

Yes. The Skill provides provider-agnostic debugging approaches that work across all cloud platforms. It applies the same structured troubleshooting methodologies regardless of whether your hosted cluster runs on AWS, Azure, GCP, or other providers.

How do I investigate control plane problems in a hosted cluster?

Investigating control plane issues uses standardized diagnostic sequences including kubectl commands and operator log analysis. The Skill systematically checks HostedControlPlane and HostedCluster resources to identify whether the problem stems from resource constraints, configuration drift, or lifecycle events.

What should I check when NodePool resources are causing cluster issues?

Checking NodePool resources involves examining lifecycle events, finalizers, and resource deletion status through coordinated checks. The Skill provides structured steps to determine whether NodePool problems are blocking cluster operations or preventing successful deletion.

Do I need Kubernetes knowledge to debug HyperShift cluster problems?

Yes. HyperShift cluster debugging requires familiarity with Kubernetes concepts like resources, namespaces, and kubectl commands. The Skill builds on this foundation by automating workflows and providing expert troubleshooting methodologies for hosted-cluster-specific issues.