Struct libcoreinst::cmdline::InstallConfig

pub struct InstallConfig {

    pub config_file: Vec<String>,
    pub stream: Option<String>,
    pub image_url: Option<Url>,
    pub image_file: Option<String>,
    pub ignition_file: Option<String>,
    pub ignition_url: Option<Url>,
    pub ignition_hash: Option<IgnitionHash>,
    pub architecture: DefaultedString<Architecture>,
    pub platform: Option<String>,
    pub console: Vec<Console>,
    pub firstboot_args: Option<String>,
    pub append_karg: Vec<String>,
    pub delete_karg: Vec<String>,
    pub copy_network: bool,
    pub network_dir: DefaultedString<NetworkDir>,
    pub save_partlabel: Vec<String>,
    pub save_partindex: Vec<String>,
    pub offline: bool,
    pub insecure: bool,
    pub insecure_ignition: bool,
    pub stream_base_url: Option<Url>,
    pub preserve_on_error: bool,
    pub fetch_retries: FetchRetries,
    pub secure_ipl: bool,
    pub dest_device: Option<String>,
}

Fields

config_file: Vec<String>

YAML config file with install options

Load additional config options from the specified YAML config file. Later config files override earlier ones, and command-line options override config files.

Config file keys are long option names without the leading “–”. Values are strings for non-repeatable options, arrays of strings for repeatable options, and “true” for flags. The destination device can be specified with the “dest-device” key.

stream: Option<String>

Fedora CoreOS stream

The name of the Fedora CoreOS stream to install, such as “stable”, “testing”, or “next”.

image_url: Option<Url>

Manually specify the image URL

coreos-installer appends “.sig” to find the GPG signature for the image, which must exist and be valid. A missing signature can be ignored with –insecure.

image_file: Option<String>

Manually specify a local image file

coreos-installer appends “.sig” to find the GPG signature for the image, which must exist and be valid. A missing signature can be ignored with –insecure.

ignition_file: Option<String>

Embed an Ignition config from a file

Embed the specified Ignition config in the installed system.

ignition_url: Option<Url>

Embed an Ignition config from a URL

Immediately fetch the Ignition config from the URL and embed it in the installed system.

ignition_hash: Option<IgnitionHash>

Digest (type-value) of the Ignition config

Verify that the Ignition config matches the specified digest, formatted as -. can be sha256 or sha512.

architecture: DefaultedString<Architecture>

Target CPU architecture

Create an install disk for a different CPU architecture than the host.

platform: Option<String>

Override the Ignition platform ID

Install a system that will run on the specified cloud or virtualization platform, such as “vmware”.

console: Vec<Console>

Kernel and bootloader console

Set the kernel and bootloader console, using the same syntax as the parameter to the “console=” kernel argument.

firstboot_args: Option<String>

Additional kernel args for the first boot

append_karg: Vec<String>

Append default kernel arg

Add a kernel argument to the installed system.

delete_karg: Vec<String>

Delete default kernel arg

Delete a default kernel argument from the installed system.

copy_network: bool

Copy network config from install environment

Copy NetworkManager keyfiles from the install environment to the installed system.

network_dir: DefaultedString<NetworkDir>

Override NetworkManager keyfile dir for -n

Specify the path to NetworkManager keyfiles to be copied with –copy-network.

[default: /etc/NetworkManager/system-connections/]

save_partlabel: Vec<String>

Save partitions with this label glob

Preserve any existing partitions on the destination device whose partition label (not filesystem label) matches the specified glob pattern. Multiple patterns can be specified in multiple options, or in a single option separated by commas.

Saved partitions will be renumbered if necessary. If partitions overlap with the install image, or installation fails for any other reason, the specified partitions will still be preserved.

save_partindex: Vec<String>

Save partitions with this number or range

Preserve any existing partitions on the destination device whose partition number matches the specified value or range. Ranges can be bounded on both ends (“5-7”, inclusive) or one end (“5-” or “-7”). Multiple numbers or ranges can be specified in multiple options, or in a single option separated by commas.

Saved partitions will be renumbered if necessary. If partitions overlap with the install image, or installation fails for any other reason, the specified partitions will still be preserved.

offline: bool

Force offline installation

insecure: bool

Allow unsigned image

Allow the signature to be absent. Does not allow an existing signature to be invalid.

insecure_ignition: bool

Allow Ignition URL without HTTPS or hash

stream_base_url: Option<Url>

Base URL for CoreOS stream metadata

Override the base URL for fetching CoreOS stream metadata. The default is “https://builds.coreos.fedoraproject.org/streams/”.

preserve_on_error: bool

Don’t clear partition table on error

If installation fails, coreos-installer normally clears the destination’s partition table to prevent booting from invalid boot media. Skip clearing the partition table as a debugging aid.

fetch_retries: FetchRetries

Fetch retries, or “infinite”

Number of times to retry network fetches, or the string “infinite” to retry indefinitely.

secure_ipl: bool

Enable IBM Secure IPL

dest_device: Option<String>

Destination device

Path to the device node for the destination disk. The beginning of the device will be overwritten without further confirmation.

Implementations

impl InstallConfig

pub fn expand_config_files(self) -> Result<Self>

Trait Implementations

impl Args for InstallConfig

fn group_id() -> Option<Id>

Report the [ArgGroup::id][crate::ArgGroup::id] for this set of arguments

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

Append to [Command] so it can instantiate Self.

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

Append to [Command] so it can update self.

impl CommandFactory for InstallConfig

fn command<'b>() -> Command

Build a [Command] that can instantiate Self.

fn command_for_update<'b>() -> Command

Build a [Command] that can update self.

impl Debug for InstallConfig

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

Formats the value using the given formatter.

impl Default for InstallConfig

fn default() -> InstallConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for InstallConfig

where InstallConfig: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl FromArgMatches for InstallConfig

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

Instantiate Self from [ArgMatches], parsing the arguments as needed.

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

Instantiate Self from [ArgMatches], parsing the arguments as needed.

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

Assign values from ArgMatches to self.

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

Assign values from ArgMatches to self.

impl Parser for InstallConfig

fn parse() -> Self

Parse from std::env::args_os(), exit on error

fn try_parse() -> Result<Self, Error>

Parse from std::env::args_os(), return Err on error.

fn parse_from<I, T>(itr: I) -> Self

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, exit on error

fn try_parse_from<I, T>(itr: I) -> Result<Self, Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, return Err on error.

fn update_from<I, T>(&mut self, itr: I)

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, exit on error

fn try_update_from<I, T>(&mut self, itr: I) -> Result<(), Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, return Err on error.

impl PartialEq for InstallConfig

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for InstallConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for InstallConfig

impl StructuralEq for InstallConfig

impl StructuralPartialEq for InstallConfig