Enum AgentError 

pub enum AgentError {
    NotFound {
        container: String,
        reason: String,
    },
    PullFailed {
        image: String,
        reason: String,
    },
    CreateFailed {
        id: String,
        reason: String,
    },
    StartFailed {
        id: String,
        reason: String,
    },
    UnexpectedExit {
        id: String,
        code: i32,
    },
    HealthCheckFailed {
        id: String,
        reason: String,
    },
    InitActionFailed {
        id: String,
        reason: String,
    },
    Timeout {
        timeout: Duration,
    },
    DependencyTimeout {
        service: String,
        dependency: String,
        condition: String,
        timeout: Duration,
    },
    InvalidSpec(String),
    Network(String),
    Configuration(String),
    Internal(String),
    Unsupported(String),
    RouteToPeer {
        service: String,
        required_os: String,
        reason: String,
    },
}

Agent runtime errors

Variants

NotFound

Container not found

Fields

container: String

reason: String

PullFailed

Failed to pull image

Fields

image: String

reason: String

CreateFailed

Failed to create container

Fields

id: String

reason: String

StartFailed

Failed to start container

Fields

id: String

reason: String

UnexpectedExit

Container exited unexpectedly

Fields

id: String

code: i32

HealthCheckFailed

Health check failed

Fields

id: String

reason: String

InitActionFailed

Init action failed

Fields

id: String

reason: String

Timeout

Timeout

Fields

timeout: Duration

DependencyTimeout

Dependency timeout - service waiting for dependency condition

Fields

service: String

dependency: String

condition: String

timeout: Duration

InvalidSpec(String)

Invalid spec

Network(String)

Network setup or operation failed

Configuration(String)

Configuration error (missing or invalid configuration)

Internal(String)

Internal runtime error

Unsupported(String)

Operation is not supported by this runtime

RouteToPeer

The workload cannot run on this node and must be re-placed on a peer that can satisfy required_os.

Returned by crate::runtimes::composite::CompositeRuntime::select_for when a foreign-OS workload (today: Linux on a Windows node) lands on a node that has no suitable local runtime (e.g. no WSL2 delegate configured). The scheduler is expected to catch this and re-dispatch to a cluster peer whose NodeState.os matches required_os. When no capable peer exists the scheduler marks the service failed with an actionable message naming both remediations (enable the local WSL2 delegate, or add a Linux peer to the cluster).

This variant is not a container failure: the service manager must surface it to the scheduler and must not roll up CreateFailed on top of it, otherwise the rescheduling signal is lost.

Fields

service: String

Service name that needs to be re-placed.

required_os: String

OS the workload requires (OCI-canonical: linux / windows / darwin).

reason: String

Human-readable explanation (e.g. “no WSL2 delegate configured on this Windows node”).

Trait Implementations

impl Debug for AgentError

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

Formats the value using the given formatter.

impl Display for AgentError

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

Formats the value using the given formatter.

impl Error for AgentError

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 From<DependencyError> for AgentError

fn from(err: DependencyError) -> Self

Converts to this type from the input type.