Enum ClusterError 

pub enum ClusterError {
    ClusterIdentityMismatch {
        persisted: ClusterId,
        requested: ClusterId,
    },
    UnsupportedFormatVersion {
        file: &'static str,
        found: u32,
        min: u32,
        max: u32,
    },
    CorruptMetadata {
        file: &'static str,
        detail: String,
    },
    Io(Error),
    Rng(String),
    Unsupported(&'static str),
    InvalidTrustMaterial(&'static str),
    InvalidInvite(&'static str),
    AlreadyBootstrapped {
        cluster_id: ClusterId,
    },
    NotInitialized,
    BootstrapInProgress(PathBuf),
    NodeNotFound {
        node: NodeId,
    },
    InvalidNodeStateTransition {
        node: NodeId,
        from: NodeState,
        to: NodeState,
    },
    InvalidConfirmationToken,
}

The one error type of the cluster bootstrap surface.

Variants

ClusterIdentityMismatch

A persisted identity binds this node to a different cluster than the bootstrap/join being attempted (S2A-001). Only wipe_identity resets the binding.

Fields

persisted: ClusterId

Cluster the persisted identity belongs to.

requested: ClusterId

Cluster the attempted operation targeted.

UnsupportedFormatVersion

A durable metadata file carries a format version outside the supported range (spec section 4.10: fail closed).

Fields

file: &'static str

Metadata file kind (identity.json, cluster.json, …).

found: u32

Version found in the file.

min: u32

Oldest version this build accepts.

max: u32

Newest version this build accepts.

CorruptMetadata

A durable metadata file failed structural verification: undecodable payload, unknown fields, or a reserved all-zero identifier.

Fields

file: &'static str

Metadata file kind (identity.json, cluster.json, …).

detail: String

What failed verification.

Io(Error)

Cluster metadata I/O failed.

Rng(String)

The caller-supplied CSPRNG failed.

Unsupported(&'static str)

The operation is deliberately not implemented yet; fails closed.

InvalidTrustMaterial(&'static str)

Caller-supplied trust material failed validation.

InvalidInvite(&'static str)

A cluster join invite failed validation.

AlreadyBootstrapped

The node is already bootstrapped; re-running init/join is rejected.

Fields

cluster_id: ClusterId

Cluster the persisted bootstrap record belongs to.

NotInitialized

No bootstrap record exists in this directory yet.

BootstrapInProgress(PathBuf)

Another bootstrap workflow holds the bootstrap lock file.

Recovery (review N7): if no bootstrap is running, remove the stale cluster-meta/bootstrap.lock (content is pid + timestamp for diagnosis) and retry cluster init / join / drain.

NodeNotFound

The target node is absent from the local membership record.

Fields

node: NodeId

The node that was looked up.

InvalidNodeStateTransition

The requested node state transition is not permitted.

Fields

node: NodeId

The node whose state was to change.

from: NodeState

Current persisted state.

to: NodeState

Requested target state.

InvalidConfirmationToken

node remove was attempted without the matching confirmation token.

Trait Implementations

impl Debug for ClusterError

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

Formats the value using the given formatter.

impl Display for ClusterError

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

Formats the value using the given formatter.

impl Error for ClusterError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<ClusterError> for ClusterBackupError

fn from(source: ClusterError) -> Self

Converts to this type from the input type.

impl From<ClusterError> for RuntimeError

fn from(source: ClusterError) -> Self

Converts to this type from the input type.

impl From<ClusterError> for TabletError

fn from(source: ClusterError) -> Self

Converts to this type from the input type.

impl From<Error> for ClusterError

fn from(source: Error) -> Self

Converts to this type from the input type.