5.3. 支持的镜像自定义

流程

• 自定义带有 distro 的蓝图，来始终构建指定的 RHEL 镜像：

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

流程

• 自定义带有软件包的蓝图：

  [[packages]]
  name = "package_group_name"

  将 "package_group_name" 替换为组的名称。例如，"tmux"。

  [[packages]]
  name = "tmux"
  version = "2.9a"

流程

• 自定义蓝图以配置主机名：

  [customizations]
  hostname = "baseimage"

流程

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

  [[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

  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 值，并省略您不需要的任何行。

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

流程

• 自定义带有组的蓝图：

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

  为每个组重复此块。

流程

• 通过为现有用户设置 SSH 密钥来自定义蓝图：

流程

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

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

• 定义一个要在镜像中使用的内核名称

  [customizations.kernel]
  name = "KERNEL-rt"

流程

• 自定义带有您想要的 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 服务器来在所选环境中引导。但是，您可以在蓝图中自定义时区。

流程

• 设置区域设置：

• 要列出语言支持的值，请运行以下命令：

  $ localectl list-locales

• 要列出键盘支持的值，请运行以下命令：

  $ localectl list-keymaps

流程

• 使用以下设置自定义蓝图，以打开其他端口和服务：

  [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 不同。

流程

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

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

  例如：

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

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

• / - root 挂载点
• /var
• /home
• /opt
• /srv
• /usr
• /app
• /data
• /boot - 从 RHEL 8.7 和 RHEL 9.1 开始，蓝图支持 /boot 自定义。

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

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

• 创建新目录。
• 为您要创建的目录设置用户和组所有权。
• 以八进制格式设置目录模式权限。
• 确保根据需要创建父目录。

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

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

流程

• 在蓝图中自定义文件系统配置：

  [[customizations.filesystem]]
  mountpoint = "MOUNTPOINT"
  size = MINIMUM-PARTITION-SIZE

  MINIMUM-PARTITION-SIZE 值没有默认大小格式。蓝图自定义支持以下值和单位：kB 到 TB 以及 KiB 到 TiB。例如，您可以以字节为单位定义挂载点大小：

  [[customizations.filesystem]]
  mountpoint = "/var"
  size = 1073741824

• 使用单位定义挂载点大小。例如：

  [[customizations.filesystem]]
  mountpoint = "/opt"
  size = "20 GiB"

  [[customizations.filesystem]]
  mountpoint = "/boot"
  size = "1 GiB"

• 使用 [[customizations.directories]]，在 /etc 目录下为镜像创建自定义目录：

  [[customizations.directories]]
  path = "/etc/directory_name"
  mode = "octal_access_permission"
  user = "user_string_or_integer"
  group = "group_string_or_integer"
  ensure_parents = boolean

  蓝图条目如下所述：

• path - 必需 - 输入您要创建的目录的路径。它必须是 /etc 目录下的绝对路径。
• mode - 可选 - 以八进制格式设置目录的访问权限。如果没有指定权限，则默认为 0755。前面的零是可选的。
• user - 可选 - 将用户设置为目录的所有者。如果没有指定用户，则默认为 root。您可以将用户指定为字符串或整数。
• group - 可选 - 将组设置为目录的所有者。如果没有指定组，则默认为 root。您可以将组指定为字符串或整数。
• ensure_parents - 可选 - 指定是否要根据需要创建父目录。如果没有指定值，则默认为 false。

• 使用 [[customizations.directories]]，在 /etc 目录下为镜像创建自定义文件：

  [[customizations.files]]
  path = "/etc/directory_name"
  mode = "octal_access_permission"
  user = "user_string_or_integer"
  group = "group_string_or_integer"
  data = "Hello world!"

  蓝图条目如下所述：

• path - 必需 - 输入您要创建的文件的路径。它必须是 /etc 目录下的绝对路径。
• mode 可选 - 以八进制格式设置对文件的访问权限。如果没有指定权限，则默认为 0644。前面的零是可选的。
• user - 可选 - 将用户设置为文件所有者。如果没有指定用户，则默认为 root。您可以将用户指定为字符串或整数。
• group - 可选 - 将组设置为文件所有者。如果没有指定组，则默认为 root。您可以将组指定为字符串或整数。
• data - 可选 - 指定纯文本文件的内容。如果没有指定内容，它会创建一个空文件。