Skip to content

Commit

Permalink
sysconfig-network-configuration: mention live image customization
Browse files Browse the repository at this point in the history
  • Loading branch information
bgilbert committed Feb 17, 2022
1 parent 750a1d7 commit 69eecc4
Showing 1 changed file with 9 additions and 0 deletions.
9 changes: 9 additions & 0 deletions modules/ROOT/pages/sysconfig-network-configuration.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,8 @@ Whether or not a machine needs networking in the initramfs can dictate how a use

* via kernel arguments
** these get processed by dracut modules in the initramfs on first boot
* via live image customization
** by embedding network configuration in the live ISO or PXE image
* via `coreos-installer install --copy-network`
** by propagating the install environment networking configuration
* via Afterburn
Expand Down Expand Up @@ -61,6 +63,13 @@ echo "ip=${ip}::${gateway}:${netmask}:${hostname}:${interface}:none:${nameserver
----


==== via live image customization

coreos-installer allows you to embed NetworkManager keyfiles directly in a live ISO or PXE image by using the `--network-keyfile` option to `coreos-installer iso customize` or `coreos-installer pxe customize`. The configuration is applied in the initramfs before Ignition runs. If you also use the `--installer-config` option or any of the `--dest-*` options to configure automatic installation, or the `--copy-network` option when installing manually, the network configuration will be forwarded to the installed system.

For more details on embedding network configuration in a live image, see the xref:live-reference.adoc#_passing_network_configuration_to_a_live_iso_or_pxe_system[live ISO/PXE image reference].


==== via `coreos-installer install --copy-network`

For manual bare metal install workflows it may not be preferable to use dracut kernel arguments for configuring network:
Expand Down

0 comments on commit 69eecc4

Please sign in to comment.