coreos-installer 命令简介及安装

1. 下载

下载地址： https://github.com/coreos/coreos-installer/releases

2. coreos-installer简介

coreos-installer是一个帮助安装Fedora coreos（FCOS）和Red Hat Enterprise Linux coreos（RHCOS）的程序。

coreos-installer 0.10.1之前版本存在密码签名错误漏洞, 能够修改原始安装程序映像的攻击者可利用该漏洞写入任意数据，并实现对正在安装的节点的完全访问。

coreos-installer 包含在Fedora coreos和RHEL coreos中。只需从命令行运行coreos-installer。Fedora CoreOS提供了可从RAM运行的实时CD和网络引导映像；可以使用这些来运行coreos安装程序，将Fedora coreos或RHEL coreos安装到磁盘。

可以执行的操作：

• 将操作系统安装到目标磁盘，可以选择使用Ignition配置或第一个引导内核参数（coreos-installer install）对其进行自定义

• 下载并验证各种云、虚拟化或裸机平台的操作系统映像（coreos-installer download）

• 列出可供下载的Fedora CoreOS映像（coreos-installer list-stream）

• 在实时ISO映像中嵌入点火配置，以自定义从中启动的运行系统（coreos-installer iso ignition)）
  将Ignition配置包装在initrd映像中，该映像可以附加到实时PXE initramfs中，以自定义从中启动的运行系统（coreos-installer pxe ignition）

每个子命令的可用选项在“命令行参考”中或通过--help选项提供。

有关如何下载和使用coreos-installer的更多信息，请参阅《入门指南》。

3. coreos-installer 子命令、命令行选项和参数

3.1 coreos-installer install 子命令

选项	描述
-u, --image-url <url>	手动指定镜像 URL。
-f,--image-file <path>	手动指定本地镜像文件。用于调试。
-i, --ignition-file <path>	从文件中嵌入 Ignition 配置。
-i,--ignition-url <URL>	从 URL 嵌入 Ignition 配置。
--ignition-hash <digest>	Ignition 配置 的 type-value 的摘要值。
-p, --platform <name>	覆盖已安装系统的 Ignition 平台 ID。
--append-karg <arg>…​	将默认内核参数附加到安装的系统中。
--delete-karg <arg>…​	从安装的系统中删除默认内核参数。
-n, --copy-network	从安装环境中复制网络配置。 重要 copy-network 选项仅复制在 /etc/NetworkManager/system-connections 下找到的网络配置。特别是，它不会复制系统主机名。
--network-dir <path>	用于 -n。默认为 /etc/NetworkManager/system-connections/。
--save-partlabel <lx>..	使用这个标签 glob 保存分区。
--save-partindex <id>…​	使用这个数值或范围保存分区。
--insecure	跳过签名验证。
--insecure-ignition	允许没有 HTTPS 或 hash 的 Ignition URL。
--architecture <name>	目标 CPU 架构.有效值为 x86_64 和 arm64。
--preserve-on-error	出错时不要清除分区表。
-h,--help	打印帮助信息.

参数	描述
<device>	目标设备.

3.2 coreos-installer ISO 子命令

子命令	描述
$ coreos-installer iso customize <options> <ISO_image>	自定义 RHCOS live ISO 镜像。
coreos-installer iso reset <options> <ISO_image>	将 RHCOS live ISO 镜像恢复到默认设置。
coreos-installer iso ignition remove <options> <ISO_image>	从 ISO 镜像中删除嵌入的 Ignition 配置。

3.3 coreos-installer ISO customize 子命令选项

选项	描述
--dest-ignition <path>	将指定的 Ignition 配置文件合并到目标系统的新配置片段中。
--dest-device <path>	安装并覆盖指定的目标设备。
--dest-karg-append <arg>	为每个目标系统引导添加一个内核参数。
--dest-karg-delete <arg>	从目标系统的每个引导中删除内核参数。
--network-keyfile <path>	使用指定的 NetworkManager 密钥文件进行实时和目标系统配置网络。
--ignition-ca <path>	指定要被 Ignition 信任的额外 TLS 证书颁发机构。
--pre-install <path>	在安装之前运行指定的脚本。
--post-install <path>	安装后运行指定的脚本。
--installer-config <path>	应用指定的安装程序配置文件。
--live-ignition <path>	将指定的 Ignition 配置文件合并到实时环境的新配置片段中。
--live-karg-append <arg>	为每个实时环境引导添加一个内核参数。
--live-karg-delete <arg>	从实时环境每次引导时删除内核参数。
--live-karg-replace <k=o=n>	在每次启动 live 环境时替换内核参数，格式为 key=old=new。
-f,--force	覆盖现有的 Ignition 配置。
-o,--output <path>	将 ISO 写入到新的输出文件。
-h,--help	打印帮助信息.

3.4 coreos-installer PXE 子命令

子命令	描述
请注意，并非所有子命令都接受所有这些选项。
coreos-installer pxe customize <options> <path>	自定义 RHCOS live PXE 引导配置。
coreos-installer pxe ignition wrap <options>	在镜像中嵌套 Ignition 配置。
coreos-installer pxe ignition unwrap <options> <image_name>	在镜像中显示嵌套的 Ignition 配置。
coreos-installer PXE customize 子命令选项
选项	描述
请注意，并非所有子命令都接受所有这些选项。
--dest-ignition <path>	将指定的 Ignition 配置文件合并到目标系统的新配置片段中。
--dest-device <path>	安装并覆盖指定的目标设备。
--network-keyfile <path>	使用指定的 NetworkManager 密钥文件进行实时和目标系统配置网络。
--ignition-ca <path>	指定要被 Ignition 信任的额外 TLS 证书颁发机构。
--pre-install <path>	在安装之前运行指定的脚本。
post-install <path>	安装后运行指定的脚本。
--installer-config <path>	应用指定的安装程序配置文件。
--live-ignition <path>	将指定的 Ignition 配置文件合并到实时环境的新配置片段中。
-o, --output <path>	将 initramfs 写入一个新输出文件。 注意 PXE 环境需要这个选项。
-h,--help	打印帮助信息.

3.5 coreos.inst 引导选项

参数	描述
coreos.inst.install_dev	必需。要安装到的系统中的块设备。建议您使用完整路径，如 /dev/sda，但 允许使用。
coreos.inst.ignition_url	可选：嵌入到安装的系统中的 Ignition 配置的 URL。如果没有指定 URL，则不会嵌入 Ignition 配置。仅支持 HTTP 和 HTTPS 协议。
coreos.inst.save_partlabel	可选：在安装过程中要保留的分区分离标签。允许使用 glob 风格的通配符。指定分区不需要存在。
coreos.inst.save_partindex	可选：在安装过程中压缩要保留的分区索引。允许 m-n 范围，m 或 n 可以被省略。指定分区不需要存在。
coreos.inst.insecure	可选：将 coreos.inst.image_url 指定的 OS 镜像提交取消签名。
coreos.inst.image_url	可选：下载并安装指定的 RHCOS 镜像。 这个参数不应该在生产环境中使用，而是只用于调试目的。 虽然此参数可用于安装与 live 介质不匹配的 RHCOS 版本，但建议您使用与您要安装版本匹配的介质。 如果您使用 coreos.inst.image_url，还必须使用 coreos.inst.insecure。这是因为，裸机介质没有为 OpenShift Container Platform 进行 GPG 签名。 仅支持 HTTP 和 HTTPS 协议。
coreos.inst.skip_reboot	可选：安装后系统不会重启。安装完成后，您将收到提示，提示您检查在安装过程中发生的情况。这个参数不应该在生产环境中使用，而是只用于调试目的。
coreos.inst.platform_id	可选：安装 RHCOS 镜像的平台的 Ignition 平台 ID。默认为 metal。这个选项决定是否从云供应商（如 VMware）请求 Ignition 配置。例如： coreos.inst.platform_id=vmware。
ignition.config.url	可选：用于实时引导的 Ignition 配置的 URL。例如，这可用于自定义调用 coreos-installer 的方式，或者用于在安装前或安装后运行代码。这与 coreos.inst.ignition_url （这是已安装系统的 Ignition 配置）不同。