1.29 - Add a blog post about VolumeAttributesClass #43777

sunnylovestiramisu · 2023-11-01T20:45:35Z

Add a blog for kubernetes/enhancements#3751 (~~WIP~~)

Draft of the blog post: https://docs.google.com/document/d/1IDtALLef8mh9PLNj545hdZgBTyWHql9l0zduSV_yGSg/edit?resourcekey=0-PLJOfJNET_34xAdlGwLXiQ#heading=h.ymhtacwivbvt

netlify · 2023-11-01T20:48:22Z

✅ Pull request preview available for checking

Built without sensitive environment variables

Name	Link
🔨 Latest commit	`0daa5df`
🔍 Latest deploy log	https://app.netlify.com/sites/kubernetes-io-main-staging/deploys/657202c5a273db0008d43ace
😎 Deploy Preview	https://deploy-preview-43777--kubernetes-io-main-staging.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

krol3 · 2023-11-15T17:03:38Z

Hi @sunnylovestiramisu! , Here the communications 1.29 Team, the deadline to the feature blog be ready to review is this Friday, Nov 17th, the proposal publish date will be Dec 15th. cc: @a-mccarthy @kcmartin @James-Quigley

sunnylovestiramisu · 2023-11-15T17:46:33Z

@krol3 We's like to post the blog post in mid Dec ish probably around Dec 15th? What do you think?

krol3 · 2023-11-15T18:28:40Z

@krol3 We's like to post the blog post in mid Dec ish probably around Dec 15th? What do you think?

Scheduled it! Thanks @sunnylovestiramisu 🙏🏾

kcmartin · 2023-11-17T00:33:52Z

@sunnylovestiramisu 1.29 Comms Team here! The blog format requires that you add the following to the beginning of the file:

layout: blog
title: "Kubernetes 1.29: VolumeAttributesClass for Volume Modification"
date: 2023-11-15
slug: kubernetes-1-29-volume-attributes-class
---

**Author:** Sunny Song (Google)```

kcmartin · 2023-11-17T00:36:57Z

content/en/blog/_posts/2023-11-20-volume-attributes-class/index.md

@@ -0,0 +1,162 @@
+# Kubernetes v1.29: VolumeAttributesClass for Volume Modification


See my comment about the correct formatting for the blog post

Updated base on comments: 3367a87

Ritikaa96 · 2023-11-20T10:30:49Z

content/en/blog/_posts/2023-11-20-volume-attributes-class/index.md

+
+**Authors**: Sunny Song(Google)
+
+The v1.29 release of Kubernetes introduced an alpha feature to support modify volume by changing VolumeAttributesClass that was assigned to a PersistentVolumeClaim (PVC). With the feature enabled, Kubernetes can handle updates of volume attributes other than capacity. Allowing volume attributes to be changed without managing it through different provider's APIs directly simplifies the current flow.


Suggested change

The v1.29 release of Kubernetes introduced an alpha feature to support modify volume by changing VolumeAttributesClass that was assigned to a PersistentVolumeClaim (PVC). With the feature enabled, Kubernetes can handle updates of volume attributes other than capacity. Allowing volume attributes to be changed without managing it through different provider's APIs directly simplifies the current flow.

The v1.29 release of Kubernetes introduced an alpha feature to support modify volume

by changing VolumeAttributesClass that was assigned to a PersistentVolumeClaim (PVC).

With the feature enabled, Kubernetes can handle updates of volume attributes other than capacity.

Allowing volume attributes to be changed without managing it through different

provider's APIs directly simplifies the current flow.

Updated in: 3367a87

by changing VolumeAttributesClass that was assigned to a PersistentVolumeClaim (PVC).

It maybe misunderstand by users how to change the volume attributes of a PVC. It should be changed the reference of the PVC's volume attributes class by editing the PVC's spec.volumeAttributesClassName field, not the VolumeAttributesClass itself.

cc @Ritikaa96 @sunnylovestiramisu

content/en/blog/_posts/2023-11-20-volume-attributes-class/index.md

Ritikaa96 · 2023-11-20T10:59:12Z

content/en/blog/_posts/2023-11-20-volume-attributes-class/index.md

+
+*   See the [VolumeAttributesClass KEP](https://github.com/kubernetes/enhancements/tree/master/keps/sig-storage/3751-volume-attributes-class) for more information on the design
+*   You can view or comment on the [project board](https://github.com/orgs/kubernetes-csi/projects/72) for VolumeAttributesClass
+*   In order to move this feature towards beta, we need feedback from the community, so here's a call to action: add support to the CSI drivers, try out this feature, consider how it can help with problems that your users are having…


Suggested change

* In order to move this feature towards beta, we need feedback from the community, so here's a call to action: add support to the CSI drivers, try out this feature, consider how it can help with problems that your users are having…

* In order to move this feature towards beta, we need feedback from the community,

so here's a call to action: add support to the CSI drivers, try out this feature,

consider how it can help with problems that your users are having…

Ritikaa96 · 2023-11-20T11:00:03Z

content/en/blog/_posts/2023-11-20-volume-attributes-class/index.md

+
+## How to use it
+
+If you want to test the feature whilst it's alpha, you need to enable the relevant feature gate in the kube-controller-manager and the kube-apiserver. Use the --feature-gates command line argument:


Suggested change

If you want to test the feature whilst it's alpha, you need to enable the relevant feature gate in the kube-controller-manager and the kube-apiserver. Use the --feature-gates command line argument:

If you want to test the feature whilst it's alpha, you need to enable the relevant feature gate

in the kube-controller-manager and the kube-apiserver. Use the --feature-gates command line argument:

tengqm · 2023-11-20T13:50:21Z

Do we have some more formal docs under /content/en/docs for this VolumeAttributesClass thing?

sunnylovestiramisu · 2023-11-20T17:29:54Z

Docs PR in: #43463

carlory · 2023-11-21T03:17:35Z

content/en/blog/_posts/2023-11-20-volume-attributes-class/index.md

+
+## VolumeAttributesClass
+
+The new resource.k8s.io/v1alpha1 API group provides two new types:


resource.k8s.io/v1alpha1 is not correct.

VolumeAttributesClass API belongs to storage.k8s.io/v1alpha1.

PVC belongs to core/v1.

Ritikaa96

Few nits

Ritikaa96 · 2023-11-22T04:22:27Z

content/en/blog/_posts/2023-11-20-volume-attributes-class/index.md

+```
+
+
+It also requires the CSI driver has implemented the ModifyVolume API.


Suggested change

It also requires the CSI driver has implemented the ModifyVolume API.

It also requires that the CSI driver has implemented the ModifyVolume API.

Ritikaa96 · 2023-11-22T04:24:28Z

content/en/blog/_posts/2023-11-20-volume-attributes-class/index.md

+
+### User Flow
+
+If you would like to see the feature in action and verify it works fine in your cluster here's what you can try:


Suggested change

If you would like to see the feature in action and verify it works fine in your cluster here's what you can try:

If you would like to see the feature in action and verify it works fine in your cluster, here's what you can try:

Ritikaa96 · 2023-11-22T04:35:53Z

content/en/blog/_posts/2023-11-20-volume-attributes-class/index.md

+
+## Getting involved
+
+We always welcome new contributors so if you would like to get involved you can join our [Kubernetes Storage Special-Interest-Group](https://github.com/kubernetes/community/tree/master/sig-storage) (SIG).


Suggested change

We always welcome new contributors so if you would like to get involved you can join our [Kubernetes Storage Special-Interest-Group](https://github.com/kubernetes/community/tree/master/sig-storage) (SIG).

We always welcome new contributors. So, if you would like to get involved, you can join our [Kubernetes Storage Special-Interest-Group](https://github.com/kubernetes/community/tree/master/sig-storage) (SIG).

content/en/blog/_posts/2023-11-20-volume-attributes-class/index.md

kcmartin · 2023-11-26T20:27:03Z

content/en/blog/_posts/2023-11-20-volume-attributes-class/index.md

+provider's APIs directly simplifies the current flow.
+
+You can read VolumeAttributesClass in the Kubernetes documentation for more details
+about how to use that, or you can read on to learn about why the Kubernetes project is supporting this feature.


Suggested change

about how to use that, or you can read on to learn about why the Kubernetes project is supporting this feature.

or you can read on to learn about why the Kubernetes project is supporting this feature.

sunnylovestiramisu · 2023-12-04T17:09:56Z

@sftim Changed date to Dec 15th.

Review was stale

sftim

Thanks

I recommend some whitespace changes.

content/en/blog/_posts/2023-12-15-volume-attributes-class/index.md

sftim · 2023-12-05T17:13:14Z

content/en/blog/_posts/2023-12-15-volume-attributes-class/index.md

+```yaml
+kubectl describe pvc <PVC_NAME>
+```


Please indent all of the non-blank lines by three spaces.

This is just a command, it should not be yaml actually. Let me correct that.

content/en/blog/_posts/2023-12-15-volume-attributes-class/index.md

sunnylovestiramisu · 2023-12-05T21:28:44Z

@sftim updated the PR again.

content/en/blog/_posts/2023-12-15-volume-attributes-class/index.md

sftim

The Markdown looks right. Thanks for putting the time in on this article @sunnylovestiramisu.

/lgtm

k8s-ci-robot · 2023-12-07T20:14:16Z

LGTM label has been added.

Git tree hash: 60cbd2a3828875173b82d5e24127a0e1c0484820

k8s-ci-robot · 2023-12-07T20:14:24Z

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: sftim

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

~~content/en/blog/OWNERS~~ [sftim]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

sftim · 2023-12-07T20:14:38Z

/label tide/merge-method-squash
~~Once~~ Now this has an LGTM label, it's helpful if you squash it to 1 commit (it is OK to keep the same tree; in fact, that helps)

We can remove that label (tide/merge-method-squash) once this is only 1 commit. It's also OK to merge this PR just as it is.

🛑 Do not merge until Kubernetes v1.29 is released 🛑

sftim · 2023-12-13T18:53:35Z

/remove-label tide/merge-method-squash
(it's fine)

/hold cancel

k8s-ci-robot added do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Nov 1, 2023

k8s-ci-robot requested a review from nate-double-u November 1, 2023 20:46

k8s-ci-robot added the area/blog Issues or PRs related to the Kubernetes Blog subproject label Nov 1, 2023

k8s-ci-robot requested a review from onlydole November 1, 2023 20:46

k8s-ci-robot added language/en Issues or PRs related to English language sig/docs Categorizes an issue or PR as relevant to SIG Docs. labels Nov 1, 2023

pacoxu mentioned this pull request Nov 10, 2023

Kubernetes VolumeAttributesClass ModifyVolume kubernetes/enhancements#3751

Open

11 tasks

sunnylovestiramisu force-pushed the blog branch from 36ff05b to 04b37a5 Compare November 13, 2023 22:51

k8s-ci-robot added size/L Denotes a PR that changes 100-499 lines, ignoring generated files. and removed size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Nov 13, 2023

sunnylovestiramisu force-pushed the blog branch 2 times, most recently from 1a56e89 to 69d1c46 Compare November 13, 2023 23:00

sunnylovestiramisu changed the title ~~[WIP] Add a blog post about VolumeAttributesClass~~ Add a blog post about VolumeAttributesClass Nov 15, 2023

k8s-ci-robot removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Nov 15, 2023

kcmartin reviewed Nov 17, 2023

View reviewed changes

Ritikaa96 suggested changes Nov 20, 2023

View reviewed changes

sunnylovestiramisu force-pushed the blog branch from 69d1c46 to 3367a87 Compare November 20, 2023 17:46

carlory reviewed Nov 21, 2023

View reviewed changes

Ritikaa96 suggested changes Nov 22, 2023

View reviewed changes

kcmartin reviewed Nov 26, 2023

View reviewed changes

content/en/blog/_posts/2023-11-20-volume-attributes-class/index.md Outdated Show resolved Hide resolved

kcmartin reviewed Nov 26, 2023

View reviewed changes

sftim reviewed Dec 5, 2023

View reviewed changes

sunnylovestiramisu force-pushed the blog branch from f6f491d to 255d8b0 Compare December 5, 2023 21:28

sftim reviewed Dec 6, 2023

View reviewed changes

content/en/blog/_posts/2023-12-15-volume-attributes-class/index.md Outdated Show resolved Hide resolved

sftim reviewed Dec 6, 2023

View reviewed changes

content/en/blog/_posts/2023-12-15-volume-attributes-class/index.md Outdated Show resolved Hide resolved

sftim reviewed Dec 6, 2023

View reviewed changes

content/en/blog/_posts/2023-12-15-volume-attributes-class/index.md Outdated Show resolved Hide resolved

sftim reviewed Dec 6, 2023

View reviewed changes

content/en/blog/_posts/2023-12-15-volume-attributes-class/index.md Outdated Show resolved Hide resolved

sftim reviewed Dec 6, 2023

View reviewed changes

content/en/blog/_posts/2023-12-15-volume-attributes-class/index.md Outdated Show resolved Hide resolved

sftim reviewed Dec 6, 2023

View reviewed changes

content/en/blog/_posts/2023-12-15-volume-attributes-class/index.md Outdated Show resolved Hide resolved

sunnylovestiramisu force-pushed the blog branch from 255d8b0 to fbcae05 Compare December 6, 2023 17:09

sftim reviewed Dec 6, 2023

View reviewed changes

content/en/blog/_posts/2023-12-15-volume-attributes-class/index.md Outdated Show resolved Hide resolved

sunnylovestiramisu added 3 commits December 7, 2023 17:36

Add a blog post about VolumeAttributesClass

7000237

Update Based on Comments - Dec 4

0553a7c

Update Based on Comments - Dec 7

0daa5df

sunnylovestiramisu force-pushed the blog branch from fbcae05 to 0daa5df Compare December 7, 2023 17:37

sftim approved these changes Dec 7, 2023

View reviewed changes

k8s-ci-robot assigned sftim Dec 7, 2023

k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Dec 7, 2023

k8s-ci-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Dec 7, 2023

k8s-ci-robot added the tide/merge-method-squash Denotes a PR that should be squashed by tide when it merges. label Dec 7, 2023

k8s-ci-robot removed do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. tide/merge-method-squash Denotes a PR that should be squashed by tide when it merges. labels Dec 13, 2023

k8s-ci-robot merged commit e0e08b7 into kubernetes:main Dec 13, 2023
6 checks passed

sunnylovestiramisu changed the title ~~Add a blog post about VolumeAttributesClass~~ 1.29 - Add a blog post about VolumeAttributesClass Jan 29, 2024

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

1.29 - Add a blog post about VolumeAttributesClass #43777

1.29 - Add a blog post about VolumeAttributesClass #43777

sunnylovestiramisu commented Nov 1, 2023 •

edited by sftim

netlify bot commented Nov 1, 2023 •

edited

krol3 commented Nov 15, 2023 •

edited

sunnylovestiramisu commented Nov 15, 2023

krol3 commented Nov 15, 2023

kcmartin commented Nov 17, 2023 •

edited

kcmartin Nov 17, 2023

sunnylovestiramisu Nov 20, 2023

Ritikaa96 Nov 20, 2023

sunnylovestiramisu Nov 20, 2023

carlory Nov 21, 2023

Ritikaa96 Nov 20, 2023

Ritikaa96 Nov 20, 2023

tengqm commented Nov 20, 2023

sunnylovestiramisu commented Nov 20, 2023 •

edited

carlory Nov 21, 2023 •

edited

Ritikaa96 left a comment

Ritikaa96 Nov 22, 2023

Ritikaa96 Nov 22, 2023

Ritikaa96 Nov 22, 2023

kcmartin Nov 26, 2023

sunnylovestiramisu commented Dec 4, 2023

sftim left a comment

sftim Dec 5, 2023

sunnylovestiramisu Dec 5, 2023

sunnylovestiramisu commented Dec 5, 2023

sftim left a comment

k8s-ci-robot commented Dec 7, 2023

k8s-ci-robot commented Dec 7, 2023

sftim commented Dec 7, 2023 •

edited

sftim commented Dec 13, 2023

		@@ -0,0 +1,162 @@
		# Kubernetes v1.29: VolumeAttributesClass for Volume Modification


		Authors: Sunny Song(Google)

		The v1.29 release of Kubernetes introduced an alpha feature to support modify volume by changing VolumeAttributesClass that was assigned to a PersistentVolumeClaim (PVC). With the feature enabled, Kubernetes can handle updates of volume attributes other than capacity. Allowing volume attributes to be changed without managing it through different provider's APIs directly simplifies the current flow.


		## How to use it

		If you want to test the feature whilst it's alpha, you need to enable the relevant feature gate in the kube-controller-manager and the kube-apiserver. Use the --feature-gates command line argument:

	If you want to test the feature whilst it's alpha, you need to enable the relevant feature gate in the kube-controller-manager and the kube-apiserver. Use the --feature-gates command line argument:
	If you want to test the feature whilst it's alpha, you need to enable the relevant feature gate
	in the kube-controller-manager and the kube-apiserver. Use the --feature-gates command line argument:


		## VolumeAttributesClass

		The new resource.k8s.io/v1alpha1 API group provides two new types:

		```


		It also requires the CSI driver has implemented the ModifyVolume API.

	It also requires the CSI driver has implemented the ModifyVolume API.
	It also requires that the CSI driver has implemented the ModifyVolume API.


		### User Flow

		If you would like to see the feature in action and verify it works fine in your cluster here's what you can try:


		## Getting involved

		We always welcome new contributors so if you would like to get involved you can join our [Kubernetes Storage Special-Interest-Group](https://github.com/kubernetes/community/tree/master/sig-storage) (SIG).

	We always welcome new contributors so if you would like to get involved you can join our [Kubernetes Storage Special-Interest-Group](https://github.com/kubernetes/community/tree/master/sig-storage) (SIG).
	We always welcome new contributors. So, if you would like to get involved, you can join our [Kubernetes Storage Special-Interest-Group](https://github.com/kubernetes/community/tree/master/sig-storage) (SIG).

	about how to use that, or you can read on to learn about why the Kubernetes project is supporting this feature.
	or you can read on to learn about why the Kubernetes project is supporting this feature.

1.29 - Add a blog post about VolumeAttributesClass #43777

1.29 - Add a blog post about VolumeAttributesClass #43777

Conversation

sunnylovestiramisu commented Nov 1, 2023 • edited by sftim

netlify bot commented Nov 1, 2023 • edited

✅ Pull request preview available for checking

krol3 commented Nov 15, 2023 • edited

sunnylovestiramisu commented Nov 15, 2023

krol3 commented Nov 15, 2023

kcmartin commented Nov 17, 2023 • edited

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

tengqm commented Nov 20, 2023

sunnylovestiramisu commented Nov 20, 2023 • edited

carlory Nov 21, 2023 • edited

Choose a reason for hiding this comment

Ritikaa96 left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

sunnylovestiramisu commented Dec 4, 2023

sftim left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

sunnylovestiramisu commented Dec 5, 2023

sftim left a comment

Choose a reason for hiding this comment

k8s-ci-robot commented Dec 7, 2023

k8s-ci-robot commented Dec 7, 2023

sftim commented Dec 7, 2023 • edited

sftim commented Dec 13, 2023

sunnylovestiramisu commented Nov 1, 2023 •

edited by sftim

netlify bot commented Nov 1, 2023 •

edited

krol3 commented Nov 15, 2023 •

edited

kcmartin commented Nov 17, 2023 •

edited

sunnylovestiramisu commented Nov 20, 2023 •

edited

carlory Nov 21, 2023 •

edited

sftim commented Dec 7, 2023 •

edited