README: English ｜ 中文

local-disk-manager (LDM) is a sub module of HwameiStor.

Local Disk Manager (LDM) is one of modules of HwameiStor. LDM is to simplify the management of disks on nodes. It can abstract the disk on the node into a resource and can be monitored and managed. It's a daemon that will be deployed on each node, then detect the disk on the node, abstract it into local disk (LD) resources and save it to kubernetes.

At present, the LDM project is still in the alpha stage.

LocalDisk(LD): LDM abstracts disk resources into objects in k8s. A LD resource object represents the disk resources on the host.

LocalDiskClaim(LDC): The way to use disk, users can add a description of the disk to select the disk to be used.

At present, LDC supports the following disk description options:

• NodeName
• Capacity
• DiskType(e.g. HDD/SSD)

If you want to entirely deploy HwameiStor, please refer to here. If you just want to deploy LDM separately, you can refer to the following installation steps.

# git clone https://github.com/hwameistor/local-disk-manager.git

# cd deploy

# kubectl apply -f deploy/crds/

# kubectl apply -f deploy/

# kubectl get localdisk
10-6-118-11-sda    10-6-118-11                             Unclaimed
10-6-118-11-sdb    10-6-118-11                             Unclaimed

Get locally discovered disk resource information. There are four columns of information.

• Column NAME represents how this disk is displayed in the cluster resources.
• Column NODEMATCH indicates which host this disk is on.
• Column CLAIM indicates which localdiskclaim statement this disk is used by.
• Column PHASE represents the current state of the disk.

kuebctl get localdisk <name> -o yaml View more information about disks.

# kubectl apply -f deploy/samples/hwameistor.io_v1alpha1_localdiskclaim_cr.yaml

Allocate available disks by issuing a disk usage request. In the description of the request, you can add disk requirements, such as disk type and disk capacity

# kubectl get localdiskclaim <name>

Check the status of claim. If there is a disk available, you will see that the status is bound and the status is on the corresponding localdisk is Claimed and points to the claim that references the disk.

Please submit any feedback and issue at: Issues