mirror of
https://github.com/ceph/ceph-csi.git
synced 2024-11-25 15:50:20 +00:00
doc: Add initial design notes for the Health Checker
Signed-off-by: Niels de Vos <ndevos@ibm.com>
This commit is contained in:
parent
a4195b6e11
commit
95149642cb
25
docs/design/proposals/volume-condition.md
Normal file
25
docs/design/proposals/volume-condition.md
Normal file
@ -0,0 +1,25 @@
|
|||||||
|
# Support for CSI `VolumeCondition` aka Volume Health Checker
|
||||||
|
|
||||||
|
## health-checker API
|
||||||
|
|
||||||
|
Under `internal/health-checker` the Manager for health-checking is
|
||||||
|
implemented. The Manager can start a checking process for a given path, return
|
||||||
|
the (un)healthy state and stop the checking process when the volume is not
|
||||||
|
needed anymore.
|
||||||
|
|
||||||
|
The Manager is responsible for creating a suitable checker for the requested
|
||||||
|
path. If the path is a block-device, the BlockChecker should be created. For a
|
||||||
|
filesystem path (directory), the FileChecker is appropriate.
|
||||||
|
|
||||||
|
## CephFS
|
||||||
|
|
||||||
|
The health-checker writes to the file `csi-volume-condition.ts` in the root of
|
||||||
|
the volume. This file contains a JSON formatted timestamp.
|
||||||
|
|
||||||
|
A new `data` directory is introduced for newly created volumes. During the
|
||||||
|
`NodeStageVolume` call the root of the volume is mounted, and the `data`
|
||||||
|
directory is bind-mounted inside the container when `NodePublishVolume` is
|
||||||
|
called.
|
||||||
|
|
||||||
|
The `data` directory makes it possible to place Ceph-CSI internal files in the
|
||||||
|
root of the volume, without that the user/application has access to it.
|
Loading…
Reference in New Issue
Block a user