Skip to content

Commit cc70cef

Browse files
docs(linstor): record the measured topology requirement
The first paragraph asserted what external-provisioner sends without the flag; it is now read off the wire on a three-node dev stand. A WaitForFirstConsumer CreateVolume carries requisite as the single segment the scheduler chose with the flag set, and all three node segments without it, the chosen one merely first in preferred. Same run confirmed piraeus re-derives the csi-controller Deployment once when the flag lands on an existing LinstorCluster, and that the satellite DaemonSets do not move. The `replicated` note claimed less than the facts support. That class binds Immediate, and external-provisioner scopes strict topology to late binding, so the flag never reaches that path -- which is a stronger statement than the PV merely being remotely accessible, and does not depend on reasoning about placement at all. Signed-off-by: Myasnikov Daniil <[email protected]> Assisted-By: LLM
1 parent 00c6eb1 commit cc70cef

1 file changed

Lines changed: 10 additions & 3 deletions

File tree

‎packages/system/linstor/values.yaml‎

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,11 @@ linstorCSI:
7070
## can place two importers on a node that cannot hold both disks plus both
7171
## scratch volumes, and the second scratch is then placed elsewhere.
7272
##
73+
## Measured on the wire, on a three-node dev stand: the CreateVolume request
74+
## for a WaitForFirstConsumer volume carries `requisite` as the single segment
75+
## the scheduler chose when the flag is set, and all three node segments when
76+
## it is not, the chosen one merely first in `preferred`.
77+
##
7378
## Reproduced and fixed by measurement 2026-08-25 on a three-node cluster: with
7479
## the flag absent the scratch PV landed on a different node than its disk and
7580
## the import hung indefinitely at ImportScheduled with no error anywhere; with
@@ -79,9 +84,11 @@ linstorCSI:
7984
## self-correcting wait.
8085
##
8186
## Verified for node-pinned (`local`) volumes, which is what the cluster
82-
## default uses. For `replicated` volumes the PV is remotely accessible, so the
83-
## constraint is satisfiable wherever the pod lands; that case is reasoned
84-
## rather than measured, hence the switch.
87+
## default uses. `replicated` is untouched for a sharper reason than its PV
88+
## being remotely accessible: it binds `Immediate`, and external-provisioner
89+
## scopes strict topology to late binding, so the flag never reaches that
90+
## path at all. The switch stays because the flag is an upstream default this
91+
## chart overrides, not because the other class is in doubt.
8592
strictTopology: true
8693
image:
8794
repository: ghcr.io/cozystack/cozystack/linstor-csi

0 commit comments

Comments
 (0)