statefulset-debug

Diagnose Kubernetes StatefulSet rollout and scaling failures via pod ordinals, PVC bindings, and update strategies.

225|28|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/scitix/siclaw --skill statefulset-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: statefulset-debug
Source: https://github.com/scitix/siclaw/tree/main/skills/core/statefulset-debug
Command: npx skills add https://github.com/scitix/siclaw --skill statefulset-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps SREs and DevOps engineers quickly identify and understand the root causes of failures in Kubernetes StatefulSet rollouts and scaling operations.

Core Features & Use Cases

  • Rollout Stuck Diagnosis: Pinpoints why a StatefulSet update is not progressing, whether due to pod issues, update strategy misconfigurations, or partitions.
  • Scaling Failure Analysis: Investigates why scaling up or down operations for a StatefulSet might be blocked.
  • PVC Binding Deadlock Detection: Identifies issues where pods are stuck pending due to PersistentVolumeClaim binding problems.
  • Use Case: A StatefulSet managing a database cluster is stuck during an update, and new pods are not becoming ready. This Skill will analyze the StatefulSet's configuration, pod statuses, and PVC bindings to determine if the issue is with a specific pod's readiness probe, a OnDelete strategy not being followed, or a PVC topology conflict.

Quick Start

Use the statefulset-debug skill to diagnose why the statefulset 'my-db' in the 'production' namespace is not updating.

Frequently Asked Questions about statefulset-debug

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

FAQPage Schema
Why is my Kubernetes StatefulSet rollout stuck and not progressing?

A Kubernetes StatefulSet rollout stall is often caused by pod readiness probe failures, OnDelete strategy misconfigurations, or partition settings preventing ordered updates. Diagnosing the issue requires analyzing pod ordinals, update strategies, and PVC bindings.

How do I debug PVC binding deadlocks when scaling a StatefulSet?

To debug PVC binding deadlocks during StatefulSet scaling, analyze PersistentVolumeClaim binding statuses and pod pending states. This identifies topology conflicts or storage constraints blocking pods from starting in the ordered startup sequence.

What causes a StatefulSet OnDelete update strategy to stop working?

A StatefulSet OnDelete update strategy stops working when manual pod deletions are not triggering the expected recreation with new configurations. Analyzing pod ordinals and update strategy adherence identifies whether controllers are skipping updates or if partitions are misconfigured.

Do I need kubectl to diagnose StatefulSet scaling failures?

Yes, you need kubectl for cluster interaction to diagnose StatefulSet scaling failures. Understanding the StatefulSet lifecycle and using kubectl to inspect pod statuses, update strategies, and PVC bindings are required to identify the root cause.

How does StatefulSet ordered startup sequence affect pod scaling?

The StatefulSet ordered startup sequence affects pod scaling by requiring each pod to become ready before the next one starts. If a pod fails its readiness probe or encounters a PVC binding issue, the entire scaling operation blocks until the deadlock is resolved.