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 docs for VolumeManager reconstruction after kubelet restart #40038

Merged
merged 1 commit into from
Apr 3, 2023

Conversation

jsafrane
Copy link
Member

@jsafrane jsafrane commented Mar 16, 2023

Add docs for NewVolumeManagerReconstruction feature gate. This feature should be invisible to users - kubelet does the same thing as before, only in a different order at the startup. It's behind a feature gate to allow opt-out in case it's buggy.

KEP: https://github.com/kubernetes/enhancements/tree/master/keps/sig-storage/3756-volume-reconstruction
Enhancement issue: kubernetes/enhancements#3756

@k8s-ci-robot k8s-ci-robot added this to the 1.27 milestone Mar 16, 2023
@k8s-ci-robot k8s-ci-robot added 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 Mar 16, 2023
@k8s-ci-robot 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 Mar 16, 2023
@jsafrane
Copy link
Member Author

Please also review release-note in kubernetes/kubernetes#115268, that's the other place where we warn that any issues with kubelet startup could be caused by this feature.

@sftim
Copy link
Contributor

sftim commented Mar 16, 2023

/retitle Add docs for VolumeManager reconstruction after kubelet restart

@k8s-ci-robot k8s-ci-robot changed the title Add NewVolumeManagerReconstruction feature gate Add docs for VolumeManager reconstruction after kubelet restart Mar 16, 2023
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

Comment on lines 630 to 633
- `NewVolumeManagerReconstruction`: Enables improved discovery of mounted volumes during kubelet
startup. Since this code has been significantly refactored, we allow to opt-out in case kubelet
gets stuck at the startup or is not unmounting volumes from terminated Pods. Note that this
refactoring was behind `SELinuxMountReadWriteOncePod` alpha feature gate in Kubernets 1.25.
Copy link
Contributor

Choose a reason for hiding this comment

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

  • We should revise the SELinuxMountReadWriteOncePod description too, then.
    • We can backport a change to 1.25 and 1.26 docs to explain that the feature gate behavior partly moves to NewVolumeManagerReconstruction
  • “Kubernets” is a typo

@sftim
Copy link
Contributor

sftim commented Mar 16, 2023

/sig node

@k8s-ci-robot k8s-ci-robot added the sig/node Categorizes an issue or PR as relevant to SIG Node. label Mar 16, 2023
@sftim
Copy link
Contributor

sftim commented Mar 16, 2023

/sig storage

@k8s-ci-robot k8s-ci-robot added the sig/storage Categorizes an issue or PR as relevant to SIG Storage. label Mar 16, 2023
@jsafrane jsafrane force-pushed the volume-reconstruction branch from 0d7b014 to cfde821 Compare March 20, 2023 16:48
@jsafrane jsafrane force-pushed the volume-reconstruction branch from cfde821 to 7eefbb8 Compare March 20, 2023 17:46
@k8s-ci-robot k8s-ci-robot added size/S Denotes a PR that changes 10-29 lines, ignoring generated files. and removed size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Mar 20, 2023
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.

LGTM for docs
Ready for tech review

@tengqm
Copy link
Contributor

tengqm commented Mar 31, 2023

/approve
from docs side.

@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: tengqm

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

@k8s-ci-robot k8s-ci-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Mar 31, 2023
@xing-yang
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 Apr 3, 2023
@k8s-ci-robot
Copy link
Contributor

LGTM label has been added.

Git tree hash: 83a00fb782c443b993b0233bdda1af603dac598e

@k8s-ci-robot k8s-ci-robot merged commit cbd571e into kubernetes:dev-1.27 Apr 3, 2023
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. 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. sig/node Categorizes an issue or PR as relevant to SIG Node. sig/storage Categorizes an issue or PR as relevant to SIG Storage. size/S Denotes a PR that changes 10-29 lines, ignoring generated files.
Projects
Development

Successfully merging this pull request may close these issues.

5 participants