Skip to main content

MesofactServeBundle

Struct MesofactServeBundle 

Source
pub struct MesofactServeBundle {
    pub digest: BlakeHash,
    pub runtime: String,
    pub lifecycle: BundleLifecycle,
    pub port: Option<u16>,
    pub env: BTreeMap<String, String>,
}
Expand description

Serve-time reference to a published W272 bundle (R599-F4) — the {bundle_digest, runtime, lifecycle} triple a mesofact-static workload carries when kamaji, not the build reconciler, serves it.

Fields§

§digest: BlakeHash

BLAKE3 digest of the published bundle manifest — the content-address kamaji materializes from the bundle store (yah_mesofact_bundle, R599-F1). Same 64-hex shape the bundle crate’s BundleHash validates.

§runtime: String

Runtime that serves the bundle: "self" (bundle ships its own bins/<triple>/serve) or "mesofact/<version>" (resolve the stock serve runtime asset from the node cache). Wire-mirrors yah_mesofact_bundle::BundleRuntime; kept as a plain String here so workload-spec stays free of the bundle crate and its non-TS/schema newtypes.

§lifecycle: BundleLifecycle

How kamaji supervises the served bundle. Default: keep-alive.

§port: Option<u16>

Port the served bundle listens on (R599-F12). This is the bundle-tier analogue of a container’s expose.mesh.ports: the declared serving port, which a proxy pairs with the workload’s mesh IP to get a dialable address.

Nonethe supervisor allocates one (R844-F2), and reports the port it bound back to yubaba on the next workload listing, where it lands in the service record an ingress upstream is rendered from. This is the normal case: a mirror should not have to name a port at all.

It used to mean “fall back to kamaji’s node-wide default (KAMAJI_BUNDLE_PORT, else 8080)”, which was a single node-wide slot wearing the word default — correct only while a node hosted one bundle, and a silent collision for the second. R599-F12 added this field so a workload could opt out of that; R844-F2 removed the default itself, so opting out is no longer something anyone has to remember to do.

Declaring a port still pins it exactly, for a workload that must be reachable at a known number.

No skip_serializing_if — see serve_bundle’s note: the postcard wire codec is positional, so an omitted byte shifts every later field.

§env: BTreeMap<String, String>

Environment the serve process is forked with (R556-T12) — already resolved values, NAME → value.

This is what makes an SSR route that reads a private source deployable at all: mesofact serve resolves a source’s credentials from its own process environment at request time, and before this field the static / SSR serve process was forked with env: vec![] while only the revalidate_receiver sub-slot carried any. A declared-authed SSR site therefore deployed clean and failed per request on the node.

Resolution happens deploy-side, exactly like MesofactRevalidateReceiver::env: the mirror declares source URIs (vault:<slot> / env:<VAR>), yah cloud apply resolves them against the operator’s vault, and the node receives values. Keystore slot names never cross the wire.

Appended after port — see port’s note: the postcard wire codec is positional, so a new field goes last and never carries skip_serializing_if.

Trait Implementations§

Source§

impl Clone for MesofactServeBundle

Source§

fn clone(&self) -> MesofactServeBundle

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for MesofactServeBundle

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<'de> Deserialize<'de> for MesofactServeBundle

Source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl Eq for MesofactServeBundle

Source§

impl PartialEq for MesofactServeBundle

Source§

fn eq(&self, other: &MesofactServeBundle) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl Serialize for MesofactServeBundle

Source§

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

Serialize this value into the given Serde serializer. Read more
Source§

impl StructuralPartialEq for MesofactServeBundle

Source§

impl TS for MesofactServeBundle

Source§

type WithoutGenerics = MesofactServeBundle

If this type does not have generic parameters, then WithoutGenerics should just be Self. If the type does have generic parameters, then all generic parameters must be replaced with a dummy type, e.g ts_rs::Dummy or ().
The only requirement for these dummy types is that EXPORT_TO must be None. Read more
Source§

type OptionInnerType = MesofactServeBundle

If the implementing type is std::option::Option<T>, then this associated type is set to T. All other implementations of TS should set this type to Self instead.
Source§

fn ident(cfg: &Config) -> String

Identifier of this type, excluding generic parameters.
Source§

fn docs() -> Option<String>

JSDoc comment to describe this type in TypeScript - when TS is derived, docs are automatically read from your doc comments or #[doc = ".."] attributes
Source§

fn name(cfg: &Config) -> String

Name of this type in TypeScript, including generic parameters
Source§

fn decl_concrete(cfg: &Config) -> String

Declaration of this type using the supplied generic arguments. The resulting TypeScript definition will not be generic. For that, see TS::decl(). If this type is not generic, then this function is equivalent to TS::decl().
Source§

fn decl(cfg: &Config) -> String

Declaration of this type, e.g. type User = { user_id: number, ... }. This function will panic if the type has no declaration. Read more
Source§

fn inline(cfg: &Config) -> String

Formats this types definition in TypeScript, e.g { user_id: number }. This function will panic if the type cannot be inlined.
Source§

fn inline_flattened(cfg: &Config) -> String

Flatten a type declaration. This function will panic if the type cannot be flattened.
Source§

fn visit_generics(v: &mut impl TypeVisitor)
where Self: 'static,

Iterates over all type parameters of this type.
Source§

fn output_path() -> Option<PathBuf>

Returns the output path to where T should be exported, relative to the output directory. The returned path does not include any base directory. Read more
Source§

fn visit_dependencies(v: &mut impl TypeVisitor)
where Self: 'static,

Iterates over all dependency of this type.
Source§

fn dependencies(cfg: &Config) -> Vec<Dependency>
where Self: 'static,

Resolves all dependencies of this type recursively.
Source§

fn export(cfg: &Config) -> Result<(), ExportError>
where Self: 'static,

Manually export this type to the filesystem. To export this type together with all of its dependencies, use TS::export_all. Read more
Source§

fn export_all(cfg: &Config) -> Result<(), ExportError>
where Self: 'static,

Manually export this type to the filesystem, together with all of its dependencies. To export only this type, without its dependencies, use TS::export. Read more
Source§

fn export_to_string(cfg: &Config) -> Result<String, ExportError>
where Self: 'static,

Manually generate bindings for this type, returning a String. This function does not format the output, even if the format feature is enabled. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.