9.2. RHEL Image Builder のインストール
RHEL Image Builder は、カスタムのシステムイメージを作成するツールです。RHEL Image Builder を使用する前に、RHEL Image Builder をインストールする必要があります。
9.2.1. RHEL Image Builder のシステム要件 リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder を実行するホストは、次の要件を満たしている必要があります。
パラメーター | 最低要求値 |
---|---|
System type | 専用のホストまたは仮想マシン。RHEL Image Builder は、Red Hat Universal Base Images (UBI) などのコンテナーではサポートされていないことに注意してください。 |
プロセッサー | 2 コア |
メモリー | 4 GiB |
ディスク領域 | `/var/cache/` ファイルシステムに 20 GiB の空き領域 |
アクセス権限 | root |
ネットワーク | Red Hat コンテンツ配信ネットワーク (CDN) へのインターネット接続 |
インターネットに接続できない場合は、分離されたネットワークで RHEL Image Builder を使用してください。そのためには、Red Hat コンテンツ配信ネットワーク (CDN) に接続しないように、ローカルリポジトリーを参照するようにデフォルトのリポジトリーをオーバーライドする必要があります。コンテンツが内部でミラーリングされていることを確認するか、Red Hat Satellite を使用してください。
9.2.2. RHEL Image Builder のインストール リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder をインストールして、osbuild-composer
パッケージのすべての機能にアクセスできるようにします。
前提条件
- RHEL Image Builder をインストールする RHEL ホストにログインしている。
- ホストが Red Hat Subscription Manager (RHSM) または Red Hat Satellite にサブスクライブしている。
-
RHEL Image Builder パッケージをインストールできるように、
BaseOS
リポジトリーおよびAppStream
リポジトリーを有効化している。
手順
RHEL Image Builder とその他の必要なパッケージをインストールします。
yum install osbuild-composer composer-cli cockpit-composer
# yum install osbuild-composer composer-cli cockpit-composer
Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
osbuild-composer
- カスタマイズした RHEL オペレーティングシステムイメージをビルドするサービス。 -
composer-cli
- このパッケージにより、CLI インターフェイスへのアクセスが可能になります。 -
cockpit-composer
- このパッケージにより、Web UI インターフェイスへのアクセスが可能になります。Web コンソールは、cockpit-composer
パッケージの依存関係としてインストールされます。
-
RHEL Image Builder ソケットを有効にして起動します。
systemctl enable --now osbuild-composer.socket
# systemctl enable --now osbuild-composer.socket
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Web コンソールで RHEL Image Builder を使用する場合は、それを有効にして起動します。
systemctl enable --now cockpit.socket
# systemctl enable --now cockpit.socket
Copy to Clipboard Copied! Toggle word wrap Toggle overflow osbuild-composer
サービスとcockpit
サービスは、最初のアクセス時に自動的に起動します。ログアウトおよびログインしなくても
composer-cli
コマンドのオートコンプリート機能がすぐに動作するように、シェル設定スクリプトをロードします。source /etc/bash_completion.d/composer-cli
$ source /etc/bash_completion.d/composer-cli
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
osbuild-composer
パッケージは、Red Hat Enterprise Linux 8.3 以降の新機能すべてに焦点を当てた新しいバックエンドエンジンで、デフォルト設定として推奨されています。以前のバックエンドの lorax-composer
は非推奨となり、Red Hat Enterprise Linux 8 ライフサイクルの残りの期間、一部の修正のみを受信し、今後のメジャーリリースから削除される予定です。osbuild-composer を優先するには、lorax-composer
のアンインストールを推奨します。
検証
composer-cli
を実行して、インストールが動作することを確認します。composer-cli status show
# composer-cli status show
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
トラブルシューティング
システムジャーナルを使用して、RHEL Image Builder のアクティビティーを追跡できます。さらに、ファイル内のログメッセージを見つけることができます。
トレースバックのジャーナル出力を見つけるには、次のコマンドを実行します。
journalctl | grep osbuild
$ journalctl | grep osbuild
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 複数のサービスインスタンスを起動できるテンプレートサービスである
osbuild-worker@.service
などのローカルワーカーを表示するには、以下を実行します。journalctl -u osbuild-worker*
$ journalctl -u osbuild-worker*
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 実行中のサービスを表示するには:
journalctl -u osbuild-composer.service
$ journalctl -u osbuild-composer.service
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
9.2.3. lorax-composer RHEL Image Builder バックエンドに戻す手順 リンクのコピーリンクがクリップボードにコピーされました!
osbuild-composer
バックエンドは、はるかに拡張性が高くなっていますが、現時点では以前の lorax-composer
バックエンドとの機能パリティーがありません。
以前のバックエンドに戻すには、以下の手順に従います。
前提条件
-
osbuild-composer
パッケージがインストールされている。
手順
osbuild-composer バックエンドを削除します。
yum remove osbuild-composer yum remove weldr-client
# yum remove osbuild-composer # yum remove weldr-client
Copy to Clipboard Copied! Toggle word wrap Toggle overflow /etc/yum.conf
ファイルで、osbuild-composer
パッケージの除外エントリーを追加します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow lorax-composer
パッケージをインストールします。yum install lorax-composer composer-cli
# yum install lorax-composer composer-cli
Copy to Clipboard Copied! Toggle word wrap Toggle overflow lorax-composer
サービスを有効にして開始し、再起動するたびに開始します。systemctl enable --now lorax-composer.socket systemctl start lorax-composer
# systemctl enable --now lorax-composer.socket # systemctl start lorax-composer
Copy to Clipboard Copied! Toggle word wrap Toggle overflow