Enum BuildNode

pub enum BuildNode {
    From {
        image_ref: String,
        display_name: String,
    },
    FromScratch {
        scratch_ref: Option<String>,
    },
    Run {
        parent: NodeId,
        command: String,
        cwd: String,
        additional_envs: HashMap<String, String>,
    },
    CopyFromImage {
        parent: NodeId,
        src_image: NodeId,
        src_path: String,
        dst_path: String,
    },
    CopyFromLocal {
        parent: NodeId,
        src_path: String,
        dst_path: String,
    },
    SetWorkdir {
        parent: NodeId,
        new_workdir: String,
    },
    SetEntrypoint {
        parent: NodeId,
        new_entrypoint: Vec<String>,
    },
    SetCmd {
        parent: NodeId,
        new_cmd: Vec<String>,
    },
    SetLabel {
        parent: NodeId,
        label: String,
        value: String,
    },
    Merge(MergeNode),
    SetEnv {
        parent: NodeId,
        key: String,
        value: String,
    },
    AppendEnvValue {
        parent: NodeId,
        key: String,
        value: String,
    },
    SetUser {
        parent: NodeId,
        user: String,
    },
}

Represent one operation, such as RUN or FROM.

Think of it as one line of a Dockerfile, or one node in the buildkit graph.

Paths

All the paths in this structure can either be absolute or relative path. In the case of relative paths, they are ALWAYS relative to the working directory of the parent image (as stored in the image config). Translators from this to e.g. buildkit LLB should resolve the paths as necessary.

In the case of copy, src_path and dst_path should be resolved relative to the source image’s workdir and the destination (parent) image’s workdir, respectively.

TODO: add caching control

Variants

From

Fields

image_ref: String

The actual image reference to use. Probably a resolved hash.

display_name: String

What user specified initially, such as “alpine”.

FromScratch

Fields

scratch_ref: Option<String>

A hack, inserted by buildkit.rs See buildkit_frontend.rs for documentation

Run

Fields

parent: NodeId

command: String

cwd: String

additional_envs: HashMap<String, String>

CopyFromImage

Fields

parent: NodeId

src_image: NodeId

src_path: String

dst_path: String

CopyFromLocal

Fields

parent: NodeId

src_path: String

dst_path: String

SetWorkdir

Fields

parent: NodeId

new_workdir: String

SetEntrypoint

Fields

parent: NodeId

new_entrypoint: Vec<String>

SetCmd

Fields

parent: NodeId

new_cmd: Vec<String>

SetLabel

Fields

parent: NodeId

label: String

value: String

Merge(MergeNode)

SetEnv

Fields

parent: NodeId

key: String

value: String

AppendEnvValue

Fields

parent: NodeId

key: String

value: String

SetUser

Fields

parent: NodeId

user: String

Trait Implementations

impl Clone for BuildNode

fn clone(&self) -> BuildNode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BuildNode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BuildNode

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for BuildNode

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

where __S: Serializer,

Serialize this value into the given Serde serializer.