Chapter 10. Managing persistent volume claims

Procedure

1. Create a Persistent Volume Claim (PVC) for the application to use.

   1. In OpenShift Web Console, click Storage Persistent Volume Claims.
   2. Set the Project for the application pod.

   3. Click Create Persistent Volume Claim.

      1. Specify a Storage Class provided by OpenShift Container Storage.
      2. Specify the PVC Name, for example, myclaim.
      3. Select the required Access Mode.
      4. Specify a Size as per application requirement.
      5. Click Create and wait until the PVC is in Bound status.

2. Configure a new or existing application pod to use the new PVC.

   • For a new application pod, perform the following steps:

     1. Click Workloads →Pods.
     2. Create a new application pod.

     3. Under the spec: section, add volume: section to add the new PVC as a volume for the application pod.

        volumes:
          - name: <volume_name>
            persistentVolumeClaim:
              claimName: <pvc_name>

        For example:

        volumes:
          - name: mypd
            persistentVolumeClaim:
              claimName: myclaim

   • For an existing application pod, perform the following steps:

     1. Click Workloads →Deployment Configs.
     2. Search for the required deployment config associated with the application pod.
     3. Click on its Action menu (⋮) Edit Deployment Config.

     4. Under the spec: section, add volume: section to add the new PVC as a volume for the application pod and click Save.

        volumes:
          - name: <volume_name>
            persistentVolumeClaim:
              claimName: <pvc_name>

        For example:

        volumes:
          - name: mypd
            persistentVolumeClaim:
              claimName: myclaim

3. Verify that the new configuration is being used.

   1. Click Workloads Pods.
   2. Set the Project for the application pod.
   3. Verify that the application pod appears with a status of Running.
   4. Click the application pod name to view pod details.
   5. Scroll down to Volumes section and verify that the volume has a Type that matches your new Persistent Volume Claim, for example, myclaim.

Procedure

1. Log in to OpenShift Web Console.
2. Click Storage Persistent Volume Claims
3. Search for the required PVC name by using the Filter textbox. You can also filter the list of PVCs by Name or Label to narrow down the list
4. Check the Status column corresponding to the required PVC.
5. Click the required Name to view the PVC details.

Procedure

1. Log in to OpenShift Web Console.
2. Click Home Overview Persistent Storage
3. Locate the Inventory card to see the number of PVCs with errors.
4. Click Storage Persistent Volume Claims
5. Search for the required PVC using the Filter textbox.
6. Click on the PVC name and navigate to Events
7. Address the events as required or as directed.

Procedure

1. In OpenShift Web Console, navigate to Storage Persistent Volume Claims.
2. Click the Action Menu (⋮) next to the Persistent Volume Claim you want to expand.

3. Click Expand PVC:

   

4. Select the new size of the Persistent Volume Claim, then click Expand:

   

5. To verify the expansion, navigate to the PVC’s details page and verify the Capacity field has the correct size requested.

   Note

   When expanding PVCs based on Ceph RADOS Block Devices (RBDs), if the PVC is not already attached to a pod the Condition type is FileSystemResizePending in the PVC’s details page. Once the volume is mounted, filesystem resize succeeds and the new size is reflected in the Capacity field.