Documenting EndpointSlice deduplication requirements

This commit is contained in:
Rob Scott 2020-08-11 17:35:06 -07:00
parent d9784dc5b4
commit 9bca5270fe
No known key found for this signature in database
GPG Key ID: 90C19B2D4A99C91B
1 changed files with 9 additions and 0 deletions

View File

@ -192,6 +192,15 @@ necessary soon anyway. Rolling updates of Deployments also provide a natural
repacking of EndpointSlices with all Pods and their corresponding endpoints
getting replaced.
### Duplicate endpoints
Due to the nature of EndpointSlice changes, endpoints may be represented in more
than one EndpointSlice at the same time. This naturally occurs as changes to
different EndpointSlice objects can arrive at the Kubernetes client watch/cache
at different times. Implementations using EndpointSlice must be able to have the
endpoint appear in more than one slice. A reference implementation of how to
perform endpoint deduplication can be found in the `EndpointSliceCache`
implementation in `kube-proxy`.
## {{% heading "whatsnext" %}}