Enum BuildError 

pub enum BuildError {
    DockerfileParse {
        message: String,
        line: usize,
    },
    ContextRead {
        path: PathBuf,
        source: Error,
    },
    PathEscape {
        path: PathBuf,
    },
    FileIgnored {
        path: PathBuf,
    },
    StageNotFound {
        name: String,
    },
    RunFailed {
        command: String,
        exit_code: i32,
    },
    LayerCreate {
        message: String,
    },
    CacheError {
        message: String,
    },
    RegistryError {
        message: String,
    },
    IoError(Error),
    VariableExpansion(String),
    InvalidInstruction {
        instruction: String,
        reason: String,
    },
    BuildahExecution {
        command: String,
        exit_code: i32,
        stderr: String,
    },
    ContextTooLarge {
        size: u64,
        max: u64,
    },
    BaseImageNotFound {
        image: String,
    },
    CircularDependency {
        stages: Vec<String>,
    },
    BuildahNotFound {
        message: String,
    },
    ZImagefileParse {
        message: String,
    },
    ZImagefileValidation {
        message: String,
    },
    PipelineError {
        message: String,
    },
}

Build-specific errors

Variants

DockerfileParse

Dockerfile parsing failed

Fields

message: String

The underlying parsing error message

line: usize

Line number where the error occurred (1-indexed)

ContextRead

Failed to read build context

Fields

path: PathBuf

Path that could not be read

source: Error

Underlying IO error

PathEscape

Path escape attempt detected (security violation)

Fields

path: PathBuf

The offending path

FileIgnored

File was ignored by .dockerignore

Fields

path: PathBuf

The ignored file path

StageNotFound

Referenced stage not found

Fields

name: String

The stage name or index that was referenced

RunFailed

RUN instruction failed

Fields

command: String

The command that failed

exit_code: i32

Exit code returned by the command

LayerCreate

Failed to create layer

Fields

message: String

Underlying error description

CacheError

Cache operation failed

Fields

message: String

Underlying cache error

RegistryError

Registry operation failed

Fields

message: String

Underlying registry error

IoError(Error)

IO error

VariableExpansion(String)

Variable expansion failed

InvalidInstruction

Invalid instruction

Fields

instruction: String

The instruction that was invalid

reason: String

Reason why it was invalid

BuildahExecution

Buildah command execution failed

Fields

command: String

The buildah command that failed

exit_code: i32

Exit code from buildah

stderr: String

Standard error output

ContextTooLarge

Build context too large

Fields

size: u64

Actual size in bytes

max: u64

Maximum allowed size

BaseImageNotFound

Base image not found

Fields

image: String

The image reference that was not found

CircularDependency

Circular dependency in multi-stage build

Fields

stages: Vec<String>

The stages involved in the cycle

BuildahNotFound

Buildah binary not found or installation failed

Fields

message: String

Details about the failure

ZImagefileParse

ZImagefile YAML deserialization failed

Fields

message: String

The underlying YAML parse error message

ZImagefileValidation

ZImagefile semantic validation failed

Fields

message: String

Description of what validation rule was violated

PipelineError

Pipeline validation or execution error

Fields

message: String

Description of the pipeline error

Implementations

impl BuildError

pub fn parse_error(msg: impl Into<String>, line: usize) -> Self

Create a DockerfileParse error from a message and line number

pub fn context_read(path: impl Into<PathBuf>, source: Error) -> Self

Create a ContextRead error from a path and IO error

pub fn path_escape(path: impl Into<PathBuf>) -> Self

Create a PathEscape error

pub fn stage_not_found(name: impl Into<String>) -> Self

Create a StageNotFound error

pub fn run_failed(command: impl Into<String>, exit_code: i32) -> Self

Create a RunFailed error

pub fn layer_create(msg: impl Into<String>) -> Self

Create a LayerCreate error

pub fn cache_error(msg: impl Into<String>) -> Self

Create a CacheError

pub fn registry_error(msg: impl Into<String>) -> Self

Create a RegistryError

pub fn invalid_instruction( instruction: impl Into<String>, reason: impl Into<String>, ) -> Self

Create an InvalidInstruction error

pub fn buildah_execution( command: impl Into<String>, exit_code: i32, stderr: impl Into<String>, ) -> Self

Create a BuildahExecution error

pub fn buildah_not_found(message: impl Into<String>) -> Self

Create a BuildahNotFound error

pub fn zimagefile_parse(message: impl Into<String>) -> Self

Create a ZImagefileParse error

pub fn zimagefile_validation(message: impl Into<String>) -> Self

Create a ZImagefileValidation error

pub fn pipeline_error(message: impl Into<String>) -> Self

Create a PipelineError

Trait Implementations

impl Debug for BuildError

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

Formats the value using the given formatter.

impl Display for BuildError

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

Formats the value using the given formatter.

impl Error for BuildError

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<Error> for BuildError

fn from(source: Error) -> Self

Converts to this type from the input type.