Mrunal Patel 8e5b17cf13 Switch to github.com/golang/dep for vendoring

Signed-off-by: Mrunal Patel <mrunalp@gmail.com>

2017-01-31 16:45:59 -08:00

8.1 KiB

Raw Blame History

vSphere Volume

Prerequisites
Examples

Prerequisites

Kubernetes with vSphere Cloud Provider configured. For cloudprovider configuration please refer vSphere getting started guide.

Examples

Volumes

Create VMDK.

First ssh into ESX and then use following command to create vmdk,
```
vmkfstools -c 2G /vmfs/volumes/datastore1/volumes/myDisk.vmdk
```

Create Pod which uses 'myDisk.vmdk'.

See example

   apiVersion: v1
   kind: Pod
   metadata:
     name: test-vmdk
   spec:
     containers:
     - image: gcr.io/google_containers/test-webserver
       name: test-container
       volumeMounts:
       - mountPath: /test-vmdk
         name: test-volume
     volumes:
     - name: test-volume
       # This VMDK volume must already exist.
       vsphereVolume:
         volumePath: "[datastore1] volumes/myDisk"
         fsType: ext4

Download example

Creating the pod:

$ kubectl create -f examples/volumes/vsphere/vsphere-volume-pod.yaml

Verify that pod is running:

$ kubectl get pods test-vmdk
NAME      READY     STATUS    RESTARTS   AGE
test-vmdk   1/1     Running   0          48m

Persistent Volumes

Create VMDK.

First ssh into ESX and then use following command to create vmdk,
```
vmkfstools -c 2G /vmfs/volumes/datastore1/volumes/myDisk.vmdk
```

Create Persistent Volume.

See example:

apiVersion: v1
kind: PersistentVolume
metadata:
  name: pv0001
spec:
  capacity:
    storage: 2Gi
  accessModes:
    - ReadWriteOnce
  persistentVolumeReclaimPolicy: Retain
  vsphereVolume:
    volumePath: "[datastore1] volumes/myDisk"
    fsType: ext4

Download example

Creating the persistent volume:

$ kubectl create -f examples/volumes/vsphere/vsphere-volume-pv.yaml

Verifying persistent volume is created:

$ kubectl describe pv pv0001
Name:		pv0001
Labels:		<none>
Status:		Available
Claim:
Reclaim Policy:	Retain
Access Modes:	RWO
Capacity:	2Gi
Message:
Source:
    Type:	vSphereVolume (a Persistent Disk resource in vSphere)
    VolumePath:	[datastore1] volumes/myDisk
    FSType:	ext4
No events.

Create Persistent Volume Claim.

See example:

kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: pvc0001
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 2Gi

Download example

Creating the persistent volume claim:

$ kubectl create -f examples/volumes/vsphere/vsphere-volume-pvc.yaml

Verifying persistent volume claim is created:

$ kubectl describe pvc pvc0001
Name:		pvc0001
Namespace:	default
Status:		Bound
Volume:		pv0001
Labels:		<none>
Capacity:	2Gi
Access Modes:	RWO
No events.

Create Pod which uses Persistent Volume Claim.

See example:

apiVersion: v1
kind: Pod
metadata:
  name: pvpod
spec:
  containers:
  - name: test-container
    image: gcr.io/google_containers/test-webserver
    volumeMounts:
    - name: test-volume
      mountPath: /test-vmdk
  volumes:
  - name: vmdk-storage
    persistentVolumeClaim:
      claimName: pvc0001

Download example

Creating the pod:

$ kubectl create -f examples/volumes/vsphere/vsphere-volume-pvcpod.yaml

Verifying pod is created:

$ kubectl get pod pvpod
NAME      READY     STATUS    RESTARTS   AGE
pvpod       1/1     Running   0          48m

Storage Class

Note: Here you don't need to create vmdk it is created for you.

Create Storage Class.

See example:

kind: StorageClass
apiVersion: storage.k8s.io/v1beta1
metadata:
  name: fast
provisioner: kubernetes.io/vsphere-volume
parameters:
    diskformat: zeroedthick

Download example

Creating the storageclass:

$ kubectl create -f examples/volumes/vsphere/vsphere-volume-sc-fast.yaml

Verifying storage class is created:

$ kubectl describe storageclass fast 
Name:		fast
Annotations:	<none>
Provisioner:	kubernetes.io/vsphere-volume
Parameters:	diskformat=zeroedthick
No events.

Create Persistent Volume Claim.

See example:

kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: pvcsc001
  annotations:
    volume.beta.kubernetes.io/storage-class: fast
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 2Gi

Download example

Creating the persistent volume claim:

$ kubectl create -f examples/volumes/vsphere/vsphere-volume-pvcsc.yaml

Verifying persistent volume claim is created:

$ kubectl describe pvc pvcsc001
Name:		pvcsc001
Namespace:	default
Status:		Bound
Volume:		pvc-80f7b5c1-94b6-11e6-a24f-005056a79d2d
Labels:		<none>
Capacity:	2Gi
Access Modes:	RWO
No events.

Persistent Volume is automatically created and is bounded to this pvc.

Verifying persistent volume claim is created:

$ kubectl describe pv pvc-80f7b5c1-94b6-11e6-a24f-005056a79d2d
Name:		pvc-80f7b5c1-94b6-11e6-a24f-005056a79d2d
Labels:		<none>
Status:		Bound
Claim:		default/pvcsc001
Reclaim Policy:	Delete
Access Modes:	RWO
Capacity:	2Gi
Message:
Source:
    Type:	vSphereVolume (a Persistent Disk resource in vSphere)
    VolumePath:	[datastore1] kubevols/kubernetes-dynamic-pvc-80f7b5c1-94b6-11e6-a24f-005056a79d2d.vmdk
    FSType:	ext4
No events.

Note: VMDK is created inside kubevols folder in datastore which is mentioned in 'vsphere' cloudprovider configuration. The cloudprovider config is created during setup of Kubernetes cluster on vSphere.

Create Pod which uses Persistent Volume Claim with storage class.

See example:

apiVersion: v1
kind: Pod
metadata:
  name: pvpod
spec:
  containers:
  - name: test-container
    image: gcr.io/google_containers/test-webserver
    volumeMounts:
    - name: test-volume
      mountPath: /test-vmdk
  volumes:
  - name: vmdk-storage
    persistentVolumeClaim:
      claimName: pvcsc001

Download example

Creating the pod:

$ kubectl create -f examples/volumes/vsphere/vsphere-volume-pvcscpod.yaml

Verifying pod is created:

$ kubectl get pod pvpod
NAME      READY     STATUS    RESTARTS   AGE
pvpod       1/1     Running   0          48m

8.1 KiB Raw Blame History

vSphere Volume

Prerequisites

Examples

Volumes

Persistent Volumes

Storage Class

8.1 KiB

Raw Blame History