4.3. 設定ファイルでサポートされているイメージのカスタマイズ


TOML または JSON 形式のビルド設定ファイルを使用して、作成するディスクイメージにカスタマイズを追加できます。

コンテナー内のディレクトリーでは、設定ファイルが /config.toml にマッピングされます。カスタマイズオブジェクトにより、イメージの変更を定義します。また、ビルド設定ファイルを config.json または config.toml として /usr/lib/bootc-image-builder ディレクトリーに埋め込むこともできます。デフォルトでは、システムはこのディレクトリーにあるファイルシステムまたはディスクのカスタマイズを自動的に使用します。別のカスタマイズを明示的に指定すると、この動作をオーバーライドできます。

JSON 形式の場合、--config 引数を使用するときに stdin を使用して設定を渡すこともできます。

ユーザーのカスタマイズ

ディスクイメージにユーザーを追加し、必要に応じて SSH 鍵を設定します。このセクションのフィールドは、name を除いてすべてオプションです。

Expand
TOMLJSON
[[customizations.user]]
name = "user"
password = "password"
key = "ssh-rsa AAA ... user@email.com"
groups = ["wheel"]
{
  "customizations": {
    "user": [
      {
        "name": "user",
        "password": "password",
        "key": "ssh-rsa AAA ... user@email.com",
        "groups": [
          "wheel",
          "admins"
        ]
      }
    ]
  }
}
カーネルの設定

設定ファイルでカーネルブートパラメーターをカスタマイズできます。

Expand
TOMLJSON
[customizations.kernel]
name = "kernel-debug"
append = "nosmt=force"
{
  "customizations": {
    "kernel": {
      "append": "mitigations=auto,nosmt"
    }
  }
}
ファイルシステムの設定

カスタマイズのファイルシステムセクションを使用して、//boot などのベースパーティションの最小サイズを設定したり、/var の下にマウントポイントを持つ追加のパーティションを作成したりできます。

Expand
TOMLJSON
[[customizations.filesystem]]
mountpoint = "/"
minsize = "10 GiB"

[[customizations.filesystem]]
mountpoint = "/var/data"
minsize = "20 GiB"
{
  "customizations": {
    "filesystem": [
      {
        "mountpoint": "/",
        "minsize": "10 GiB"
      },
      {
        "mountpoint": "/var/data",
        "minsize": "20 GiB"
      }
    ]
  }
}
ファイルシステムタイプと rootfs の相互作用

ルートファイルシステムタイプ (--rootfs) 引数は、ソースコンテナーのデフォルト値をオーバーライドします。また、ext4xfs、および btrfs タイプのすべての追加マウントポイントのファイルシステムタイプも設定します。

サポートされているマウントポイントとサイズには、rootfsbtrfs でない限り、次の制限とルールが適用されます。

  • / を指定すると、ルートファイルシステムの最小サイズを設定できます。起動したシステムの /sysroot にマウントされるファイルシステムの最終的なサイズは、この設定で指定した値、またはベースコンテナーのサイズを 2 倍にした値のうち、どちらか大きい方になります。
  • /boot を指定すると、ブートパーティションの最小サイズを設定できます。/var のサブディレクトリーも指定できますが、/var 内のシンボリックリンクは指定できません。たとえば、/var/home/var/run はシンボリックリンクであり、それ自体ではファイルシステムにはなりません。
  • /var 自体はマウントポイントにはなりません。rootfs オプションは、ルートファイルシステムのファイルシステムタイプを定義します。
  • 現在、ビルド時に btrfs サブボリュームを作成することはサポートされていません。したがって、rootfsbtrfs の場合、/var 配下にカスタムマウントポイントを作成することはサポートされていません。//boot のみを設定できます。
Anaconda ISO (インストーラー) の設定オプション

任意のインストールコマンドを含むキックスタートファイルを作成します。その後、ISO ビルドにキックスタートファイルを追加して、フルカスタマイズおよび自動化されたインストールメディアを作成します。

注記

[customizations.user][customizations.installer.kickstart] を組み合わせたカスタマイズはサポートされていません。キックスタートを追加するときは、TOML 形式の設定ファイルを使用してください。複数行の文字列ではエラーが発生しやすいためです。

Expand
TOMLJSON
[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
"""
{
  "customizations": {
    "installer": {
      "kickstart": {
        "contents": "text --non-interactive\nzerombr\nclearpart --all --initlabel --disklabel=gpt\nautopart --noswap --type=lvm\nnetwork --bootproto=dhcp --device=link --activate --onboot=on"
      }
    }
  }
}
警告

bootc-image-builder は、システムがコンテナーイメージに自動的に追加するコマンド以外に、キックスタートコマンドを追加することはありません。詳細は、キックスタートファイルの作成 を参照してください。

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

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

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hat
トップに戻る