Oracle Cloud Infrastructure Documentation

Using a Persistent Volume

On Compute Cloud@Customer, to use this persistent storage, create a Kubernetes deployment and assign a persistent volume claim as shown in the following sections.

Using Block Volume Storage

The following example uses block volume storage:

$ kubectl create -f nginx-deploy.yaml

The following output is the content of the nginx-deploy.yaml file.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-bv-deployment
spec:
  replicas: 3
  selector:
    matchLabels:
      app: nginx-bv
  template:
    metadata:
      labels:
        app: nginx-bv
    spec:
      containers:
      - name: nginx
        image: available_internal_registry/nginx:latest
        volumeMounts:
        - mountPath: /usr/share/nginx/
          name: data
        ports:
        - containerPort: 80
          name: http
          protocol: TCP
      volumes:
      - name: data
        persistentVolumeClaim:
          claimName: mynginxclaim

Using File System Storage

The following example uses file system storage:

$ kubectl create -f nginx-deploy.yaml

The following output is the content of the nginx-deploy.yaml file.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-fss-deployment
spec:
  replicas: 3
  selector:
    matchLabels:
      app: nginx-fss
  template:
    metadata:
      labels:
        app: nginx-fss
    spec:
      containers:
      - name: nginx
        image: nginx:latest
        volumeMounts:
        - mountPath: /usr/share/nginx/
          name: data
        ports:
        - containerPort: 80
          name: http
          protocol: TCP
      volumes:
      - name: data
        persistentVolumeClaim:
          claimName: fss-pvc

Verify the New Storage Asset

Use the get pod subcommand to show the names of the replicas in the pod:

$ kubectl get pod
nginx-deployment-55ff88b668-2k8rt 1/1 Running 0 4m54s
nginx-deployment-55ff88b668-79c2t 1/1 Running 0 4m54s
nginx-deployment-55ff88b668-qpdfd 1/1 Running 0 4m54s

Log in to the pod and use the Linux df command to show that the application replicas are using the persistentVolumeClaim storage. The Filesystem column in the df output shows the mount target IP address and the file system export path.

$ kubectl exec -it nginx-deployment-55ff88b668-2k8rt -- df -h /usr/share/nginx/html
Filesystem                                                                          Size Used Avail Use% Mounted on
xxx.xx.xxx.xxx:/export/4fsderwh09ufyf84ei1lh3q2x8ou86pq5vcbx3aeeo060xxxxxxxxxxxxxxx 67T  0    67T   0%   /usr/share/nginx/html