Struct kumo_server_common::nodeid::NodeId

pub struct NodeId {
    pub uuid: Uuid,
    /* private fields */
}

The NodeId is intended to identify a specific instance of KumoMTA within your own local cluster. It is a uuid that will be generated and persisted when the node starts up.

If persisting the id isn’t possible, we fall back to generating a “stable” v1 uuid from the mac address or deriving a fake mac address from the hostid of the system. Those aren’t great when running in some virtualization environments, so it is recommended to resolve any issues with persisting the id there. There are some environment variables that can be used to influence that if the default filesystem path is not suitable for whatever reason.

The intended use of the nodeid is disambiguation during reporting, and also for future configuration management/provisioning related functionality.

Fields

uuid: Uuid

Unique node id in the cluster

Implementations

impl NodeId

pub fn get() -> Self

Get the NodeId

pub fn get_uuid() -> Uuid

Retrieve just the uuid

pub fn check() -> Result<()>

Raises an error if we don’t have a persistent unique node id

pub fn new() -> Self

Trait Implementations

impl Clone for NodeId

fn clone(&self) -> NodeId

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for NodeId

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

Formats the value using the given formatter.

impl Display for NodeId

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

Formats the value using the given formatter.