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

Document user namespace changes in v1.27 (KEP-127) #39860

Merged
merged 2 commits into from
Mar 31, 2023

Conversation

rata
Copy link
Member

@rata rata commented Mar 8, 2023

Placeholder PR to document the changes in Kubernetes v1.27 for user namespaces (KEP-127)

cc @giuseppe

@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 Mar 8, 2023
@k8s-ci-robot k8s-ci-robot added the language/en Issues or PRs related to English language label Mar 8, 2023
@k8s-ci-robot k8s-ci-robot added sig/docs Categorizes an issue or PR as relevant to SIG Docs. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. labels Mar 8, 2023
@netlify
Copy link

netlify bot commented Mar 8, 2023

Pull request preview available for checking

Built without sensitive environment variables

Name Link
🔨 Latest commit 4986795
🔍 Latest deploy log https://app.netlify.com/sites/kubernetes-io-main-staging/deploys/6408acf52334740007aecc98
😎 Deploy Preview https://deploy-preview-39860--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 settings.

@reylejano
Copy link
Member

Remember to change the base branch and target the dev-1.27 branch
/milestone 1.27
/cc @mickeyboxell

@k8s-ci-robot k8s-ci-robot added this to the 1.27 milestone Mar 8, 2023
@rata rata changed the base branch from main to dev-1.27 March 14, 2023 10:24
@k8s-ci-robot k8s-ci-robot added size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. and removed size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Mar 14, 2023
@k8s-ci-robot k8s-ci-robot added size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. and removed size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. labels Mar 14, 2023
@rata
Copy link
Member Author

rata commented Mar 14, 2023

@reylejano thanks, fixed that now!

@mickeyboxell
Copy link
Contributor

Hi @rata 👋 please take a look at Documenting for a release - PR Ready for Review to get your PR ready for review as soon as possible. 01:00 UTC Wednesday 22nd March 2023 / 17:00 PDT Tuesday 21st March 2023 is the official deadline.

This PR will need a doc review by Tuesday 4th April 2023 to get this into the release. Please reach out to required SIGs to get their review. Thank you!

@k8s-ci-robot k8s-ci-robot added size/M Denotes a PR that changes 30-99 lines, ignoring generated files. and removed size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Mar 21, 2023
@rata rata force-pushed the rata/userns branch 2 times, most recently from c0bd517 to cb8701e Compare March 21, 2023 11:43
@rata rata marked this pull request as ready for review March 21, 2023 11:46
@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 Mar 21, 2023
@rata
Copy link
Member Author

rata commented Mar 21, 2023

@mickeyboxell thanks, this should be ready for review now!

@rata
Copy link
Member Author

rata commented Mar 22, 2023

Pushed a new revision, PTAL

@tengqm
Copy link
Contributor

tengqm commented Mar 22, 2023

/label tide/merge-method-squash
/lgtm

@k8s-ci-robot k8s-ci-robot added the tide/merge-method-squash Denotes a PR that should be squashed by tide when it merges. label Mar 22, 2023
@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Mar 22, 2023
@k8s-ci-robot
Copy link
Contributor

LGTM label has been added.

Git tree hash: 7b641c7f1ad38026c10fdaab06d84eb4583e7d30

@k8s-ci-robot k8s-ci-robot removed the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Mar 23, 2023
@rata
Copy link
Member Author

rata commented Mar 23, 2023

@tengqm Can you PTAL?

I've added a new commit duplicating a warning about versions. It seems it is better to be super clear about this and not have it only in some pages and not others.

I'm trying to err on the side of being very clear as a learning from another (not related to this) bug report where doc was the issue.

Did it as another commit, also, as you selected the squash merge method

@tengqm
Copy link
Contributor

tengqm commented Mar 23, 2023

/approve

@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 23, 2023
@rata
Copy link
Member Author

rata commented Mar 23, 2023

@tengqm thanks, now the lgtm is missing :-D

@netlify
Copy link

netlify bot commented Mar 27, 2023

👷 Deploy Preview for kubernetes-io-vnext-staging processing.

Name Link
🔨 Latest commit a3c840e
🔍 Latest deploy log https://app.netlify.com/sites/kubernetes-io-vnext-staging/deploys/6421a6aa069a0800073f8d8b

@rata
Copy link
Member Author

rata commented Mar 27, 2023

Updated this PR to address similar comments that were raised in this other PR and also applied here: #40264


* The filesystem you use for `/var/lib/kubelet/pods/`, or the custom directory
you configure for this, needs idmap mount support.
* All the filesystems used in the pod need support for idmap mounts.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
* All the filesystems used in the pod need support for idmap mounts.
* Every volume that is mounted into any container in the pod must support idmap mounts.

Copy link
Member Author

@rata rata Mar 27, 2023

Choose a reason for hiding this comment

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

This smells slightly incorrect. What supports idmap mount is the filesystem, not the volume. It doesn't matter if it is an EBS volume, a local disk volume or what. The only thing that matters is that the filesystem used in that volume supports idmap mounts in the kernel running on the host.

So, what about this instead?

* All the filesystems used in the pod's volumes must support idmap mounts.

Copy link
Member Author

Choose a reason for hiding this comment

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

Changed it to that, let me know what you think

content/en/docs/concepts/workloads/pods/user-namespaces.md Outdated Show resolved Hide resolved
content/en/docs/concepts/workloads/pods/user-namespaces.md Outdated Show resolved Hide resolved
@rata
Copy link
Member Author

rata commented Mar 27, 2023

@sftim fixed all, thanks! PTAL

Also, with the new implementation, the fsGroup was dropped. So removed
the mention to those limitations.

Signed-off-by: Rodrigo Campos <[email protected]>
@tengqm
Copy link
Contributor

tengqm commented Mar 31, 2023

/lgtm
reapplied.

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

LGTM label has been added.

Git tree hash: 47c8f361630764ce0c0d919700424947b8306475

@k8s-ci-robot k8s-ci-robot merged commit 2ffb037 into kubernetes:dev-1.27 Mar 31, 2023
DonatoHorn pushed a commit to DonatoHorn/website that referenced this pull request Jun 25, 2023
* content: Update user namespaces version requirements

Also, with the new implementation, the fsGroup was dropped. So removed
the mention to those limitations.

Signed-off-by: Rodrigo Campos <[email protected]>

* content: Add reference to the userns task in the concepts page

Signed-off-by: Rodrigo Campos <[email protected]>

---------

Signed-off-by: Rodrigo Campos <[email protected]>
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. size/M Denotes a PR that changes 30-99 lines, ignoring generated files. tide/merge-method-squash Denotes a PR that should be squashed by tide when it merges.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

8 participants