From 1befe950a069f42096620696f32e6d37a2181fc8 Mon Sep 17 00:00:00 2001 From: zhangxiaoyu-zidif Date: Tue, 5 Dec 2017 15:29:35 -0600 Subject: [PATCH 1/3] Create glossary for persistent volume --- _data/glossary/persistent-volume.yaml | 14 ++++++++++++++ 1 file changed, 14 insertions(+) create mode 100644 _data/glossary/persistent-volume.yaml diff --git a/_data/glossary/persistent-volume.yaml b/_data/glossary/persistent-volume.yaml new file mode 100644 index 0000000000..f6ed124ad4 --- /dev/null +++ b/_data/glossary/persistent-volume.yaml @@ -0,0 +1,14 @@ +id: persistent-volume +name: Persistent Volume +full-link: /docs/concepts/storage/persistent-volumes/ +related: +- statefulset +- deployment +- pod +tags: +- core-object +- storage +short-description: > + Persistent Volume is a kind of interface through two resource types, i.e. pv and pvc, and provides pod persistent storage service. +long-description: | + Persistent Volume subsystem provides an API for users and administrators that abstracts details of how storage is provided from how it is consumed. From d067660586616926b4112b34999aea97045666ec Mon Sep 17 00:00:00 2001 From: Qiming Date: Sun, 24 Dec 2017 14:55:23 +0800 Subject: [PATCH 2/3] Update persistent-volume.yaml --- _data/glossary/persistent-volume.yaml | 1 + 1 file changed, 1 insertion(+) diff --git a/_data/glossary/persistent-volume.yaml b/_data/glossary/persistent-volume.yaml index f6ed124ad4..005f3dc5d8 100644 --- a/_data/glossary/persistent-volume.yaml +++ b/_data/glossary/persistent-volume.yaml @@ -4,6 +4,7 @@ full-link: /docs/concepts/storage/persistent-volumes/ related: - statefulset - deployment +- persistent-volume-claim - pod tags: - core-object From 2cbe8c3e5862a4c44cb9db3d7e75faa00f064410 Mon Sep 17 00:00:00 2001 From: Qiming Date: Sun, 24 Dec 2017 14:58:57 +0800 Subject: [PATCH 3/3] Update persistent-volume.yaml --- _data/glossary/persistent-volume.yaml | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/_data/glossary/persistent-volume.yaml b/_data/glossary/persistent-volume.yaml index 005f3dc5d8..1f0fe7b528 100644 --- a/_data/glossary/persistent-volume.yaml +++ b/_data/glossary/persistent-volume.yaml @@ -10,6 +10,8 @@ tags: - core-object - storage short-description: > - Persistent Volume is a kind of interface through two resource types, i.e. pv and pvc, and provides pod persistent storage service. + An API object that represents a piece of storage in the cluster. Available as a general, pluggable resource that persists beyond the lifecycle of any individual {% glossary_tooltip term_id="pod" %}. long-description: | - Persistent Volume subsystem provides an API for users and administrators that abstracts details of how storage is provided from how it is consumed. + PersistentVolumes (PVs) provide an API that abstracts details of how storage is provided from how it is consumed. + PVs are used directly in scenarios where storage can be be created ahead of time (static provisioning). + For scenarios that require on-demand storage (dynamic provisioning), PersistentVolumeClaims (PVCs) are used instead.