Create shared PVCs using CSI

This document describes how to create shared Portworx volumes using the CSI provisioner.

Prerequisite

Ensure that your Portworx installation supports CSI. When Generating the Portworx specs select CSI under Customize, then Advanced Settings. This will add the CSI components to the Portworx install spec.

Step 1 : Create a CSI StorageClass

Create and apply a StorageClass spec, specifying the pxd.portworx.com Portworx CSI provisioner:

kind: StorageClass
apiVersion: storage.k8s.io/v1
metadata:
  name: portworx-csi-shared-sc
provisioner: pxd.portworx.com
parameters:
  repl: "3"
  shared: "true"

Step 2 : Create a PVC

Create and apply a PersistentVolumeClaim spec, specifying storageClassName with the CSI enabled StorageClass you created above:

kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: px-shared-pvc
spec:
  storageClassName: portworx-csi-shared-sc
  accessModes:
    - ReadWriteMany
  resources:
    requests:
      storage: 2Gi

Step 3 : Deploy your application

Now start your application which references the above PVC.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  selector:
    matchLabels:
      app: nginx
  replicas: 3
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx
        ports:
        - containerPort: 80
        securityContext:
          privileged: true
        volumeMounts:
        - name: nginx-persistent-storage
          mountPath: /usr/share/nginx/html
          readOnly: true
      volumes:
      - name: nginx-persistent-storage
        persistentVolumeClaim:
          claimName: px-shared-pvc

Create PVCs using the ReadOnlyMany access mode