MiroirNodeGroup
miroir.home-operations.com / v1alpha1
apiVersion: miroir.home-operations.com/v1alpha1
kind: MiroirNodeGroup
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
MiroirNodeGroupSpec selects a set of nodes and the MiroirNode spec they
share.
nodeSelector object required
NodeSelector picks the member nodes by label. An empty selector
matches every node in the cluster (the Kubernetes convention).
The expression rule mirrors what LabelSelectorAsSelector enforces at
runtime — the LabelSelector schema alone admits combinations that
would otherwise fail every reconcile.
matchExpressions []object
matchExpressions is a list of label selector requirements. The requirements are ANDed.
key
string required
key is the label key that the selector applies to.
operator
string required
operator represents a key's relationship to a set of values.
Valid operators are In, NotIn, Exists and DoesNotExist.
values
[]string
values is an array of string values. If the operator is In or NotIn,
the values array must be non-empty. If the operator is Exists or DoesNotExist,
the values array must be empty. This array is replaced during a strategic
merge patch.
matchLabels
object
matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions, whose key field is "key", the
operator is "In", and the values array contains only "value". The requirements are ANDed.
template object required
Template is the MiroirNode spec applied to every member, with two
per-node facts resolved from the Node object: an empty zone
inherits the node's topology.kubernetes.io/zone label, and the
replication address comes from the node's
miroir.home-operations.com/address annotation.
address
string
Address optionally pins the node's DRBD replication endpoint to a
dedicated storage NIC/VLAN IP (IPv4 or IPv6); empty falls back to
the node's InternalIP. It applies to volumes created afterwards —
existing volumes keep the address persisted at creation. An explicit
empty string means unset (0.10 values files carry them).
maxLength:
45
autoEvict
boolean
AutoEvict, when explicitly false, exempts this node from auto-evict:
its legs are never re-placed while its heartbeat is stale (a node
with known long outages). Absent means eligible.
pools []object required
Pools lists this node's storage pools, one entry per pool. Every
node in the topology carries at least one.
minItems:
1maxItems:
32loopfile object
Loopfile makes this a loopfile pool.
baseDir
string required
BaseDir is the directory holding the sparse files, e.g.
"/var/lib/miroir". Must be reflink-capable (XFS reflink=1 or btrfs)
for CoW snapshots; the agent refuses the pool otherwise.
minLength:
1maxLength:
256lvmthin object
LVMThin makes this an lvmthin pool.
device
string
Device is the block device backing the pool's VG. Optional when the
VG already exists (a pre-provisioned or shared VG); required for the
agent to create it on first start.
maxLength:
256
poolSize
string
PoolSize bounds the thin pool (an lvm size spec, e.g. "400g");
empty claims all free VG space.
maxLength:
32
name
string required
Name is the pool name ("default" for the pre-multi-pool single
pool). It becomes an LVM VG name suffix, a metric label value, and a
StorageClass parameter, so it stays a short lowercase identifier.
pattern:
^[a-z0-9]([a-z0-9-]{0,30}[a-z0-9])?$zfs object
ZFS makes this a zfs pool.
compression
string
Compression is the compression property for newly created zvols;
"inherit" uses the parent dataset's setting. Existing zvols are not
mutated, and snapshot clones retain their source properties. Empty
means the default (lz4) — 0.10 values files carry explicit empty
strings, and the agent has always defaulted them.
pattern:
^(|inherit|on|off|lz4|lzjb|zle|gzip(-[1-9])?|zstd(-([1-9]|1[0-9]))?|zstd-fast(-(10|[1-9]|[2-9]0|100|500|1000))?)$
dataset
string required
Dataset is the parent dataset for zvols.
minLength:
1maxLength:
256
volBlockSize
string
VolBlockSize is the volblocksize property for newly created zvols.
Empty means the default (4K), for the same 0.10 compatibility reason
as Compression.
enum:
, 4K, 8K, 16K, 32K, 64K, 128K
zone
string
Zone is an optional failure domain (rack, host group, AZ). When set,
the controller spreads a volume's replicas across distinct zones;
empty means unconstrained.
maxLength:
63status object
MiroirNodeGroupStatus reports the group's materialized membership.
conditions []object
Conditions follow the standard Kubernetes condition conventions.
lastTransitionTime
string required
lastTransitionTime is the last time the condition transitioned from one status to another.
This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
format:
date-time
message
string required
message is a human readable message indicating details about the transition.
This may be an empty string.
maxLength:
32768
observedGeneration
integer
observedGeneration represents the .metadata.generation that the condition was set based upon.
For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
with respect to the current state of the instance.
format:
int64minimum:
0
reason
string required
reason contains a programmatic identifier indicating the reason for the condition's last transition.
Producers of specific condition types may define expected values and meanings for this field,
and whether the values are considered a guaranteed API.
The value should be a CamelCase string.
This field may not be empty.
pattern:
^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$minLength:
1maxLength:
1024
status
string required
status of the condition, one of True, False, Unknown.
enum:
True, False, Unknown
type
string required
type of condition in CamelCase or in foo.example.com/CamelCase.
pattern:
^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$maxLength:
316
nodes
[]string
Nodes lists the member nodes whose MiroirNode this group currently
manages, sorted by name.
observedGeneration
integer
ObservedGeneration is the spec generation this status reflects.
format:
int64No matches. Try .spec.nodeSelector for an exact path