5.3. 支持的镜像自定义

您可以通过在蓝图中添加自定义来自定义镜像，例如：

添加一个额外的 RPM 软件包
启用服务
自定义一个内核命令行参数.

在其他参数之间。您可以在蓝图中使用多个镜像自定义。通过使用自定义配置，您可以将软件包和组添加到默认软件包中不提供的镜像中。要使用这些选项，请在蓝图中配置自定义，并将其导入(push)到 RHEL 镜像构建器中。

其他资源

在添加文件系统自定义"大小" （红帽知识库）后，蓝图导入会失败。

5.3.1. 选择一个发行版

您可以使用 distro 字段选择在制作镜像时使用的发行版，或者解决蓝图中的依赖问题。如果 distro 留空，它将使用主机发行版。如果没有指定发行版，蓝图将使用主机分发。如果您升级主机操作系统，则没有发行版集合的蓝图使用新的操作系统版本构建镜像。您无法构建一个与 RHEL 镜像构建器主机不同的操作系统镜像。

使用 RHEL 发行版自定义蓝图，以始终构建指定的 RHEL 镜像：

name = "blueprint_name"
description = "blueprint_version"
version = "0.1"
distro = "different_minor_version"

例如：

name = "tmux"
description = "tmux image with openssh"
version = "1.2.16"
distro = "rhel-9.5"

替换 "different_minor_version" 以构建不同的次版本，例如，如果要构建 RHEL 9.5 镜像，请使用 distro = "rhel-94"。在 RHEL 9.3 镜像中，您可以构建次版本，如 RHEL 9.3、RHEL 8.10 和更早的版本。

5.3.2. 选择一个软件包组

使用软件包组自定义蓝图。groups 列表描述了您要安装到镜像中的软件包组。软件包组在存储库元数据中定义。每个组都有一个描述性名称，主要用于在用户界面中显示，以及一个 ID，通常在 Kickstart 文件中使用。在这种情况下，您必须使用 ID 来列出组。组有三种不同的方法来对软件包进行分类：mandatory、default 和 optional。蓝图中只安装了 mandatory 和 default 软件包。无法选择 optional 软件包。

name 属性是必需的字符串，必须与存储库中的软件包组 id 完全匹配。

注意

目前，osbuild-composer 中的软件包和模块之间没有区别。两者都被视为 RPM 软件包依赖项。

自定义带有软件包的蓝图：
```
[[groups]]
name = "group_name"
```
使用组名称替换 group_name。例如：anaconda-tools ：
```
[[groups]]
name = "anaconda-tools"
```

5.3.3. 设置镜像主机名

customizations.hostname 是一个可选字符串，您可以用来配置最终镜像主机名。此自定义是可选的，如果您未设置它，则蓝图使用默认主机名。

自定义蓝图以配置主机名：
```
[customizations]
hostname = "baseimage"
```

5.3.4. 指定其他用户

将用户添加到镜像中，并可选择设置其 SSH 密钥。本节的所有字段都是可选的，但 name 除外。

流程

自定义蓝图来将用户添加到镜像中：

[[customizations.user]]
name = "USER-NAME"
description = "USER-DESCRIPTION"
password = "PASSWORD-HASH"
key = "PUBLIC-SSH-KEY"
home = "/home/USER-NAME/"
shell = "/usr/bin/bash"
groups = ["users", "wheel"]
uid = NUMBER
gid = NUMBER

[[customizations.user]]
name = "admin"
description = "Administrator account"
password = "$6$CHO2$3rN8eviE2t50lmVyBYihTgVRHcaecmeCk31L..."
key = "PUBLIC SSH KEY"
home = "/srv/widget/"
shell = "/usr/bin/bash"
groups = ["widget", "users", "wheel"]
uid = 1200
gid = 1200
expiredate = 12345

GID 是可选的，且必须在镜像中已存在。（可选）软件包会创建它，或者蓝图使用 [[customizations.group] 条目创建 GID。

将 PASSWORD-HASH 替换为实际的 密码哈希。要生成 密码哈希，请使用如下命令：

$ python3 -c 'import crypt,getpass;pw=getpass.getpass();print(crypt.crypt(pw) if (pw==getpass.getpass("Confirm: ")) else exit())'

使用适当的值替换其他占位符。

输入 name 值，并省略您不需要的任何行。

为每个要包含的用户重复这个块。

5.3.5. 指定附加组

为生成的系统镜像指定一个组。name 和 gid 属性都是必需的。

自定义带有组的蓝图：

[[customizations.group]]
name = "GROUP-NAME"
gid = NUMBER

为每个组重复此块。例如：

[[customizations.group]]
name = "widget"
gid = 1130

5.3.6. 为现有用户设置 SSH 密钥

您可以使用 customizations.sshkey 为最终镜像中的现有用户设置 SSH 密钥。user 和 key 属性是必需的。

通过为现有用户设置 SSH 密钥来自定义蓝图：
```
[[customizations.sshkey]]
user = "root"
key = "PUBLIC-SSH-KEY"
```
例如：
```
[[customizations.sshkey]]
user = "root"
key = "SSH key for root"
```
注意
您只能为现有用户配置 customizations.sshkey 自定义。要创建用户并设置 SSH 密钥，请参阅指定其他用户自定义。

5.3.7. 附加一个内核参数

您可以向引导装载程序内核命令行中附加参数。默认情况下，RHEL 镜像构建器将默认内核构建到镜像中。但是，您可以通过在蓝图中配置它来自定义内核。

在默认值中附加内核引导选项：

[customizations.kernel]
append = "KERNEL-OPTION"

例如：

[customizations.kernel]
name = "kernel-debug"
append = "nosmt=force"

5.3.8. 设置时区和 NTP

您可以自定义蓝图来配置时区和 网络时间协议 (NTP)。timezone 和 ntpservers 属性是可选字符串。如果您没有自定义时区，系统将使用 Universal Time, Coordinated (UTC)。如果您没有设置 NTP 服务器，系统将使用默认发行版。

自定义带有您想要的 timezone 和 ntpservers 的蓝图：
```
[customizations.timezone]
timezone = "TIMEZONE"
ntpservers = "NTP_SERVER"
```
例如：
```
[customizations.timezone]
timezone = "US/Eastern"
ntpservers = ["0.north-america.pool.ntp.org", "1.north-america.pool.ntp.org"]
```
注意
有些镜像类型，如 Google Cloud，已经建立了 NTP 服务器。您无法覆盖它，因为镜像需要 NTP 服务器来在所选环境中引导。但是，您可以在蓝图中自定义时区。

5.3.9. 自定义区域设置

您可以为生成的系统镜像自定义区域设置。language 和 keyboard 属性是必需的。您可以添加许多其他语言。您添加的第一个语言是主语言，其他语言是次要语言。

流程

设置区域设置：

[customizations.locale]
languages = ["LANGUAGE"]
keyboard = "KEYBOARD"

例如：

[customizations.locale]
languages = ["en_US.UTF-8"]
keyboard = "us"

要列出语言支持的值，请运行以下命令：
```
$ localectl list-locales
```
要列出键盘支持的值，请运行以下命令：
```
$ localectl list-keymaps
```

5.3.10. 自定义防火墙

为生成的系统镜像设置防火墙。默认情况下，防火墙阻止进入的连接，但明确启用其端口的服务除外，如 sshd。

如果您不想使用 [customizations.firewall] 或 [customizations.firewall.services]，可以删除属性，或者将它们设置为空列表 []。如果您只想使用默认的防火墙设置，您可以从蓝图中省略自定义。

注意

Google 和 OpenStack 模板为其环境明确禁用防火墙。您无法通过设置蓝图来覆盖此行为。

流程

使用以下设置自定义蓝图，以打开其他端口和服务：
```
[customizations.firewall]
ports = ["PORTS"]
```
其中 ports 是包含要打开的端口或一系列端口和协议的可选字符串列表。您可以使用以下格式配置端口：port:protocol 格式。您可以使用 portA-portB:protocol 格式配置端口范围。例如：
```
[customizations.firewall]
ports = ["22:tcp", "80:tcp", "imap:tcp", "53:tcp", "53:udp", "30000-32767:tcp", "30000-32767:udp"]
```
您可以使用数字端口或 /etc/services 中的名称来启用或禁用端口列表。
在 customizations.firewall.service 部分中指定要启用或禁用哪个防火墙服务：
```
[customizations.firewall.services]
enabled = ["SERVICES"]
disabled = ["SERVICES"]
```
您可以检查可用的防火墙服务：
```
$ firewall-cmd --get-services
```
例如：
```
[customizations.firewall.services]
enabled = ["ftp", "ntp", "dhcp"]
disabled = ["telnet"]
```
注意
firewall.services 中列出的服务与 /etc/services 文件中提供的 service-names 不同。

5.3.11. 启用或禁用服务

您可以控制在引导期间要启用哪些服务。有些镜像类型已经启用或禁用了服务，以确保镜像正常工作，您无法覆盖此设置。蓝图中的 [customizations.services] 设置不会替代这些服务，但可以将服务添加到已在镜像模板中存在的服务列表中。

自定义在引导时要启用哪些服务：

[customizations.services]
enabled = ["SERVICES"]
disabled = ["SERVICES"]

例如：

[customizations.services]
enabled = ["sshd", "cockpit.socket", "httpd"]
disabled = ["postfix", "telnetd"]

5.3.12. 指定自定义文件系统配置

您可以在蓝图中指定自定义文件系统配置，因此创建带有特定磁盘布局的镜像，而不是默认的布局配置。通过使用蓝图中的非默认布局配置，您可以受益于：

安全基准合规性
防止磁盘不足错误
提高的性能
与现有设置的一致性

注意

OSTree 系统不支持文件系统自定义，因为 OSTree 镜像有自己的挂载规则，如只读。不支持以下镜像类型：

image-installer
edge-installer
edge-simplified-installer

另外，以下镜像类型不支持文件系统自定义，因为这些镜像类型不会创建分区的操作系统镜像：

edge-commit
edge-container
tar
container

但是，以下镜像类型支持文件系统自定义：

simplified-installer
edge-raw-image
edge-ami
edge-vsphere

对于 OSTree 系统的一些额外的例外，您可以在文件系统的 /root 级别中选择任意目录名称，例如： ' /local',' /mypartition', /$PARTITION。在逻辑卷中，这些更改在 LVM 分区系统之上进行。支持以下目录： /var、' /var/log' 和 /var/lib/containers。以下是根级别的例外：

"/home": {Deny: true},
"/mnt": {Deny: true},
"/opt": {Deny: true},
"/ostree": {Deny: true},
"/root": {Deny: true},
"/SRV": {Deny: true},
"/var/home": {Deny: true},
"/var/mnt": {Deny: true},
"/var/opt": {Deny: true},
"/var/roothome": {Deny: true},
"/var/srv": {Deny: true},
"/var/usrlocal": {Deny: true},

对于 RHEL 8.10 和 9.5 的发行版本发行版本，蓝图支持以下 挂载点 及其子目录：

/ - root 挂载点
/var
/home
/opt
/srv
/usr
/app
/data
/tmp

在 RHEL 9.5 和 8.10 发行版本中，您可以指定任意自定义挂载点，除了为操作系统保留的特定路径。

您不能对以下挂载点及其子目录指定任意自定义挂载点：

/bin
/boot/efi
/dev
/etc
/lib
/lib64
/lost+found
/proc
/run
/sbin
/sys
/sysroot
/var/lock
/var/run

您可以在蓝图中自定义 /usr 自定义挂载点的文件系统，但不允许其子目录。

注意

从 RHEL 9.0 发行版开始，才支持使用 CLI 自定义挂载点。在之前的发行版本中，您只能将 root 分区指定为挂载点，并将 size 参数指定为镜像大小的别名。

如果您在自定义镜像中有多个分区，您可以在 LVM 上创建带有自定义文件系统分区的镜像，并在运行时调整这些分区大小。要做到这一点，您可以在蓝图中指定自定义文件系统配置，因此请使用所需的磁盘布局创建镜像。默认文件系统布局保持不变 - 如果您使用没有文件系统自定义的普通镜像，cloud-init 会调整 root 分区的大小。

蓝图自动将文件系统自定义转换为 LVM 分区。

您可以使用自定义文件蓝图自定义来创建新文件或替换现有文件。您指定的文件的父目录必须存在，否则镜像构建会失败。通过在 [[customizations.directories]] 自定义中指定它来确保父目录存在。

警告

如果您将文件自定义与其他蓝图自定义相结合，这可能会影响其他自定义的功能，或者可能会覆盖当前的文件自定义。

5.3.12.1. 在蓝图中指定自定义文件

使用 [[customizations.files]] 蓝图自定义，您可以：

创建新文本文件。
修改现有文件。警告：这可能会覆盖现有内容。
为您要创建的文件设置用户和组所有权。
以八进制格式设置模式权限。

您无法创建或替换以下文件：

/etc/fstab
/etc/shadow
/etc/passwd
/etc/group

您可以使用 [[customizations.files]] 和 [[customizations.directories]] 蓝图自定义在镜像中创建自定义文件和目录。您只能在 /etc 目录中使用这些自定义。

注意

这些蓝图自定义被所有镜像类型支持，但部署 OSTree 提交的镜像类型除外，如 edge-raw-image、edge-installer、edge-simplified-installer。

警告

如果您将 customizations.directories 与设置了 mode、user 或 group 的镜像中已存在的目录路径一起使用，则镜像构建无法防止更改现有目录的所有权或权限。

5.3.12.2. 在蓝图中指定自定义目录

使用 [[customizations.directory]] 蓝图自定义，您可以：