kubectl directpv suspend drives

The kubectl directpv suspend drives command suspends drives and marks their volumes as read-only. Suspending a drive mounts its volumes to an empty temporary directory, allowing StatefulSet pods to start even when the underlying drive is unavailable.

Suspend drives before performing maintenance tasks such as drive repair.

To restore normal operation, use kubectl directpv resume drives.

kubectl directpv suspend drives af3b8b4c-73b4-4a74-84b7-1ec30492a6f0 --dangerous

┌────────────────────────────────────────┬─────────────────────────────┐
│ DRIVE                                  │ MESSAGE                     │
├────────────────────────────────────────┼─────────────────────────────┤
│ af3b8b4c-73b4-4a74-84b7-1ec30492a6f0   │ Suspended                   │
└────────────────────────────────────────┴─────────────────────────────┘

kubectl directpv suspend drives [DRIVE_ID ...]          \
                                --dangerous             \
                                [-d|--drives "string"]  \
                                [--dry-run]             \
                                [-n|--nodes "string"]

Optional

The unique identifier of one or more drives to suspend. Specify multiple drive IDs separated by spaces. Use kubectl directpv list drives to find drive IDs.

Required

Confirms that you understand suspending drives makes their volumes read-only. The command does not run without this flag.

Optional

Suspend drives on specific nodes. Specify multiple nodes as a comma-separated list or by repeating the flag. Supports ellipsis expansion notation.

Short form: -n

Optional

Suspend drives by name. Specify multiple drives as a comma-separated list or by repeating the flag. Supports ellipsis expansion notation.

Short form: -d

Optional

Display what drives would be suspended without making changes.

This command supports the following global flags:

Suspend a specific drive before performing repair or maintenance:

kubectl directpv suspend drives af3b8b4c-73b4-4a74-84b7-1ec30492a6f0 --dangerous

Suspend all drives on node1 for node-level maintenance:

kubectl directpv suspend drives --nodes=node1 --dangerous

Suspend only drive sda on node1:

kubectl directpv suspend drives --nodes=node1 --drives=sda --dangerous

Check which drives would be suspended without making changes:

kubectl directpv suspend drives --nodes=node1 --dry-run

By Kubernetes design, an active StatefulSet workload requires that all of its Pods are in a running state. A faulty drive prevents the StatefulSet from starting.

Suspending a drive provides a workaround by mounting the affected volumes to an empty temporary directory (/var/lib/directpv/tmp) with read-only access. This allows the StatefulSet to start while repairing or replacing the drive.

When you suspend a drive:

1. DirectPV remounts volumes to an empty temporary directory.
2. Volumes become read-only.
3. The drive status shows Suspended.
4. StatefulSet Pods using these volumes can start (with read-only data access).

You must specify at least one selection method:

• One or more DRIVE_ID arguments
• --nodes flag
• --drives flag

After suspending, verify the drive status:

kubectl directpv list drives --all

Suspended drives show Ready,Suspended in the status column.

After completing maintenance or repair:

1. Resume the drive using kubectl directpv resume drives.
2. Verify drive status using kubectl directpv list drives.