Struct RevisionStagePayload 

pub struct RevisionStagePayload {
    pub environment_id: String,
    pub deployment_id: String,
    pub revision_id: Option<String>,
    pub idempotency_key: Option<String>,
    pub bundle_path: Option<PathBuf>,
    pub bundle_digest: String,
    pub bundle_source_uri: Option<String>,
    pub pack_list: Vec<PackListEntryPayload>,
    pub pack_list_lock_ref: PathBuf,
    pub config_digest: String,
    pub signature_sidecar_ref: PathBuf,
    pub drain_seconds: u32,
}

Fields

environment_id: String

deployment_id: String

revision_id: Option<String>

Stable revision id for safe lost-response retries against an HTTP store (A8 §2). When absent, one is minted per invocation — fine for a one-shot local stage, but a bare remote retry then mints a different id (and key), changing the request fingerprint so the server’s replay ledger can’t dedup it. Pin it together with idempotency_key for retry-safe remote staging. Honored by the remote (--store-url) path; the local path always mints.

idempotency_key: Option<String>

Caller-supplied A8 §2 idempotency key. Optional for back-compat; when absent, one is minted per invocation. Supply a stable key (with revision_id) for safe lost-response retries against the HTTP store. Honored by the remote (--store-url) path; the local path always mints.

bundle_path: Option<PathBuf>

Local .gtbundle to resolve. When set, the bundle is extracted under the revision dir and its embedded .gtpacks are pinned into pack-list.lock — bundle_digest / pack_list / pack_list_lock_ref are then derived from the artifact and any caller-supplied values for those fields are ignored. When unset, the legacy path records the caller-supplied pointers verbatim.

bundle_digest: String

bundle_source_uri: Option<String>

Registry reference the bundle was resolved from (oci://…, repo://…, store://…), asserted by the caller that resolved it. Recorded on the revision so a remote worker can pull the bundle at boot; None for a locally-staged bundle. The deployer never derives this — by the time stage runs the --bundle path already holds a local file — so the caller threads it through. bundle_digest is the integrity backstop on whatever the worker pulls.

pack_list: Vec<PackListEntryPayload>

pack_list_lock_ref: PathBuf

Env-relative pack-list lockfile. Empty (the default) means “no lock written”: the runtime-config materializer only surfaces a non-empty ref, so an unstaged/legacy revision never points greentic-start at a file that does not exist. The --bundle path overwrites this with the real revisions/<rev>/pack-list.lock it writes.

config_digest: String

signature_sidecar_ref: PathBuf

drain_seconds: u32

Trait Implementations

impl Clone for RevisionStagePayload

fn clone(&self) -> RevisionStagePayload

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RevisionStagePayload

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RevisionStagePayload

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RevisionStagePayload

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

where __S: Serializer,

Serialize this value into the given Serde serializer.