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

手順

• 指定の 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 は、実際の 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

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

手順

• 既存ユーザーの 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"]

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

• / - ルートマウントポイント
• /var
• /home
• /opt
• /srv/
• /usr
• /app
• /data
• /boot - ブループリントは、RHEL 8.7 および RHEL 9.1 以降で /boot のカスタマイズをサポートしています。

• 新しいテキストファイルを作成する。
• 既存のファイルを変更する。警告: これにより、既存のコンテンツが上書きされる可能性があります。
• 作成するファイルのユーザーとグループの所有権を設定する。
• モード許可を 8 進数形式で設定する。

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

• 新しいディレクトリーを作成する。
• 作成するディレクトリーのユーザーとグループの所有権を設定する。
• ディレクトリーモードのパーミッションを 8 進数形式で設定する。
• 必要に応じて親ディレクトリーを作成する。

• 新しいテキストファイルを作成する。
• 既存のファイルを変更する。警告: これにより、既存のコンテンツが上書きされる可能性があります。
• 作成するファイルのユーザーとグループの所有権を設定する。
• モード許可を 8 進数形式で設定する。

• /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 - オプション - ディレクトリーのアクセスパーミッションを 8 進数形式で設定します。パーミッションを指定しない場合、デフォルトで 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 - オプション - ファイルのアクセスパーミッションを 8 進数形式で設定します。パーミッションを指定しない場合、デフォルトで 0644 に設定されます。先頭のゼロは任意です。
• user - オプション - ユーザーをファイルの所有者として設定します。ユーザーを指定しない場合は、デフォルトで root に設定されます。ユーザーは文字列または整数として指定できます。
• group - オプション - グループをファイルの所有者として設定します。グループを指定しない場合は、デフォルトで root になります。グループは文字列または整数として指定できます。
• data - オプション - プレーンテキストファイルの内容を指定します。コンテンツを指定しない場合は、空のファイルが作成されます。