Skip to content

Commit 17d75d4

Browse files
authored
Merge pull request #51726 from sunnylovestiramisu/vac-doc
KEP-3751 VolumeAttributesClass GA in 1.34 Doc Update
2 parents 450bed9 + 2d15dba commit 17d75d4

File tree

2 files changed

+13
-19
lines changed

2 files changed

+13
-19
lines changed

content/en/docs/concepts/storage/volume-attributes-classes.md

Lines changed: 9 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -20,23 +20,7 @@ A VolumeAttributesClass provides a way for administrators to describe the mutabl
2020
"classes" of storage they offer. Different classes might map to different quality-of-service levels.
2121
Kubernetes itself is un-opinionated about what these classes represent.
2222

23-
This is a beta feature and disabled by default.
24-
25-
If you want to test the feature whilst it's beta, you need to enable the `VolumeAttributesClass`
26-
[feature gate](/docs/reference/command-line-tools-reference/feature-gates/) for the kube-controller-manager, kube-scheduler,
27-
and the kube-apiserver. You use the `--feature-gates` command line argument:
28-
29-
```
30-
--feature-gates="...,VolumeAttributesClass=true"
31-
```
32-
33-
You will also have to enable the `storage.k8s.io/v1beta1` API group through the
34-
`kube-apiserver` [runtime-config](https://kubernetes.io/docs/tasks/administer-cluster/enable-disable-api/).
35-
You use the following command line argument:
36-
37-
```
38-
--runtime-config=storage.k8s.io/v1beta1=true
39-
```
23+
This feature is generally available (GA) as of version 1.34, and users have the option to disable it.
4024

4125
You can also only use VolumeAttributesClasses with storage backed by
4226
{{< glossary_tooltip text="Container Storage Interface" term_id="csi" >}}, and only where the
@@ -53,7 +37,7 @@ Administrators set the name and other parameters of a class when first creating
5337
While the name of a VolumeAttributesClass object in a `PersistentVolumeClaim` is mutable, the parameters in an existing class are immutable.
5438

5539
```yaml
56-
apiVersion: storage.k8s.io/v1beta1
40+
apiVersion: storage.k8s.io/v1
5741
kind: VolumeAttributesClass
5842
metadata:
5943
name: silver
@@ -77,6 +61,9 @@ which are independent programs that follow a specification defined by Kubernetes
7761
Authors of external provisioners have full discretion over where their code lives, how
7862
the provisioner is shipped, how it needs to be run, what volume plugin it uses, etc.
7963

64+
To understand how the provisioner works with VolumeAttributesClass, refer to
65+
the [CSI external-provisioner documentation](https://kubernetes-csi.github.io/docs/external-provisioner.html).
66+
8067
### Resizer
8168

8269
Each VolumeAttributesClass has a resizer that determines what volume plugin is used
@@ -101,7 +88,7 @@ spec:
10188
A new VolumeAttributesClass gold is available in the cluster:
10289

10390
```yaml
104-
apiVersion: storage.k8s.io/v1beta1
91+
apiVersion: storage.k8s.io/v1
10592
kind: VolumeAttributesClass
10693
metadata:
10794
name: gold
@@ -124,6 +111,9 @@ spec:
124111
125112
```
126113

114+
To understand how the resizer works with VolumeAttributesClass, refer to
115+
the [CSI external-resizer documentation](https://kubernetes-csi.github.io/docs/external-resizer.html).
116+
127117
## Parameters
128118

129119
VolumeAttributeClasses have parameters that describe volumes belonging to them. Different parameters may be accepted

content/en/docs/reference/command-line-tools-reference/feature-gates/VolumeAttributesClass.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,10 @@ stages:
1313
- stage: beta
1414
defaultValue: false
1515
fromVersion: "1.31"
16+
toVersion: "1.33"
17+
- stage: stable
18+
defaultValue: true
19+
fromVersion: "1.34"
1620
---
1721
Enable support for VolumeAttributesClasses.
1822
See [Volume Attributes Classes](/docs/concepts/storage/volume-attributes-classes/)

0 commit comments

Comments
 (0)