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: BlakeHashBLAKE3 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: StringRuntime 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: BundleLifecycleHow 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.
None → the 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
impl Clone for MesofactServeBundle
Source§fn clone(&self) -> MesofactServeBundle
fn clone(&self) -> MesofactServeBundle
1.0.0 (const: unstable) · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read moreSource§impl Debug for MesofactServeBundle
impl Debug for MesofactServeBundle
Source§impl<'de> Deserialize<'de> for MesofactServeBundle
impl<'de> Deserialize<'de> for MesofactServeBundle
Source§fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
impl Eq for MesofactServeBundle
Source§impl PartialEq for MesofactServeBundle
impl PartialEq for MesofactServeBundle
Source§impl Serialize for MesofactServeBundle
impl Serialize for MesofactServeBundle
impl StructuralPartialEq for MesofactServeBundle
Source§impl TS for MesofactServeBundle
impl TS for MesofactServeBundle
Source§type WithoutGenerics = MesofactServeBundle
type WithoutGenerics = MesofactServeBundle
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 moreSource§type OptionInnerType = MesofactServeBundle
type OptionInnerType = MesofactServeBundle
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 docs() -> Option<String>
fn docs() -> Option<String>
TS is derived, docs are
automatically read from your doc comments or #[doc = ".."] attributesSource§fn decl_concrete(cfg: &Config) -> String
fn decl_concrete(cfg: &Config) -> String
TS::decl().
If this type is not generic, then this function is equivalent to TS::decl().Source§fn decl(cfg: &Config) -> String
fn decl(cfg: &Config) -> String
type User = { user_id: number, ... }.
This function will panic if the type has no declaration. Read moreSource§fn inline(cfg: &Config) -> String
fn inline(cfg: &Config) -> String
{ user_id: number }.
This function will panic if the type cannot be inlined.Source§fn inline_flattened(cfg: &Config) -> String
fn inline_flattened(cfg: &Config) -> String
Source§fn visit_generics(v: &mut impl TypeVisitor)where
Self: 'static,
fn visit_generics(v: &mut impl TypeVisitor)where
Self: 'static,
Source§fn output_path() -> Option<PathBuf>
fn output_path() -> Option<PathBuf>
T should be exported, relative to the output directory.
The returned path does not include any base directory. Read moreSource§fn visit_dependencies(v: &mut impl TypeVisitor)where
Self: 'static,
fn visit_dependencies(v: &mut impl TypeVisitor)where
Self: 'static,
Source§fn dependencies(cfg: &Config) -> Vec<Dependency>where
Self: 'static,
fn dependencies(cfg: &Config) -> Vec<Dependency>where
Self: 'static,
Source§fn export(cfg: &Config) -> Result<(), ExportError>where
Self: 'static,
fn export(cfg: &Config) -> Result<(), ExportError>where
Self: 'static,
TS::export_all. Read moreSource§fn export_all(cfg: &Config) -> Result<(), ExportError>where
Self: 'static,
fn export_all(cfg: &Config) -> Result<(), ExportError>where
Self: 'static,
TS::export. Read moreSource§fn export_to_string(cfg: &Config) -> Result<String, ExportError>where
Self: 'static,
fn export_to_string(cfg: &Config) -> Result<String, ExportError>where
Self: 'static,
Auto Trait Implementations§
impl Freeze for MesofactServeBundle
impl RefUnwindSafe for MesofactServeBundle
impl Send for MesofactServeBundle
impl Sync for MesofactServeBundle
impl Unpin for MesofactServeBundle
impl UnsafeUnpin for MesofactServeBundle
impl UnwindSafe for MesofactServeBundle
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> DeserializeOwned for Twhere
T: for<'de> Deserialize<'de>,
Source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
Source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
Source§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key and return true if they are equal.