Struct ClusterJoinRequest 

pub struct ClusterJoinRequest {

    pub token: String,
    pub advertise_addr: String,
    pub overlay_port: u16,
    pub raft_port: u16,
    pub api_port: u16,
    pub wg_public_key: String,
    pub mode: String,
    pub services: Option<Vec<String>>,
    pub cpu_total: f64,
    pub memory_total: u64,
    pub disk_total: u64,
    pub gpus: Vec<GpuInfoSummary>,
    pub os: Option<OsKind>,
    pub arch: Option<ArchKind>,
    pub labels: HashMap<String, String>,
    pub secrets_pubkey: Option<[u8; 32]>,
}

Request body for POST /api/v1/cluster/join.

Fields

token: String

Base64-encoded join token (contains auth_secret for validation)

advertise_addr: String

Joining node’s advertise address (IP)

overlay_port: u16

Joining node’s overlay port (WireGuard)

raft_port: u16

Joining node’s Raft RPC port

api_port: u16

Joining node’s API server port

wg_public_key: String

Joining node’s WireGuard public key

mode: String

Node mode: “full” or “replicate”

services: Option<Vec<String>>

Services to replicate (only if mode == “replicate”)

cpu_total: f64

Total CPU cores on the joining node

memory_total: u64

Total memory in bytes

disk_total: u64

Total disk in bytes

gpus: Vec<GpuInfoSummary>

Detected GPUs

os: Option<OsKind>

Operating system of the joining agent. None = legacy client that did not report platform info.

arch: Option<ArchKind>

CPU architecture of the joining agent. Same legacy semantics as os.

labels: HashMap<String, String>

Free-form labels advertised by the joining agent, used for NodeSelector placement matching. Empty on legacy clients.

secrets_pubkey: Option<[u8; 32]>

Joiner’s 32-byte X25519 pubkey for sealed-box DEK wrapping. Present on Phase-1+ joiners; absent on legacy clients (in which case the leader treats the node as not eligible to host replicated-secret ciphertext until it re-joins with a pubkey).

Trait Implementations

impl Clone for ClusterJoinRequest

fn clone(&self) -> ClusterJoinRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ComposeSchema for ClusterJoinRequest

fn compose(generics: Vec<RefOr<Schema>>) -> RefOr<Schema>

impl Debug for ClusterJoinRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ClusterJoinRequest

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl ToSchema for ClusterJoinRequest

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

Return name of the schema.

fn schemas(schemas: &mut Vec<(String, RefOr<Schema>)>)

Implement reference utoipa::openapi::schema::Schemas for this type.