Enum kube_runtime::watcher::ListSemantic

pub enum ListSemantic {
    MostRecent,
    Any,
}

Configurable list semantics for watcher relists

Variants

MostRecent

List calls perform a full quorum read for most recent results

Prefer this if you have strong consistency requirements. Note that this is more taxing for the apiserver and can be less scalable for the cluster.

If you are observing large resource sets (such as congested Controller cases), you typically have a delay between the list call completing, and all the events getting processed. In such cases, it is probably worth picking Any over MostRecent, as your events are not guaranteed to be up-to-date by the time you get to them anyway.

Any

List calls returns cached results from apiserver

This is faster and much less taxing on the apiserver, but can result in much older results than has previously observed for Restarted events, particularly in HA configurations, due to partitions or stale caches.

This option makes the most sense for controller usage where events have some delay between being seen by the runtime, and it being sent to the reconciler.

Trait Implementations

impl Clone for ListSemantic

fn clone(&self) -> ListSemantic

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ListSemantic

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ListSemantic

fn default() -> ListSemantic

Returns the “default value” for a type.

impl PartialEq for ListSemantic

fn eq(&self, other: &ListSemantic) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ListSemantic