Struct ContainerId 

pub struct ContainerId {
    pub service: String,
    pub replica: u32,
    pub role: String,
    pub node_id: u64,
}

Container identifier.

Identifies a container by (service, replica) for the legacy single-group case, and extends with role + node_id for cluster-aware multi-group services and cross-node identification.

Defaults: role = "default", node_id = 0. Existing constructors (ContainerId::new(service, replica)) produce these defaults. Use ContainerId::with_role_and_node(...) when the new fields matter.

Display:

• With defaults: {service}-rep-{replica} (backward compat).
• Otherwise: {service}-{role}-{replica}-on-{node_id}.

Fields

service: String

replica: u32

role: String

Role within replica_groups. "default" for services without groups.

node_id: u64

Cluster node that owns this container. 0 in single-node deployments or before the cluster is initialized.

Implementations

impl ContainerId

pub fn new(service: impl Into<String>, replica: u32) -> Self

Build a legacy {service, replica} ContainerId with default role and node_id. Used by all existing callsites — behavior is unchanged.

pub fn with_role_and_node( service: impl Into<String>, replica: u32, role: impl Into<String>, node_id: u64, ) -> Self

Build a cluster-aware ContainerId with explicit role and node_id. Used by ServiceManager when a service has replica_groups or when the daemon participates in a multi-node cluster.

pub fn is_legacy_shape(&self) -> bool

True when both role and node_id are at their defaults — i.e. this is a legacy-shape ContainerId.

pub fn parse_display(s: &str) -> Option<Self>

Parse a ContainerId back from its Display form.

This is the exact inverse of Display:

• "{service}-rep-{replica}" (legacy shape) → ContainerId::new.
• "{service}-{role}-{replica}-on-{node_id}" (cluster shape) → ContainerId::with_role_and_node.

The service name may itself contain -, so parsing anchors on the rightmost structural markers (-on- then the trailing -rep-/-{role}- segment) rather than splitting left-to-right. Returns None for any string that does not match either shape (e.g. a hex id or a bare name).

Trait Implementations

impl Clone for ContainerId

fn clone(&self) -> ContainerId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContainerId

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ContainerId

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ContainerId

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

Formats the value using the given formatter.

impl Eq for ContainerId

impl Hash for ContainerId

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ContainerId

fn eq(&self, other: &ContainerId) -> 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 ContainerId

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ContainerId