This guide gives a simple example on how to provision zonal and regional PDs in single-zone and regional clusters.
Note: Regional cluster support only available in beta starting with Kubernetes 1.14.
See instructions
This example provisions a zonal PD in both single-zone and regional clusters.
- Create example Zonal Storage Class
$ kubectl apply -f ./examples/kubernetes/demo-zonal-sc.yaml
- Create example PVC and Pod
$ kubectl apply -f ./examples/kubernetes/demo-pod.yaml
- Verify PV is created and bound to PVC
$ kubectl get pvc
NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS AGE
podpvc Bound pvc-e36abf50-84f3-11e8-8538-42010a800002 10Gi RWO csi-gce-pd 9s
- Verify pod is created and in
RUNNING
state (it may take a few minutes to get to running state)
$ kubectl get pods
NAME READY STATUS RESTARTS AGE
web-server 1/1 Running 0 1m
Note: Regional cluster support only available in beta starting with Kubernetes 1.14.
This example provisions a regional PD in regional clusters.
-
Create example Regional Storage Class. Choose between:
-
Unrestricted zones
$ kubectl apply -f ./examples/kubernetes/demo-regional-sc.yaml
-
Restricted zones
$ kubectl apply -f ./examples/kubernetes/demo-regional-restricted-sc.yaml
-
-
Create example PVC and Pod
$ kubectl apply -f ./examples/kubernetes/demo-pod.yaml
- Verify PV is created and bound to PVC
$ kubectl get pvc
NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS AGE
podpvc Bound pvc-e36abf50-84f3-11e8-8538-42010a800002 10Gi RWO csi-gce-pd 9s
- Verify pod is created and in
RUNNING
state (it may take a few minutes to get to running state)
$ kubectl get pods
NAME READY STATUS RESTARTS AGE
web-server 1/1 Running 0 1m
The list of recognized StorageClass parameters
is the same as the list of CSI CreateVolume parameters.
The list of recognized topology keys in allowedTopologies
is listed here