k8s_gpu_pod_troubleshooter

Diagnose GPU pod scheduling and allocation issues in Kubernetes clusters with HAMi.

4.3k|742|Updated Sep 14, 2021
One-click install
npx skills add https://github.com/Project-HAMi/HAMi --skill k8s-gpu-pod-troubleshooter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: k8s_gpu_pod_troubleshooter
Source: https://github.com/Project-HAMi/HAMi/tree/main/skill/k8s-debug-gpu-pod
Command: npx skills add https://github.com/Project-HAMi/HAMi --skill k8s-gpu-pod-troubleshooter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps diagnose and resolve complex issues related to GPU pod scheduling, allocation, and runtime failures within Kubernetes clusters managed by HAMi.

Core Features & Use Cases

  • Component Health Check: Verifies the status of HAMi scheduler, device plugins, and webhooks.
  • Resource Analysis: Assesses GPU node capacity, allocatable resources, and pending pod requests.
  • Troubleshooting Workflow: Guides users through steps to identify root causes of GPU-related CrashLoopBackOff, pending pods, and scheduling conflicts.
  • Use Case: A data science team is experiencing CrashLoopBackOff errors for their GPU-accelerated training pods. This Skill can systematically identify whether the issue stems from HAMi component failures, insufficient GPU resources, incorrect webhook configurations, or driver mismatches on the nodes.

Quick Start

Use the k8s_gpu_pod_troubleshooter skill to diagnose why my GPU pods are stuck in pending status in the 'ai-ml' namespace.

Frequently Asked Questions about k8s_gpu_pod_troubleshooter

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

FAQPage Schema
Why are my Kubernetes GPU pods stuck in pending status?

Kubernetes GPU pods get stuck in pending status when HAMi components fail, GPU resources are insufficient, or scheduling policies conflict. This diagnostic workflow checks HAMi scheduler health, device plugin status, and pending pod requests to identify the exact root cause.

How do I troubleshoot CrashLoopBackOff errors on GPU pods in Kubernetes?

Troubleshoot CrashLoopBackOff errors on Kubernetes GPU pods by systematically checking HAMi webhook mutations, device plugin configurations, container runtime settings, and driver mismatches. This workflow isolates component failures and provides actionable remediation guidance.

How does the HAMi webhook affect Kubernetes GPU pod scheduling?

The HAMi webhook mutates pod specifications during Kubernetes GPU scheduling to enforce allocation policies. Webhook misconfigurations cause pod allocation failures, which this diagnostic workflow detects by verifying webhook status against expected mutation rules.

Can I diagnose insufficient GPU resource allocation in a HAMi managed cluster?

You can diagnose insufficient GPU resource allocation in HAMi managed clusters by analyzing GPU node capacity and allocatable resources against pending pod requests. This workflow assesses resource availability to determine if scheduling failures stem from true resource scarcity.

What is the best way to check HAMi device plugin health in a Kubernetes cluster?

The best way to check HAMi device plugin health is running a comprehensive diagnostic workflow that verifies the device plugin status alongside the HAMi scheduler and webhooks. This identifies plugin errors causing GPU pod scheduling conflicts.

What causes scheduling policy conflicts for Kubernetes GPU pods using HAMi?

Scheduling policy conflicts for Kubernetes GPU pods arise from HAMi webhook misconfigurations, device plugin errors, or mismatched container runtime configurations. This diagnostic workflow systematically checks these components to resolve allocation failures.