Skip to content

bizflycloud/csi-bizflycloud

Repository files navigation

Bizfly Cloud CSI Drivers for Kubernetes

A set of Container Storage Interface (CSI) Drivers for Bizfly Cloud Storage products.

About

This repository allows Kubernetes to provision and manage Bizfly Cloud volumes via two distinct CSI plugins:

  1. Bizfly Cloud Block Storage - volume.csi.bizflycloud.vn (RWO capability)
  2. Bizfly Cloud File Storage - fs.csi.bizflycloud.vn (RWX capability for shared access)

Features

Below is a list of functionality implemented by the plugins. In general, CSI features implementing an aspect of the specification are available on any Bizfly Cloud Kubernetes version for which beta support for the feature is provided.

For File Storage (NFS-backed Shared Storage), the driver specifically supports ReadWriteMany (RWX). This means multiple Pods can concurrently read and write to the same volume.

See also the project examples for use cases.

Volume Expansion

Volumes can be expanded by updating the storage request value of the corresponding PVC:

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: csi-pvc
  namespace: default
spec:
  [...]
  resources:
    requests:
      # The field below can be increased.
      storage: 20Gi
      [...]

After successful expansion, the status section of the PVC object will reflect the actual volume capacity.

Important notes:

  • Volumes can only be increased in size, not decreased; attempts to do so will lead to an error.
  • Expanding a volume that is larger than the target size will have no effect. The PVC object status section will continue to represent the actual volume capacity.
  • Resizing volumes other than through the PVC object (e.g., the Bizfly cloud control panel) is not recommended as this can potentially cause conflicts. Additionally, size updates will not be reflected in the PVC object status section immediately, and the section will eventually show the actual volume capacity.

Raw Block Volume

Volumes can be used in raw block device mode by setting the volumeMode on the corresponding PVC:

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: csi-pvc
  namespace: default
spec:
  [...]
  volumeMode: Block

Important notes:

  • If using volume expansion functionality, only expansion of the underlying persistent volume is guaranteed. We do not guarantee to automatically expand the filesystem if you have formatted the device.

Volume Snapshots

Snapshots can be created and restored through VolumeSnapshot objects.

See also Volume Snapshot.

Install Bizfly Cloud CSI Driver

Please Refer to install Bizfly Cloud CSI Driver

Contributing

At Bizfly Cloud we value and love our community! If you have any issues or would like to contribute, feel free to open an issue or PR.

About

A Container Storage Interface (CSI) Driver for BizFly Cloud Block Storage

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors