Struct SidecarConfig 

pub struct SidecarConfig {
    pub addr: Option<String>,
    pub tls_dir: Option<PathBuf>,
    pub idle_secs: u64,
    pub storage_graph_root: Option<PathBuf>,
    pub storage_run_root: Option<PathBuf>,
    pub storage_driver: Option<String>,
    pub context_mount: Option<(PathBuf, PathBuf)>,
}

Transport configuration for connecting to a zlayer-buildd sidecar.

Default operation: the daemon spawns its own local sidecar bound to 127.0.0.1:<auto-port> with mTLS material under ${ZLAYER_DATA_DIR}/buildd/. A remote builder (LAN build host) is selected by setting addr to a host:port reachable by the caller.

Fields

addr: Option<String>

host:port to dial. None means “spawn a local sidecar and use the auto-allocated 127.0.0.1 port.”

tls_dir: Option<PathBuf>

Directory containing the mTLS material (ca.pem, cert.pem, key.pem). None means use the default under ${ZLAYER_DATA_DIR}/buildd/.

idle_secs: u64

Idle-shutdown timeout in seconds for an auto-spawned local sidecar. Ignored when addr points at a remote sidecar (lifecycle is the remote operator’s responsibility).

storage_graph_root: Option<PathBuf>

Storage GraphRoot to pass to the sidecar. None → derive ${ZLAYER_DATA_DIR}/buildd/storage/graph.

storage_run_root: Option<PathBuf>

Storage RunRoot. None → ${ZLAYER_DATA_DIR}/buildd/storage/run.

storage_driver: Option<String>

Storage driver name. None → vfs for rootless safety. Operators running as root may switch to overlay for performance.

context_mount: Option<(PathBuf, PathBuf)>

Build-context mount translation for a remote (cross-host) sidecar.

When the sidecar runs in a different mount namespace than the client (e.g. a zlayer-buildd inside a VZ-Linux container on a macOS host), the build context must be shared in via a bind / virtiofs mount and the context_dir sent on the wire must be the path the sidecar sees, not the host path the client computed.

Some((host_prefix, guest_prefix)) rewrites any context_dir that starts with host_prefix so the prefix becomes guest_prefix. The dockerfile paths are translated the same way. None (the default, same-host sidecar) passes paths through unchanged.

Implementations

impl SidecarConfig

pub const DEFAULT_IDLE_SECS: u64 = 30

pub fn default_idle_secs() -> u64

Trait Implementations

impl Clone for SidecarConfig

fn clone(&self) -> SidecarConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SidecarConfig

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

Formats the value using the given formatter.

impl Default for SidecarConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SidecarConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for SidecarConfig

impl PartialEq for SidecarConfig

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

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 SidecarConfig