4.8. サポートされているイメージのカスタマイズ

• 指定の 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-8.5"

• パッケージを使用してブループリントをカスタマイズします。

  [[groups]]
  name = "group_name"

  group_name は、グループの名前に置き換えます。たとえば、anaconda-tools です。

  [[groups]]
  name = "anaconda-tools"

• source - 必須フィールド。これは、レジストリーにあるコンテナーイメージへの参照です。この例では、registry.access.redhat.com レジストリーを使用します。タグのバージョンを指定できます。デフォルトのタグバージョンは latest です。
• name - ローカルレジストリー内のコンテナーの名前。
• tls-verify - ブールフィールド。tls-verify ブールフィールドは、Transport Layer Security を制御します。デフォルト値は true です。

• registry.access.redhat.com/ubi9/ubi:latest のコンテナーとホストのコンテナーを埋め込むには、ブループリントに次のカスタマイズを追加します。

  [[containers]]
  source = "registry.access.redhat.com/ubi9/ubi:latest"
  name =  "local-name"
  tls-verify = true
  
  [[containers]]
  source = "localhost/test:latest"
  local-storage = true

• ブループリントをカスタマイズしてホスト名を設定します。

  [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

  [[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 はオプションであり、イメージにすでに存在している必要があります。GID は、必要に応じて、パッケージによって作成されるか、ブループリントによって [[customizations.group]] エントリーを使用して作成されます。

  PASSWORD-HASH は、実際の password hash に置き換えます。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

  追加するすべてのグループにこのブロックを繰り返します。以下に例を示します。

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

• 既存ユーザーの SSH キーを設定してブループリントをカスタマイズします。

  [[customizations.sshkey]]
  user = "root"
  key = "PUBLIC-SSH-KEY"

  以下に例を示します。

  [[customizations.sshkey]]
  user = "root"
  key = "SSH key for root"

  注記

  既存ユーザーに対してのみ、customizations.sshkey カスタマイズを設定できます。ユーザーを作成して SSH キーを設定するには、追加ユーザーの指定 のカスタマイズを参照してください。

• デフォルト設定にカーネルの起動パラメーターオプションを追加します。

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

  以下に例を示します。

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

前提条件

• システムが登録され、RHEL が RHEL for Real Time サブスクリプションに割り当てられている。dnf を使用した RHEL for Real Time のインストール を参照してください。

検証

• イメージから仮想マシンを起動した後、デフォルトのカーネルとして kernel-rt が正しく選択されたイメージがビルドされていることを確認します。

  $ cat /proc/cmdline
  BOOT_IMAGE=(hd0,got3)/vmlinuz-5.14.0-362.24.1..el9_version_.x86_64+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 サーバーを起動する必要があるため、これをオーバーライドすることはできません。ただし、ブループリントでタイムゾーンをカスタマイズできます。

手順

• ロケール設定を行います。

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

  以下に例を示します。

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

• 言語でサポートされている値を一覧表示するには、以下のコマンドを実行します。

  $ 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"]

• auto-lvm: 1 つ以上のファイルシステムのカスタマイズがない限り、RAW パーティションモードを使用します。ある場合は、LVM パーティションモードを使用します。
• lvm: 追加のマウントポイントがない場合でも、常に LVM パーティションモードを使用します。
• raw: マウントポイントが 1 つ以上ある場合でも、RAW パーティションを使用します。

• 次のカスタマイズを使用して、partitioning_mode 変数を使用してブループリントをカスタマイズできます。

  [customizations]
  partitioning_mode = "lvm"

• セキュリティーベンチマークへの準拠
• ディスク外エラーに対する保護
• パフォーマンスの向上
• 既存のセットアップとの整合性

• image-installer
• edge-installer
• edge-simplified-installer

• edge-commit
• edge-container
• tar
• container

• / - ルートマウントポイント
• /var
• /home
• /opt
• /srv/
• /usr
• /app
• /data
• /tmp

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