From 907c4ad98d281b421272b756132690a2f6868be5 Mon Sep 17 00:00:00 2001 From: Jan Safranek Date: Fri, 6 Jan 2017 13:58:04 +0100 Subject: [PATCH] Move provisioning examples out of 'experimental' directory. Dynamic provisioning is pretty stable now. --- .../persistent-volume-provisioning/README.md | 26 +++++++++---------- .../aws-ebs.yaml | 0 .../claim1.json | 0 .../gce-pd.yaml | 0 .../glusterfs-dp.yaml | 0 .../glusterfs-provisioning-secret.yaml | 0 .../quobyte/example-pod.yaml | 0 .../quobyte/quobyte-admin-secret.yaml | 0 .../quobyte/quobyte-storage-class.yaml | 0 .../rbd/ceph-secret-admin.yaml | 0 .../rbd/ceph-secret-user.yaml | 0 .../rbd/pod.yaml | 0 .../rbd/rbd-storage-class.yaml | 0 13 files changed, 13 insertions(+), 13 deletions(-) rename examples/{experimental => }/persistent-volume-provisioning/README.md (92%) rename examples/{experimental => }/persistent-volume-provisioning/aws-ebs.yaml (100%) rename examples/{experimental => }/persistent-volume-provisioning/claim1.json (100%) rename examples/{experimental => }/persistent-volume-provisioning/gce-pd.yaml (100%) rename examples/{experimental => }/persistent-volume-provisioning/glusterfs-dp.yaml (100%) rename examples/{experimental => }/persistent-volume-provisioning/glusterfs-provisioning-secret.yaml (100%) rename examples/{experimental => }/persistent-volume-provisioning/quobyte/example-pod.yaml (100%) rename examples/{experimental => }/persistent-volume-provisioning/quobyte/quobyte-admin-secret.yaml (100%) rename examples/{experimental => }/persistent-volume-provisioning/quobyte/quobyte-storage-class.yaml (100%) rename examples/{experimental => }/persistent-volume-provisioning/rbd/ceph-secret-admin.yaml (100%) rename examples/{experimental => }/persistent-volume-provisioning/rbd/ceph-secret-user.yaml (100%) rename examples/{experimental => }/persistent-volume-provisioning/rbd/pod.yaml (100%) rename examples/{experimental => }/persistent-volume-provisioning/rbd/rbd-storage-class.yaml (100%) diff --git a/examples/experimental/persistent-volume-provisioning/README.md b/examples/persistent-volume-provisioning/README.md similarity index 92% rename from examples/experimental/persistent-volume-provisioning/README.md rename to examples/persistent-volume-provisioning/README.md index de83f46b181..3a5c6985c67 100644 --- a/examples/experimental/persistent-volume-provisioning/README.md +++ b/examples/persistent-volume-provisioning/README.md @@ -1,6 +1,6 @@ ## Persistent Volume Provisioning -This example shows how to use experimental persistent volume provisioning. +This example shows how to use dynamic persistent volume provisioning. ### Prerequisites @@ -191,19 +191,19 @@ parameters: First create Quobyte admin's Secret in the system namespace. Here the Secret is created in `kube-system`: ``` -$ kubectl create -f examples/experimental/persistent-volume-provisioning/quobyte/quobyte-admin-secret.yaml --namespace=kube-system +$ kubectl create -f examples/persistent-volume-provisioning/quobyte/quobyte-admin-secret.yaml --namespace=kube-system ``` Then create the Quobyte storage class: ``` -$ kubectl create -f examples/experimental/persistent-volume-provisioning/quobyte/quobyte-storage-class.yaml +$ kubectl create -f examples/persistent-volume-provisioning/quobyte/quobyte-storage-class.yaml ``` Now create a PVC ``` -$ kubectl create -f examples/experimental/persistent-volume-provisioning/claim1.json +$ kubectl create -f examples/persistent-volume-provisioning/claim1.json ``` Check the created PVC: @@ -239,7 +239,7 @@ No events. Create a Pod to use the PVC: ``` -$ kubectl create -f examples/experimental/persistent-volume-provisioning/quobyte/example-pod.yaml +$ kubectl create -f examples/persistent-volume-provisioning/quobyte/example-pod.yaml ``` #### Azure Disk @@ -263,7 +263,7 @@ parameters: ### User provisioning requests Users request dynamically provisioned storage by including a storage class in their `PersistentVolumeClaim`. -The annotation `volume.beta.kubernetes.io/storage-class` is used to access this experimental feature. It is required that this value matches the name of a `StorageClass` configured by the administrator. +The annotation `volume.beta.kubernetes.io/storage-class` is used to access this feature. It is required that this value matches the name of a `StorageClass` configured by the administrator. In the future, the storage class may remain in an annotation or become a field on the claim itself. ``` @@ -302,10 +302,10 @@ and automatically bound to the claim requesting storage. ``` $ kubectl get pv -$ kubectl create -f examples/experimental/persistent-volume-provisioning/gce-pd.yaml +$ kubectl create -f examples/persistent-volume-provisioning/gce-pd.yaml storageclass "slow" created -$ kubectl create -f examples/experimental/persistent-volume-provisioning/claim1.json +$ kubectl create -f examples/persistent-volume-provisioning/claim1.json persistentvolumeclaim "claim1" created $ kubectl get pv @@ -353,10 +353,10 @@ From the key value, we will create a secret. We must create the Ceph admin Secre $ kubectl create secret generic ceph-secret-admin --from-literal=key='AQBfxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==' --namespace=kube-system --type=kubernetes.io/rbd ``` -Now modify `examples/experimental/persistent-volume-provisioning/rbd/rbd-storage-class.yaml` to reflect your environment, particularly the `monitors` field. We are now ready to create our RBD Storage Class: +Now modify `examples/persistent-volume-provisioning/rbd/rbd-storage-class.yaml` to reflect your environment, particularly the `monitors` field. We are now ready to create our RBD Storage Class: ``` -$ kubectl create -f examples/experimental/persistent-volume-provisioning/rbd/rbd-storage-class.yaml +$ kubectl create -f examples/persistent-volume-provisioning/rbd/rbd-storage-class.yaml ``` The kube-controller-manager is now able to provision storage, however we still need to be able to map the RBD volume to a node. Mapping should be done with a non-privileged key, if you have existing users you can get all keys by running `ceph auth list` on your Ceph cluster with the admin key. For this example we will create a new user and pool. @@ -382,7 +382,7 @@ You are now ready to provision and use RBD storage. With the storageclass configured, let's create a PVC in our example namespace, `myns`: ``` -$ kubectl create -f examples/experimental/persistent-volume-provisioning/claim1.json --namespace=myns +$ kubectl create -f examples/persistent-volume-provisioning/claim1.json --namespace=myns ``` Eventually the PVC creation will result in a PV and RBD volume to match: @@ -423,7 +423,7 @@ No events. With our storage provisioned, we can now create a Pod to use the PVC: ``` -$ kubectl create -f examples/experimental/persistent-volume-provisioning/rbd/pod.yaml --namespace=myns +$ kubectl create -f examples/persistent-volume-provisioning/rbd/pod.yaml --namespace=myns ``` Now our pod has an RBD mount! @@ -435,5 +435,5 @@ $ kubectl exec -it $PODNAME --namespace=myns -- df -h | grep rbd ``` -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/examples/experimental/persistent-volume-provisioning/README.md?pixel)]() +[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/examples/persistent-volume-provisioning/README.md?pixel)]() diff --git a/examples/experimental/persistent-volume-provisioning/aws-ebs.yaml b/examples/persistent-volume-provisioning/aws-ebs.yaml similarity index 100% rename from examples/experimental/persistent-volume-provisioning/aws-ebs.yaml rename to examples/persistent-volume-provisioning/aws-ebs.yaml diff --git a/examples/experimental/persistent-volume-provisioning/claim1.json b/examples/persistent-volume-provisioning/claim1.json similarity index 100% rename from examples/experimental/persistent-volume-provisioning/claim1.json rename to examples/persistent-volume-provisioning/claim1.json diff --git a/examples/experimental/persistent-volume-provisioning/gce-pd.yaml b/examples/persistent-volume-provisioning/gce-pd.yaml similarity index 100% rename from examples/experimental/persistent-volume-provisioning/gce-pd.yaml rename to examples/persistent-volume-provisioning/gce-pd.yaml diff --git a/examples/experimental/persistent-volume-provisioning/glusterfs-dp.yaml b/examples/persistent-volume-provisioning/glusterfs-dp.yaml similarity index 100% rename from examples/experimental/persistent-volume-provisioning/glusterfs-dp.yaml rename to examples/persistent-volume-provisioning/glusterfs-dp.yaml diff --git a/examples/experimental/persistent-volume-provisioning/glusterfs-provisioning-secret.yaml b/examples/persistent-volume-provisioning/glusterfs-provisioning-secret.yaml similarity index 100% rename from examples/experimental/persistent-volume-provisioning/glusterfs-provisioning-secret.yaml rename to examples/persistent-volume-provisioning/glusterfs-provisioning-secret.yaml diff --git a/examples/experimental/persistent-volume-provisioning/quobyte/example-pod.yaml b/examples/persistent-volume-provisioning/quobyte/example-pod.yaml similarity index 100% rename from examples/experimental/persistent-volume-provisioning/quobyte/example-pod.yaml rename to examples/persistent-volume-provisioning/quobyte/example-pod.yaml diff --git a/examples/experimental/persistent-volume-provisioning/quobyte/quobyte-admin-secret.yaml b/examples/persistent-volume-provisioning/quobyte/quobyte-admin-secret.yaml similarity index 100% rename from examples/experimental/persistent-volume-provisioning/quobyte/quobyte-admin-secret.yaml rename to examples/persistent-volume-provisioning/quobyte/quobyte-admin-secret.yaml diff --git a/examples/experimental/persistent-volume-provisioning/quobyte/quobyte-storage-class.yaml b/examples/persistent-volume-provisioning/quobyte/quobyte-storage-class.yaml similarity index 100% rename from examples/experimental/persistent-volume-provisioning/quobyte/quobyte-storage-class.yaml rename to examples/persistent-volume-provisioning/quobyte/quobyte-storage-class.yaml diff --git a/examples/experimental/persistent-volume-provisioning/rbd/ceph-secret-admin.yaml b/examples/persistent-volume-provisioning/rbd/ceph-secret-admin.yaml similarity index 100% rename from examples/experimental/persistent-volume-provisioning/rbd/ceph-secret-admin.yaml rename to examples/persistent-volume-provisioning/rbd/ceph-secret-admin.yaml diff --git a/examples/experimental/persistent-volume-provisioning/rbd/ceph-secret-user.yaml b/examples/persistent-volume-provisioning/rbd/ceph-secret-user.yaml similarity index 100% rename from examples/experimental/persistent-volume-provisioning/rbd/ceph-secret-user.yaml rename to examples/persistent-volume-provisioning/rbd/ceph-secret-user.yaml diff --git a/examples/experimental/persistent-volume-provisioning/rbd/pod.yaml b/examples/persistent-volume-provisioning/rbd/pod.yaml similarity index 100% rename from examples/experimental/persistent-volume-provisioning/rbd/pod.yaml rename to examples/persistent-volume-provisioning/rbd/pod.yaml diff --git a/examples/experimental/persistent-volume-provisioning/rbd/rbd-storage-class.yaml b/examples/persistent-volume-provisioning/rbd/rbd-storage-class.yaml similarity index 100% rename from examples/experimental/persistent-volume-provisioning/rbd/rbd-storage-class.yaml rename to examples/persistent-volume-provisioning/rbd/rbd-storage-class.yaml