Use KPFS volumes

You can use KPFS volumes in Kubernetes clusters of KCE.

You can use KPFS volumes by using one of the following two methods:

• Static volume

  You can use KPFS static volumes by using one of the following two methods:

  • Directly use volumes

  • Use PVs or PVCs
• Dynamic volume

Background

KPFS is a high-performance file storage system developed by Kingsoft Cloud for high-performance computing. KPFS enables business applications with a high aggregate bandwidth and high Input/Output Operations Per Second (IOPS) to read and write data within milliseconds. KPFS provides high-performance file storage with a high throughput and high IOPS, and adopts a scalable and fully managed design, enabling you to quickly develop business applications and focus on business innovation.

Prerequisites

A KPFS file system is created before the file system can be mounted. You can create a file system in the KPFS console.

Instructions

1. KPFS can provide shared storage services for multiple pods simultaneously. A PVC can be used by multiple pods.
2. The KPFS client must be installed on a node before KPFS can be used.

3. KPFS can be directly used in clusters created on December 15, 2020 or later. To use KPFS in clusters created before December 15, 2020, update the image of the ksc-flexvolume-ds component in the clusters to hub.kce.ksyun.com/ksyun/ksc-flexvolume:v1.8.2-mp. To update the image, run the following command:

   kubectl set image ds/ksc-flexvolume-ds ksc-flexvolume-ds=hub.kce.ksyun.com/ksyun/ksc-flexvolume:v1.8.2-mp --record -n kube-system 

4. KPFS dynamic volumes can be directly used in clusters created on February 24, 2021 or later. To use KPFS dynamic volumes in clusters created before February 24, 2021, update the disk-provisioner component in the kube-system namespace of the clusters. For more information about the YAML file, see Appendix.

View a file system

After creating a KPFS file system, you can view the information and obtain the conrresponding server address of the KPFS file system in the KPFS console.

Static volume

Parameter description

Directly use volumes

apiVersion: extensions/v1beta1
kind: Deployment
metadata:
  name: static-kpfs-dep
spec:
  replicas: 2
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
        - name: nginx-flexvolume-kpfs
          image: nginx
          volumeMounts:
            - name: kpfs-test
              mountPath: "/data"
      volumes:
        - name: kpfs-test
          flexVolume:
            driver: "ksc/kpfs"
            options:
              server: 10.0.1.xx
              fileSystem: kpfs-xxxxxxx
              subPath: /test-dep  # This parameter is optional.

Use PVs or PVCs

Create a PV:

apiVersion: v1
kind: PersistentVolume
metadata:
  name: static-kpfs-pv
spec:
  capacity:
    storage: 5Gi
  storageClassName: static-kpfs-pv
  accessModes:
    - ReadWriteMany
  flexVolume:
    driver: "ksc/kpfs"
    options:
      server: 10.0.1.47
      fileSystem: kpfs-xxxxxx
      subPath: /test1-dep

Create a PVC:

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: static-kpfs-pvc
spec:
  accessModes:
    - ReadWriteMany
  storageClassName: static-kpfs-pv
  resources:
    requests:
      storage: 5Gi

Create a Deployment:

apiVersion: extensions/v1beta1
kind: Deployment
metadata:
  name: static-kpfs-dep
spec:
  replicas: 2
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
        - name: nginx-flexvolume-disk
          image: nginx
          volumeMounts:
            - name: kpfs-test
              mountPath: "/data"
      volumes:
        - name: kpfs-test
          persistentVolumeClaim:
            claimName: static-kpfs-pvc

Dynamic volume

Parameter description

Create a StorageClass:

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: ksc-kpfs
parameters:
  server: "10.0.1.xx"
  fileSystem: "kpfs-xxxxx"
  subPath: provisioner-kpfs
  archiveOnDelete: "true"
  storageType: ksc/kpfs
provisioner: ksc/storage

Create a StatefulSet:

apiVersion:  apps/v1
kind: StatefulSet
metadata:
  name: test-sts
spec:
  serviceName: test
  selector:
    matchLabels:
      app: nginx
  replicas: 2
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
        - name: nginx
          image: nginx
          volumeMounts:
            - name: pvc-disk
              mountPath: "/data"
  volumeClaimTemplates:
  - metadata:
      name: pvc-disk
    spec:
      accessModes:
      - ReadWriteOnce
      storageClassName: ksc-kpfs
      resources:
        requests:
          storage: 10Gi