Portworx CSI Storage Class

To use a CSI base storage class with Portworx ensure that your installation was setup with CSI enabled, if your Portworx installation isn't running with CSI enabled view the Portworx document here to enable CSI.

Once Portworx is running you need to create a storage class with the fowling configuration, this can be applied via the Platform9 SaaS Management Plane using the Storage Class dashboards.

YAML
    
 
kind: StorageClassapiVersion: storage.k8s.io/v1metadata:  name: portworx-csi-scprovisioner: pxd.portworx.comparameters:  repl: "1"
Copy

Create Storage Class

Navigate to the Storage Class dashboard and click Add New Storage Class.

Next, enter the details for the storage class.

Finally, review the configuration, ensure it matches the example below including the replication parameter at the bottom of the YAML spec. Once the YAML is correct click Complete and Platform9 will create the storage class.

YAML
    
 
kind: StorageClassapiVersion: storage.k8s.io/v1metadata:  name: portworx-csi-scprovisioner: pxd.portworx.comparameters:  repl: "1"
Copy

Create a Test PVC

You can test the CSI based storage class by creating a PVC with the following YAML spec and applying it to your cluster. Copy the YAML to a file locally and use kubectl to add the PVC. Ensure the StorageClassName matches the storage class that you created above

YAML
    
 
kind: PersistentVolumeClaimapiVersion: v1metadata:   name: px-mysql-pvcspec:   storageClassName: portworx-csi-sc   accessModes:     - ReadWriteOnce   resources:     requests:       storage: 2Gi
Copy

Create the PVC from the YAML file with the command below:

Bash
    
 
kubectl apply -f pvc-test-portworx.yaml
Copy

output
    
 
persistentvolumeclaim/px-mysql-pvc created
Copy

To view the state of the PVC run

Bash
    
 
kubectl get pvc px-mysql-pvc
Copy

Output
    
 
NAME           STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS      AGEpx-mysql-pvc   Bound    pvc-81fae0ac-fda5-43e3-a760-d93359079896   2Gi        RWO            portworx-csi-sc   8s
Copy

Use Kubectl to apply the YAML spec below to create an example MySQL application to use the new PVC.

Bash
    
 
kubectl apply -f mysql-example.yaml
Copy

YAML
    
 
apiVersion: apps/v1kind: Deploymentmetadata:  name: mysqlspec:  selector:    matchLabels:      app: mysql  strategy:    rollingUpdate:      maxSurge: 1      maxUnavailable: 1    type: RollingUpdate  replicas: 1  template:    metadata:      labels:        app: mysql        version: "1"    spec:      containers:      - image: mysql:5.6        name: mysql        env:        - name: MYSQL_ROOT_PASSWORD          value: password        ports:        - containerPort: 3306        volumeMounts:        - name: mysql-persistent-storage          mountPath: /var/lib/mysql      volumes:      - name: mysql-persistent-storage        persistentVolumeClaim:          claimName: px-mysql-pvc
Copy

Run kubectl get all -n default command to view the running deployment.

Bash
    
​x
 
kubectl get all -n defaultNAME                         READY   STATUS    RESTARTS   AGEpod/mysql-67f5996b5f-jwctm   1/1     Running   0          3m53s​NAME                 TYPE        CLUSTER-IP   EXTERNAL-IP   PORT(S)   AGEservice/kubernetes   ClusterIP   10.21.0.1    <none>        443/TCP   98m​NAME                    READY   UP-TO-DATE   AVAILABLE   AGEdeployment.apps/mysql   1/1     1            1           3m53s​NAME                               DESIRED   CURRENT   READY   AGEreplicaset.apps/mysql-67f5996b5f   1         1         1       3m53s
Copy

Last updated on

Was this page helpful?