From 9c0c75e0f2d8f5acfb1607b3afa79e3497cfa129 Mon Sep 17 00:00:00 2001 From: Tim Bannister Date: Wed, 17 Nov 2021 00:20:18 +0000 Subject: [PATCH 1/2] Reorder storage concepts Introduce concepts in an order that should suit people new to Kubernetes, so that you don't encounter details like volume cloning until you've seen more of the basic volume types (persistent, ephemeral, projected). --- content/en/docs/concepts/storage/ephemeral-volumes.md | 2 +- content/en/docs/concepts/storage/projected-volumes.md | 1 + content/en/docs/concepts/storage/storage-capacity.md | 2 +- content/en/docs/concepts/storage/volume-pvc-datasource.md | 2 +- content/en/docs/concepts/storage/volume-snapshot-classes.md | 2 +- content/en/docs/concepts/storage/volume-snapshots.md | 2 +- 6 files changed, 6 insertions(+), 5 deletions(-) diff --git a/content/en/docs/concepts/storage/ephemeral-volumes.md b/content/en/docs/concepts/storage/ephemeral-volumes.md index 1e811fb82a..2d54f71cd2 100644 --- a/content/en/docs/concepts/storage/ephemeral-volumes.md +++ b/content/en/docs/concepts/storage/ephemeral-volumes.md @@ -7,7 +7,7 @@ reviewers: - pohly title: Ephemeral Volumes content_type: concept -weight: 50 +weight: 30 --- diff --git a/content/en/docs/concepts/storage/projected-volumes.md b/content/en/docs/concepts/storage/projected-volumes.md index a5914adb6f..962e6bae91 100644 --- a/content/en/docs/concepts/storage/projected-volumes.md +++ b/content/en/docs/concepts/storage/projected-volumes.md @@ -6,6 +6,7 @@ reviewers: - zshihang title: Projected Volumes content_type: concept +weight: 21 # just after persistent volumes --- diff --git a/content/en/docs/concepts/storage/storage-capacity.md b/content/en/docs/concepts/storage/storage-capacity.md index 13ae8ab722..dbe30643d9 100644 --- a/content/en/docs/concepts/storage/storage-capacity.md +++ b/content/en/docs/concepts/storage/storage-capacity.md @@ -7,7 +7,7 @@ reviewers: - pohly title: Storage Capacity content_type: concept -weight: 45 +weight: 70 --- diff --git a/content/en/docs/concepts/storage/volume-pvc-datasource.md b/content/en/docs/concepts/storage/volume-pvc-datasource.md index 9e59560d1d..f800d9107a 100644 --- a/content/en/docs/concepts/storage/volume-pvc-datasource.md +++ b/content/en/docs/concepts/storage/volume-pvc-datasource.md @@ -6,7 +6,7 @@ reviewers: - msau42 title: CSI Volume Cloning content_type: concept -weight: 30 +weight: 60 --- diff --git a/content/en/docs/concepts/storage/volume-snapshot-classes.md b/content/en/docs/concepts/storage/volume-snapshot-classes.md index ee781d665f..45f7149a38 100644 --- a/content/en/docs/concepts/storage/volume-snapshot-classes.md +++ b/content/en/docs/concepts/storage/volume-snapshot-classes.md @@ -8,7 +8,7 @@ reviewers: - yuxiangqian title: Volume Snapshot Classes content_type: concept -weight: 30 +weight: 41 # just after volume snapshots --- diff --git a/content/en/docs/concepts/storage/volume-snapshots.md b/content/en/docs/concepts/storage/volume-snapshots.md index 7673ecf2b4..8d9a5acb72 100644 --- a/content/en/docs/concepts/storage/volume-snapshots.md +++ b/content/en/docs/concepts/storage/volume-snapshots.md @@ -8,7 +8,7 @@ reviewers: - yuxiangqian title: Volume Snapshots content_type: concept -weight: 20 +weight: 40 --- From 195ab34d01bddd08ca440b6bd5c43a114d07f5bf Mon Sep 17 00:00:00 2001 From: Tim Bannister Date: Wed, 17 Nov 2021 00:21:53 +0000 Subject: [PATCH 2/2] Fix nits Tidying that I spotted whilst reordering the storage concepts section. --- content/en/docs/concepts/storage/persistent-volumes.md | 3 +-- content/en/docs/concepts/storage/projected-volumes.md | 3 +-- content/en/docs/concepts/storage/storage-capacity.md | 1 - 3 files changed, 2 insertions(+), 5 deletions(-) diff --git a/content/en/docs/concepts/storage/persistent-volumes.md b/content/en/docs/concepts/storage/persistent-volumes.md index f2093073df..4496f247d9 100644 --- a/content/en/docs/concepts/storage/persistent-volumes.md +++ b/content/en/docs/concepts/storage/persistent-volumes.md @@ -10,14 +10,13 @@ feature: title: Storage orchestration description: > Automatically mount the storage system of your choice, whether from local storage, a public cloud provider such as GCP or AWS, or a network storage system such as NFS, iSCSI, Gluster, Ceph, Cinder, or Flocker. - content_type: concept weight: 20 --- -This document describes the current state of _persistent volumes_ in Kubernetes. Familiarity with [volumes](/docs/concepts/storage/volumes/) is suggested. +This document describes _persistent volumes_ in Kubernetes. Familiarity with [volumes](/docs/concepts/storage/volumes/) is suggested. diff --git a/content/en/docs/concepts/storage/projected-volumes.md b/content/en/docs/concepts/storage/projected-volumes.md index 962e6bae91..e515b1138e 100644 --- a/content/en/docs/concepts/storage/projected-volumes.md +++ b/content/en/docs/concepts/storage/projected-volumes.md @@ -1,6 +1,5 @@ --- reviewers: -- sftim - marosset - jsturtevant - zshihang @@ -11,7 +10,7 @@ weight: 21 # just after persistent volumes -This document describes the current state of _projected volumes_ in Kubernetes. Familiarity with [volumes](/docs/concepts/storage/volumes/) is suggested. +This document describes _projected volumes_ in Kubernetes. Familiarity with [volumes](/docs/concepts/storage/volumes/) is suggested. diff --git a/content/en/docs/concepts/storage/storage-capacity.md b/content/en/docs/concepts/storage/storage-capacity.md index dbe30643d9..ecf3fdc213 100644 --- a/content/en/docs/concepts/storage/storage-capacity.md +++ b/content/en/docs/concepts/storage/storage-capacity.md @@ -16,7 +16,6 @@ Storage capacity is limited and may vary depending on the node on which a pod runs: network-attached storage might not be accessible by all nodes, or storage is local to a node to begin with. -{{< feature-state for_k8s_version="v1.19" state="alpha" >}} {{< feature-state for_k8s_version="v1.21" state="beta" >}} This page describes how Kubernetes keeps track of storage capacity and