huawei-cloud-cce-pod-failure-diagnoser

Diagnose Huawei Cloud CCE Pod failures using hcloud and read-only kubectl-cce evidence.

1|Updated May 27, 2026
One-click install
npx skills add https://github.com/pancake0001/huawei-cloudnative-skills --skill huawei-cloud-cce-pod-failure-diagnoser-pancake0001
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: huawei-cloud-cce-pod-failure-diagnoser
Source: https://github.com/pancake0001/huawei-cloudnative-skills/tree/main/releases/container/cce/huawei-cloud-cce-pod-failure-diagnoser
Command: npx skills add https://github.com/pancake0001/huawei-cloudnative-skills --skill huawei-cloud-cce-pod-failure-diagnoser-pancake0001

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? When Pods in a Huawei Cloud CCE cluster enter CrashLoopBackOff, ImagePullBackOff, OOMKilled, Pending, or Evicted states, engineers must manually correlate Events, logs, metrics, and node conditions to find the root cause. This Skill automates that read-only evidence collection and ranks the most likely causes with direct evidence. ## Core Features & Use Cases - Lifecycle-based cause ranking: Walks the Pod lifecycle funnel (admission, scheduling, volume mount, image pull, container start, probes, node pressure) and ranks causes such as ImagePullFailure, OOMKilled, SchedulingBlocked, StorageMountFailure, and SandboxOrCNIBlocked with cited evidence. - Structured evidence collection: Gathers Pod status, Events, current and previous container logs, metrics-server data, and node/PVC context through hcloud CCE and the kubectl-cce plugin, with strict cluster ID validation and credential redaction. - Scenario-specific guidance: Applies dedicated guides for ImagePullBackOff, CrashLoopBackOff, OOMKilled, Pending, storage mount failures, eviction, probe failures, CNI/sandbox failures, and quota/admission rejections, producing a Markdown or JSON report with ruled-out causes and handoff recommendations. - Use Case: A Deployment's Pods are stuck in ImagePullBackOff. The Skill resolves the cluster UUID, pulls Pod Events, identifies a missing repository tag, rules out scheduling and OOM causes, and recommends fixing the image reference—without running any mutating command. ## Quick Start Ask the AI to diagnose why Pod my-app-xxx in namespace default of CCE cluster <cluster-id> in region cn-north-4 is in CrashLoopBackOff and produce a root-cause report.

Frequently Asked Questions about huawei-cloud-cce-pod-failure-diagnoser

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

FAQPage Schema
How do I diagnose a CrashLoopBackOff Pod in Huawei Cloud CCE?▼

Provide the region, cluster ID, namespace, and Pod name. The Skill collects Pod status, Events, and previous container logs via kubectl cce, then ranks causes such as application startup errors, bad commands, or probe failures with cited evidence.

How to troubleshoot ImagePullBackOff on CCE with kubectl?▼

Use Pod Events as primary evidence instead of logs, since the container never started. The Skill checks the image reference, tag, registry auth, imagePullSecrets, and DNS signals, then recommends fixing the image field or pull secret.

What tools are required for CCE Pod diagnosis?▼

You need the hcloud KooCLI for cluster discovery and kubectl with the kubectl-cce plugin for Kubernetes reads. Credentials come from hcloud configuration or explicit CLI flags, and the kubectl-cce-installer skill can repair missing tools.

Can this Skill restart or delete failing Pods automatically?▼

No. The Skill is strictly read-only and never runs apply, delete, scale, drain, or rollback commands. Any mutating remediation is handed off as a recommendation to the auto-remediation-runner skill after user confirmation.

Why does kubectl top pod fail during CCE diagnosis?▼

The Metrics API is unavailable when metrics-server is missing or RBAC denies access. The Skill records this as a verification gap and continues with Events, logs, and status evidence instead of inventing resource trends.

What happens if I provide a cluster name instead of a UUID?▼

The Skill lists CCE clusters via hcloud and performs an exact unique name match to resolve the UUID, then verifies it with ShowCluster. Ambiguous or unmatched names stop the diagnosis and prompt for a correct cluster ID.