From 9caf449265ecb5fb4d231cf81572b348a03a1416 Mon Sep 17 00:00:00 2001 From: Sergey Vasilyev Date: Fri, 31 May 2019 11:58:56 +0200 Subject: [PATCH] Warn that Minikube cannot handle the PVC/PV resizes properly --- docs/walkthrough/prerequisites.rst | 8 ++++++++ docs/walkthrough/updates.rst | 13 +++++++++++++ 2 files changed, 21 insertions(+) diff --git a/docs/walkthrough/prerequisites.rst b/docs/walkthrough/prerequisites.rst index d310565d..b799cd17 100644 --- a/docs/walkthrough/prerequisites.rst +++ b/docs/walkthrough/prerequisites.rst @@ -10,3 +10,11 @@ Otherwise, let's install minikube locally (e.g. for MacOS): * `Install kubectl `_ * :doc:`Install minikube ` (a local Kubernetes cluster) * :doc:`Install Kopf ` + +.. warning:: + Unfortunately, Minikube cannot handle the PVC/PV resizing, + as it uses the HostPath provider internally. + You can either skip the :doc:`updates` step of this tutorial + (where the sizes of the volumes are changed), + or you can use an external Kubernetes cluster + with real dynamically sized volumes. diff --git a/docs/walkthrough/updates.rst b/docs/walkthrough/updates.rst index f829146f..a899fdf2 100644 --- a/docs/walkthrough/updates.rst +++ b/docs/walkthrough/updates.rst @@ -2,6 +2,13 @@ Updating the objects ==================== +.. warning:: + Unfortunately, Minikube cannot handle the PVC/PV resizing, + as it uses the HostPath provider internally. + You can either skip this step of the tutorial, + or you can use an external Kubernetes cluster + with real dynamically sized volumes. + Previously (:doc:`creation`), we have implemented a handler for the creation of an ``EphemeralVolumeClaim`` (EVC), and created the corresponding ``PersistantVolumeClaim`` (PVC). @@ -109,3 +116,9 @@ Check the size of the actual PV behind the PVC, which is now increased: NAME CAPACITY ACCESS MODES ... pvc-a37b65bd-8384-11e9-b857-42010a800265 2Gi RWO ... + +.. warning:: + Kubernetes & ``kubectl`` improperly show the capacity of PVCs: + it remains the same (1G) event after the change. + The size of actual PV (Persistent Volume) of each PVC is important! + This issue is not related to Kopf, so we go around it.