| parent | nav_order |
|---|---|
Command line reference |
4 |
{: .no_toc }
- TOC {:toc}
Customize a CoreOS live ISO image
Usage: coreos-installer iso customize [OPTIONS] <ISO>
Arguments:
<ISO>
ISO image
Options:
--dest-ignition <path>
Ignition config fragment for dest sys
Automatically run installer and merge the specified Ignition config into the config
for the destination system.
--dest-device <path>
Install destination device
Automatically run installer, installing to the specified destination device. The
resulting boot media will overwrite the destination device without confirmation.
--dest-console <spec>
Kernel and bootloader console for dest
Automatically run installer, configuring the specified kernel and bootloader console
for the destination system. The argument uses the same syntax as the parameter to
the "console=" kernel argument.
--dest-karg-append <arg>
Destination kernel argument to append
Automatically run installer, adding the specified kernel argument for every boot of
the destination system.
--dest-karg-delete <arg>
Destination kernel argument to delete
Automatically run installer, deleting the specified kernel argument for every boot of
the destination system.
--network-keyfile <path>
NetworkManager keyfile for live & dest
Configure networking using the specified NetworkManager keyfile. Network settings
will be applied in the live environment, including when Ignition is run. If
installer is enabled via additional options, network settings will also be applied in
the destination system, including when Ignition is run.
--network-nmstate <path>
Nmstate file for live & dest
Configure networking using NetworkManager keyfiles generated from the specified
Nmstate files. Network settings will be applied in the live environment, including
when Ignition is run. If installer is enabled via additional options, network
settings will also be applied in the destination system, including when Ignition is
run.
--ignition-ca <path>
Ignition PEM CA bundle for live & dest
Specify additional TLS certificate authorities to be trusted by Ignition, in PEM
format. Authorities will be trusted by Ignition in the live environment and, if
installer is enabled via additional options, in the destination system.
--pre-install <path>
Script to run before installation
If installer is run at boot, run this script before installation. If the script
fails, the live environment will stop at an emergency shell.
--post-install <path>
Script to run after installation
If installer is run at boot, run this script after installation. If the script fails,
the live environment will stop at an emergency shell.
--installer-config <path>
Installer config file
Automatically run coreos-installer and apply the specified installer config file.
Config files are applied in the order that they are specified.
--live-ignition <path>
Ignition config fragment for live env
Merge the specified Ignition config into the config for the live environment.
--live-karg-append <arg>
Live kernel argument to append
Kernel argument to append to boots of the live environment.
--live-karg-delete <arg>
Live kernel argument to delete
Kernel argument to delete from boots of the live environment.
--live-karg-replace <k=o=n>
Live kernel argument to replace
Kernel argument to replace for boots of the live environment, in the form
key=old=new. For a default argument "a=b", specifying "--live-karg-replace a=b=c"
will produce the argument "a=c".
-f, --force
Overwrite existing customizations
-o, --output <path>
Write ISO to a new output file
-h, --help
Print help (see a summary with '-h')
Embed an Ignition config in an ISO image
Usage: coreos-installer iso ignition embed [OPTIONS] <ISO>
Arguments:
<ISO> ISO image
Options:
-f, --force Overwrite an existing Ignition config
-i, --ignition-file <path> Ignition config to embed [default: stdin]
-o, --output <path> Write ISO to a new output file
-h, --help Print help
Show the embedded Ignition config from an ISO image
Usage: coreos-installer iso ignition show <ISO>
Arguments:
<ISO> ISO image
Options:
-h, --help Print help
Remove an existing embedded Ignition config from an ISO image
Usage: coreos-installer iso ignition remove [OPTIONS] <ISO>
Arguments:
<ISO> ISO image
Options:
-o, --output <path> Write ISO to a new output file
-h, --help Print help
Embed network settings in an ISO image
Usage: coreos-installer iso network embed [OPTIONS] --keyfile <path> <ISO>
Arguments:
<ISO> ISO image
Options:
-k, --keyfile <path> NetworkManager keyfile to embed
-f, --force Overwrite existing network settings
-o, --output <path> Write ISO to a new output file
-h, --help Print help
Extract embedded network settings from an ISO image
Usage: coreos-installer iso network extract [OPTIONS] <ISO>
Arguments:
<ISO> ISO image
Options:
-C, --directory <path> Extract to directory instead of stdout
-h, --help Print help
Remove existing network settings from an ISO image
Usage: coreos-installer iso network remove [OPTIONS] <ISO>
Arguments:
<ISO> ISO image
Options:
-o, --output <path> Write ISO to a new output file
-h, --help Print help
Modify kernel args in an ISO image
Usage: coreos-installer iso kargs modify [OPTIONS] <ISO>
Arguments:
<ISO> ISO image
Options:
-a, --append <KARG> Kernel argument to append
-d, --delete <KARG> Kernel argument to delete
-r, --replace <KARG=OLDVAL=NEWVAL> Kernel argument to replace
-o, --output <PATH> Write ISO to a new output file
-h, --help Print help
Reset kernel args in an ISO image to defaults
Usage: coreos-installer iso kargs reset [OPTIONS] <ISO>
Arguments:
<ISO> ISO image
Options:
-o, --output <PATH> Write ISO to a new output file
-h, --help Print help
Show kernel args from an ISO image
Usage: coreos-installer iso kargs show [OPTIONS] <ISO>
Arguments:
<ISO> ISO image
Options:
-d, --default Show default kernel args
-h, --help Print help
Extract PXE files from an ISO image
Usage: coreos-installer iso extract pxe [OPTIONS] <ISO>
Arguments:
<ISO> ISO image
Options:
-o, --output-dir <PATH> Output directory [default: .]
-h, --help Print help
Extract a minimal ISO from a CoreOS live ISO image
Usage: coreos-installer iso extract minimal-iso [OPTIONS] <ISO> [OUTPUT_ISO]
Arguments:
<ISO> ISO image
[OUTPUT_ISO] Minimal ISO output file [default: -]
Options:
--output-rootfs <PATH> Extract rootfs image as well
--rootfs-url <URL> Inject rootfs URL karg into minimal ISO
-h, --help Print help
Restore a CoreOS live ISO image to default settings
Usage: coreos-installer iso reset [OPTIONS] <ISO>
Arguments:
<ISO> ISO image
Options:
-o, --output <path> Write ISO to a new output file
-h, --help Print help