Enum SpreadScope 

pub enum SpreadScope {
    Instance,
    Role,
    Cluster,
}

Which set of DNS Pods a spread rule balances across failure domains.

This is the field that makes zone spreading actually work in Bindy, and it exists because a DNS server is not an anonymous replica.

A Bind9Cluster with primary.replicas: 3 does not create one three-Pod Deployment. Each primary is an individually addressable nameserver (its hostname ends up in an NS record), so the cluster controller creates three separate Bind9Instance resources, each backed by its own single-Pod Deployment. A spread constraint whose label selector matches only its own Deployment’s Pods would therefore balance a set of size one — which is always trivially balanced, and spreads nothing.

scope selects the label selector the operator generates, and so decides which Pods the scheduler counts per domain.

Variants

Instance

Balance only the Pods of this one Bind9Instance.

Correct for a standalone Bind9Instance with spec.replicas: 2 or more, where one Deployment really does own every Pod in the set. A no-op for cluster-managed instances, which have one Pod each.

Role

Balance every Pod of the same role across the whole cluster.

Selects on bindy.firestoned.io/cluster + bindy.firestoned.io/role, so all primaries of my-dns are balanced against each other (and all secondaries separately against each other). This is the default for cluster-managed instances and the setting that satisfies “spread primaries across zones before stacking two in one zone”.

Cluster

Balance every Pod of the cluster, primaries and secondaries together.

Selects on bindy.firestoned.io/cluster alone. Useful when total DNS footprint per zone matters more than per-role balance — for example when primaries and secondaries are sized alike and you simply want an even spread of nameservers per zone. Set it on both primary.placement and secondary.placement so every Pod carries the same constraint.

Trait Implementations

impl Clone for SpreadScope

fn clone(&self) -> SpreadScope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SpreadScope

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SpreadScope

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for SpreadScope

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for SpreadScope

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl Serialize for SpreadScope

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for SpreadScope

impl Eq for SpreadScope

impl StructuralPartialEq for SpreadScope