From 00e5f9d05965e59e49a2720d3189152f1598e72d Mon Sep 17 00:00:00 2001 From: Vladimir Vivien Date: Tue, 5 Jun 2018 13:48:15 -0400 Subject: [PATCH 1/3] CSI documetation update for raw block volume support --- content/en/docs/concepts/storage/volumes.md | 20 +++++++++++++++++++ .../feature-gates.md | 2 ++ 2 files changed, 22 insertions(+) diff --git a/content/en/docs/concepts/storage/volumes.md b/content/en/docs/concepts/storage/volumes.md index a44fc5ae704ec..93830c226ae18 100644 --- a/content/en/docs/concepts/storage/volumes.md +++ b/content/en/docs/concepts/storage/volumes.md @@ -1152,6 +1152,26 @@ persistent volume: secret is required. If the secret object contains more than one secret, all secrets are passed. +#### CSI raw block volume support + +{{< feature-state for_k8s_version="v1.11" state="alpha" >}} + +Starting with version 1.11, CSI introduced support for raw block volumes. This work +relies on the raw block volume feature that was introduced in previous versions of +Kubernetes. This feature will make it possible for vendors with external CSI drivers to +implement raw block volumes support in Kubernetes workload. + +CSI block volume support is feature-gated and turned off by default. To run CSI with +block volume support enabled, an administrator must enabled the feature for each + Kubernetes component using the following: + +``` +--feature-gates=BlockVolume=true,CSIBlockVolume=true +``` + +Learn more about raw block volume support and see how to setup your PV/PVC +[here](/docs/concepts/storage/persistent-volumes/#raw-block-volume-support). + ### FlexVolume `FlexVolume` is an out-of-tree plugin interface that has existed in Kubernetes diff --git a/content/en/docs/reference/command-line-tools-reference/feature-gates.md b/content/en/docs/reference/command-line-tools-reference/feature-gates.md index c50733b8fb5db..6057904cdebf9 100644 --- a/content/en/docs/reference/command-line-tools-reference/feature-gates.md +++ b/content/en/docs/reference/command-line-tools-reference/feature-gates.md @@ -40,6 +40,7 @@ different Kubernetes components. | `CPUManager` | `true` | Beta | 1.10 | | | `CRIContainerLogRotation` | `false` | Alpha | 1.10 | 1.10 | | `CRIContainerLogRotation` | `true` | Beta| 1.11 | | +| `CSIBlockVolume` | `false` | Alpha | 1.11 | 1.11 | | `CSIPersistentVolume` | `false` | Alpha | 1.9 | 1.9 | | `CSIPersistentVolume` | `true` | Beta | 1.10 | | | `CustomPodDNS` | `false` | Alpha | 1.9 | 1.9 | @@ -151,6 +152,7 @@ Each feature gate is designed for enabling/disabling a specific feature: for more details. - `CPUManager`: Enable container level CPU affinity support, see [CPU Management Policies](/docs/tasks/administer-cluster/cpu-management-policies/). - `CRIContainerLogRotation`: Enable container log rotation for cri container runtime. +- `CSIBlockVolume`: Enable external CSI volume drivers to support block storage. Check the [`csi` raw block volume support](/docs/concepts/storage/volumes/#csi-raw-block-volume-support) for detail. - `CSIPersistentVolume`: Enable discovering and mounting volumes provisioned through a [CSI (Container Storage Interface)](https://github.com/kubernetes/community/blob/master/contributors/design-proposals/storage/container-storage-interface.md) compatible volume plugin. From d297404898ff4b5f9d057b38cc563f9c4a3e3802 Mon Sep 17 00:00:00 2001 From: Andrew Chen Date: Mon, 18 Jun 2018 13:06:21 -0700 Subject: [PATCH 2/3] minor edits for "CSI raw block volume support" Some small grammar and style nits. --- content/en/docs/concepts/storage/volumes.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/content/en/docs/concepts/storage/volumes.md b/content/en/docs/concepts/storage/volumes.md index 93830c226ae18..bc08acc030b52 100644 --- a/content/en/docs/concepts/storage/volumes.md +++ b/content/en/docs/concepts/storage/volumes.md @@ -1156,21 +1156,21 @@ persistent volume: {{< feature-state for_k8s_version="v1.11" state="alpha" >}} -Starting with version 1.11, CSI introduced support for raw block volumes. This work -relies on the raw block volume feature that was introduced in previous versions of +Starting with version 1.11, CSI introduced support for raw block volumes, which +relies on the raw block volume feature that was introduced in a previous version of Kubernetes. This feature will make it possible for vendors with external CSI drivers to -implement raw block volumes support in Kubernetes workload. +implement raw block volumes support in Kubernetes workloads. CSI block volume support is feature-gated and turned off by default. To run CSI with -block volume support enabled, an administrator must enabled the feature for each - Kubernetes component using the following: +block volume support enabled, a cluster administrator must enable the feature for each +Kubernetes component using the following feature gate flags: ``` --feature-gates=BlockVolume=true,CSIBlockVolume=true ``` -Learn more about raw block volume support and see how to setup your PV/PVC -[here](/docs/concepts/storage/persistent-volumes/#raw-block-volume-support). +Learn how to +[setup your PV/PVC with raw block volume support](/docs/concepts/storage/persistent-volumes/#raw-block-volume-support). ### FlexVolume From cac7761b0002af72e60afdfbb8f816a2c79bf90e Mon Sep 17 00:00:00 2001 From: Andrew Chen Date: Mon, 18 Jun 2018 13:09:06 -0700 Subject: [PATCH 3/3] minor CSIBlockVolume edits --- .../reference/command-line-tools-reference/feature-gates.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/reference/command-line-tools-reference/feature-gates.md b/content/en/docs/reference/command-line-tools-reference/feature-gates.md index 6057904cdebf9..ebe16302a536d 100644 --- a/content/en/docs/reference/command-line-tools-reference/feature-gates.md +++ b/content/en/docs/reference/command-line-tools-reference/feature-gates.md @@ -152,7 +152,7 @@ Each feature gate is designed for enabling/disabling a specific feature: for more details. - `CPUManager`: Enable container level CPU affinity support, see [CPU Management Policies](/docs/tasks/administer-cluster/cpu-management-policies/). - `CRIContainerLogRotation`: Enable container log rotation for cri container runtime. -- `CSIBlockVolume`: Enable external CSI volume drivers to support block storage. Check the [`csi` raw block volume support](/docs/concepts/storage/volumes/#csi-raw-block-volume-support) for detail. +- `CSIBlockVolume`: Enable external CSI volume drivers to support block storage. See the [`csi` raw block volume support](/docs/concepts/storage/volumes/#csi-raw-block-volume-support) documentation for more details. - `CSIPersistentVolume`: Enable discovering and mounting volumes provisioned through a [CSI (Container Storage Interface)](https://github.com/kubernetes/community/blob/master/contributors/design-proposals/storage/container-storage-interface.md) compatible volume plugin.