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

手順

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   # composer-cli blueprints push blueprint-name.toml

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

   # composer-cli blueprints show BLUEPRINT-NAME

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

   # composer-cli blueprints depsolve blueprint-name

手順

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

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

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

   • blueprint-name は RHEL for Edge のブループリント名です。

   • 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 Commit イメージを作成します。

   # composer-cli compose start-ostree --ref rhel/9/x86_64/edge --parent parent-OSTree-REF --url URL blueprint-name image-type

   以下に例を示します。

   • parent に基づいて新しい ref を使用して新しい RHEL for Edge Commit を作成するには、次のコマンドを実行します。

     # composer-cli compose start-ostree --ref rhel/9/x86_64/edge --parent rhel/9/x86_64/edge --url http://10.0.2.2:8080/repo rhel_update edge-commit

   • 同じ ref に基づいて新しい RHEL for Edge Commit を作成するには、次のコマンドを実行します。

     # composer-cli compose start-ostree --ref rhel/9/x86_64/edge --url http://10.0.2.2:8080/repo rhel_update edge-commit

     ここでは、以下のようになります。

     • --ref 引数は、OSTree リポジトリーの構築に使用したものと同じパス値を指定します。
     • --parent 引数は、親コミットをコミット ID としてではなく、解決してプルする ref として指定します (例: rhel/9/x86_64/edge)。
     • blueprint-name は RHEL for Edge のブループリント名です。
     • --url 引数は、イメージに埋め込むコミットの OSTree リポジトリーへの URL を指定します (例: http://10.0.2.2:8080/repo)。

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

       注記

       • --parent 引数は、RHEL for Edge Commit (.tar) イメージタイプにのみ使用できます。--url 引数と --parent 引数をあわせて使用すると、RHEL for Edge Container (.tar) イメージタイプでエラーが発生します。
       • parent ref 引数を省略すると、システムは --ref 引数で指定された ref にフォールバックします。

       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