Enum ImageSource 

pub enum ImageSource {
    Pull(String),
    Build {
        context: String,
        dockerfile: String,
        build_args: HashMap<String, String>,
        target: Option<String>,
        tag: String,
    },
}

How the container image is obtained.

Produced during resolution and consumed by the runtime (to decide whether to call docker pull or docker build) and by the export pipeline (to emit the correct Compose image or build stanza).

Example

use lightshuttle_spec::ImageSource;
use std::collections::HashMap;

// A pre-built image pulled from a registry.
let pulled = ImageSource::Pull("postgres:16-alpine".into());

// An image built locally from a Dockerfile.
let built = ImageSource::Build {
    context: ".".into(),
    dockerfile: "Dockerfile".into(),
    build_args: HashMap::new(),
    target: None,
    tag: "lightshuttle/myproject_app:dev".into(),
};

Variants

Pull(String)

Pull the named image reference from a registry.

The inner String is a fully qualified image reference such as postgres:16-alpine or ghcr.io/org/image:tag.

Build

Build the image locally from a Dockerfile.

The runtime calls docker build (or equivalent) with these parameters before starting the container.

Fields

context: String

Build context directory, relative to the manifest file.

dockerfile: String

Dockerfile path within context.

build_args: HashMap<String, String>

Build-time --build-arg key/value pairs.

target: Option<String>

Optional multi-stage --target stage name.

tag: String

Tag applied to the resulting image (e.g. lightshuttle/<project>_<resource>:dev).

Trait Implementations

impl Clone for ImageSource

fn clone(&self) -> ImageSource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ImageSource

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

Formats the value using the given formatter.