ホーム
製品
Red Hat Enterprise Linux
8
システムデザインガイド
9.3. RHEL Image Builder CLI を使用したシステムイメージの作成

9.3. RHEL Image Builder CLI を使用したシステムイメージの作成

RHEL Image Builder は、カスタムのシステムイメージを作成するツールです。RHEL Image Builder を制御し、カスタムシステムイメージを作成するには、コマンドライン (CLI) または Web コンソールインターフェイスを使用できます。

9.3.1. RHEL Image Builder コマンドラインインターフェイスの紹介
リンクのコピー

RHEL Image Builder コマンドラインインターフェイス (CLI) を使用してブループリントを作成するには、適切なオプションとサブコマンドを指定して composer-cli コマンドを実行します。

コマンドラインのワークフローの概要は次のとおりです。

ブループリントを作成するか、既存のブループリント定義をプレーンテキストファイルにエクスポート (保存) します。
テキストエディターでこのファイルを編集します。
ブループリントテキストファイルを Image Builder にインポートします。
Compose を実行して、ブループリントからイメージをビルドします。
イメージファイルをエクスポートしてダウンロードします。

composer-cli コマンドには、ブループリントを作成する基本的なサブコマンドとは別に、設定したブループリントと Compose の状態を調べるための多くのサブコマンドが用意されています。

9.3.2. RHEL Image Builder を非 root ユーザーとして使用する
リンクのコピー

非 root として composer-cli コマンドを実行するには、ユーザーが weldr グループに属している必要があります。

前提条件

ユーザーを作成している。

手順

ユーザーを weldr または root グループに追加するには、次のコマンドを実行します:
```
$ sudo usermod -a -G weldr user
$ newgrp weldr
```

9.3.3. コマンドラインを使用したブループリントの作成
リンクのコピー

RHEL Image Builder のコマンドラインインターフェイス (CLI) を使用して、新しいブループリントを作成できます。ブループリントには、最終的なイメージと、パッケージやカーネルのカスタマイズなどのそのカスタマイズが記述されています。

前提条件

root ユーザーまたは weldr グループのメンバーであるユーザーとしてログインしている。

手順

次の内容のプレーンテキストファイルを作成します。
```
name = "BLUEPRINT-NAME"
description = "LONG FORM DESCRIPTION TEXT"
version = "0.0.1"
modules = []
groups = []
```
BLUEPRINT-NAME および LONG FORM DESCRIPTION TEXT は、ブループリントの名前および説明に置き換えます。
0.0.1 は、セマンティックバージョニングスキームに従ってバージョン番号に置き換えます。
ブループリントに含まれるすべてのパッケージに、次の行をファイルに追加します。
```
[[packages]]
name = "package-name"
version = "package-version"
```
package-name は、httpd、gdb-doc、coreutils などのパッケージ名に置き換えます。
必要に応じて、package-version を使用するバージョンに置き換えます。このフィールドは、dnf バージョンの指定に対応します。
- 特定のバージョンについては、8.7.0 などの正確なバージョン番号を使用してください。
- 利用可能な最新バージョンについては、アスタリスク * を使用してください。
- 最新のマイナーバージョンを指定する場合は、8.* などの形式を使用してください。
ニーズに合わせてブループリントをカスタマイズします。たとえば、Simultaneous Multi Threading (SMT) を無効にするには、ブループリントファイルに次の行を追加します。
```
[customizations.kernel]
append = "nosmt=force"
```
その他に利用できるカスタマイズについては、サポートされているイメージのカスタマイズを参照してください。
[] と [[]] は TOML で表現される異なるデータ構造であることに注意してください。
- [customizations.kernel] ヘッダーは、キーと各値のペアの集合によって定義される単一のテーブルを表します (例: append = "nosmt=force")。
- [[packages]] ヘッダーはテーブルの配列を表します。最初のインスタンスで、配列とその最初のテーブル要素を定義します (例: name = "package-name"、version = "package-version")。後続の各インスタンスで、指定の順序で、その配列内に新しいテーブル要素を作成して定義します。
たとえば、ファイルを BLUEPRINT-NAME.toml として保存し、テキストエディターを閉じます。
オプション: Blueprint TOML ファイルのすべての設定が正しく解析されているかどうかを確認します。ブループリントを保存し、保存した出力を入力ファイルと比較します。
```
# composer-cli blueprints save BLUEPRINT-NAME.toml
```
1. 保存した BLUEPRINT-NAME.toml ファイルを入力ファイルと比較します。
ブループリントをプッシュします。
```
# composer-cli blueprints push BLUEPRINT-NAME.toml
```
BLUEPRINT-NAME は、前の手順で使用した値に置き換えます。
注記
composer-cli を非 root として使用してイメージを作成するには、ユーザーを weldr または root グループに追加します。
# usermod -a -G weldr user $ newgrp weldr

検証

ブループリントがプッシュされ存在していることを確認するには、既存のブループリントを一覧表示します。
```
# composer-cli blueprints list
```
追加したばかりのブループリント設定を表示します。
```
# composer-cli blueprints show BLUEPRINT-NAME
```
ブループリントに記載されているコンポーネントおよびバージョンと、その依存関係が有効かどうかを確認します。
```
# composer-cli blueprints depsolve BLUEPRINT-NAME
```
RHEL Image Builder がカスタムリポジトリーのパッケージの依存関係を解決できない場合は、osbuild-composer キャッシュを削除します。3
```
$ sudo rm -rf /var/cache/osbuild-composer/*
$ sudo systemctl restart osbuild-composer
```

9.3.4. コマンドラインを使用したブループリントの編集
リンクのコピー

コマンドライン (CLI) で既存のブループリントを編集して、たとえば、新しいパッケージを追加したり、新しいグループを定義したり、カスタマイズしたイメージを作成したりできます。

前提条件

ブループリントを作成している。

手順

既存のブループリントをリストします。
```
# composer-cli blueprints list
```
ブループリントをローカルテキストファイルに保存します。
```
# composer-cli blueprints save BLUEPRINT-NAME
```
BLUEPRINT-NAME .toml ファイルをテキストエディターで編集し、変更を加えます。
編集を完了する前に、ファイルが有効なブループリントであることを確認します。
1. ブループリントに次の行が存在する場合は、それを削除します。
  packages = []
2. たとえば、バージョン番号を 0.0.1 から 0.1.0 に増やします。RHEL Image Builder のブループリントバージョンでは、セマンティックバージョニングスキームを使用する必要があります。また、バージョンを変更しない場合、パッチバージョンコンポーネントが自動的に増加することにも注意してください。
ファイルを保存し、テキストエディターを閉じます。
ブループリントを RHEL Image Builder にプッシュして戻します。
```
# composer-cli blueprints push BLUEPRINT-NAME.toml
```
注記
ブループリントを RHEL Image Builder にインポートして戻すには、.toml 拡張子を含むファイル名を指定しますが、他のコマンドではブループリント名のみを使用します。

検証

RHEL Image Builder にアップロードした内容が編集内容と一致することを確認するには、ブループリントの内容をリストします。
```
# composer-cli blueprints show BLUEPRINT-NAME
```
ブループリントに記載されているコンポーネントおよびバージョンと、その依存関係が有効かどうかを確認します。
```
# composer-cli blueprints depsolve BLUEPRINT-NAME
```

9.3.5. RHEL Image Builder コマンドラインでのシステムイメージの作成
リンクのコピー

RHEL Image Builder のコマンドラインインターフェイスを使用して、カスタマイズした RHEL イメージをビルドできます。そのためには、ブループリントとイメージタイプを指定する必要があります。必要に応じて、ディストリビューションを指定することもできます。ディストリビューションを指定しない場合は、ホストシステムと同じディストリビューションとバージョンが使用されます。アーキテクチャーもホストのアーキテクチャーと同じになります。

前提条件

イメージにブループリントを用意している。コマンドラインを使用して RHEL Image Builder ブループリントを作成するを参照してください。

手順

オプション: 作成できるイメージ形式をリストします。
```
# composer-cli compose types
```
Compose を起動します。
```
# composer-cli compose start BLUEPRINT-NAME IMAGE-TYPE
```
BLUEPRINT-NAME をブループリントの名前に、IMAGE-TYPE をイメージのタイプに置き換えます。使用可能な値は、composer-cli compose types コマンドの出力を参照してください。
作成プロセスはバックグラウンドで開始され、作成者の Universally Unique Identifier (UUID) が表示されます。
イメージの作成が完了するまでに最大 10 分かかる場合があります。
Compose のステータスを確認するには、以下のコマンドを実行します。
```
# composer-cli compose status
```
Compose が完了すると、ステータスが FINISHED になります。リスト内の Compose を識別するには、その UUID を使用します。
Compose プロセスが完了したら、作成されたイメージファイルをダウンロードします。
```
# composer-cli compose image UUID
```
UUID は、前の手順で示した UUID 値に置き換えます。

検証

イメージを作成した後、次のコマンドを使用してイメージ作成の進行状況を確認できます。

イメージのメタデータをダウンロードして、Compose 用のメタデータの .tar ファイルを取得します。
```
$ sudo composer-cli compose metadata UUID
```
イメージのログをダウンロードします。
```
$ sudo composer-cli compose logs UUID
```
このコマンドは、イメージ作成のログを含む .tar ファイルを作成します。ログが空の場合は、ジャーナルを確認できます。
ジャーナルを確認してください。
```
$ journalctl | grep osbuild
```
イメージのマニフェストを確認します。
```
$ sudo cat /var/lib/osbuild-composer/jobs/job_UUID.json
```
ジャーナルで job_UUID .json を見つけることができます。

9.3.6. RHEL Image Builder コマンドラインの基本的なコマンド
リンクのコピー

RHEL Image Builder コマンドラインインターフェイスでは、以下のサブコマンドを利用できます。

ブループリント操作

利用可能なブループリント一覧の表示

# composer-cli blueprints list

TOML 形式でブループリントの内容の表示

# composer-cli blueprints show <BLUEPRINT-NAME>

TOML 形式のブループリントの内容を BLUEPRINT-NAME.toml ファイルに保存 (エクスポート)

# composer-cli blueprints save <BLUEPRINT-NAME>

ブループリントの削除

# composer-cli blueprints delete <BLUEPRINT-NAME>

TOML 形式のブループリントファイルを RHEL Image Builder へプッシュ (インポート)

# composer-cli blueprints push <BLUEPRINT-NAME>

ブループリントでイメージの設定

利用可能なイメージタイプをリスト表示します。

# composer-cli compose types

Compose の起動

# composer-cli compose start <BLUEPRINT> <COMPOSE-TYPE>

Compose のリスト表示

# composer-cli compose list

Compose、およびそのステータスのリスト表示

# composer-cli compose status

実行中の Compose のキャンセル

# composer-cli compose cancel <COMPOSE-UUID>

完了した Compose の削除

# composer-cli compose delete <COMPOSE-UUID>

Compose の詳細情報の表示

# composer-cli compose info <COMPOSE-UUID>

Compose のイメージファイルのダウンロード

# composer-cli compose image <COMPOSE-UUID>

サブコマンドとオプションをもっと見る

# composer-cli help

9.3.7. RHEL Image Builder のブループリント形式
リンクのコピー

RHEL Image Builder のブループリントは、TOML 形式のプレーンテキストとしてユーザーに表示されます。

一般的なブループリントファイルの要素には、次のものが含まれます。

ブループリントのメタデータ

name = "<BLUEPRINT-NAME>"
description = "<LONG FORM DESCRIPTION TEXT>"
version = "<VERSION>"

BLUEPRINT-NAME および LONG FORM DESCRIPTION TEXT フィールドは、ブループリントの名前と説明です。

VERSION は、セマンティックバージョニングスキームに従ったバージョン番号であり、ブループリントファイル全体で 1 つだけ存在するものです。

イメージに追加するグループ

[[groups]]
name = "group-name"

group エントリーは、イメージにインストールするパッケージのグループを説明します。グループは、次のパッケージカテゴリーを使用します。

必須
デフォルト
任意
group-name は、anaconda-tools、widget、wheel または users などのグループの名前です。ブループリントは、必須パッケージとデフォルトパッケージをインストールします。オプションパッケージを選択するメカニズムはありません。

イメージに追加するパッケージ

[[packages]]
name = "<package-name>"
version = "<package-version>"

package-name は、httpd、gdb-doc、または coreutils などのパッケージの名前です。

package-version は使用するバージョンです。このフィールドは、dnf バージョンの指定に対応します。

特定のバージョンについては、8.7.0 などの正確なバージョン番号を使用してください。
利用可能な最新バージョンを指定する場合は、アスタリスク (*) を使用します。
最新のマイナーバージョンの場合は、8.* などの形式を使用します。
追加するすべてのパッケージにこのブロックを繰り返します。

注記

RHEL Image Builder ツールのパッケージとモジュールの間に違いはありません。どちらも RPM パッケージの依存関係として扱われます。

9.3.8. サポートされているイメージのカスタマイズ
リンクのコピー

ブループリントに次のようなカスタマイズを追加することで、イメージをカスタマイズできます。

RPM パッケージの追加
サービスの有効化
カーネルコマンドラインパラメーターのカスタマイズ

とりわけ、ブループリント内ではいくつかのイメージのカスタマイズを使用できます。カスタマイズを使用すると、デフォルトのパッケージでは使用できないパッケージやグループをイメージに追加できます。これらのオプションを使用するには、ブループリントでカスタマイズを設定し、それを RHEL Image Builder にインポート (プッシュ) します。

9.3.8.1. ディストリビューションの選択
リンクのコピー

distro フィールドを使用して、イメージを作成するときやブループリント内の依存関係を解決するときに使用するディストリビューションを指定できます。distro フィールドが空白のままの場合、ブループリントはホストのオペレーティングシステムディストリビューションを自動的に使用します。ディストリビューションを指定しない場合、ブループリントはホストディストリビューションを使用します。ホストオペレーティングシステムをアップグレードすると、指定されたディストリビューションがないブループリントは、アップグレードされたオペレーティングシステムのバージョンを使用してイメージをビルドします。

新しいシステムで古いメジャーバージョンのイメージをビルドできます。たとえば、RHEL 10 ホストを使用して、RHEL 9 および RHEL 8 のイメージを作成できます。ただし、古いシステムで新しいメジャーバージョンのイメージをビルドすることはできません。

重要

RHEL Image Builder ホストとは異なるオペレーティングシステムイメージをビルドすることはできません。たとえば、RHEL システムを使用して Fedora または CentOS のイメージをビルドすることはできません。

指定の 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 8.10 イメージをビルドする場合は、distro = "rhel-810" を使用します。RHEL 8.10 イメージでは、RHEL 8.9 以前のリリースなどのマイナーバージョンをビルドできます。

9.3.8.2. パッケージグループの選択
リンクのコピー

パッケージグループを使用してブループリントをカスタマイズします。イメージにインストールするパッケージのグループを、groups リストに記述します。パッケージグループはリポジトリーのメタデータで定義されます。各グループには、主にユーザーインターフェイスでの表示に使用されるわかりやすい名前と、キックスタートファイルでよく使用される ID があります。この場合、ID を使用してグループをリストする必要があります。グループでは、必須、デフォルト、任意の 3 つの方法でパッケージを分類できます。ブループリントには、必須パッケージとデフォルトパッケージのみがインストールされます。任意のパッケージを選択することはできません。

name 属性は、必須の文字列であり、リポジトリー内のパッケージグループ ID と正確に一致する必要があります。

注記

現在、osbuild-composer のパッケージとモジュールの間に違いはありません。どちらも RPM パッケージの依存関係として扱われます。

パッケージを使用してブループリントをカスタマイズします。
```
[[groups]]
name = "group_name"
```
group_name は、グループの名前に置き換えます。たとえば、anaconda-tools です。
```
[[groups]]
name = "anaconda-tools"
```

9.3.8.3. コンテナーの埋め込み
リンクのコピー

ブループリントをカスタマイズして、最新の RHEL コンテナーを埋め込むことができます。ソースを含むオブジェクトと、必要に応じて tls-verify 属性をコンテナーリストに含めます。

イメージに埋め込むコンテナーイメージを、コンテナーリストのエントリーに記述します。

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

埋め込まれたコンテナーは自動的に起動しません。これを起動するには、systemd ユニットファイルまたは quadlets を作成し、ファイルをカスタマイズします。

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

containers-auth.json ファイルを使用して、保護されたコンテナーリソースにアクセスできます。コンテナーレジストリーの認証情報を参照してください。

9.3.8.4. イメージのホスト名の設定
リンクのコピー

customizations.hostname は、最終イメージのホスト名を設定するために使用できるオプションの文字列です。このカスタマイズはオプションであり、設定しない場合、ブループリントはデフォルトのホスト名を使用します。

ブループリントをカスタマイズしてホスト名を設定します。
```
[customizations]
hostname = "baseimage"
```

9.3.8.5. 追加ユーザーの指定
リンクのコピー

ユーザーをイメージに追加し、必要に応じて 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 はオプションであり、イメージにすでに存在している必要があります。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 の値を入力し、不要な行は省略します。
追加するすべてのユーザーにこのブロックを繰り返します。

9.3.8.6. 追加グループの指定
リンクのコピー

作成されるシステムイメージのグループを指定します。name 属性と gid 属性は両方とも必須です。

グループを使用してブループリントをカスタマイズします。
```
[[customizations.group]]
name = "GROUP-NAME"
gid = NUMBER
```
追加するすべてのグループにこのブロックを繰り返します。以下に例を示します。
```
[[customizations.group]]
name = "widget"
gid = 1130
```

9.3.8.7. 既存ユーザーの 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 キーを設定するには、追加ユーザーの指定のカスタマイズを参照してください。

9.3.8.8. カーネル引数の追加
リンクのコピー

ブートローダーのカーネルコマンドラインに引数を追加できます。デフォルトでは、RHEL Image Builder はデフォルトのカーネルをイメージにビルドします。ただし、ブループリントでカーネルを設定することでカーネルをカスタマイズできます。

デフォルト設定にカーネルの起動パラメーターオプションを追加します。
```
[customizations.kernel]
append = "KERNEL-OPTION"
```
以下に例を示します。
```
[customizations.kernel]
name = "kernel-debug"
append = "nosmt=force"
```

9.3.8.9. リアルタイムカーネルを使用した RHEL イメージのビルド
リンクのコピー

リアルタイムカーネル (kernel-rt) を使用して RHEL イメージをビルドするには、デフォルトカーネルとして kernel-rt が正しく選択されたイメージをビルドできるように、リポジトリーをオーバーライドする必要があります。/usr/share/osbuild-composer/repositories/ ディレクトリーの .json を使用してください。その後、ビルドしたイメージをシステムにデプロイし、リアルタイムカーネル機能を使用できます。

注記

リアルタイムカーネルは、Red Hat Enterprise Linux の動作認定を受けた AMD64 および Intel 64 サーバープラットフォームで動作します。

前提条件

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

手順

以下のディレクトリーを作成します。
```
# mkdir /etc/osbuild-composer/repositories/
```
/usr/share/osbuild-composer/repositories/rhel-8.version.json ファイルの内容を新しいディレクトリーにコピーします。
```
# cp /usr/share/osbuild-composer/repositories/rhel-8.version.json /etc/osbuild-composer/repositories
```

/etc/osbuild-composer/repositories/rhel-8.version.json ファイルを編集して、RT カーネルリポジトリーを含めます。

# grep -C 6 kernel-rt /etc/osbuild-composer/repositories/rhel-8.version.json
      "baseurl": "https://cdn.redhat.com/content/dist/rhel8/8.version/x86_64/appstream/os",
      "gpgkey": "-----BEGIN PGP PUBLIC KEY BLOCK-----\n\nm………..=\n=UZd/\n-----END PGP PUBLIC KEY BLOCK-----\n",
      "rhsm": true,
      "check_gpg": true
    },
    {
      "name": "kernel-rt",
      "baseurl": "https://cdn.redhat.com/content/dist/rhel8/8.version/x86_64/rt/os",
      "gpgkey": "-----BEGIN PGP PUBLIC KEY BLOCK-----\n\nmQINBEr………fg==\n=UZd/\n-----END PGP PUBLIC KEY BLOCK-----\n",
      "rhsm": true,
      "check_gpg": true
    },

サービスを再起動します。
```
# systemctl restart osbuild-composer
```
kernel-rt が .json ファイルに含まれていることを確認します。
```
# composer-cli sources list
# composer-cli sources info kernel-rt
```
以前に設定した URL が表示されます。

ブループリントを作成します。ブループリントに、"[customizations.kernel]" カスタマイズを追加します。以下は、ブループリントに "[customizations.kernel]" を追加した例です。

name = "rt-kernel-image"
description = ""
version = "2.0.0"
modules = []
groups = []
distro = "rhel-8_version_"
[[customizations.user]]
name = "admin"
password = "admin"
groups = ["users", "wheel"]
[customizations.kernel]
name = "kernel-rt"
append = ""

ブループリントをサーバーにプッシュします。
```
# composer-cli blueprints push rt-kernel-image.toml
```
作成したブループリントからイメージをビルドします。次の例では、(.qcow2) イメージをビルドします。
```
# composer-cli compose start rt-kernel-image qcow2
```
ビルドしたイメージを、リアルタイムカーネル機能を使用するシステムにデプロイします。

検証

イメージから仮想マシンを起動した後、デフォルトのカーネルとして kernel-rt が正しく選択されたイメージがビルドされていることを確認します。
```
$ cat /proc/cmdline
BOOT_IMAGE=(hd0,got3)/vmlinuz-5.14.0-362.24.1..el8_version_.x86_64+rt...
```

9.3.8.10. タイムゾーンと NTP の設定
リンクのコピー

ブループリントをカスタマイズして、タイムゾーンと Network Time Protocol (NTP) を設定できます。timezone 属性と ntpservers 属性は両方ともオプションの文字列です。タイムゾーンをカスタマイズしない場合、システムは 協定世界時 (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 サーバーを起動する必要があるため、これをオーバーライドすることはできません。ただし、ブループリントでタイムゾーンをカスタマイズできます。

9.3.8.11. ロケール設定のカスタマイズ
リンクのコピー

作成されるシステムイメージのロケール設定をカスタマイズできます。language 属性と keyboard 属性は両方とも必須です。他の多くの言語を追加できます。最初に追加する言語はプライマリー言語で、他の言語はセカンダリー言語です。

手順

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

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

以下に例を示します。

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

言語でサポートされている値を一覧表示するには、以下のコマンドを実行します。
```
$ localectl list-locales
```
キーボードでサポートされている値を一覧表示するには、以下のコマンドを実行します。
```
$ localectl list-keymaps
```

9.3.8.12. ファイアウォールのカスタマイズ
リンクのコピー

生成されたシステムイメージのファイアウォールを設定します。デフォルトでは、ファイアウォールは、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 とは異なります。

9.3.8.13. サービスの有効化または無効化
リンクのコピー

システムの起動時に有効にするサービスを制御することができます。一部のイメージタイプでは、イメージが正しく機能するようにすでにサービスが有効または無効になっており、このセットアップをオーバーライドすることができません。ブループリントの [customizations.services] 設定はこれらのサービスを置き換えるものではありませんが、イメージテンプレートにすでに存在するサービスのリストにサービスを追加します。

起動時に有効にするサービスをカスタマイズします。

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

以下に例を示します。

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

9.3.8.14. キックスタートファイルへの ISO イメージの注入
リンクのコピー

[customization.installer] ブループリントのカスタマイズを使用すると、イメージインストーラー や エッジインストーラー などの ISO インストーラーのビルドに独自のキックスタートファイルを追加して、ベアメタルデプロイメント用の ISO イメージを構築する際の柔軟性を高めることができます。

警告

キックスタートはシステム上の最初のディスクを自動的に再フォーマットするように設定されています。そのため、既存のオペレーティングシステムまたはデータを有するマシンで ISO を起動すると、破壊的な結果を招く可能性があります。

次の中から、独自のキックスタートファイルを追加する方法を選択できます。

インストールプロセス中にすべての値を設定する。
キックスタートで unattended = true フィールドを有効にし、デフォルト設定を使用した完全に無人のインストールを実行する。
キックスタートフィールドを使用して独自のキックスタートを注入する。これにより、すべての必須フィールドを指定した場合に完全に無人のインストールが実行されるか、またはインストーラーが欠落している可能性のあるいくつかのフィールドの入力を要求することになります。

Anaconda インストーラーの ISO イメージタイプでは、次のブループリントのカスタマイズがサポートされています。

[customizations.installer]
unattended = true
sudo-nopasswd = ["user", "%wheel"]

無人:インストールを完全に自動化するキックスタートファイルを作成します。これには、デフォルトで次のオプションの設定が含まれます。

テキスト表示モード
en_US.UTF-8 言語/ロケール
US キーボードレイアウト
UTC タイムゾーン
zerombr、clearpart、autopart による最初のディスクの自動的なワイプおよびパーティション設定
DHCP と自動アクティブ化を有効にするネットワークオプション

以下に例を示します。

liveimg --url file:///run/install/<_repo_>/liveimg.tar.gz
lang en_US.UTF-8
keyboard us
timezone UTC
zerombr
clearpart --all --initlabel
text
autopart --type=plain --fstype=xfs --nohome
reboot --eject
network --device=link --bootproto=dhcp --onboot=on --activate

sudo-nopasswd:インストール後に /etc/sudoers.d にドロップインファイルを作成し、指定されたユーザーとグループがパスワードなしで sudo を実行できるようにするスニペットをキックスタートファイルに追加します。グループには % という接頭辞を付ける必要があります。たとえば、値を ["user", "%wheel"] に設定すると、次のようなキックスタートの %post セクションが作成されます。

%post
echo -e "user\tALL=(ALL)\tNOPASSWD: ALL" > "/etc/sudoers.d/user"
chmod 0440 /etc/sudoers.d/user
echo -e "%wheel\tALL=(ALL)\tNOPASSWD: ALL" > "/etc/sudoers.d/%wheel"
chmod 0440 /etc/sudoers.d/%wheel
restorecon -rvF /etc/sudoers.d
%end

インストーラーキックスタート

または、次のカスタマイズを使用して、カスタムのキックスタートを含めることもできます。

[customizations.installer.kickstart]
contents = """
text --non-interactive
zerombr
clearpart --all --initlabel --disklabel=gpt
autopart --noswap --type=lvm
network --bootproto=dhcp --device=link --activate --onboot=on
"""

osbuild-composer を使用すると、image-installer または edge-installer イメージタイプに関連する場合に、システムをインストールするコマンド liveimg または ostreesetup が自動的に追加されます。[customizations.installer.kickstart] によるカスタマイズを、他のインストーラーカスタマイズと組み合わせて使用することはできません。

9.3.8.15. パーティションモードの指定
リンクのコピー

ビルドするディスクイメージをパーティション設定する方法を選択するには、partitioning_mode 変数を使用します。サポートされている次のモードでイメージをカスタマイズできます。

auto-lvm: 1 つ以上のファイルシステムのカスタマイズがない限り、RAW パーティションモードを使用します。ある場合は、LVM パーティションモードを使用します。
lvm: 追加のマウントポイントがない場合でも、常に LVM パーティションモードを使用します。
raw: マウントポイントが 1 つ以上ある場合でも、RAW パーティションを使用します。
次のカスタマイズを使用して、partitioning_mode 変数を使用してブループリントをカスタマイズできます。
```
[customizations]
partitioning_mode = "lvm"
```

9.3.8.16. カスタムファイルシステム設定の指定
リンクのコピー

ブループリントでカスタムファイルシステム設定を指定できるため、デフォルトのレイアウト設定ではなく、特定のディスクレイアウトでイメージを作成できます。ブループリントでデフォルト以外のレイアウト設定を使用すると、次の利点が得られます。

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

注記

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 ディレクトリーがサポートされています。root レベルでの例外は次のとおりです。

"/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 より前のリリースディストリビューションの場合、ブループリントは次の mountpoints とそのサブディレクトリーをサポートしています。

/ - ルートマウントポイント
/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 8.5 ディストリビューション以降、CLI を使用した場合のみサポートされます。以前のディストリビューションでは、root パーティションをマウントポイントとして指定し、size 引数をイメージ size のエイリアスとして指定することしかできません。RHEL 8.6 以降、osbuild-composer-46.1-1.el8 RPM 以降のバージョンでは、物理パーティションは使用できなくなり、ファイルシステムのカスタマイズによって論理ボリュームが作成されます。

カスタマイズされたイメージに複数のパーティションがある場合、LVM でカスタマイズされたファイルシステムパーティションを使用してイメージを作成し、実行時にそれらのパーティションのサイズを変更できます。これを行うには、ブループリントでカスタマイズされたファイルシステム設定を指定して、必要なディスクレイアウトでイメージを作成します。デフォルトのファイルシステムレイアウトは変更されません。ファイルシステムをカスタマイズせずにプレーンイメージを使用すると、cloud-init によってルートパーティションのサイズが変更されます。

ブループリントは、ファイルシステムのカスタマイズを LVM パーティションに自動的に変換します。

カスタムファイルブループリントのカスタマイズを使用して、新しいファイルを作成したり、既存のファイルを置き換えたりできます。指定するファイルの親ディレクトリーが存在している必要があります。存在しない場合、イメージのビルドが失敗します。[[customizations.directories]] のカスタマイズで親ディレクトリーを指定して、親ディレクトリーが存在することを確認してください。

警告

ファイルのカスタマイズを他のブループリントのカスタマイズと組み合わせると、他のカスタマイズの機能に影響が生じたり、現在のファイルのカスタマイズがオーバーライドされる可能性があります。

9.3.8.16.1. カスタマイズされたファイルをブループリントで指定する
リンクのコピー

[[customizations.files]] ブループリントのカスタマイズを使用すると、次のことが可能になります。

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

以下のファイルは作成または置き換えることはできません。

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

[[customizations.files]] および [[customizations.directories]] ブループリントのカスタマイズを使用して、イメージ内にカスタマイズされたファイルとディレクトリーを作成できます。これらのカスタマイズは、/etc ディレクトリーでのみ使用できます。

注記

これらのブループリントのカスタマイズは、OSTree コミットをデプロイするイメージタイプ (edge-raw-image、edge-installer、edge-simplified-installer など) を除く、すべてのイメージタイプでサポートされます。

警告

mode、user、または group がすでに設定されているイメージ内にすでに存在するディレクトリーパスで customizations.directories を使用すると、イメージビルドで既存のディレクトリーの所有権または権限の変更を防ぐことができません。

9.3.8.16.2. カスタマイズされたディレクトリーをブループリントで指定する
リンクのコピー

[[customizations.directories]] ブループリントのカスタマイズを使用すると、以下を行うことができます。

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

[[customizations.files]] ブループリントのカスタマイズを使用すると、次のことが可能になります。

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

注記

以下のファイルは作成または置き換えることはできません。

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

以下のカスタマイズが可能です。

ブループリントのファイルシステム設定をカスタマイズします。
```
[[customizations.filesystem]]
mountpoint = "MOUNTPOINT"
minsize = MINIMUM-PARTITION-SIZE
```
MINIMUM-PARTITION-SIZE 値には、デフォルトのサイズ形式はありません。ブループリントのカスタマイズでは、kB から TB、および KiB から TiB の値と単位がサポートされています。たとえば、マウントポイントのサイズをバイト単位で定義できます。
```
[[customizations.filesystem]]
mountpoint = "/var"
minsize = 1073741824
```

単位を使用してマウントポイントのサイズを定義します。以下に例を示します。

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

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

minsize を設定して最小パーティションを定義します。以下に例を示します。
```
[[customizations.filesystem]]
mountpoint = "/var"
minsize = 2147483648
```
[[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 - オプション - プレーンテキストファイルの内容を指定します。コンテンツを指定しない場合は、空のファイルが作成されます。

9.3.8.17. ブループリントでボリュームグループと論理ボリュームの命名を指定する
リンクのコピー

RHEL Image Builder は次の操作に使用できます。

高度なパーティションレイアウトを使用して RHEL ディスクイメージを作成します。カスタムのマウントポイント、LVM ベースのパーティション、LVM ベースの SWAP を使用してディスクイメージを作成できます。たとえば、config.toml ファイルを使用して、/ および /boot ディレクトリーのサイズを変更できます。
使用するファイルシステムを選択します。ext4 と xfs のどちらかを選択できます。
スワップパーティションと LV を追加します。ディスクイメージに LV ベースの SWAP を含めることができます。
LVM エンティティーの名前を変更します。イメージ内の論理ボリューム (LV) とボリュームグループ (VG) にカスタム名を付けることができます。

次のオプションはサポートされていません。

1 つのイメージに複数の PV または VG を含める
SWAP ファイル
/dev/shm や /tmp などの非物理パーティションのマウントオプション

たとえば、以下のようになります。ファイルシステムが存在する VG および LG カスタマイズ名を追加します。

[[customizations.disk.partitions]]
type = "plain"
label = "data"
mountpoint = "/data"
fs_type = "ext4"
minsize = "50 GiB"

[[customizations.disk.partitions]]
type = "lvm"
name = "mainvg"
minsize = "20 GiB"

[[customizations.disk.partitions.logical_volumes]]
name = "rootlv"
mountpoint = "/"
label = "root"
fs_type = "ext4"
minsize = "2 GiB"

[[customizations.disk.partitions.logical_volumes]]
name = "homelv"
mountpoint = "/home"
label = "home"
fs_type = "ext4"
minsize = "2 GiB"

[[customizations.disk.partitions.logical_volumes]]
name = "swaplv"
fs_type = "swap"
minsize = "1 GiB"

9.3.9. RHEL Image Builder によってインストールされるパッケージ
リンクのコピー

RHEL Image Builder を使用してシステムイメージを作成すると、システムは一連のベースパッケージグループをインストールします。

注記

ブループリントにコンポーネントを追加する場合は、追加したコンポーネント内のパッケージが他のパッケージコンポーネントと競合しないようにしてください。そうしないと、システムは依存関係を解決できず、カスタマイズされたイメージの作成に失敗します。次のコマンドを実行して、パッケージ間に競合がないかどうかを確認できます。

# composer-cli blueprints depsolve BLUEPRINT-NAME

デフォルトでは、RHEL Image Builder は Core グループをパッケージの基本リストとして使用します。

Expand

表9.3 イメージタイプの作成をサポートするデフォルトパッケージ
イメージタイプ	デフォルトパッケージ
`ami`	`checkpolicy、chrony、cloud-init、cloud-utils-growpart、@Core、dhcp-client、gdisk、insights-client、kernel、langpacks-en、net-tools、NetworkManager、redhat-release、redhat-release-eula、rng-tools、rsync、selinux-policy-targeted、tar、yum-utils`
`openstack`	`@core､langpacks-en`
`qcow2`	`@core, chrony, dnf, kernel, yum, nfs-utils, dnf-utils, cloud-init, python3-jsonschema, qemu-guest-agent, cloud-utils-growpart, dracut-norescue, tar, tcpdump, rsync, dnf-plugin-spacewalk, rhn-client-tools, rhnlib, rhnsd, rhn-setup, NetworkManager, dhcp-client, cockpit-ws, cockpit-system, subscription-manager-cockpit, redhat-release, redhat-release-eula, rng-tools, insights-client`
`tar`	`policycoreutils、selinux-policy-targeted`
`vhd`	`@core､langpacks-en`
`vmdk`	`@core、chrony、cloud-init、firewalld、langpacks-en、open-vm-tools、selinux-policy-targeted`
`edge-commit`	`redhat-release`、`glibc`、`glibc-minimal-langpack`、`nss-altfiles`、`dracut-config-generic`、`dracut-network`、`basesystem`、`bash`、`platform-python`、`shadow-utils`、`chrony`、`setup`、`shadow-utils`、`sudo`、`systemd`、`coreutils`、`util-linux`、`curl`、`vim-minimal`、`rpm`、`rpm-ostree`、`polkit`、`lvm2`、`cryptsetup`、`pinentry`、`e2fsprogs`、`dosfstools`、`keyutils`、`gnupg2`、`attr`、`xz`、`gzip`、`firewalld`、`iptables`、`NetworkManager`、`NetworkManager-wifi`、`NetworkManager-wwan`、`wpa_supplicant`、`traceroute`、`hostname`、`iproute`、`iputils`、`openssh-clients`、`procps-ng`、`rootfiles`、`openssh-server`、`passwd`、`policycoreutils`、`policycoreutils-python-utils`、`selinux-policy-targeted`、`setools-console`、`less`、`tar`、`rsync`、`usbguard`、`bash-completion`、`tmux`、`ima-evm-utils`、`audit`、`podman`、`containernetworking-plugins`、`container-selinux`、`skopeo`、`criu`、`slirp4netns`、`fuse-overlayfs`、`clevis`、`clevis-dracut`、`clevis-luks`、`greenboot`、`greenboot-default-health-checks`、`fdo-client`、`fdo-owner-cli`、`sos`
`edge-container`	`dnf、dosfstools、e2fsprogs、glibc、lorax-templates-generic、lorax-templates-rhel、lvm2、policycoreutils、python36、python3-iniparse、qemu-img、selinux-policy-targeted、systemd、tar、xfsprogs、xz`
`edge-installer`	aajohan-comfortaa-fonts、abattis-cantarell-fonts、alsa-firmware、alsa-tools-firmware、anaconda、anaconda-install-env-deps、anaconda-widgets、audit、bind-utils、bitmap-fangsongti-fonts、bzip2、cryptsetup、dbus-x11、dejavu-sans-fonts、dejavu-sans-mono-fonts、device-mapper-persistent-data、dnf、dump、ethtool、fcoe-utils、ftp、gdb-gdbserver、gdisk、gfs2-utils、glibc-all-langpacks、google-noto-sans-cjk-ttc-fonts、gsettings-desktop-schemas、hdparm、hexedit、initscripts、ipmitool、iwl3945-firmware、iwl4965-firmware、iwl6000g2a-firmware、iwl6000g2b-firmware、jomolhari-fonts、kacst-farsi-fonts、kacst-qurn-fonts、kbd、kbd-misc、kdump-anaconda-addon、khmeros-base-fonts、libblockdev-lvm-dbus、libertas-sd8686-firmware、libertas-sd8787-firmware、libertas-usb8388-firmware、libertas-usb8388-olpc-firmware、libibverbs、libreport-plugin-bugzilla、libreport-plugin-reportuploader、libreport-rhel-anaconda-bugzilla、librsvg2、linux-firmware、lklug-fonts、lldpad、lohit-assamese-fonts、lohit-bengali-fonts、lohit-devanagari-fonts、lohit-gujarati-fonts、lohit-gurmukhi-fonts、lohit-kannada-fonts、lohit-odia-fonts、lohit-tamil-fonts、lohit-telugu-fonts、lsof、madan-fonts、metacity、mtr、mt-st、net-tools、nmap-ncat、nm-connection-editor、nss-tools、openssh-server、oscap-anaconda-addon、pciutils、perl-interpreter、pigz、python3-pyatspi、rdma-core、redhat-release-eula、rpm-ostree、rsync、rsyslog、sg3_utils、sil-abyssinica-fonts、sil-padauk-fonts、sil-scheherazade-fonts、smartmontools、smc-meera-fonts、spice-vdagent、strace、system-storage-manager、thai-scalable-waree-fonts、tigervnc-server-minimal、tigervnc-server-module、udisks2、udisks2-iscsi、usbutils、vim-minimal、volume_key、wget、xfsdump、xorg-x11-drivers、xorg-x11-fonts-misc、xorg-x11-server-utils、xorg-x11-server-Xorg、xorg-x11-xauth
`edge-simplified-installer`	`attr、basesystem、binutils、bsdtar、clevis-dracut、clevis-luks、cloud-utils-growpart、coreos-installer、coreos-installer-dracut、coreutils、device-mapper-multipath、dnsmasq、dosfstools、dracut-live、e2fsprogs、fcoe-utils、fdo-init、gzip、ima-evm-utils、iproute、iptables、iputils、iscsi-initiator-utils、keyutils、lldpad、lvm2、passwd、policycoreutils、policycoreutils-python-utils、procps-ng、rootfiles、setools-console、sudo、traceroute、util-linux`
`image-installer`	`aajohan-comfortaa-fonts`、`abattis-cantarell-fonts`、`alsa-firmware`、`alsa-tools-firmware`、`anaconda`、`anaconda-dracut`、`anaconda-install-env-deps`、`anaconda-widgets`、`audit`、`bind-utils`、`bitmap-fangsongti-fonts`、`bzip2`、`cryptsetup`、`curl`、`dbus-x11`、`dejavu-sans-fonts`、`dejavu-sans-mono-fonts`、`device-mapper-persistent-data`、`dmidecode`、`dnf`、`dracut-config-generic`、`dracut-network`、`efibootmgr`、`ethtool`、`fcoe-utils`、`ftp`、`gdb-gdbserver`、`gdisk`、`glibc-all-langpacks`、`gnome-kiosk`、`google-noto-sans-cjk-ttc-fonts`、`grub2-tools`、`grub2-tools-extra`、`grub2-tools-minimal`、`grubby`、`gsettings-desktop-schemas`、`hdparm`、`hexedit`、`hostname`、`initscripts`、`ipmitool`、`iwl1000-firmware`、`iwl100-firmware`、`iwl105-firmware`、`iwl135-firmware`、`iwl2000-firmware`、`iwl2030-firmware`、`iwl3160-firmware`、`iwl5000-firmware`、`iwl5150-firmware`、`iwl6000g2a-firmware`、`iwl6000g2b-firmware`、`iwl6050-firmware`、`iwl7260-firmware`、`jomolhari-fonts`、`kacst-farsi-fonts`、`kacst-qurn-fonts`、`kbd`、`kbd-misc`、`kdump-anaconda-addon`、`kernel`、`khmeros-base-fonts`、`less`、`libblockdev-lvm-dbus`、`libibverbs`、`libreport-plugin-bugzilla`、`libreport-plugin-reportuploader`、`librsvg2`、`linux-firmware`、`lklug-fonts`、`lldpad`、`lohit-assamese-fonts`、`lohit-bengali-fonts`、`lohit-devanagari-fonts`、`lohit-gujarati-fonts`、`lohit-gurmukhi-fonts`、`lohit-kannada-fonts`、`lohit-odia-fonts`、`lohit-tamil-fonts`、`lohit-telugu-fonts`、`lsof`、`madan-fonts`、`mtr`、`mt-st`、`net-tools`、`nfs-utils`、`nmap-ncat`、`nm-connection-editor`、`nss-tools`、`openssh-clients`、`openssh-server`、`oscap-anaconda-addon`、`ostree`、`pciutils`、`perl-interpreter`、`pigz`、`plymouth`、`prefixdevname`、`python3-pyatspi`、`rdma-core`、`redhat-release-eula`、`rng-tools`、`rpcbind`、`rpm-ostree`、`rsync`、`rsyslog`、`selinux-policy-targeted`、`sg3_utils`、`sil-abyssinica-fonts`、`sil-padauk-fonts`、`sil-scheherazade-fonts`、`smartmontools`、`smc-meera-fonts`、`spice-vdagent`、`strace`、`systemd`、`tar`、`thai-scalable-waree-fonts`、`tigervnc-server-minimal`、`tigervnc-server-module`、`udisks2`,`udisks2-iscsi`,`usbutils`,`vim-minimal`、`volume_key`、`wget`、`xfsdump`、`xfsprogs`、`xorg-x11-drivers`、`xorg-x11-fonts-misc`、`xorg-x11-server-utils`、`xorg-x11-server-Xorg`、`xorg-x11-xauth`、`xz`
`edge-raw-image`	`dnf、dosfstools、e2fsprogs、glibc、lorax-templates-generic、lorax-templates-rhel、lvm2、policycoreutils、python36、python3-iniparse、qemu-img、selinux-policy-targeted、systemd、tar、xfsprogs、xz`
`gce`	`@core、langpacks-en、acpid、dhcp-client、dnf-automatic、net-tools、python3、rng-tools、tar、vim`

9.3.10. カスタムイメージで有効なサービス
リンクのコピー

Image Builder を使用してカスタムイメージを設定する場合、イメージが使用するデフォルトのサービスは次のように決定されます。

osbuild-composer ユーティリティーを使用する RHEL リリース
イメージの種類

たとえば、ami イメージタイプは、デフォルトで sshd、chronyd、および cloud-init サービスを有効にします。これらのサービスが有効になっていない場合、カスタムイメージは起動しません。

Expand

表9.4 イメージタイプの作成をサポートするために有効になっているサービス
イメージタイプ	デフォルトで有効化されているサービス
`ami`	sshd, cloud-init, cloud-init-local, cloud-config, cloud-final
`openstack`	sshd, cloud-init, cloud-init-local, cloud-config, cloud-final
`qcow2`	cloud-init
`rhel-edge-commit`	デフォルトでは、追加のサービスは有効になりません。
`tar`	デフォルトでは、追加のサービスは有効になりません。
`vhd`	sshd, chronyd, waagent, cloud-init, cloud-init-local, cloud-config, cloud-final
`vmdk`	sshd、chronyd、vmtoolsd、cloud-init

注記:システムの起動時に有効にするサービスをカスタマイズできます。ただし、カスタマイズは、前述のイメージタイプに対してデフォルトで有効になっているサービスを上書きしません。

9.3. RHEL Image Builder CLI を使用したシステムイメージの作成

9.3.1. RHEL Image Builder コマンドラインインターフェイスの紹介
リンクのコピー

9.3.2. RHEL Image Builder を非 root ユーザーとして使用する
リンクのコピー

9.3.3. コマンドラインを使用したブループリントの作成
リンクのコピー

9.3.4. コマンドラインを使用したブループリントの編集
リンクのコピー

9.3.5. RHEL Image Builder コマンドラインでのシステムイメージの作成
リンクのコピー

9.3.6. RHEL Image Builder コマンドラインの基本的なコマンド
リンクのコピー

9.3.7. RHEL Image Builder のブループリント形式
リンクのコピー

9.3.8. サポートされているイメージのカスタマイズ
リンクのコピー

9.3.8.1. ディストリビューションの選択
リンクのコピー

9.3.8.2. パッケージグループの選択
リンクのコピー

9.3.8.3. コンテナーの埋め込み
リンクのコピー

9.3.8.4. イメージのホスト名の設定
リンクのコピー

9.3.8.5. 追加ユーザーの指定
リンクのコピー

9.3.8.6. 追加グループの指定
リンクのコピー

9.3.8.7. 既存ユーザーの SSH キーの設定
リンクのコピー

9.3.8.8. カーネル引数の追加
リンクのコピー

9.3.8.9. リアルタイムカーネルを使用した RHEL イメージのビルド
リンクのコピー

9.3.8.10. タイムゾーンと NTP の設定
リンクのコピー

9.3.8.11. ロケール設定のカスタマイズ
リンクのコピー

9.3.8.12. ファイアウォールのカスタマイズ
リンクのコピー

9.3.8.13. サービスの有効化または無効化
リンクのコピー

9.3.8.14. キックスタートファイルへの ISO イメージの注入
リンクのコピー

9.3.8.15. パーティションモードの指定
リンクのコピー

9.3.8.16. カスタムファイルシステム設定の指定
リンクのコピー

9.3.8.16.1. カスタマイズされたファイルをブループリントで指定する
リンクのコピー

9.3.8.16.2. カスタマイズされたディレクトリーをブループリントで指定する
リンクのコピー

9.3.8.17. ブループリントでボリュームグループと論理ボリュームの命名を指定する
リンクのコピー

9.3.9. RHEL Image Builder によってインストールされるパッケージ
リンクのコピー

9.3.10. カスタムイメージで有効なサービス
リンクのコピー

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

9.3. RHEL Image Builder CLI を使用したシステムイメージの作成

9.3.1. RHEL Image Builder コマンドラインインターフェイスの紹介リンクのコピーリンクがクリップボードにコピーされました!

9.3.2. RHEL Image Builder を非 root ユーザーとして使用するリンクのコピーリンクがクリップボードにコピーされました!

9.3.3. コマンドラインを使用したブループリントの作成リンクのコピーリンクがクリップボードにコピーされました!

9.3.4. コマンドラインを使用したブループリントの編集リンクのコピーリンクがクリップボードにコピーされました!

9.3.5. RHEL Image Builder コマンドラインでのシステムイメージの作成リンクのコピーリンクがクリップボードにコピーされました!

9.3.6. RHEL Image Builder コマンドラインの基本的なコマンドリンクのコピーリンクがクリップボードにコピーされました!

9.3.7. RHEL Image Builder のブループリント形式リンクのコピーリンクがクリップボードにコピーされました!

9.3.8. サポートされているイメージのカスタマイズリンクのコピーリンクがクリップボードにコピーされました!

9.3.8.1. ディストリビューションの選択リンクのコピーリンクがクリップボードにコピーされました!

9.3.8.2. パッケージグループの選択リンクのコピーリンクがクリップボードにコピーされました!

9.3.8.3. コンテナーの埋め込みリンクのコピーリンクがクリップボードにコピーされました!

9.3.8.4. イメージのホスト名の設定リンクのコピーリンクがクリップボードにコピーされました!

9.3.8.5. 追加ユーザーの指定リンクのコピーリンクがクリップボードにコピーされました!

9.3.8.6. 追加グループの指定リンクのコピーリンクがクリップボードにコピーされました!

9.3.8.7. 既存ユーザーの SSH キーの設定リンクのコピーリンクがクリップボードにコピーされました!

9.3.8.8. カーネル引数の追加リンクのコピーリンクがクリップボードにコピーされました!

9.3.8.9. リアルタイムカーネルを使用した RHEL イメージのビルドリンクのコピーリンクがクリップボードにコピーされました!

9.3.8.10. タイムゾーンと NTP の設定リンクのコピーリンクがクリップボードにコピーされました!

9.3.8.11. ロケール設定のカスタマイズリンクのコピーリンクがクリップボードにコピーされました!

9.3.8.12. ファイアウォールのカスタマイズリンクのコピーリンクがクリップボードにコピーされました!

9.3.8.13. サービスの有効化または無効化リンクのコピーリンクがクリップボードにコピーされました!

9.3.8.14. キックスタートファイルへの ISO イメージの注入リンクのコピーリンクがクリップボードにコピーされました!

9.3.8.15. パーティションモードの指定リンクのコピーリンクがクリップボードにコピーされました!

9.3.8.16. カスタムファイルシステム設定の指定リンクのコピーリンクがクリップボードにコピーされました!

9.3.8.16.1. カスタマイズされたファイルをブループリントで指定するリンクのコピーリンクがクリップボードにコピーされました!

9.3.8.16.2. カスタマイズされたディレクトリーをブループリントで指定するリンクのコピーリンクがクリップボードにコピーされました!

9.3.8.17. ブループリントでボリュームグループと論理ボリュームの命名を指定するリンクのコピーリンクがクリップボードにコピーされました!

9.3.9. RHEL Image Builder によってインストールされるパッケージリンクのコピーリンクがクリップボードにコピーされました!

9.3.10. カスタムイメージで有効なサービスリンクのコピーリンクがクリップボードにコピーされました!

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

9.3.1. RHEL Image Builder コマンドラインインターフェイスの紹介
リンクのコピー

9.3.2. RHEL Image Builder を非 root ユーザーとして使用する
リンクのコピー

9.3.3. コマンドラインを使用したブループリントの作成
リンクのコピー

9.3.4. コマンドラインを使用したブループリントの編集
リンクのコピー

9.3.5. RHEL Image Builder コマンドラインでのシステムイメージの作成
リンクのコピー

9.3.6. RHEL Image Builder コマンドラインの基本的なコマンド
リンクのコピー

9.3.7. RHEL Image Builder のブループリント形式
リンクのコピー

9.3.8. サポートされているイメージのカスタマイズ
リンクのコピー

9.3.8.1. ディストリビューションの選択
リンクのコピー

9.3.8.2. パッケージグループの選択
リンクのコピー

9.3.8.3. コンテナーの埋め込み
リンクのコピー

9.3.8.4. イメージのホスト名の設定
リンクのコピー

9.3.8.5. 追加ユーザーの指定
リンクのコピー

9.3.8.6. 追加グループの指定
リンクのコピー

9.3.8.7. 既存ユーザーの SSH キーの設定
リンクのコピー

9.3.8.8. カーネル引数の追加
リンクのコピー

9.3.8.9. リアルタイムカーネルを使用した RHEL イメージのビルド
リンクのコピー

9.3.8.10. タイムゾーンと NTP の設定
リンクのコピー

9.3.8.11. ロケール設定のカスタマイズ
リンクのコピー

9.3.8.12. ファイアウォールのカスタマイズ
リンクのコピー

9.3.8.13. サービスの有効化または無効化
リンクのコピー

9.3.8.14. キックスタートファイルへの ISO イメージの注入
リンクのコピー

9.3.8.15. パーティションモードの指定
リンクのコピー

9.3.8.16. カスタムファイルシステム設定の指定
リンクのコピー

9.3.8.16.1. カスタマイズされたファイルをブループリントで指定する
リンクのコピー

9.3.8.16.2. カスタマイズされたディレクトリーをブループリントで指定する
リンクのコピー

9.3.8.17. ブループリントでボリュームグループと論理ボリュームの命名を指定する
リンクのコピー

9.3.9. RHEL Image Builder によってインストールされるパッケージ
リンクのコピー

9.3.10. カスタムイメージで有効なサービス
リンクのコピー