Struct ImageSpec 

pub struct ImageSpec {
    pub base: Option<BaseImage>,
    pub oci: Option<OciImage>,
    pub dockerfile: Option<DockerfileImage>,
    pub build_steps: Vec<ImageBuildStep>,
    pub env: HashMap<String, String>,
    pub architecture: ImageArchitecture,
    pub python_version: String,
    pub filesystem: ImageFilesystem,
}

A Sailbox image: a base or registry image plus ordered build steps.

Fields

base: Option<BaseImage>

Base image to build on; mutually exclusive with oci and dockerfile.

oci: Option<OciImage>

Your own image used as the root filesystem; mutually exclusive with base and dockerfile. Names a Debian- or Ubuntu-based image on a supported public registry (docker.io, ghcr.io, public.ecr.aws, or quay.io) by tag, digest, or bare name (a bare name means the latest tag). A tag is pinned for your organization once an image has been built from it: later builds keep getting that version, even if the tag moves upstream. A forced build (BuildMode::ForceBuild) looks the tag up again and moves the pin for your whole organization. If forced builds of the same tag overlap, the last-requested one that succeeds decides what the tag means, no matter which build finishes first. A digest names exactly one image, so it never moves.

dockerfile: Option<DockerfileImage>

Your own Dockerfile built into the image; mutually exclusive with base and oci. Every image its FROM (and COPY --from) instructions name must live on a supported public registry (docker.io, ghcr.io, public.ecr.aws, or quay.io; a short name like python:3.12 means docker.io/library/python:3.12). Each named image is pinned to the version its tag pointed at the first time your organization used it, and those pinned versions become part of the built image’s identity, so rebuilding the same spec reuses the same image even after a tag moves. A forced build (BuildMode::ForceBuild) looks the tags up again and builds what they point at now.

build_steps: Vec<ImageBuildStep>

Ordered build steps applied on top of the image source.

env: HashMap<String, String>

Environment variables baked into the image.

architecture: ImageArchitecture

Target CPU architecture. Unset means amd64 with base and dockerfile, and with oci means whichever architecture the registry image was built for (amd64 when it was built for both). Setting it with oci requires the image to provide that architecture.

python_version: String

Exact Python version to install as python3; empty uses the builder default. Not accepted with oci or dockerfile: a pinned interpreter would shadow the Python the image was built around.

filesystem: ImageFilesystem

Writable root filesystem; unspecified preserves the ext4 default.

Trait Implementations

impl Clone for ImageSpec

fn clone(&self) -> ImageSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ImageSpec

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

Formats the value using the given formatter.

impl Default for ImageSpec

fn default() -> ImageSpec

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ImageSpec

where ImageSpec: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ImageSpec

fn eq(&self, other: &ImageSpec) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ImageSpec

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ImageSpec