第5章 Image Builder コマンドラインを使用した RHEL for Edge イメージの作成

手順

1. TOML 形式で、以下の内容でプレーンテキストファイルを作成します。

   name = "blueprint-name"
   description = "blueprint-text-description"
   version = "0.0.1"
   modules = [ ]
   groups = [ ]

   詳細は以下のようになります。

   • blueprint-name は名前で、blueprint-text-description は Blueprint の説明になります。
   • 0.0.1 は、Semantic Versioning スキームに従って、バージョン番号に置き換えます。

   • モジュール は、イメージにインストールされるパッケージ名とそれに対応するバージョングロブを記述します (例: パッケージ名 = "tmux"、対応するバージョングロブのバージョン = "2.9a")。

     現在、パッケージとモジュールには違いがないことに注意してください。

   • グループ は、イメージにインストールされるパッケージグループです (例: グループパッケージ anaconda-tools)。

     このとき、モジュールおよびグループがわからない場合は、空欄のままにしておきます。

2. 要件に沿うように、必要なパッケージを含め、Blueprint の他の詳細をカスタマイズします。

   Blueprint に含むすべてのパッケージについて、以下の行をファイルに追加します。

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

   詳細は以下のようになります。

   • package-name は、パッケージ名に置き換えます (例: httpd, gdb-doc、coreutils など)。

   • package-version は、使用するパッケージのバージョン番号に置き換えます。

     package-version は、以下の dnf バージョン仕様をサポートしています。

   • 特定のバージョンを指定する場合は、9.0 のように、バージョン番号を正確に指定してください。
   • 利用可能な最新バージョンを指定する場合は、アスタリスク * を使用します。
   • 最新のマイナーバージョンを指定する場合の形式は、9.* のようになります。

3. Blueprint を Image Builder サーバーにプッシュ (インポート) します。

   # composer-cli blueprints push blueprint-name.toml

4. 既存の Blueprint を一覧表示して、作成した Blueprint が正常にプッシュされて存在するかどうかを確認します。

   # composer-cli blueprints show BLUEPRINT-NAME

5. Blueprint に記載されているコンポーネントおよびバージョンと、その依存関係が有効かどうかを確認します。

   # composer-cli blueprints depsolve blueprint-name

手順

1. RHEL for Edge Commit イメージを作成します。

   # composer-cli compose start blueprint-name image-type

   詳細は以下のようになります。

   • blueprint-name は RHEL for Edge の Blueprint 名です。

   • image-type は network-based deployment の edge-commit です。

     composer プロセスがキューに追加されたことを確認する画面が表示されます。また、作成されたイメージの UUID (Universally Unique Identifier) 番号も表示されます。UUID 番号を使用してビルドを追跡します。また、更なるタスクのために UUID 番号を手元に保管しておきます。

2. イメージの作成状態を確認します。

   # composer-cli compose status

   出力には、以下の形式で状態が表示されます。

   <UUID> RUNNING date blueprint-name blueprint-version image-type

   注記

   イメージの作成プロセスは、完了するまでに最大 20 分かかります。

   イメージ作成プロセスを中断するには、以下を実行します。

   # composer-cli compose cancel <UUID>

   既存イメージを削除するには、以下を実行します。

   # composer-cli compose delete <UUID>

   イメージの準備ができたら、イメージをダウンロードして ネットワークデプロイメント で使用できます。

手順

1. RHEL for Edgeのイメージを作成します。

   # composer-cli compose start-ostree --ref rhel/9/x86_64/edge --parent parent-OSTree-commit-id blueprint-name image-type

   詳細は以下のようになります。

   • --ref は、ostree リポジトリーの構築に使用した値と同じです。
   • --parentは OSTree の親コミットです。
   • blueprint-name は RHEL for Edge の Blueprint 名です。

   • image-type は network-based deployment の edge-commit です。

     注記

     --parent引数は、RHEL for Edge Commit (.tar)イメージタイプにのみ使用できます。引数--urlと--parentを一緒に使うとエラーになります。

     composer プロセスがキューに追加されたことを確認する画面が表示されます。また、作成されたイメージの UUID (Universally Unique Identifier) 番号も表示されます。UUID 番号を使用してビルドを追跡します。また、更なるタスクのために UUID 番号を手元に保管しておきます。

2. イメージの作成状態を確認します。

   # composer-cli compose status

   出力には、以下の形式で状態が表示されます。

   <UUID> RUNNING date blueprint-name blueprint-version image-type

   注記

   イメージ作成プロセスの完了まで数分かかります。

   (オプション）イメージ作成プロセスを中断するには、以下を実行します。

   # composer-cli compose cancel <UUID>

   (オプション）既存のイメージを削除するには、以下を実行します。

   # composer-cli compose delete <UUID>

手順

1. RHEL for Edge イメージの状態を確認します。

   # composer-cli compose status

   出力には、以下が表示される必要があります。

   $ <UUID> FINISHED date blueprint-name blueprint-version image-type

2. イメージをダウンロードしてください。

   # composer-cli compose image <UUID>

   Image Builder は、イメージを tar ファイルとしてカレントディレクトリにダウンロードします。

   UUID 番号とイメージサイズは並んで表示されます。

   $ <UUID>-commit.tar: size MB