-
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
Updating EndpointSlice documentation for beta release in 1.17 #17411
Conversation
Deploy preview for kubernetes-io-vnext-staging processing. Building with commit 73c7698 https://app.netlify.com/sites/kubernetes-io-vnext-staging/deploys/5dd8296092e03b0008978d43 |
/milestone 1.17 |
content/en/docs/reference/command-line-tools-reference/feature-gates.md
Outdated
Show resolved
Hide resolved
@@ -26,7 +26,7 @@ Endpoints. | |||
|
|||
## Endpoint Slice resources {#endpointslice-resource} | |||
|
|||
In Kubernetes, an Endpoint Slice contains references to a set of network | |||
In Kubernetes, an EndpointSlice contains references to a set of network | |||
endpoints. The EndpointSlice controller automatically creates Endpoint Slices |
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.
(if #16885 lands, I can add a page about that specific controller).
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.
Nice! I've got some slides that help explain the logic in that controller if that's helpful.
content/en/docs/concepts/services-networking/endpoint-slices.md
Outdated
Show resolved
Hide resolved
Just a reminder about the last Docs deadline - 22nd Nov, by which this PR needs to be merged! |
5904449
to
4a4df51
Compare
Hey @daminisatya, thanks for the reminder! This fell through the cracks between code freeze and KubeCon. I've made a round of updates and this is ready for another round of review. |
/approve |
@@ -86,7 +86,8 @@ different Kubernetes components. | |||
| `DynamicAuditing` | `false` | Alpha | 1.13 | | | |||
| `DynamicKubeletConfig` | `false` | Alpha | 1.4 | 1.10 | | |||
| `DynamicKubeletConfig` | `true` | Beta | 1.11 | | | |||
| `EndpointSlice` | `false` | Alpha | 1.16 | | | |||
| `EndpointSlice` | `false` | Alpha | 1.16 | 1.16 | | |||
| `EndpointSlice` | `false` | Beta | 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.
@robscott , should line 90 set the beta feature gate to true
?
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.
Sadly no, we ended up switching it to disabled by default (kubernetes/kubernetes#85365)
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.
OK. I was under the impression that all beta features were enabled by default.
@@ -127,6 +127,6 @@ Endpoints API 提供了一种简单明了的方法在 Kubernetes 中跟踪网络 | |||
* [Enabling Endpoint Slices](/docs/tasks/administer-cluster/enabling-endpoint-slices) | |||
* Read [Connecting Applications with Services](/docs/concepts/services-networking/connect-applications-service/) | |||
--> | |||
* [启用 Endpoint Slices](/docs/tasks/administer-cluster/enabling-endpoint-slices) | |||
* [启用 Endpoint Slices](/docs/tasks/administer-cluster/enabling-endpoint-slices |
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.
@robscott Do you intend to add further updates this page (the YAML)?
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.
Woops, thanks for catching that! Originally the plan was for EndpointSlices to be enabled by default, so I'd removed this in the initial version of the PR. As it turns out, this wasn't deemed quite stable enough to be enabled by default so I had to bring this back, and I messed up adding this back in the first time.
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.
Not sure what happened here. Are you missing the end paren?
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.
That was something I missed the first time I tried to revert my initial removal of that link. I pushed a fix for that yesterday so there should be no changes to the zh
version of this file left in this PR. Sorry for the confusion there!
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.
👍
4a4df51
to
6509c43
Compare
@kbhawkey Is this pr good to go? |
6509c43
to
73c7698
Compare
/lgtm |
[APPROVALNOTIFIER] This PR is APPROVED This pull-request has been approved by: daminisatya, 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 |
* 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)
This updates the EndpointSlice documentation for the beta release targeted for v1.17.
EndpointSlice Beta PR: kubernetes/kubernetes#84390
EndpointSlice Enhancement Issue: kubernetes/enhancements#752