Enum BuildMode 

pub enum BuildMode {
    ReuseExisting,
    ForceBuild,
}

Whether an image already built from the same definition satisfies a build call, or the image is built again.

Variants

ReuseExisting

Use the already-built image when one exists; build only when none does. Once an organization has a built image for the registry tag of an imported registry image (ImageDefinition::oci_ref), this keeps using the version the tag pointed to then, even if the tag has moved since. The tags a Dockerfile’s FROM and COPY --from instructions name (ImageDefinition::dockerfile) hold to their first-use versions the same way.

ForceBuild

Build again even if a built image exists: the fresh build runs under a new image ID, and this call waits for it to become ready. New Sailboxes use the fresh image once it is ready, Sailboxes that already exist keep the filesystem they were created with, and a forced build that fails changes nothing. For an image imported through a registry tag (ImageDefinition::oci_ref), a forced build also asks the registry what the tag points at now and builds that version. The tag then means that version for your whole organization, while specs built earlier keep their pinned version. For an image built from a Dockerfile (ImageDefinition::dockerfile), a forced build looks up the tags its FROM and COPY --from instructions name and moves those pins for your whole organization, while specs built earlier keep the versions their build used. If forced builds overlap, the last-requested one that succeeds decides which image new Sailboxes use and, for a tag, what the tag means.

Trait Implementations

impl Clone for BuildMode

fn clone(&self) -> BuildMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for BuildMode

impl Debug for BuildMode

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

Formats the value using the given formatter.

impl Eq for BuildMode

impl PartialEq for BuildMode

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for BuildMode