-
Notifications
You must be signed in to change notification settings - Fork 14.5k
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
Graduate Node-specific Volume Limits to GA #17432
Conversation
Deploy preview for kubernetes-io-vnext-staging processing. Building with commit 1d204b4 https://app.netlify.com/sites/kubernetes-io-vnext-staging/deploys/5dd64ad41c84ac00086eaf6a |
/milestone 1.17 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Informal feedback; I hope it's useful.
|
||
Kubernetes 1.11 introduced support for dynamic volume limits based on Node type as an Alpha feature. | ||
In Kubernetes 1.12 this feature is graduating to Beta and will be enabled by default. | ||
Support for dynamic volume limits was introduced as an Alpha feature in Kubernetes 1.11. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Now that the feature is stable, it's (IMO) OK to omit the history. Readers can look at the v1.16 docs (one before the version it went GA) if they are interested.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Re-worded, PTAL
4c5436f
to
a69bf78
Compare
/lgtm |
Oh actually, can you update feature-gates.md too? |
a69bf78
to
0d8adc4
Compare
Done! PTAL |
@@ -46,8 +46,9 @@ different Kubernetes components. | |||
| `APIListChunking` | `true` | Beta | 1.9 | | | |||
| `APIResponseCompression` | `false` | Alpha | 1.7 | | | |||
| `AppArmor` | `true` | Beta | 1.4 | | | |||
| `AttachVolumeLimit` | `true` | Alpha | 1.11 | 1.11 | | |||
| `AttachVolumeLimit` | `false` | Alpha | 1.11 | 1.11 | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This was set to true
in Alpha, which I think is incorrect, right?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
As a GA feature, this should move to the section Feature gates for graduated or deprecated features
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Fixed
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think we move the alpha and beta rows also to the graduated section below too
71cfd8c
to
1cf93fe
Compare
It is recommended that CSI drivers allow for customization of volume limits | ||
as well. That way cluster administrators can distribute the limits of the | ||
same storage backends (e.g. iSCSI) accross different drivers, according to | ||
their individual needs. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@gnufied can you take a look at this?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think this should be documented in - https://kubernetes-csi.github.io/docs/csi-node-object.html and not here because these are mostly user facing docs.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Makes sense. Removed
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I spotted that the feature gate handling wasn't quite right
|
||
Kubernetes 1.11 introduced support for dynamic volume limits based on Node type as an Alpha feature. | ||
In Kubernetes 1.12 this feature is graduating to Beta and will be enabled by default. | ||
Support for dynamic volume limits in Kubernetes 1.17 has been declared stable. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
You can omit this line: the feature-state shortcode says the same thing.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Removed
@@ -46,8 +46,9 @@ different Kubernetes components. | |||
| `APIListChunking` | `true` | Beta | 1.9 | | | |||
| `APIResponseCompression` | `false` | Alpha | 1.7 | | | |||
| `AppArmor` | `true` | Beta | 1.4 | | | |||
| `AttachVolumeLimit` | `true` | Alpha | 1.11 | 1.11 | | |||
| `AttachVolumeLimit` | `false` | Alpha | 1.11 | 1.11 | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
As a GA feature, this should move to the section Feature gates for graduated or deprecated features
b7ecbe9
to
bc15987
Compare
@@ -38,6 +38,8 @@ that can be attached to a Node: | |||
|
|||
You can change these limits by setting the value of the | |||
`KUBE_MAX_PD_VOLS` environment variable, and then starting the scheduler. | |||
CSI drivers might have a diferent procedure, see their documentation |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
typo: different
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Fixed
@@ -46,8 +46,9 @@ different Kubernetes components. | |||
| `APIListChunking` | `true` | Beta | 1.9 | | | |||
| `APIResponseCompression` | `false` | Alpha | 1.7 | | | |||
| `AppArmor` | `true` | Beta | 1.4 | | | |||
| `AttachVolumeLimit` | `true` | Alpha | 1.11 | 1.11 | | |||
| `AttachVolumeLimit` | `false` | Alpha | 1.11 | 1.11 | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think we move the alpha and beta rows also to the graduated section below too
bc15987
to
a1aa2cf
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Comments address, PTAL
@@ -38,6 +38,8 @@ that can be attached to a Node: | |||
|
|||
You can change these limits by setting the value of the | |||
`KUBE_MAX_PD_VOLS` environment variable, and then starting the scheduler. | |||
CSI drivers might have a diferent procedure, see their documentation |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Fixed
/lgtm |
@sftim lgtm from your side as well? |
All fine by me. @bertinatto looks like this needs a rebase though? |
a1aa2cf
to
1d204b4
Compare
/lgtm |
/approve |
[APPROVALNOTIFIER] This PR is APPROVED This pull-request has been approved by: daminisatya 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 |
* feat: graduate TaintNodesByCondition to GA (#17073) * Promote StartupProbe to beta (enabled by default). (#17164) * Watch bookmarks to GA (#17026) * feat: graduate ScheduleDaemonSetPods to GA (#17350) * Update Docker installation instructions (#17405) * Use exact version numbers for installing Docker in Ubuntu (#17428) * Move CSIMigration and CSIMigrationGCE to Beta in Kubernetes v1.17 (#17478) * Promote NodeLease feature to GA (#17189) * Update docs for csi topology ga (#17408) * Update RunAsUsername to beta (#17460) * doc:Update RunAsUsername to beta * doc: update samples - kubernetes.io/os is no longer beta * Updating based on review feedback * Promote Node-specific volume limits to GA (#17432) * Promote PodShareProcessNamespace to stable (#17192) * Promote PodShareProcessNamespace to stable * Add for_k8s_version to feature-state label Co-Authored-By: Tim Bannister <tim@scalefactory.com> * Readd version-check to shareProcessNamespace task * Update service load balancer finalizer doc for GA (#17438) * Update Topology Manager docs (#17451) * Added information on how device plugins can take advantage of Topology Manager * Updated the Topology Manager documentation to include additionalinformation and update some out of date sections * Fix broken Topology Manager link (#17746) Part of What's Next Device Plugin section * Update CRD defaulting docs for GA (#17450) * Add documentation for VolumeSnapshot Beta (#17233) * Updating EndpointSlice documentation for beta release in 1.17 (#17411) * (docs/dualstack): v1.17 updates (#17457) * Add placehold doc updates for dualstack in 1.17 Signed-off-by: Lachlan Evenson <lachlan.evenson@microsoft.com> * Add Downward API and /etc/hosts Pod IP validation Signed-off-by: Lachlan Evenson <lachlan.evenson@microsoft.com> * remove addressed known issue via k/k pr 85246 Signed-off-by: Lachlan Evenson <lachlan.evenson@microsoft.com> * Remove known issue and add flag as part of k/k 79993 Signed-off-by: Lachlan Evenson <lachlan.evenson@microsoft.com> * remove follow up placeholders Signed-off-by: Lachlan Evenson <lachlan.evenson@microsoft.com> * Update verbiage Signed-off-by: Lachlan Evenson <lachlan.evenson@microsoft.com> * Make IP addressing consistent throughout the task Signed-off-by: Lachlan Evenson <lachlan.evenson@microsoft.com> * Update to status.podIPs Signed-off-by: Lachlan Evenson <lachlan.evenson@microsoft.com> * Update content/en/docs/tasks/network/validate-dual-stack.md Use set instead of env Co-Authored-By: Khaled Henidak (Kal) <khnidk@outlook.com> * add topology.kubernetes.io/zone, topology.kubernetes.io/region and node.kubernetes.io/instance-type labels to docs (#17498) Signed-off-by: Andrew Sy Kim <kiman@vmware.com> * Service topology alpha documentation (#17459) * Update list of feature flags for in-tree plugins migrated to CSI (#17533) Signed-off-by: Deep Debroy <ddebroy@docker.com> * Update Node concept for TaintNodesByCondition going GA (#17577) * feat: graduate ResourceQuotaScopeSelectors to GA in 1.17 (#17554) * kubeadm: update the upgrade documentation for 1.17 (#17587) * doc: Simplify Windows deployments with RuntimeClass (#16697) * doc: Simplify Windows deployments with RuntimeClass * Updating on review feedback * doc: Adding windows-build label from enhancement 1301 * update doc for kubelet option --reserved-cpus (#17648) * feat: update TaintNodesByCondition in feature gates table (#17377) * Update docs for v1 resource quota configuration (#17547) * AdmissionConfiguration v1 (#17548) * Update WebhookAdmissionConfiguration examples (#17549) * Update AWS EBS Migration Feature state (#16126) * Add resource version section to api-concepts documentation (#16910) * Add Resource Version semantics section to api concepts * Clarify risks of going back in time, add details about compaction and watch cache sizes * Apply suggestions from liggitt Co-Authored-By: Jordan Liggitt <jordan@liggitt.net> * remove pesudocode, apply feedback * Fix typo * Clarify equality rules * Cleanup kubectl generators docs (#17609) * Write ReplicationController without a space * Drop mentioning unsupported cluster versions * Fix capitalization for “API group” * Tweak wording * Avoid using deprecated generator in example * add Antrea description in dev-1.17 (#17919) * Promote VolumeSubpathEnvExpansion to GA * Reference Documentation for the Kubernetes API for 1.17 (#18019) * Update feature-gates.md (#18033) * Reference Documentation for kubectl Commands for 1.17 (#18017) * Update for v1.17 (#18034) * Update config.toml(release-1.17) for 1.17 (#18031)
Graduate Node-specific Volume Limits to GA
xref: kubernetes/enhancements#554