Shard
longhorn.io / v1beta2
apiVersion: longhorn.io/v1beta2
kind: Shard
metadata:
name: example
apiVersion
string
APIVersion defines the versioned schema of this representation of an object.
Servers should convert recognized schemas to the latest internal value, and
may reject unrecognized values.
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
kind
string
Kind is a string value representing the REST resource this object represents.
Servers may infer this from the endpoint the client submits requests to.
Cannot be updated.
In CamelCase.
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
metadata
object
spec object
ShardSpec defines the desired state of the Longhorn Shard
diskPath
string
DiskPath is the path of the disk that hosts the shard lvol.
diskUUID
string
DiskUUID is the UUID of the disk that hosts the shard lvol.
evictionRequested
boolean
EvictionRequested indicates this shard should be relocated to a different node or disk.
Set by the node controller when the shard's node is being drained or its disk is evicted.
nodeID
string
NodeID is the node where this shard's lvol resides and its NVMe-oF target runs.
shardGroupName
string
ShardGroupName is the name of the owning ShardGroup CR. Immutable after creation.
size
string
Size is the shard lvol size in bytes. Set by the ShardGroup controller at creation time
and used for idempotent reconciliation.
format:
int64
slotIndex
integer
SlotIndex is the zero-based position of this shard in the EC base-bdev array.
Determines the shard's role: indices 0..k-1 are DATA, k..k+m-1 are PARITY.
Immutable after creation.
minimum:
0status object
ShardStatus defines the observed state of the Longhorn Shard
lastFailureTimestamp
string
LastFailureTimestamp is the RFC3339 timestamp of the most recent shard failure.
ownerID
string
OwnerID is the ID of the node that owns this Shard.
port
integer
Port is the NVMe-oF port of the shard's target export.
format:
int32
rebuildProgress
integer
RebuildProgress is the rebuild completion percentage (0-100).
replaceTriggered
boolean
ReplaceTriggered is set to true after shard replacement has been initiated, to prevent
re-issuing the replace command on subsequent cycles while SPDK advances the slot state.
Cleared when the slot state transitions away from Failed.
role
string
Role is the EC role of this slot (data or parity). Derived from SlotIndex and the parent
ShardGroup's DataChunks; stored here for informational purposes only.
enum:
data, parity,
state
string
State is the health state of this EC shard slot.
enum:
normal, failed, replacing,
storageIP
string
StorageIP is the IP address of the NVMe-oF target exported by the shard's InstanceManager.
Populated after the shard instance is running.
No matches. Try .spec.diskPath for an exact path