ContainerImageOpts

ostree_ext::cli

Enum ContainerImageOpts 

Source 
pub(crate) enum ContainerImageOpts {
    List {
        repo: Utf8PathBuf,
    },
    Pull {
        repo: Utf8PathBuf,
        imgref: OstreeImageReference,
        ostree_digestfile: Option<Utf8PathBuf>,
        proxyopts: ContainerProxyOpts,
        quiet: bool,
        check: Option<Utf8PathBuf>,
    },
    History {
        repo: Utf8PathBuf,
        imgref: ImageReference,
    },
    Metadata {
        repo: Utf8PathBuf,
        imgref: ImageReference,
        config: bool,
    },
    ClearCachedUpdate {
        repo: Utf8PathBuf,
        imgref: ImageReference,
    },
    Copy {
        src_repo: Utf8PathBuf,
        dest_repo: Utf8PathBuf,
        imgref: OstreeImageReference,
    },
    Reexport {
        repo: Utf8PathBuf,
        src_imgref: ImageReference,
        dest_imgref: ImageReference,
        authfile: Option<PathBuf>,
        compression_fast: bool,
    },
    ReplaceDetachedMetadata {
        src: ImageReference,
        dest: ImageReference,
        contents: Option<Utf8PathBuf>,
    },
    Remove {
        repo: Utf8PathBuf,
        imgrefs: Vec<ImageReference>,
        skip_gc: bool,
    },
    PruneLayers {
        repo: Utf8PathBuf,
    },
    PruneImages {
        sysroot: Utf8PathBuf,
        and_layers: bool,
        full: bool,
    },
    Deploy {
Show 13 fields
        sysroot: Option<String>,
        stateroot: Option<String>,
        imgref: Option<String>,
        image: Option<String>,
        transport: Option<String>,
        no_signature_verification: bool,
        enforce_container_sigpolicy: bool,
        ostree_remote: Option<String>,
        proxyopts: ContainerProxyOpts,
        target_imgref: Option<OstreeImageReference>,
        no_imgref: bool,
        karg: Option<Vec<String>>,
        write_commitid_to: Option<Utf8PathBuf>,
    
},
}
Expand description

Options for import/export to tar archives.

Variants§

§

List

List container images

Fields

§repo: Utf8PathBuf

Path to the repository

§

Pull

Pull (or update) a container image.

Fields

§repo: Utf8PathBuf

Path to the repository

§imgref: OstreeImageReference

Image reference, e.g. ostree-remote-image:someremote:registry:quay.io/exampleos/exampleos:latest

§ostree_digestfile: Option<Utf8PathBuf>

File to which to write the resulting OSTree commit digest

§proxyopts: ContainerProxyOpts
§quiet: bool

Don’t display progress

§check: Option<Utf8PathBuf>

Just check for an updated manifest, but do not download associated container layers. If an updated manifest is found, a file at the provided path will be created and contain the new manifest.

§

History

Output metadata about an already stored container image.

Fields

§repo: Utf8PathBuf

Path to the repository

§imgref: ImageReference

Container image reference, e.g. registry:quay.io/exampleos/exampleos:latest

§

Metadata

Output manifest or configuration for an already stored container image.

Fields

§repo: Utf8PathBuf

Path to the repository

§imgref: ImageReference

Container image reference, e.g. registry:quay.io/exampleos/exampleos:latest

§config: bool

Output the config, not the manifest

§

ClearCachedUpdate

Remove metadata for a cached update.

Fields

§repo: Utf8PathBuf

Path to the repository

§imgref: ImageReference

Container image reference, e.g. registry:quay.io/exampleos/exampleos:latest

§

Copy

Copy a pulled container image from one repo to another.

Fields

§src_repo: Utf8PathBuf

Path to the source repository

§dest_repo: Utf8PathBuf

Path to the destination repository

§imgref: OstreeImageReference

Image reference, e.g. ostree-remote-image:someremote:registry:quay.io/exampleos/exampleos:latest

§

Reexport

Re-export a fetched image.

Unlike encapsulate, this verb handles layered images, and will also automatically preserve chunked structure from the fetched image.

Fields

§repo: Utf8PathBuf

Path to the repository

§src_imgref: ImageReference

Source image reference, e.g. registry:quay.io/exampleos/exampleos:latest

§dest_imgref: ImageReference

Destination image reference, e.g. registry:quay.io/exampleos/exampleos:latest

§authfile: Option<PathBuf>

Path to Docker-formatted authentication file.

§compression_fast: bool

Compress at the fastest level (e.g. gzip level 1)

§

ReplaceDetachedMetadata

Replace the detached metadata (e.g. to add a signature)

Fields

§src: ImageReference

Path to the source repository

§dest: ImageReference

Target image

§contents: Option<Utf8PathBuf>

Path to file containing new detached metadata; if not provided, any existing detached metadata will be deleted.

§

Remove

Unreference one or more pulled container images and perform a garbage collection.

Fields

§repo: Utf8PathBuf

Path to the repository

§imgrefs: Vec<ImageReference>

Image reference, e.g. quay.io/exampleos/exampleos:latest

§skip_gc: bool

Do not garbage collect unused layers

§

PruneLayers

Garbage collect unreferenced image layer references.

Fields

§repo: Utf8PathBuf

Path to the repository

§

PruneImages

Garbage collect unreferenced image layer references.

Fields

§sysroot: Utf8PathBuf

Path to the system root

§and_layers: bool

Also prune layers

§full: bool

Also prune layers and OSTree objects

§

Deploy

Perform initial deployment for a container image

Fields

§sysroot: Option<String>

Path to the system root

§stateroot: Option<String>

Name for the state directory, also known as “osname”. If the current system is booted via ostree, then this will default to the booted stateroot. Otherwise, the default is default.

§imgref: Option<String>

Source image reference, e.g. ostree-remote-image:someremote:registry:quay.io/exampleos/exampleos@sha256:abcd… This conflicts with --image. This conflicts with --image. Supports registry:, docker://, oci:, oci-archive:, containers-storage:, and dir:

§image: Option<String>

Name of the container image; for the registry transport this would be e.g. quay.io/exampleos/foo:latest. This conflicts with --imgref.

§transport: Option<String>

The transport; e.g. registry, oci, oci-archive. The default is registry.

§no_signature_verification: bool

This option does nothing and is now deprecated. Signature verification enforcement proved to not be viable.

If you want to still enforce it, use --enforce-container-sigpolicy.

§enforce_container_sigpolicy: bool

Require that the containers-storage stack

§ostree_remote: Option<String>

Enable verification via an ostree remote

§proxyopts: ContainerProxyOpts
§target_imgref: Option<OstreeImageReference>

Target image reference, e.g. ostree-remote-image:someremote:registry:quay.io/exampleos/exampleos:latest

If specified, --imgref will be used as a source, but this reference will be emitted into the origin so that later OS updates pull from it.

§no_imgref: bool

If set, only write the layer refs, but not the final container image reference. This allows generating a disk image that when booted uses “native ostree”, but has layer references “pre-cached” such that a container image fetch will avoid redownloading everything.

§karg: Option<Vec<String>>

Add a kernel argument

§write_commitid_to: Option<Utf8PathBuf>

Write the deployed checksum to this file

Trait Implementations§

Source§

impl Debug for ContainerImageOpts

Source§

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

Formats the value using the given formatter. Read more
Source§

impl FromArgMatches for ContainerImageOpts

Source§

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from [ArgMatches], parsing the arguments as needed. Read more
Source§

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from [ArgMatches], parsing the arguments as needed. Read more
Source§

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.
Source§

fn update_from_arg_matches_mut<'b>( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.
Source§

impl Subcommand for ContainerImageOpts

Source§

fn augment_subcommands<'b>(__clap_app: Command) -> Command

Append to [Command] so it can instantiate Self via [FromArgMatches::from_arg_matches_mut] Read more
Source§

fn augment_subcommands_for_update<'b>(__clap_app: Command) -> Command

Append to [Command] so it can instantiate self via [FromArgMatches::update_from_arg_matches_mut] Read more
Source§

fn has_subcommand(__clap_name: &str) -> bool

Test whether Self can parse a specific subcommand

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
§

impl<D> OwoColorize for D

§

fn fg<C>(&self) -> FgColorDisplay<'_, C, Self>
where C: Color,

Set the foreground color generically Read more
§

fn bg<C>(&self) -> BgColorDisplay<'_, C, Self>
where C: Color,

Set the background color generically. Read more
§

fn black(&self) -> FgColorDisplay<'_, Black, Self>

Change the foreground color to black
§

fn on_black(&self) -> BgColorDisplay<'_, Black, Self>

Change the background color to black
§

fn red(&self) -> FgColorDisplay<'_, Red, Self>

Change the foreground color to red
§

fn on_red(&self) -> BgColorDisplay<'_, Red, Self>

Change the background color to red
§

fn green(&self) -> FgColorDisplay<'_, Green, Self>

Change the foreground color to green
§

fn on_green(&self) -> BgColorDisplay<'_, Green, Self>

Change the background color to green
§

fn yellow(&self) -> FgColorDisplay<'_, Yellow, Self>

Change the foreground color to yellow
§

fn on_yellow(&self) -> BgColorDisplay<'_, Yellow, Self>

Change the background color to yellow
§

fn blue(&self) -> FgColorDisplay<'_, Blue, Self>

Change the foreground color to blue
§

fn on_blue(&self) -> BgColorDisplay<'_, Blue, Self>

Change the background color to blue
§

fn magenta(&self) -> FgColorDisplay<'_, Magenta, Self>

Change the foreground color to magenta
§

fn on_magenta(&self) -> BgColorDisplay<'_, Magenta, Self>

Change the background color to magenta
§

fn purple(&self) -> FgColorDisplay<'_, Magenta, Self>

Change the foreground color to purple
§

fn on_purple(&self) -> BgColorDisplay<'_, Magenta, Self>

Change the background color to purple
§

fn cyan(&self) -> FgColorDisplay<'_, Cyan, Self>

Change the foreground color to cyan
§

fn on_cyan(&self) -> BgColorDisplay<'_, Cyan, Self>

Change the background color to cyan
§

fn white(&self) -> FgColorDisplay<'_, White, Self>

Change the foreground color to white
§

fn on_white(&self) -> BgColorDisplay<'_, White, Self>

Change the background color to white
§

fn default_color(&self) -> FgColorDisplay<'_, Default, Self>

Change the foreground color to the terminal default
§

fn on_default_color(&self) -> BgColorDisplay<'_, Default, Self>

Change the background color to the terminal default
§

fn bright_black(&self) -> FgColorDisplay<'_, BrightBlack, Self>

Change the foreground color to bright black
§

fn on_bright_black(&self) -> BgColorDisplay<'_, BrightBlack, Self>

Change the background color to bright black
§

fn bright_red(&self) -> FgColorDisplay<'_, BrightRed, Self>

Change the foreground color to bright red
§

fn on_bright_red(&self) -> BgColorDisplay<'_, BrightRed, Self>

Change the background color to bright red
§

fn bright_green(&self) -> FgColorDisplay<'_, BrightGreen, Self>

Change the foreground color to bright green
§

fn on_bright_green(&self) -> BgColorDisplay<'_, BrightGreen, Self>

Change the background color to bright green
§

fn bright_yellow(&self) -> FgColorDisplay<'_, BrightYellow, Self>

Change the foreground color to bright yellow
§

fn on_bright_yellow(&self) -> BgColorDisplay<'_, BrightYellow, Self>

Change the background color to bright yellow
§

fn bright_blue(&self) -> FgColorDisplay<'_, BrightBlue, Self>

Change the foreground color to bright blue
§

fn on_bright_blue(&self) -> BgColorDisplay<'_, BrightBlue, Self>

Change the background color to bright blue
§

fn bright_magenta(&self) -> FgColorDisplay<'_, BrightMagenta, Self>

Change the foreground color to bright magenta
§

fn on_bright_magenta(&self) -> BgColorDisplay<'_, BrightMagenta, Self>

Change the background color to bright magenta
§

fn bright_purple(&self) -> FgColorDisplay<'_, BrightMagenta, Self>

Change the foreground color to bright purple
§

fn on_bright_purple(&self) -> BgColorDisplay<'_, BrightMagenta, Self>

Change the background color to bright purple
§

fn bright_cyan(&self) -> FgColorDisplay<'_, BrightCyan, Self>

Change the foreground color to bright cyan
§

fn on_bright_cyan(&self) -> BgColorDisplay<'_, BrightCyan, Self>

Change the background color to bright cyan
§

fn bright_white(&self) -> FgColorDisplay<'_, BrightWhite, Self>

Change the foreground color to bright white
§

fn on_bright_white(&self) -> BgColorDisplay<'_, BrightWhite, Self>

Change the background color to bright white
§

fn bold(&self) -> BoldDisplay<'_, Self>

Make the text bold
§

fn dimmed(&self) -> DimDisplay<'_, Self>

Make the text dim
§

fn italic(&self) -> ItalicDisplay<'_, Self>

Make the text italicized
§

fn underline(&self) -> UnderlineDisplay<'_, Self>

Make the text underlined
Make the text blink
Make the text blink (but fast!)
§

fn reversed(&self) -> ReversedDisplay<'_, Self>

Swap the foreground and background colors
§

fn hidden(&self) -> HiddenDisplay<'_, Self>

Hide the text
§

fn strikethrough(&self) -> StrikeThroughDisplay<'_, Self>

Cross out the text
§

fn color<Color>(&self, color: Color) -> FgDynColorDisplay<'_, Color, Self>
where Color: DynColor,

Set the foreground color at runtime. Only use if you do not know which color will be used at compile-time. If the color is constant, use either [OwoColorize::fg] or a color-specific method, such as [OwoColorize::green], Read more
§

fn on_color<Color>(&self, color: Color) -> BgDynColorDisplay<'_, Color, Self>
where Color: DynColor,

Set the background color at runtime. Only use if you do not know what color to use at compile-time. If the color is constant, use either [OwoColorize::bg] or a color-specific method, such as [OwoColorize::on_yellow], Read more
§

fn fg_rgb<const R: u8, const G: u8, const B: u8>( &self, ) -> FgColorDisplay<'_, CustomColor<R, G, B>, Self>

Set the foreground color to a specific RGB value.
§

fn bg_rgb<const R: u8, const G: u8, const B: u8>( &self, ) -> BgColorDisplay<'_, CustomColor<R, G, B>, Self>

Set the background color to a specific RGB value.
§

fn truecolor(&self, r: u8, g: u8, b: u8) -> FgDynColorDisplay<'_, Rgb, Self>

Sets the foreground color to an RGB value.
§

fn on_truecolor(&self, r: u8, g: u8, b: u8) -> BgDynColorDisplay<'_, Rgb, Self>

Sets the background color to an RGB value.
§

fn style(&self, style: Style) -> Styled<&Self>

Apply a runtime-determined style
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more