Struct ImageDefinition 

pub struct ImageDefinition {
    pub base: Option<BaseImage>,
    pub oci_ref: Option<String>,
    pub architecture: ImageArchitecture,
    pub env: HashMap<String, String>,
    pub python_version: String,
    pub filesystem: ImageFilesystem,
    pub steps: Vec<ImageDefinitionStep>,
}

A custom image definition: a base image plus ordered build steps, where local-file steps still reference paths on this machine. Resolve it with Client::resolve_image (hash + upload) or hand it to Client::build_image_definition to also build it to ready.

Fields

base: Option<BaseImage>

Base image to build on. Mutually exclusive with oci_ref.

oci_ref: Option<String>

Your own image as the root filesystem: a reference to a Debian- or Ubuntu-based image whose first segment names a supported public registry (docker.io, ghcr.io, public.ecr.aws, or quay.io), with an optional :tag or @sha256:<64 hex> pin (no tag means the latest tag). Once Sail has a built image for a tag, later builds keep using it; if no image was ever built from a lookup, Sail may look the tag up again later. The image’s ENV and WORKDIR become the Sailbox defaults for commands you run; its ENTRYPOINT and CMD are not run, because a Sailbox manages its own processes. Mutually exclusive with base.

architecture: ImageArchitecture

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

env: HashMap<String, String>

Environment variables baked into the image.

python_version: String

Exact Python version to install as python3; empty uses the builder default. Not accepted with oci_ref: a registry image keeps its own python3.

filesystem: ImageFilesystem

Writable root filesystem; unspecified preserves the ext4 default.

steps: Vec<ImageDefinitionStep>

Ordered build steps.

Trait Implementations

impl Clone for ImageDefinition

fn clone(&self) -> ImageDefinition

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ImageDefinition

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

Formats the value using the given formatter.

impl Default for ImageDefinition

fn default() -> ImageDefinition

Returns the “default value” for a type.