Struct ZStep 

pub struct ZStep {
    pub run: Option<ZCommand>,
    pub copy: Option<ZCopySources>,
    pub add: Option<ZCopySources>,
    pub env: Option<HashMap<String, String>>,
    pub workdir: Option<String>,
    pub user: Option<String>,
    pub to: Option<String>,
    pub from: Option<String>,
    pub owner: Option<String>,
    pub chmod: Option<String>,
    pub cache: Vec<ZCacheMount>,
}

A single build instruction within a stage.

Exactly one of the action fields (run, copy, add, env, workdir, user) should be set, with one exception for env:

• env alone sets persistent environment variables on the image (Dockerfile ENV semantics).
• env alongside run is allowed and acts as a transient per-RUN modifier: the env vars are exported only for that single RUN command and are NOT baked into the resulting image. This is useful for build-time secrets or knobs (e.g. CARGO_NET_OFFLINE=true) that should not persist at runtime.

env combined with any other action field (copy, add, workdir, user) is rejected. The remaining fields (to, from, owner, chmod, cache) are modifiers that apply to the chosen action.

Fields

run: Option<ZCommand>

Shell command or exec-form command to run

copy: Option<ZCopySources>

Source path(s) to copy into the image

add: Option<ZCopySources>

Source path(s) to add (supports URLs and auto-extraction)

env: Option<HashMap<String, String>>

Environment variables to set

workdir: Option<String>

Change working directory

user: Option<String>

Change user

to: Option<String>

Destination path (for copy/add actions)

from: Option<String>

Source stage name for cross-stage copy (replaces --from)

owner: Option<String>

File ownership (replaces --chown)

chmod: Option<String>

File permissions (replaces --chmod)

cache: Vec<ZCacheMount>

Cache mounts for RUN steps

Trait Implementations

impl Clone for ZStep

fn clone(&self) -> ZStep

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ZStep

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ZStep

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ZStep

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

where __S: Serializer,

Serialize this value into the given Serde serializer.