Enum RevisionLifecycleError 

pub enum RevisionLifecycleError {
    NotFound {
        env_id: EnvId,
        revision_id: RevisionId,
    },
    InvalidTransition {
        from: RevisionLifecycle,
        to: RevisionLifecycle,
    },
    Conflict {
        revision_id: RevisionId,
        actual: RevisionLifecycle,
        expected_starts: Vec<RevisionLifecycle>,
    },
    EmptyChain,
    ActiveTrafficReference {
        revision_id: RevisionId,
        splits: Vec<ActiveSplitRef>,
    },
    HealthGateFailed {
        revision_id: RevisionId,
        failed_checks: Vec<HealthCheckId>,
        message: String,
    },
    DuplicateRevision {
        env_id: EnvId,
        revision_id: RevisionId,
    },
    DeploymentNotFound {
        env_id: EnvId,
        deployment_id: DeploymentId,
    },
}

Failures produced by the pure revision-lifecycle transforms. The pure twin of greentic-deployer’s environment::lifecycle::LifecycleError (which adds a storage variant on top); each backend maps these onto its own error vocabulary — LocalFsStore → LifecycleError/StoreError, the operator-store-server → crate::remote::RemoteStoreError.

Variants

NotFound

The targeted revision was not present in the environment.

Fields

env_id: EnvId

revision_id: RevisionId

InvalidTransition

The spec matrix rejected an edge inside the requested chain. This is a programming error in the caller, not a runtime conflict — every chain passed in by the verb functions below is hand-curated.

Fields

from: RevisionLifecycle

to: RevisionLifecycle

Conflict

The revision was loaded in a state that does not start any edge in the accepted chain (or, for warm, no longer carries the lifecycle the caller observed at gate-evaluation time). actual carries the lifecycle the transform found; expected_starts lists the states it would have accepted.

Fields

revision_id: RevisionId

actual: RevisionLifecycle

expected_starts: Vec<RevisionLifecycle>

EmptyChain

The caller passed an empty accepted_chain. Internal-API misuse.

ActiveTrafficReference

The archive path (prune_from_splits = true) was invoked against a revision still referenced by one or more live traffic splits. Callers must rebalance traffic via gtc op traffic set before retrying.

Fields

revision_id: RevisionId

splits: Vec<ActiveSplitRef>

HealthGateFailed

The warm/ready health gate rejected the revision after the chain reached its final state. The transform has flipped the revision’s lifecycle to Failed IN the borrowed environment — per the module’s persist rule the caller MUST persist before surfacing this error.

Fields

revision_id: RevisionId

failed_checks: Vec<HealthCheckId>

message: String

DuplicateRevision

A revision with this id already exists in the environment. The stage verb’s revision_id is caller-supplied (the bundle staging step names its rev_dir after the ULID before the verb runs), so a retry of a lost stage response replays the same id — appending a second copy would corrupt every revision_id lookup. Backends map this to their create-on-existing conflict (HTTP 409).

Fields

env_id: EnvId

revision_id: RevisionId

DeploymentNotFound

The deployment the verb references does not exist in the environment.

Fields

env_id: EnvId

deployment_id: DeploymentId

Implementations

impl RevisionLifecycleError

pub fn env_mutated(&self) -> bool

Whether the borrowed environment was mutated before this error was returned (and therefore MUST be persisted by the caller). True only for Self::HealthGateFailed — every other error leaves the environment in a discard-only state.

Trait Implementations

impl Clone for RevisionLifecycleError

fn clone(&self) -> RevisionLifecycleError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RevisionLifecycleError

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

Formats the value using the given formatter.

impl Display for RevisionLifecycleError

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

Formats the value using the given formatter.

impl Eq for RevisionLifecycleError

impl Error for RevisionLifecycleError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for RevisionLifecycleError

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