Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Kubernetes 1.31 release blog #47281

Merged
merged 1 commit into from
Aug 13, 2024

Conversation

a-mccarthy
Copy link
Contributor

@a-mccarthy a-mccarthy commented Jul 26, 2024

PR for adding the Kubernetes 1.31 release blog.

🛑 Do not unhold or merge until Kubernetes v1.31 is released 🛑

This blog will include the identified Major themes from this discussion: kubernetes/sig-release#2526

@k8s-ci-robot k8s-ci-robot added the cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. label Jul 26, 2024
@k8s-ci-robot k8s-ci-robot added area/blog Issues or PRs related to the Kubernetes Blog subproject language/en Issues or PRs related to English language labels Jul 26, 2024
@a-mccarthy a-mccarthy marked this pull request as draft July 26, 2024 13:56
@k8s-ci-robot k8s-ci-robot added do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Jul 26, 2024
@a-mccarthy
Copy link
Contributor Author

We are still collecting content. We will aim to get content added here for review by next Friday August 2nd.

/hold

@k8s-ci-robot k8s-ci-robot added the do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. label Jul 26, 2024
@a-mccarthy
Copy link
Contributor Author

cc: @mbianchidev @edithturn @hailkomputer @rashansmith

Copy link

netlify bot commented Jul 26, 2024

Pull request preview available for checking

Built without sensitive environment variables

Name Link
🔨 Latest commit d3f0d98
🔍 Latest deploy log https://app.netlify.com/sites/kubernetes-io-main-staging/deploys/66bb5d587420600009511626
😎 Deploy Preview https://deploy-preview-47281--kubernetes-io-main-staging.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

Copy link
Contributor

@sftim sftim left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How's this work going?

@a-mccarthy
Copy link
Contributor Author

@sftim, its going well. We should still be on track to add the draft content to the PR this friday

@k8s-ci-robot 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 Aug 3, 2024



## Release theme and logo
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@neoaggelos can you send this over when you have the theme and logo ready


Also see our [Kubernetes Removals and Major Changes In v1.31](https://kubernetes.io/blog/2024/07/19/kubernetes-1-31-upcoming-changes/) blog.

#### Cgroup v1 enters the maintenance mode
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is a blog going out #47069, currently set for 8/15. Should we move the date of that blog to go out the same day as the release? I'd like to make sure we don't create confusion about this topic so i think it would be good if we can link to this blog to give readers more context

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the content as written, currently links to the blog. So we'd have to update that if we dont publish the blogs the same day.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@harche can you review this content around the cgroup maintenance mode for the release blog?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@rashansmith what do you think about the publishing date?

xref: kubernetes/enhancements#4569 (comment)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@harche, yes, lets move up the publication date to August 13th your blog. It will go out the same day as the release so we can link readers to your blog for further reading.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

please also see #47069 (comment). I've updated the content here to include more information in the release blog and no longer link to the #47069 post. This way the #47069 can go out on august 14th and we dont have to worry about timestamps. This release blog will be the only blog we publish August 13th and feature blogs will start publishing august 14th.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

SGTM

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We can if we want change #47069, post release. The change I'm imagining would revise this article with a link to the new post.

@a-mccarthy
Copy link
Contributor Author

added the draft content we have so far. We are waiting for one more KEP to get back to us with content.

Its still in draft b/c i'd like to spend some time editing before the blog reviews spend time on it to hopefully catch small clean up. but anticipate bringing this out of draft for Monday

@a-mccarthy a-mccarthy marked this pull request as ready for review August 4, 2024 23:14
@k8s-ci-robot 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 Aug 4, 2024
Copy link
Member

@shurup shurup left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Leaving a few tiny corrections/suggestions that caught my attention.

Copy link
Contributor

@sftim sftim left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks

Here's partial feedback.


Kubernetes support for AppArmor is now GA. Protect your Containers using AppArmor by setting the `appArmorProfile.type` field in the Container's `securityContext`. Note that before Kubernetes v1.30, AppArmor was controlled via annotations; starting in v1.30 it is contorlled using fields. Its recommended that you should migrate away from using annotations and start using the `appArmorProfile.type` field.

To learn more read the [AppArmor tutorial](/docs/tutorials/security/apparmor/). This work was done as a part of [KEP #24](https://github.com/kubernetes/enhancements/issues/24) lead by [SIG Node](https://github.com/kubernetes/community/tree/master/sig-node).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we have any other docs for AppArmor yet? Ideally we would.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

as far as i can tell these are the docs we have. There is a PR for adding some more apparmor related docs, but its not merged yet.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@sftim following up here, dont think there are any other apparmor docs that i can find.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We could nudge release docs to nudge the SIG about adding some, but it's not directly relevant to this announcement.

* [Random Pod selection on ReplicaSet downscaling]( https://github.com/kubernetes/enhancements/issues/2185)


### Deprecations and Removals

This comment was marked as outdated.

Comment on lines 10 to 20
Announcing the release of Kubernetes v1.31: <THING>, <tagline>!

Similar to previous releases, the release of Kubernetes v1.31 introduces new
stable, beta, and alpha features.
The consistent delivery of high-quality releases underscores the strength of our development cycle and the vibrant support from our community.
This release consists of 45 enhancements.
Of those enhancements, 11 have graduated to Stable, 22 are entering Beta,
and 12 have graduated to Alpha.

## Release theme and logo
<Logo image size is recommended to be no more than 2160px/>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Highlighting that we'll need to fill this in.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

updated!

Copy link
Contributor

@danwinship danwinship left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm, with one nitpick

@k8s-ci-robot k8s-ci-robot added the sig/docs Categorizes an issue or PR as relevant to SIG Docs. label Aug 13, 2024
@k8s-ci-robot
Copy link
Contributor

[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:

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

@a-mccarthy a-mccarthy force-pushed the 1-31-release-blog branch 2 times, most recently from 707b209 to 5e34930 Compare August 13, 2024 05:03
Traffic distribution for Services moves to beta in v1.31 and is enabled by default.

After several iterations on finding the best user experience and traffic engineering capabilities for Services networking, the SIG Networking implemented the `trafficDistribution` field in the Service specification, that serves as a guideline for the underlying implementation to consider while making routing decisions.
It supersedes the functionality formerly provided by the `service.kubernetes.io/topology-mode` annotation and its precursor `topologyKeys` field (which has been deprecated since Kubernetes 1.21).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
It supersedes the functionality formerly provided by the `service.kubernetes.io/topology-mode` annotation and its precursor `topologyKeys` field (which has been deprecated since Kubernetes 1.21).

This one line in itself (without additional context about deprecations etc) may end up confusing people about: "Does service.kubernetes.io/topology-mode no longer work?" etc. Let's just include the first sentence? The link for the detailed docs (which you have already included) should help clarify all the other details.

Besides this, LGTM

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks for the suggestion, @gauravkghildiyal, i've updated the content to remove this sentence.

author: >
[Kubernetes v1.31 Release Team](https://github.com/kubernetes/sig-release/blob/master/releases/release-1.31/release-team.md)
---

Copy link
Member

@mbianchidev mbianchidev Aug 13, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Editors: Matteo Bianchi, Yigit Demirbas, Abigail McCarthy, Edith Puclla, Rashan Smith

Maybe we can add this line like in the 1.30 blog? Just noticed the difference while looking at the draft (ordered by surname but maybe it's not the right one)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

added

Copy link
Contributor

@katcosgrove katcosgrove left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nits and style guide. Non-blocking, though

adding 1.31 release blog

remove some typos

removing typos

Apply suggestions from review

Co-authored-by: Tim Bannister <[email protected]>
Co-authored-by: Dmitry Shurupov <[email protected]>

minor updates, adding KEP kubernetes#4193 content

Apply suggestions from review

Co-authored-by: Tim Bannister <[email protected]>

small nits from review

Apply suggestions from code review

Co-authored-by: Dipesh Rawat <[email protected]>
Co-authored-by: Tim Bannister <[email protected]>

Apply suggestions from code review

Co-authored-by: Dmitry Shurupov <[email protected]>
Co-authored-by: Tim Bannister <[email protected]>
Co-authored-by: Rey Lejano <[email protected]>
Co-authored-by: Mengjiao Liu <[email protected]>

updating deprecations and removals

Apply suggestions from code review

Co-authored-by: Tim Bannister <[email protected]>
Co-authored-by: Sascha Grunert <[email protected]>

updating file name, adding intro, fixing spacing

updating cgroup section

update bound service account docs

update nft tables section

update tenses in deprecation section

Apply suggestions from code review

Co-authored-by: Antonio Ojea <[email protected]>

update nft and bound service account sections

Apply suggestions from code review

Co-authored-by: Dipesh Rawat <[email protected]>

add release logo

Apply suggestions from code review

Co-authored-by: 杨朱 · Kiki <[email protected]>

small nits

Apply suggestions from code review

Co-authored-by: Kat Cosgrove <[email protected]>
@katcosgrove
Copy link
Contributor

/lgtm

@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Aug 13, 2024
@k8s-ci-robot
Copy link
Contributor

LGTM label has been added.

Git tree hash: a6faac78588375ba27bc9b4b6b56d91a47087325

@reylejano
Copy link
Member

/lgtm

@Princesso
Copy link
Contributor

/unhold

@k8s-ci-robot k8s-ci-robot removed the do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. label Aug 13, 2024
@reylejano reylejano merged commit 9266fbb into kubernetes:main Aug 13, 2024
6 checks passed

[VolumeAttributesClass](/docs/concepts/storage/volume-attributes-classes/) API is moving to beta in v1.31.
The VolumeAttributesClass provides a generic,
Kubernetes-native API for modifying dynamically volume parameters like provisioned IO.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: dynamically volume -> dynamically provisioned volume

Just a nit.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved Indicates a PR has been approved by an approver from all required OWNERS files. area/blog Issues or PRs related to the Kubernetes Blog subproject cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. language/en Issues or PRs related to English language lgtm "Looks good to me", indicates that a PR is ready to be merged. sig/docs Categorizes an issue or PR as relevant to SIG Docs. size/L Denotes a PR that changes 100-499 lines, ignoring generated files.
Projects
Status: Published
Development

Successfully merging this pull request may close these issues.