Bundle

A bundle is a logical workload unit. See §3.5.

Field

Type

Repeated

Description

bundle_id

BundleId

pool

string

The pool this bundle’s primary jobs are placed into. The cost cascade (cheap → expensive) lives inside the pool as ordered tiers, not here.

jobs

BundleJobSpec

✅

intra_replica_placement

IntraReplicaRules

resilience_policy

ResiliencePolicy

When set, the bundle runs a primary + one backup (replica index 0 = primary, 1 = backup); absent ⇒ primary only. Replaces the old operator-set replicas count and inter_replica_placement.

state

BundleState

Lifecycle state. Bundles created prior to this field’s introduction deserialise as LIVE (proto3 default).

on_launch

OnLaunch

Whether this bundle’s FIRST placement may take a hot spare. Bundle-level rather than per-job: "get this on air now" is a decision about the production, not about one of its runtimes. Absent ⇒ AVOID_SPARE.

stop_at

google.protobuf.Timestamp

Task 118: when the Manager deletes the bundle on its own. Honoured on CreateBundle; IGNORED on UpdateBundle, where the stored values are kept (set them with SetBundleStopTime / RenewBundleLease, which never touch the jobs). Absent ⇒ no stop time / no lease.

lease

BundleLease

On create only ttl_ms is read: the lease then expires ttl_ms from the create. On read, expires_at is the stored expiry (a Manager just become primary also gives every lease one TTL from its takeover).

identity

ProductionIdentity

What the platform records about the production (norsk-ctl RFC 0007), for its runtimes' identity. Honoured on CreateBundle; IGNORED on UpdateBundle, where the stored value is kept. Protocol 1.8.