Skip to content

Commit 378db8e

Browse files
committed
KEP 3157 (watch-list): add a new ga criterion
1 parent 1f36ff1 commit 378db8e

File tree

1 file changed

+10
-3
lines changed
  • keps/sig-api-machinery/3157-watch-list

1 file changed

+10
-3
lines changed

keps/sig-api-machinery/3157-watch-list/README.md

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -101,6 +101,7 @@ tags, and then generate with `hack/update-toc.sh`.
101101
- [Alpha](#alpha)
102102
- [Beta](#beta)
103103
- [GA](#ga)
104+
- [Post-GA](#post-ga)
104105
- [Upgrade / Downgrade Strategy](#upgrade--downgrade-strategy)
105106
- [Version Skew Strategy](#version-skew-strategy)
106107
- [Production Readiness Review Questionnaire](#production-readiness-review-questionnaire)
@@ -678,15 +679,21 @@ We expect no non-infra related flakes in the last month as a GA graduation crite
678679
Whether it is safe to use the RequestWatchProgress API call
679680
or if the experimental-watch-progress-notify-interval flag has been set.
680681
Knowing etcd configuration will be used to automatically disable the streaming feature.
682+
- Use WatchProgressRequester to request progress notifications directly from etcd.
683+
This mechanism was developed in [Consistent Reads from Cache KEP](https://github.com/kubernetes/enhancements/tree/master/keps/sig-api-machinery/2340-Consistent-reads-from-cache#use-requestprogress-to-enable-automatic-watch-updates)
684+
and will reduce the overall latency for watchlist requests.
681685

682686
#### GA
683-
- Consider using WatchProgressRequester to request progress notifications directly from etcd.
684-
This mechanism was developed in [Consistent Reads from Cache KEP](https://github.com/kubernetes/enhancements/tree/master/keps/sig-api-machinery/2340-Consistent-reads-from-cache#use-requestprogress-to-enable-automatic-watch-updates)
685-
and could reduce the overall latency for watchlist requests.
686687
- [Switch](https://github.com/kubernetes/kubernetes/blob/a07b1aaa5b39b351ec8586de800baa5715304a3f/staging/src/k8s.io/apiserver/pkg/storage/cacher/cacher.go#L416)
687688
the `storage/cacher` to use streaming directly from etcd
688689
(This will also allow us to [remove](https://github.com/kubernetes/kubernetes/blob/a07b1aaa5b39b351ec8586de800baa5715304a3f/staging/src/k8s.io/client-go/tools/cache/reflector.go#L110) the `reflector.UseWatchList` field).
689690

691+
#### Post-GA
692+
- Make **list** calls expensive in APF.
693+
Once all supported releases have the streaming list enabled by default (client-go, control plane components)
694+
and the feature itself is locked to its default value, we can increase the cost of regular list requests in APF.
695+
This ensures that the fallback mechanism, which switches back to the standard list when streaming has issues, will not be affected.
696+
690697
<!--
691698
**Note:** *Not required until targeted at a release.*
692699

0 commit comments

Comments
 (0)