1. RHEL Image Builder ツールを使用した RHEL rpm-ostree イメージの作成。composer-cli ツールのコマンドラインインターフェイスから RHEL Image Builder にアクセスするか、RHEL Web コンソールのグラフィカルユーザーインターフェイスを使用できます。
2. RHEL インストーラーを使用したイメージのデプロイ

1. RHEL システムをインストールおよび登録する
2. RHEL Image Builder をインストールする
3. RHEL Image Builder を使用して RHEL for Edge Container イメージのカスタムブループリントを作成する
4. RHEL Image Builder で RHEL for Edge のブループリントをインポートする
5. OSTreeリポジトリーとしてコミットをデプロイするための Web サーバーを用意した OCI コンテナーに、RHEL for Edge のイメージエンベッドを作成する
6. RHEL for Edge Container イメージファイルをダウンロードする
7. RHEL for Edge Container Commit でリポジトリーを提供するコンテナーをデプロイする
8. RHEL Image Builder を使用して RHEL for Edge インストーラーイメージの別のブループリントを作成する
9. RHEL for Edge Container イメージを組み込んだ実行中のコンテナーからコミットをプルするように設定された RHEL for Edge Installer イメージを作成する
10. RHEL for Edge Installer イメージをダウンロードする
11. インストールを実行する

1. RHEL システムをインストールおよび登録します。
2. RHEL Image Builder をインストールする
3. RHEL Image Builder を使用して RHEL for Edge イメージのブループリントを作成する
4. RHEL Image Builder で RHEL for Edge のブループリントをインポートする
5. RHEL for Edge Commit (.tar) イメージを作成する
6. RHEL for Edge イメージファイルのダウンロード
7. RHEL Image Builder をインストールしたのと同じシステムに、RHEL for Edge Commit コンテンツを提供する Web サーバーをインストールします。手順については、NGINX のセットアップと設定 を参照してください。
8. RHEL for Edge Commit (.tar) コンテンツを実行中の Web サーバーに抽出します。
9. 実行中の Web サーバーから OSTree コンテンツをプルするキックスタートファイルを作成します。キックスタートを変更して OSTree コンテンツをプルする方法の詳細は、RHEL for Edge イメージコミットの抽出を 参照してください。
10. エッジデバイス上で RHEL インストーラー ISO を起動し、それにキックスタートを提供します。

手順

1. 仮想マシンに以下のパッケージをインストールします。

   • osbuild-composer
   • composer-cli
   • cockpit-composer
   • bash-completion
   • firewalld

   # yum install osbuild-composer composer-cli cockpit-composer bash-completion firewalld

   RHEL Image Builder が、RHEL Web コンソールでアプリケーションとしてインストールされている。

2. 仮想マシンを再起動します。

3. Web コンソールへのアクセスを許可するように、システムのファイアウォールを設定します。

   # firewall-cmd --add-service=cockpit && firewall-cmd --add-service=cockpit --permanent

4. RHEL Image Builder を有効にします。

   # systemctl enable osbuild-composer.socket cockpit.socket --now

   osbuild-composer サービスおよび cockpit サービスは、最初のアクセスで自動的に起動します。

5. システムを再起動しなくても、composer-cli コマンドのオートコンプリート機能がすぐに動作するように、シェル設定スクリプトを読み込みます。

   $ source /etc/bash_completion.d/composer-cli

手順

1. /root/repo.toml などのリポジトリーソースファイルを作成します。以下に例を示します。

   id = "k8s"
   name = "Kubernetes"
   type = "yum-baseurl"
   url = "https://server.example.com/repos/company_internal_packages/"
   check_gpg = false
   check_ssl = false
   system = false

   type フィールドは、有効な値 yum-baseurl、yum-mirrorlist、および yum-metalink を受け入れます。

2. ファイルを TOML 形式で保存します。

3. 新しいサードパーティーソースを RHEL Image Builder に追加します。

   $ composer-cli sources add <file-name>.toml

検証

1. 新しいソースが正常に追加されたかどうかを確認します。

   $ composer-cli sources list

2. 新しいソースコンテンツを確認します。

   $ composer-cli sources info <source_id>

手順

1. /root/repo.toml などのリポジトリーソースファイルを作成します。たとえば、ディストリビューションを指定するには、次のようにします。

   check_gpg = true
   check_ssl = true
   distros = ["rhel-8"]
   id = "rh9-local"
   name = "packages for RHEL"
   system = false
   type = "yum-baseurl"
   url = "https://local/repos/rhel8/projectrepo/"

2. ファイルを TOML 形式で保存します。

3. 新しいサードパーティーソースを RHEL Image Builder に追加します。

   $ composer-cli sources add <file-name>.toml

検証

1. 新しいソースが正常に追加されたかどうかを確認します。

   $ composer-cli sources list

2. 新しいソースコンテンツを確認します。

   $ composer-cli sources info <source_id>

手順

1. リポジトリーを作成するフォルダーにアクセスします。

   $ cd repo/

2. createrepo_c を実行して、RPM パッケージからリポジトリーを作成します。

   $ createrepo_c .

3. リポデータがあるディレクトリーにアクセスします。

   $ cd repodata/

4. repomd.xml ファイルに署名します。

   $ gpg -u <_gpg-key-email_> --yes --detach-sign --armor /srv/repo/example/repomd.xml

5. リポジトリーで GPG 署名チェックを有効にするには、以下を行います。

   1. リポジトリーソースで check_repogpg = true を設定します。

   2. チェックを行う gpgkey を入力します。キーが https 経由で利用できる場合は、gpgkeys フィールドにキーのキー URL を設定します。URL キーは必要なだけ追加できます。

      以下に例を示します。

      check_gpg = true
      check_ssl = true
      id = "signed local packages"
      name = "repository_name"
      type = "yum-baseurl"
      url = "https://local/repos/projectrepo/"
      check_repogpg = true
      gpgkeys=["https://local/keys/repokey.pub"]

      代わりに、たとえば次のように GPG キーを gpgkeys フィールドに直接追加します。

      check_gpg = true
      check_ssl = true
      check_repogpg
      id = "custom-local"
      name = "signed local packages"
      type = "yum-baseurl"
      url = "https://local/repos/projectrepo/"
      gpgkeys=["https://remote/keys/other-repokey.pub",
      '''-----BEGIN PGP PUBLIC KEY BLOCK-----
      …​
      -----END PGP PUBLIC KEY BLOCK-----''']

      • テストで署名が見つからない場合、GPG ツールは次のようなエラーを表示します。

        $ GPG verification is enabled, but GPG signature is not available.
        This may be an error or the repository does not support GPG verification:
        Status code: 404 for http://repo-server/rhel/repodata/repomd.xml.asc (IP: 192.168.1.3)

      • 署名が無効な場合、GPG ツールは次のようなエラーを表示します。

        repomd.xml GPG signature verification error: Bad GPG signature

手順

1. リポジトリーのオーバーライドを保存する /etc/osbuild-composer/repositories/ ディレクトリーを作成します。

   $ sudo mkdir -p /etc/osbuild-composer/repositories

2. RHEL バージョンに対応する名前を使用して、JSON ファイルを作成します。または、配布用のファイルを /usr/share/osbuild-composer/ からコピーして、その内容を変更することもできます。

   RHEL 9.3 の場合は、/etc/osbuild-composer/repositories/rhel-93.json を使用します。

3. 次の構造を JSON ファイルに追加します。次の属性から 1 つだけ文字列形式で指定します。

   • baseurl - リポジトリーのベース URL。
   • metalink - 有効なミラーリポジトリーのリストを含む metallink ファイルの URL。

   • mirrorlist - 有効なミラーリポジトリーのリストを含む mirrorlist ファイルの URL。gpgkey や metadata_expire などの残りのフィールドはオプションです。

     以下に例を示します。

     {
          "x86_64": [
             {
                 "name": "baseos",
                 "baseurl": "http://mirror.example.com/composes/released/RHEL-8/8.0/BaseOS/x86_64/os/",
                 "gpgkey": "-----BEGIN PGP PUBLIC KEY BLOCK-----\n\n (…​)",
                 "check_gpg": true
             }
         ]
     }

     あるいは、rhel-version.json を RHEL のバージョン (例: rhel-9.json) に置き換えて、ディストリビューション用の JSON ファイルをコピーすることもできます。

     $  cp /usr/share/osbuild-composer/repositories/rhel-version.json /etc/osbuild-composer/repositories/

4. オプション：JSON ファイルを確認します。

   $ json_verify  /etc/osbuild-composer/repositories/<file>.json

5. rhel-9.json ファイル内の baseurl パスを編集して保存します。以下に例を示します。

   $ /etc/osbuild-composer/repositories/rhel-version.json

6. osbuild-composer.service を再起動します。

   $ sudo systemctl restart osbuild-composer.service

手順

1. /etc/yum.repos.d/redhat.repo ファイルから baseurl を取得します。

   # cat /etc/yum.repos.d/redhat.repo
   [AppStream]
   name = AppStream mirror example
   baseurl = https://mirror.example.com/RHEL-8/8.0/AppStream/x86_64/os/
   enabled = 1
   gpgcheck = 0
   sslverify = 1
   sslcacert = /etc/pki/ca1/ca.crt
   sslclientkey = /etc/pki/ca1/client.key
   sslclientcert = /etc/pki/ca1/client.crt
   metadata_expire = 86400
   enabled_metadata = 0

2. 同じ baseurl を使用するようにリポジトリーオーバーライドを設定し、rhsm を true に設定します。

   {
       "x86_64": [
           {
               "name": "AppStream mirror example",
               "baseurl": "https://mirror.example.com/RHEL-8/8.0/AppStream/x86_64/os/",
               "gpgkey": "-----BEGIN PGP PUBLIC KEY BLOCK-----\n\n (…​)",
               "check_gpg": true,
               "rhsm": true
           }
       ]
   }

3. osbuild-composer.service を再起動します。

   $ sudo systemctl restart osbuild-composer.service

手順

1. RHEL システムで、Web ブラウザーで https://localhost:9090/ にアクセスします。
2. RHEL Image Builder にリモートでアクセスする方法の詳細は、RHEL 8 で Web コンソールを使用したシステムの管理 を参照してください。
3. 管理ユーザーアカウントを使用して、Web コンソールにログインします。
4. Web コンソールで、左側のメニューの Apps をクリックします。

5. Image Builder をクリックします。

   RHEL Image Builder ダッシュボードが右側のペインに開きます。これで、RHEL for Edge イメージのブループリントの作成に進むことができます。

手順

1. RHEL Image Builder ダッシュボードで、Create Blueprint をクリックします。

   Create Blueprint のダイアログボックスが表示されます。

2. Details ページで以下を行います。

   1. ブループリントの名前と、必要に応じてその説明を入力します。Next をクリックします。

3. オプション: Packages ページで、以下を行います。

   1. Available packages の検索で、パッケージ名を入力し、> ボタンをクリックして、パッケージを Chosen packages フィールドに移動します。必要な数のパッケージを検索して含めます。Next をクリックします。

      注記

      特に指定がない限り、これらのカスタマイズはすべてオプションです。

4. Kernel ページで、カーネル名とコマンドライン引数を入力します。
5. File system ページで、Use automatic partitioning を選択します。OSTree イメージには読み取り専用などの独自のマウントルールがあるため、ファイルシステムのカスタマイズは OSTree システムではサポートされません。Next をクリックします。

6. Services ページで、サービスを有効または無効にします。

   1. 有効または無効にするサービス名をコンマまたはスペースで区切るか、Enter キーを押して入力します。Next をクリックします。

7. Firewall ページで、ファイアウォールを設定します。

   1. Ports と、有効または無効にするファイアウォールサービスを入力します。
   2. Add zone ボタンをクリックして、各ゾーンのファイアウォールルールを個別に管理します。Next をクリックします。

8. Users ページで、以下の手順に従ってユーザーを追加します。

   1. Add user をクリックします。
   2. Username、password、および SSH key を入力します。Server administrator チェックボックスをクリックして、ユーザーを特権ユーザーとしてマークすることもできます。Next をクリックします。

9. Groups ページで、次の手順を実行してグループを追加します。

   1. Add groups ボタンをクリックします。

      1. Group name と Group ID を入力します。グループをさらに追加できます。Next をクリックします。

10. SSH keys ページで、キーを追加します。

    1. Add key ボタンをクリックします。

       1. SSH キーを入力します。
       2. User を入力します。Next をクリックします。

11. Timezone ページで、タイムゾーンを設定します。

    1. Timezone フィールドに、システムイメージに追加するタイムゾーンを入力します。たとえば、タイムゾーン形式 US/Eastern を追加します。

       タイムゾーンを設定しない場合、システムはデフォルトとして協定世界時 (UTC) を使用します。

    2. NTP サーバーを入力します。Next をクリックします。

12. Locale ページで、以下の手順を実行します。

    1. Keyboard 検索フィールドに、システムイメージに追加するパッケージ名を入力します。たとえば、["en_US.UTF-8"] と入力します。
    2. Languages 検索フィールドに、システムイメージに追加するパッケージ名を入力します。たとえば、"us" と入力します。Next をクリックします。

13. Others ページで、次の手順を実行します。

    1. Hostname フィールドに、システムイメージに追加するホスト名を入力します。ホスト名を追加しない場合、オペレーティングシステムによってホスト名が決定されます。
    2. Simplifier インストーラーイメージの場合のみ必須: Installation Devices フィールドに、システムイメージの有効なノードを入力します。たとえば、dev/sda です。Next をクリックします。

14. FIDO イメージをビルドする場合のみ必須: FIDO device onboarding ページで、次の手順を実行します。

    1. Manufacturing server URL フィールドに、次の情報を入力します。

       1. DIUN public key insecure フィールドに、セキュアでない公開鍵を入力します。
       2. DIUN public key hash フィールドに、公開鍵ハッシュを入力します。
       3. DIUN public key root certs フィールドに、公開鍵ルート証明書を入力します。Next をクリックします。

15. OpenSCAP ページで、次の手順を実行します。

    1. Datastream フィールドに、システムイメージに追加する datastream 修復手順を入力します。
    2. Profile ID フィールドに、システムイメージに追加する profile_id セキュリティープロファイルを入力します。Next をクリックします。

16. Ignition イメージをビルドする場合のみ必須: Ignition ページで、次の手順を実行します。

    1. Firstboot URL フィールドに、システムイメージに追加するパッケージ名を入力します。
    2. Embedded Data フィールドに、ファイルをドラッグまたはアップロードします。Next をクリックします。
17. .Review ページで、ブループリントの詳細を確認します。Create をクリックします。

手順

1. RHEL Image Builder のダッシュボードで、Create Image をクリックします。

2. Image output ページで、次の手順を実行します。

   1. Select a blueprint ドロップダウンメニューから、使用するブループリントを選択します。
   2. Image output type ドロップダウンリストから、ネットワークベースのデプロイメント用に "RHEL for Edge Commit (.tar)" を選択します。
   3. Next をクリックします。

   4. OSTree settings ページで、以下を入力します。

      1. リポジトリー URL: イメージに埋め込むコミットの OSTree リポジトリーへの URL を指定します。たとえば、http://10.0.2.2:8080/repo/ です。
      2. 親コミット: 以前のコミットを指定するか、現時点でコミットがない場合は空のままにします。
      3. Ref テキストボックスで、コミットを作成する場所の参照パスを指定します。デフォルトでは、Web コンソールは rhel/8/$ARCH/edge を指定します。$ARCH の値は、ホストマシンによって決定されます。Next をクリックします。

   5. Review ページでカスタマイズを確認し、Create をクリックします。

      RHEL Image Builder が、作成したブループリントの RHEL for Edge Commit イメージの作成を開始します。

      注記

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

検証

1. RHEL for Edge Commit イメージの作成の進行状況を確認するには、次の手順に従います。

   1. Images タブをクリックします。

手順

1. RHEL Image Builder のダッシュボードで、Create Image をクリックします。
2. Image output ページで、次の手順を実行します。

3. Select a blueprint ドロップダウンメニューから、使用するブループリントを選択します。

   1. Image output type ドロップダウンリストから、ネットワークベースのデプロイメント用に "RHEL for Edge Container (.tar)" を選択します。
   2. Next をクリックします。

   3. OSTree ページで、次のように入力します。

      1. リポジトリー URL: イメージに埋め込むコミットの OSTree リポジトリーへの URL を指定します。たとえば、http://10.0.2.2:8080/repo/ です。デフォルトでは、RHEL for Edge Container イメージのリポジトリーフォルダーは /repo です。

         使用する正しい URL を見つけるには、実行中のコンテナーにアクセスし、nginx.conf ファイルを確認します。使用する URL を見つけるには、実行中のコンテナーにアクセスし、nginx.conf ファイルを確認します。nginx.conf ファイル内で、root ディレクトリーエントリーを見つけて、/repo/ フォルダー情報を検索します。RHEL Image Builder を使用して RHEL for Edge Container イメージ (.tar) を作成するときにリポジトリー URL を指定しない場合、デフォルトの /repo/ エントリーが nginx.conf ファイルに作成されることに注意してください。

      2. 親コミット: 以前のコミットを指定するか、現時点でコミットがない場合は空のままにします。
      3. Ref テキストボックスで、コミットを作成する場所の参照パスを指定します。デフォルトでは、Web コンソールは rhel/8/$ARCH/edge を指定します。$ARCH の値は、ホストマシンによって決定されます。Next をクリックします。
   4. Review ページで、カスタマイズを確認します。Save blueprint をクリックします。

4. Create をクリックします。

   RHEL Image Builder が、作成したブループリントの RHEL for Edge Container イメージの作成を開始します。

   注記

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

検証

1. RHEL for Edge Container イメージの作成の進行状況を確認するには、次の手順に従います。

   1. Images タブをクリックします。

手順

1. RHEL Image Builder のダッシュボードで、Create Image をクリックします。

2. Image output ページで、次の手順を実行します。

   1. Select a blueprint ドロップダウンメニューから、使用するブループリントを選択します。
   2. Image output type ドロップダウンリストから、RHEL for Edge Installer (.iso) イメージを選択します。
   3. Next をクリックします。

   4. OSTree settings ページで、以下を入力します。

      1. リポジトリー URL: イメージに埋め込むコミットの OSTree リポジトリーへの URL を指定します。たとえば、http://10.0.2.2:8080/repo/ です。
      2. Ref テキストボックスで、コミットを作成する場所の参照パスを指定します。デフォルトでは、Web コンソールは rhel/8/$ARCH/edge を指定します。$ARCH の値は、ホストマシンによって決定されます。Next をクリックします。
   5. Review ページで、カスタマイズを確認します。Save blueprint をクリックします。

3. Create をクリックします。

   RHEL Image Builder が、作成したブループリントの RHEL for Edge Installer イメージの作成を開始します。

   注記

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

1. RHEL for Edge Installer イメージの作成の進行状況を確認するには:

   1. Images タブをクリックします。

1. More Options メニューの Download をクリックします。

   RHEL Image Builder ツールは、デフォルトのダウンロード場所にファイルをダウンロードします。

1. RHEL システムをインストールおよび登録する
2. RHEL Image Builder をインストールする
3. RHEL Image Builder を使用して RHEL for Edge Container イメージのカスタムブループリントを作成する
4. RHEL Image Builder で RHEL for Edge のブループリントをインポートする
5. OSTreeリポジトリーとしてコミットをデプロイするための Web サーバーを用意した OCI コンテナーに、RHEL for Edge のイメージエンベッドを作成する
6. Edge-simplified-installer イメージのブループリントを作成する
7. 簡略化された RHEL for Edge を構築する
8. RHEL for Edge の簡略化されたイメージのダウンロード
9. Edge-simplified-installer virt-install を使用して RAW イメージをインストールする

手順

1. TOML (Tom's Obvious, Minimal Language) 形式で、以下のコンテンツのプレーンテキストファイルを作成します。

   name = "simplified-installer-blueprint"
   description = "blueprint for the simplified installer image"
   version = "0.0.1"
   packages = []
   modules = []
   groups = []
   distro = ""
   
   [customizations]
   installation_device = "/dev/vda"
   
   [[customizations.user]]
   name = "admin"
   password = "admin"
   groups = ["users", "wheel"]
   
   [customizations.fdo]
   manufacturing_server_url = "http://10.0.0.2:8080"
   diun_pub_key_insecure = "true"

   注記

   ブループリントでの FDO のカスタマイズはオプションであり、エラーなしで RHEL for Edge Simplified Installer イメージをビルドできます。

   • name はブループリントの名前で、description は説明です。
   • 0.0.1 は、Semantic Versioning スキームに従って、バージョン番号に置き換えます。
   • モジュール には、イメージにインストールするパッケージの名前と、それに対応するバージョンの glob を記述します (例: パッケージ名 = "tmux"、対応するバージョンの glob = "2.9a")。現在、パッケージとモジュールには違いがないことに注意してください。
   • グループ は、イメージにインストールされるパッケージグループです (例: グループパッケージ anaconda-tools)。モジュールとグループがわからない場合は、空のままにします。
   • installation-device は、デバイスへの無人インストールを有効にするためのカスタマイズです。
   • Manufacturing_server_url は、最初のデバイスクレデンシャルエクスチェンジを実行するための URL です。
   • name は、イメージにログインするためのユーザー名です。
   • password は、任意のパスワードです。
   • groups は、任意のユーザーグループです ("widget" など)。

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

   # composer-cli blueprints push blueprint-name.toml

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

   # composer-cli blueprints show blueprint-name

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

   # composer-cli blueprints depsolve blueprint-name

手順

1. 起動可能な ISO イメージを作成します。

   # composer-cli compose start-ostree \
   blueprint-name \
   edge-simplified-installer \
   --ref rhel/8/x86_64/edge \
   --url URL-OSTree-repository \

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

   • blueprint-name は RHEL for Edge のブループリント名です。
   • edge-simplified-installer は image-type です。
   • --ref は、コミットが作成される場所の参照です。

   • --url は、イメージに埋め込むコミットの OSTree リポジトリーへの URL ですたとえば、http://10.0.2.2:8080/repo/ です。RHEL for Edge Container を起動するか、Web サーバーをセットアップすることができます。非ネットワークベースのデプロイメント用の RHEL for Edge Container イメージの作成 および RHEL for Edge イメージをインストールするための Web サーバーのセットアップ を参照してください。

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

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

   # composer-cli compose status

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

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

   注記

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

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

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

   RHEL Image Builder が、コマンドが実行されたカレントディレクトリーのパスに .iso ファイル形式のイメージをダウンロードします。

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

   $ <UUID>-simplified-installer.iso: size MB

手順

1. RHEL Image Builder アプリケーションの右上隅にある Create Blueprint をクリックします。

   ブループリントの名前と説明のフィールドを含むダイアログウィザードが開きます。

2. Details ページで以下を行います。

   1. ブループリントの名前と、必要に応じてその説明を入力します。Next をクリックします。

3. オプション: パッケージページで、次の手順を実行します。

   1. Available packages の検索で、パッケージ名を入力し、> ボタンをクリックして、パッケージを Chosen packages フィールドに移動します。必要な数のパッケージを検索して含めます。Next をクリックします。

      注記

      特に指定がない限り、カスタマイズはすべてオプションです。

4. オプション: Kernel ページで、カーネル名とコマンドライン引数を入力します。
5. オプション: File system ページで、Use automatic partitioning を選択します。OSTree イメージには読み取り専用などの独自のマウントルールがあるため、ファイルシステムのカスタマイズは OSTree システムではサポートされません。Next をクリックします。

6. オプション: Services ページで、サービスを有効または無効にします。

   1. 有効または無効にするサービス名をコンマまたはスペースで区切るか、Enter キーを押して入力します。Next をクリックします。

7. オプション: Firewall ページで、ファイアウォール設定をセットアップします。

   1. Ports と、有効または無効にするファイアウォールサービスを入力します。
   2. Add zone ボタンをクリックして、各ゾーンのファイアウォールルールを個別に管理します。Next をクリックします。

8. Users ページで、以下の手順に従ってユーザーを追加します。

   1. Add user をクリックします。

   2. Username、password、および SSH key を入力します。Server administrator チェックボックスをクリックして、ユーザーを特権ユーザーとしてマークすることもできます。

      注記

      ブループリントのカスタマイズでユーザーを指定し、そのブループリントからイメージを作成すると、ブループリントはインストール時に /usr/lib/passwd ディレクトリーにユーザーを作成し、/usr/etc/shadow にパスワードを作成します。ブループリント用に作成したユーザー名とパスワードを使用してデバイスにログインできます。システムにアクセスしたら、useradd コマンドなどを使用してユーザーを作成する必要があります。

      Next をクリックします。

9. オプション: Groups ページで、次の手順を実行してグループを追加します。

   1. Add groups ボタンをクリックします。

      1. Group name と Group ID を入力します。グループをさらに追加できます。Next をクリックします。

10. オプション: SSH keys ページで、キーを追加します。

    1. Add key ボタンをクリックします。

       1. SSH キーを入力します。
       2. User を入力します。Next をクリックします。

11. オプション: Timezone ページで、タイムゾーンを設定します。

    1. Timezone フィールドに、システムイメージに追加するタイムゾーンを入力します。たとえば、タイムゾーン形式 US/Eastern を追加します。

       タイムゾーンを設定しない場合、システムはデフォルトとして協定世界時 (UTC) を使用します。

    2. NTP サーバーを入力します。Next をクリックします。

12. オプション: Locale ページで、次の手順を実行します。

    1. Keyboard 検索フィールドに、システムイメージに追加するパッケージ名を入力します。たとえば、["en_US.UTF-8"] と入力します。
    2. Languages 検索フィールドに、システムイメージに追加するパッケージ名を入力します。たとえば、"us" と入力します。Next をクリックします。

13. 必須: Others ページで、次の手順を実行します。

    1. Hostname フィールドに、システムイメージに追加するホスト名を入力します。ホスト名を追加しない場合、オペレーティングシステムによってホスト名が決定されます。
    2. 必須: Installation Devices フィールドに、システムイメージの有効なノードを入力して、デバイスへの無人インストールを有効にします。たとえば、dev/sda1 と入力します。Next をクリックします。

14. オプション: FIDO device onboarding ページで、次の手順を実行します。

    1. Manufacturing server URL フィールドに、最初のデバイスクレデンシャルエクスチェンジを実行するための manufacturing server URL を入力します (例: "http://10.0.0.2:8080")。ブループリントでの FDO のカスタマイズはオプションであり、エラーなしで RHEL for Edge Simplified Installer イメージをビルドできます。
    2. DIUN public key insecure フィールドに、最初のデバイスクレデンシャルエクスチェンジを実行するための証明書公開鍵ハッシュを入力します。このフィールドは値として "true" を受け入れます。この値は、この接続が製造サーバーへの非セキュアな接続であることを意味します。たとえば、manufacturing_server_url="http://${FDO_SERVER}:8080" diun_pub_key_insecure="true" と入力します。"key insecure"、"key hash"、および "key root certs" の 3 つのオプションのうち 1 つだけを使用する必要があります。

    3. DIUN public key hash フィールドに、公開鍵のハッシュバージョンを入力します。たとえば、17BD05952222C421D6F1BB1256E0C925310CED4CE1C4FFD6E5CB968F4B73BF73。鍵ハッシュは、製造サーバーの証明書に基づいて生成することで取得できます。鍵ハッシュを生成するには、次のコマンドを実行します。

       # openssl x509 -fingerprint -sha256 -noout -in /etc/fdo/aio/keys/diun_cert.pem | cut -d"=" -f2 | sed 's/://g'

       /etc/fdo/aio/keys/diun_cert.pem は、製造サーバーに保存されている証明書です。

    4. DIUN public key root certs フィールドに、公開鍵ルート証明書を入力します。このフィールドは、製造サーバーに保存されている証明書ファイルの内容を受け入れます。証明書ファイルの内容を取得するには、次のコマンドを実行します。

       $ cat /etc/fdo/aio/keys/diun_cert.pem.

15. Next をクリックします。
16. Review ページで、ブループリントの詳細を確認します。Create をクリックします。

手順

1. Image Builder ダッシュボードにアクセスします。
2. ブループリントテーブルで、イメージを構築するブループリントを見つけます。
3. Images タブに移動し、Create Image をクリックします。Create image ウィザードが開きます。

4. Image output ページで、次の手順を実行します。

   1. Select a blueprint リストから、RHEL for Edge Simplified イメージ用に作成したブループリントを選択します。
   2. Image output type リストから、RHEL for Edge Simplified Installer (.iso) を選択します。
   3. Image Size フィールドにイメージサイズを入力します。Simplified Installer イメージに必要な最小イメージサイズは、次のとおりです。
5. Next をクリックします。

6. OSTree settings ページで、次の手順を実行します。

   1. Repository URL フィールドに、親 OSTree コミットのプル元となるリポジトリー URL を入力します。
   2. Ref フィールドに ref ブランチ名のパスを入力します。ref を入力しない場合は、ディストリビューションのデフォルトの ref が使用されます。
7. Review ページでイメージのカスタマイズを確認し、Create をクリックします。

手順

1. RHEL Image Builder ダッシュボードにアクセスします。ブループリントリストのダッシュボードが開きます。
2. ブループリントテーブルで、RHEL for Edge Simplified Installer イメージを構築したブループリントを見つけます。
3. Images タブに移動します。

4. 次のいずれかを実行します。

   • イメージをダウンロードします。
   • イメージのログをダウンロードして要素を検査し、問題がないかどうかを確認します。

手順

1. 選択したディレクトリーに ISO イメージをマウントします。

   # mkdir /mnt/rhel8-install/
   # mount -o loop,ro -t iso9660 /path_directory/installer.iso /mnt/rhel8-install/

   /path_directory/installer.iso を RHEL for Edge 起動可能な ISO イメージへのパスに置き換えます。

2. マウントされたイメージから HTTP サーバーのルートにファイルをコピーします。このコマンドにより、イメージに含まれるファイルが保存される /var/www/html/rhel8-install/ ディレクトリーを作成します。

   # mkdir /var/www/html/httpboot/
   # cp -R /mnt/rhel8-install/* /var/www/html/httpboot/
   # chmod -R +r /var/www/html/httpboot/*

   注記

   一部のコピー方法は、有効なインストールソースに必要な .treeinfo ファイルを省略できることに注意してください。この手順で示されているように、ディレクトリー全体に対して cp コマンドを実行しても、.treeinfo が正しくコピーされます。

3. 以下を置き換えて、/var/www/html/EFI/BOOT/grub.cfg ファイルを更新します。

   1. coreos.inst.install_dev=/dev/sda を coreos.inst.install_dev=/dev/vda へ
   2. linux /images/pxeboot/vmlinuz を linuxefi /images/pxeboot/vmlinuz へ
   3. initrd /images/pxeboot/initrd.img を initrdefi /images/pxeboot/initrd.img へ

   4. coreos.inst.image_file=/run/media/iso/disk.img.xz を coreos.inst.image_url=http://{IP-ADDRESS}/disk.img.xz へ

      IP-ADDRESS は、このマシンの IP アドレスで、http ブートサーバーとして機能します。

4. httpd サービスを起動します。

   # systemctl start httpd.service

   その結果、UEFI HTTP Boot サーバーをセットアップした後、UEFI HTTP ブートを使用して RHEL for Edge デバイスをインストールできます。

手順

1. UEFI HTTP ブートをサポートするようにネットワーク設定をセットアップします。libvirt を使用した UEFI HTTP ブートのセットアップ を参照してください。

2. virt-install コマンドを使用して、UEFI HTTP Boot から RHEL for Edge Virtual Machine を作成します。

   # virt-install \
       --name edge-install-image \
       --disk path=”  “, ,format=qcow2
       --ram 3072 \
       --memory 4096 \
       --vcpus 2 \
       --network network=integration,mac=mac_address \
       --os-type linux
       --os-variant rhel8 \
       --cdrom "/var/lib/libvirt/images/”ISO_FILENAME"
       --boot uefi,loader_ro=yes,loader_type=pflash,nvram_template=/usr/share/edk2/ovmf/OVMF_VARS.fd,loader_secure=no
       --virt-type kvm \
       --graphics none \
        --wait=-1
        --noreboot

手順

1. ISO イメージファイルを USB フラッシュドライブにコピーします。
2. USB フラッシュドライブを、起動するコンピューターのポートに接続します。

3. USB フラッシュドライブから ISO イメージを起動します。起動メニューには、次のオプションが表示されます。

   Install Red Hat Enterprise Linux 8
   Test this media & install Red Hat Enterprise Linux 8

4. Red Hat Enterprise Linux 8 のインストールを選択します。これにより、システムのインストールが開始します。

1. デバイスが製造サーバーに接続します。
2. 製造サーバーがデバイスの所有権バウチャーとデバイス認証情報を生成します。
3. 所有権バウチャーが所有者オンボーディングサーバーに転送されます。

4. 所有者オンボーディングサーバーは、所有権バウチャーをランデブーサーバーに転送し、ランデブーサーバーは、所有権バウチャーを所有者にマッピングします。
5. デバイスクライアントがデバイス認証情報を読み込みます。
6. デバイスクライアントがネットワークに接続します。
7. ネットワークに接続した後、デバイスクライアントはランデブーサーバーに接続します。
8. ランデブーサーバーは、所有者のエンドポイント URL をデバイスクライアントに送信し、デバイスを登録します。
9. デバイスクライアントは、ランデブーサーバーによって共有された所有者オンボーディングサーバーに接続します。
10. デバイスは、デバイスキーを使用してステートメントに署名することにより、正しいデバイスであることを証明します。
11. 所有者オンボーディングサーバーは、所有者バウチャーの最後のキーを使用してステートメントに署名することで、正しいサーバーであることを証明します。
12. 所有者オンボーディングサーバーは、デバイスの情報を Service Info API サーバーに転送します。
13. Service Info API サーバーは、デバイスの設定を送信します。
14. デバイスがオンボードされます。

1. RHEL システムをインストールおよび登録します。
2. RHEL Image Builder をインストールします。

3. RHEL Image Builder を使用して、rhel-edge-container イメージタイプ用の RHEL のカスタマイズされたブループリントを作成します。

   name = "rhel-edge-container"
   description = "Minimal RHEL for Edge Container blueprint"
   version = "0.0.1"

4. RHEL for Edge Container ブループリントを RHEL Image Builder にインポートします。
5. RHEL for Edge Container イメージを作成します。
6. RHEL for Edge Container イメージを使用して、OSTree コミットを提供します。これは、後で RHEL for Edge Simplified Installer イメージタイプを構築する際に使用されます。

7. ストレージデバイスパスのカスタマイズと FDO のカスタマイズを使用して、edge-simplified-installer イメージタイプのブループリントを作成します。

   name = "rhel-edge-simplified-installer-with-fdo"
   description = "Minimal RHEL for Edge Simplified Installer with FDO blueprint"
   version = "0.0.1"
   packages = []
   modules = []
   groups = []
   distro = ""
   
   [customizations]
   installation_device = "/dev/vda"
   
   [customizations.fdo]
   manufacturing_server_url = "http://10.0.0.2:8080"
   diun_pub_key_insecure = "true"

8. RHEL for Edge イメージ用の簡略化されたインストーラー RHEL を構築します。
9. RHEL for Edge の簡略化されたインストーラーイメージをダウンロードします。
10. この時点で、FDO サーバーインフラストラクチャーが稼働している必要があり、所有者のインフラストラクチャーの一部である service-info API サーバーによって処理される特定のオンボーディングの詳細が設定されます。
11. 簡略化されたインストーラー ISO イメージをデバイスにインストールします。FDO クライアントは Simplified Installer ISO で実行され、UEFI ディレクトリー構造によりイメージが起動可能になります。
12. ネットワーク設定により、デバイスは製造サーバーに接続して、最初のデバイス認証情報の交換を実行できます。
13. システムがエンドポイントに到達すると、デバイスに対してデバイスの認証情報が作成されます。
14. デバイスは、デバイスの認証情報を使用して Rendezvous サーバーに到達します。この場合、Rendezvous サーバーが持つバウチャーに基づいて暗号化認証情報を確認し、Rendezvous サーバーはデバイスを所有者サーバーにリダイレクトします。
15. デバイスは所有者サーバーに接続します。相互の信頼を確立し、Service-info API サーバーの設定に基づいてオンボーディングの最後の手順を行います。たとえば、デバイスに SSH キーをインストールして、ファイルを転送し、ユーザーの作成、コマンドの実行、ファイルシステムの暗号化などを行います。

手順

1. /etc/fdo ディレクトリーに鍵と証明書を生成します。

   $ for i in "diun" "manufacturer" "device-ca" "owner"; do fdo-admin-tool generate-key-and-cert $i; done
   $ ls keys
   device_ca_cert.pem device_ca_key.der diun_cert.pem diun_key.der manufacturer_cert.pem manufacturer_key.der owner_cert.pem owner_key.der

2. /etc/fdo/keys ディレクトリーに作成された鍵と証明書を確認します。

   $ tree keys

   次の出力が表示されます。

   – device_ca_cert.pem
   – device_ca_key.der
   – diun_cert.pem
   – diun_key.dre
   – manufacturer_cert.pem
   – manufacturer_key.der
   – owner_cert.pem
   – owner_key.pem

手順

1. fdo-admin-cli パッケージをインストールします。

   # yum install -y fdo-admin-cli

2. fdo-manufacturing-server RPM パッケージがインストールされているかどうかを確認します。

   $ rpm -qa | grep fdo-manufacturing-server --refresh

3. ファイルが正しくインストールされたかどうかを確認します。

   $ ls /usr/share/doc/fdo

   次の出力が表示されます。

   Output:
   manufacturing-server.yml
   owner-onboarding-server.yml
   rendezvous-info.yml
   rendezvous-server.yml
   serviceinfo-api-server.yml

4. オプション: 各ファイルの内容を確認します。次に例を示します。

   $ cat /usr/share/doc/fdo/manufacturing-server.yml

5. 製造サーバーを設定します。次の情報を提供する必要があります。

   • 製造サーバーの URL
   • Rendezvous サーバーの IP アドレスまたは DNS 名

   • 生成したキーおよび証明書へのパス。キーおよび証明書の生成 を参照してください。

     製造サーバーの設定ファイルの例は、/usr/share/doc/fdo/manufacturing-server.yml ディレクトリーにあります。以下は、/etc/fdo ディレクトリーに作成および保存される manufacturing server.yml の例です。これには、作成したディレクトリー、証明書、キー、ランデブーサーバーの IP アドレス、およびデフォルトのポートへのパスが含まれています。

     session_store_driver:
       Directory:
         path: /etc/fdo/stores/manufacturing_sessions/
     ownership_voucher_store_driver:
       Directory:
         path: /etc/fdo/stores/owner_vouchers
     public_key_store_driver:
       Directory:
         path: /etc/fdo/stores/manufacturer_keys
     bind: "0.0.0.0:8080"
     protocols:
       plain_di: false
       diun:
         mfg_string_type: SerialNumber
         key_type: SECP384R1
         allowed_key_storage_types:
           - Tpm
           - FileSystem
         key_path: /etc/fdo/keys/diun_key.der
         cert_path: /etc/fdo/keys/diun_cert.pem
     rendezvous_info:
       - deviceport: 8082
         ip_address: 192.168.122.99
         ownerport: 8082
         protocol: http
     manufacturing:
       manufacturer_cert_path: /etc/fdo/keys/manufacturer_cert.pem
       device_cert_ca_private_key: /etc/fdo/keys/device_ca_key.der
       device_cert_ca_chain: /etc/fdo/keys/device_ca_cert.pem
       owner_cert_path: /etc/fdo/keys/owner_cert.pem
       manufacturer_private_key: /etc/fdo/keys/manufacturer_key.der

6. 製造サーバーを起動します。

   1. systemd ユニットファイルがサーバー内にあるかどうかを確認します。

      # systemctl list-unit-files | grep fdo | grep manufacturing
      fdo-manufacturing-server.service disabled disabled

   2. 製造サーバーを有効にして起動します。

      # systemctl enable --now fdo-manufacturing-server.service

   3. ファイアウォールのデフォルトのポートを開きます。

      # firewall-cmd --add-port=8080/tcp --permanent
      # systemctl restart firewalld

   4. サービスがポート 8080 でリッスンしていることを確認します。

      # ss -ltn

7. 簡略化されたインストーラーを使用して、RHEL for Edge をシステムにインストールします。簡略化されたインストーラーイメージを構築して、RHEL for Edge image イメージをプロビジョニングする を参照してください。

手順

1. fdo-rendezvous-server RPM パッケージをインストールします。

   # yum install -y fdo-rendezvous-server

2. 製造元証明書へのパスを含む、rendezvous-server.yml 設定ファイルを作成します。/usr/share/doc/fdo/rendezvous-server.yml に例があります。次の例は、/etc/fdo/rendezvous-server.yml に保存される設定ファイルを示しています。

   storage_driver:
     Directory:
       path: /etc/fdo/stores/rendezvous_registered
   session_store_driver:
     Directory:
       path: /etc/fdo/stores/rendezvous_sessions
   trusted_manufacturer_keys_path: /etc/fdo/keys/manufacturer_cert.pem
   max_wait_seconds: ~
   bind: "0.0.0.0:8082"

3. ランデブーサーバーサービスのステータスを確認します。

   # systemctl list-unit-files | grep fdo | grep rende
   fdo-rendezvous-server.service disabled disabled

   1. サービスが停止して無効になっている場合は、有効にして起動します。

      # systemctl enable --now fdo-rendezvous-server.service

4. サーバーがデフォルト設定のポート 8082 でリッスンしていることを確認します。

   # ss -ltn

5. このサーバーにファイアウォールが設定されている場合は、ポートを開きます。

   # firewall-cmd --add-port=8082/tcp --permanent
   # systemctl restart firewalld

手順

1. このサーバーに必要な RPM をインストールします。

   # dnf install -y fdo-owner-cli fdo-owner-onboarding-server

2. owner-onboarding-server.yml 設定ファイルを準備し、/etc/fdo/ ディレクトリーに保存します。このファイルには、コピー済みの証明書へのパスと、所有者サーバーサービスを公開する場所に関する情報を含めます。

   以下は、/usr/share/doc/fdo/owner-onboarding-server.yml で利用できる例です。URL や認証トークンなど、Service Info API への参照を見つけることができます。

   ---
   ownership_voucher_store_driver:
     Directory:
       path: /etc/fdo/stores/owner_vouchers
   session_store_driver:
     Directory:
       path: /etc/fdo/stores/owner_onboarding_sessions
   trusted_device_keys_path: /etc/fdo/keys/device_ca_cert.pem
   owner_private_key_path: /etc/fdo/keys/owner_key.der
   owner_public_key_path: /etc/fdo/keys/owner_cert.pem
   bind: "0.0.0.0:8081"
   service_info_api_url: "http://localhost:8083/device_info"
   service_info_api_authentication:
     BearerToken:
       token: Kpt5P/5flBkaiNSvDYS3cEdBQXJn2Zv9n1D50431/lo=
   owner_addresses:
     - transport: http
       addresses:
         - ip_address: 192.168.122.149

3. Service Info API を作成して設定します。

   1. ユーザー作成、コピーまたは作成するファイル、実行するコマンド、暗号化するディスクなどのオンボーディング用の自動化情報を追加します。/usr/share/doc/fdo/serviceinfo-api-server.yml にある Service Info API 設定ファイルの例をテンプレートとして使用し、/etc/fdo/ の下に設定ファイルを作成します。

      ---
      service_info:
        initial_user:
          username: admin
          sshkeys:
          - "ssh-rsa AAAA...."
        files:
        - path: /root/resolv.conf
          source_path: /etc/resolv.conf
        commands:
        - command: touch
          args:
          - /root/test
          return_stdout: true
          return_stderr: true
        diskencryption_clevis:
        - disk_label: /dev/vda4
          binding:
            pin: tpm2
            config: "{}"
          reencrypt: true
        additional_serviceinfo: ~
      bind: "0.0.0.0:8083"
      device_specific_store_driver:
        Directory:
          path: /etc/fdo/stores/serviceinfo_api_devices
      service_info_auth_token: Kpt5P/5flBkaiNSvDYS3cEdBQXJn2Zv9n1D50431/lo=
      admin_auth_token: zJNoErq7aa0RusJ1w0tkTjdITdMCWYkndzVv7F0V42Q=

4. systemd ユニットのステータスを確認します。

   # systemctl list-unit-files | grep fdo
   fdo-owner-onboarding-server.service        disabled        disabled
   fdo-serviceinfo-api-server.service         disabled        disabled

   1. サービスが停止して無効になっている場合は、有効にして起動します。

      # systemctl enable --now fdo-owner-onboarding-server.service
      # systemctl enable --now fdo-serviceinfo-api-server.service

      注記

      設定ファイルを変更するたびに、systemd サービスを再起動する必要があります。

5. サーバーがデフォルト設定のポート 8083 でリッスンしていることを確認します。

   # ss -ltn

6. このサーバーにファイアウォールが設定されている場合は、ポートを開きます。

   # firewall-cmd --add-port=8081/tcp --permanent
   # firewall-cmd --add-port=8083/tcp --permanent
   # systemctl restart firewalld

手順

1. デバイス上で RHEL for Edge の簡略化されたインストーラーイメージを起動して、インストールプロセスを開始します。たとえば、CD-ROM または USB フラッシュドライブからインストールできます。

2. ターミナルを介して、デバイスが製造サービスに到達し、最初のデバイスクレデンシャルエクスチェンジを実行して、所有権バウチャーを作成したことを確認します。

   所有権バウチャーは、Manufacturing-sever.yml ファイルの ownerning_voucher_store_driver: パラメーターで設定されている保管場所にあります。

   このディレクトリーには、正しいデバイスクレデンシャルがデバイスに追加されたことを示す、GUID 形式の名前を持つ owner_voucher ファイルが含まれているはずです。

   オンボーディングサーバーは、デバイス認証情報を使用して、オンボーディングサーバーに対して認証を行います。次に、設定をデバイスに渡します。デバイスはオンボーディングサーバーから設定を受け取った後、SSH キーを受け取り受信、デバイスにオペレーティングシステムをインストールします。最後に、システムは自動的に再起動し、TPM に保存されている強力なキーで暗号化します。

1. Service Info API で作成したユーザー名とパスワードを入力して、デバイスにログインします。

手順

1. ダウンロードしたイメージの .tar ファイルを展開します。

   # tar xvf <UUID>-commit.tar

2. .tar ファイルを展開したディレクトリーに移動します。

   これには、compose.json ファイルおよび OSTree ディレクトリーがあります。compose.json ファイルにはコミット番号があり、OSTree ディレクトリーには RPM パッケージがあります。

3. compose.json ファイルを開き、コミット ID 番号を書き留めます。Web サーバーの設定を進める際には、この番号が必要になります。

   jq JSON プロセッサーがインストールされている場合は、jq ツールを使用してコミット ID を取得することもできます。

   # jq '.["ostree-commit"]' < compose.json

4. コミットの RPM パッケージを一覧表示します。

   # rpm-ostree db list rhel/8/x86_64/edge --repo=repo

5. キックスタートファイルを使用して RHEL インストーラーを実行します。必要に応じて、既存のファイルを使用するか、Kickstart Generator ツールを使用して作成できます。

   キックスタートファイルに、ファイルシステムのプロビジョニング、ユーザーの作成、RHEL for Edge イメージの取得およびデプロイの方法の詳細を含めるようにしてください。RHEL インストーラーは、インストールプロセス中にこの情報を使用します。

   以下は、キックスタートファイルの例です。

   lang en_US.UTF-8
   keyboard us
   timezone Etc/UTC --isUtc
   text
   zerombr
   clearpart --all --initlabel
   autopart
   reboot
   user --name=core --group=wheel
   sshkey --username=core "ssh-rsa AAAA3Nza…​."
   rootpw --lock
   network --bootproto=dhcp
   
   ostreesetup --nogpg --osname=rhel --remote=edge --url=https://mirror.example.com/repo/ --ref=rhel/8/x86_64/edge

   OStree ベースのインストールでは、ostreesetup コマンドを使用して設定をセットアップします。OSTree のコミットを、以下のフラグを使用して取得します。

   • --nogpg - GNU Privacy Guard (GPG) キー検証を無効にします。
   • --osname - オペレーティングシステムのインストールの管理ルート。
   • --remote - オペレーティングシステムのインストールの管理ルート。
   • --url - インストール元となるリポジトリーの URL
   • --ref - インストールが使用するリポジトリーからのブランチの名前。

   • --url=http://mirror.example.com/repo/ - edge-commit を抽出して nginx で提供したホストシステムのアドレス。このアドレスを使用して、ゲストコンピューターからホストシステムにアクセスすることができます。

     たとえば、/var/www/html ディレクトリーにコミットイメージを抽出し、ホスト名がwww.example.com のコンピューターで nginx を介してコミットを提供する場合、--url パラメーターの値は http://www.example.com/repo となります。

     注記

     Apache HTTP Server では https が有効になっていないため、http プロトコルを使用してサービスを開始し、コミットを提供します。

手順

1. 以下の手順に従って、nginx 設定ファイルを作成します。

   events {
   
   }
   
   http {
       server{
           listen 8080;
           root /usr/share/nginx/html;
                   }
            }
   
   pid /run/nginx.pid;
   daemon off;

2. 以下の手順で Dockerfile を作成します。

   FROM registry.access.redhat.com/ubi8/ubi
   RUN yum -y install nginx && yum clean all
   COPY kickstart.ks /usr/share/nginx/html/
   COPY repo /usr/share/nginx/html/
   COPY nginx /etc/nginx.conf
   EXPOSE 8080
   CMD ["/usr/sbin/nginx", "-c", "/etc/nginx.conf"]
   ARG commit
   ADD ${commit} /usr/share/nginx/html/

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

   • kickstart.ks は、RHEL for Edge イメージのキックスタートファイルの名前です。キックスタートファイルには、ディレクティブの情報が含まれています。後でイメージを管理しやすくするためにも、greenboot チェックのチェックおよび設定を含むことが推奨されます。そのためには、以下の設定を含むようにキックスタートファイルを更新します。

     lang en_US.UTF-8
     keyboard us
     timezone Etc/UTC --isUtc
     text
     zerombr
     clearpart --all --initlabel
     autopart
     reboot
     user --name=core --group=wheel
     sshkey --username=core "ssh-rsa AAAA3Nza…​."
     
     ostreesetup --nogpg --osname=rhel --remote=edge
     --url=https://mirror.example.com/repo/
     --ref=rhel/8/x86_64/edge
     
     %post
     cat << EOF > /etc/greenboot/check/required.d/check-dns.sh
     #!/bin/bash
     
     DNS_SERVER=$(grep nameserver /etc/resolv.conf | cut -f2 -d" ")
     COUNT=0
     
     # check DNS server is available
     ping -c1 $DNS_SERVER
     while [ $? != '0' ] && [ $COUNT -lt 10 ]; do
     
     							
     							
     							
     							
     							
     							COUNT++
     echo "Checking for DNS: Attempt $COUNT ."
     sleep 10
     ping -c 1 $DNS_SERVER
     done
     EOF
     %end

     任意の HTTP サービスで OSTree リポジトリーをホストできます。コンテナーを使用する例は、これを行う方法のオプションにすぎません。Dockerfile は次のタスクを実行します。

     1. 最新の Universal Base Image (UBI) の使用
     2. Web サーバー (nginx) をインストールします。
     3. キックスタートファイルのサーバーへの追加
     4. RHEL for Edge イメージのコミットのサーバーへの追加

3. Docker コンテナーをビルドします。

   # podman build -t name-of-container-image --build-arg commit=uuid-commit.tar .

4. コンテナーを実行します。

   # podman run --rm -d -p port:8080 localhost/name-of-container-image

   これにより、サーバーがセットアップされ、commit.tar リポジトリーとキックスタートファイルを使用して、RHEL インストーラーを起動する準備が整いました。

手順

1. libvirt virt-install ユーティリティーを使用して RHEL Anaconda インストーラーを実行し、RHEL オペレーティングシステムで仮想マシン (VM) を作成します。.qcow2 ディスクイメージを有人インストールのターゲットディスクとして使用します。

   virt-install \
   --name rhel-edge-test-1 \
   --memory 2048 \
   --vcpus 2 \
   --disk path=prepared_disk_image.qcow2,format=qcow2,size=8 \
   --os-variant rhel8 \
   --cdrom /home/username/Downloads/rhel-8-x86_64-boot.iso

2. インストール画面で:

   図8.1 Red Hat Enterprise Linux 起動メニュー

   

   1. e キーを押して、追加のカーネルパラメーターを追加します。

      inst.ks=http://edge_device_ip:port/kickstart.ks

      カーネルパラメーターは、RHEL インストーラーに含まれる RHEL イメージではなく、キックスタートファイルを使用して RHEL をインストールすることを指定します。

   2. カーネルパラメーターを追加したら、Ctrl+X を押して、キックスタートファイルを使用して RHEL インストールを起動します。

      RHEL インストーラーが起動し、サーバー (HTTP) エンドポイントからキックスタートファイルを取得してコマンドを実行します。このコマンドには、HTTP エンドポイントから RHEL for Edge イメージコミットをインストールするコマンドが含まれます。インストールが完了すると、RHEL インストーラーからログインの詳細を求められます。

検証

1. ログイン 画面で、ユーザーアカウントの認証情報を入力し、Enter をクリックします。

2. RHEL for Edge イメージが正常にインストールされているかどうかを確認します。

   $ rpm-ostree status

   コマンドの出力には、イメージのコミット ID が表示され、正常にインストールされたことがわかります。

   以下は出力例です。

   State: idle
   Deployments:
   * ostree://edge:rhel/8/x86_64/edge
   		  Timestamp: 2020-09-18T20:06:54Z
   			Commit: 836e637095554e0b634a0a48ea05c75280519dd6576a392635e6fa7d4d5e96

手順

1. RHEL for Edge Container イメージを実行して Web サーバーを起動します。サーバーは、RHEL for Edge Container イメージ内のコミットをフェッチし、使用可能になり、実行可能になります。

2. libvirt virt-install を使用して、カスタマイズされた .qcow2 ディスクイメージを渡して RHEL Anaconda インストーラーを実行します。

   virt-install \
   --name rhel-edge-test-1 \
   --memory 2048 \
   --vcpus 2 \
   --disk path=prepared_disk_image.qcow2,format=qcow2,size=8 \
   --os-variant rhel8 \
   --cdrom /home/username/Downloads/rhel-8-x86_64-boot.iso

3. インストール画面で:

   図8.2 Red Hat Enterprise Linux 起動メニュー

   

   1. TAB キーを押して、キックスタートカーネル引数を追加します。

      inst.ks=http://web-server_device_ip:port/kickstart.ks

      カーネルパラメーターは、RHEL インストーラーに含まれる RHEL イメージではなく、キックスタートファイルを使用して RHEL をインストールすることを指定します。

   2. カーネルパラメーターを追加したら、Ctrl+X を押して、キックスタートファイルを使用して RHEL インストールを起動します。

      RHEL インストーラーが起動し、サーバー (HTTP) エンドポイントからキックスタートファイルを取得してコマンドを実行します。このコマンドには、HTTP エンドポイントから RHEL for Edge イメージコミットをインストールするコマンドが含まれます。インストールが完了すると、RHEL インストーラーからログインの詳細を求められます。

検証

1. ログイン 画面で、ユーザーアカウントの認証情報を入力し、Enter をクリックします。

2. RHEL for Edge イメージが正常にインストールされているかどうかを確認します。

   $ rpm-ostree status

   コマンドの出力には、イメージのコミット ID が表示され、正常にインストールされたことがわかります。

   以下は出力例です。

   State: idle
   Deployments:
   * ostree://edge:rhel/8/x86_64/edge
   		  Timestamp: 2020-09-18T20:06:54Z
   			Commit: 836e637095554e0b634a0a48ea05c75280519dd6576a392635e6fa7d4d5e96

手順

1. RHEL for Edge Container OSTree コミットをダウンロードしたディレクトリーに移動します。

2. RHEL for Edge Container OSTree コミットを Podman にロードします。

   $ sudo podman load -i UUID-container.tar

   コマンド出力にはイメージ ID が提供されます (例: @8e0d51f061ff1a51d157804362bc875b649b27f2ae1e66566a15e7e6530cec63)。

3. 前のステップで生成したイメージ ID を使用して、新しい RHEL for Edge Container イメージにタグ付けします。

   $ sudo podman tag image-ID localhost/edge-container

   podman tag コマンドは、ローカルイメージに別の名前を割り当てます。

4. edge-container という名前のコンテナーを実行します。

   $ sudo podman run -d --name=edge-container -p 8080:8080 localhost/edge-container

   podman run -d --name=edge-container コマンドは、localhost/edge-container イメージに基づいて、コンテナーに名前を割り当てます。

5. コンテナーをリスト表示します。

   $ sudo podman ps -a
   CONTAINER ID  IMAGE                               	COMMAND	CREATED    	STATUS                	PORTS   NAMES
   2988198c4c4b  …./localhost/edge-container   /bin/bash  3 seconds ago  Up 2 seconds ago      	edge-container

手順

1. RHEL for Edge Installer インストーラーイメージの作成を開始します。

   # composer-cli compose start-ostree --ref rhel/8/x86_64/edge --url URL-OSTree-repository blueprint-name image-type

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

   • ref は、お客様が ostree リポジトリーの構築に使用した値と同じです。
   • URL-OSTree-repository は、イメージに埋め込むコミットの OSTree リポジトリーへの URL です。たとえば、http://10.0.2.2:8080/repo/ です。ネットワークベース以外のデプロイメント用の RHEL for Edge Container イメージの作成 を参照してください。
   • blueprint-name は、RHEL for Edge Installer のブループリント名です。

   • image-type は edge-installer です。

     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>

   RHEL Image Builder は、イメージのビルド時に、実行中のコンテナーが提供するコミットをプルします。

   イメージのビルドが完了したら、作成された ISO イメージをダウンロードできます。

3. イメージをダウンロードします。RHEL for Edge イメージのダウンロード を参照してください。

   イメージの準備ができたら、ネットワーク以外のデプロイメント に使用できます。ネットワークベース以外のデプロイメント向けの RHEL for Edge イメージのインストール を参照してください。

手順

1. (.iso) イメージをインストールするための qcow 仮想マシンディスクファイルを作成します。これは、仮想マシン用のハードディスクドライブのイメージです。以下に例を示します。

   $ qemu-img create -f qcow2 diskfile.qcow2 20G

2. virt-install コマンドを使用して、ディスクをドライブとして使用し、Installer ISO イメージを CD-ROM として使用して仮想マシンを起動します。以下に例を示します。

   $ virt-install \
   --boot uefi \
   --name VM_NAME
   --memory 2048 \
   --vcpus 2 \
   --disk path=diskfile.qcow2
   --cdrom /var/lib/libvirt/images/UUID-installer.iso \
   --os-variant rhel9.0

   このコマンドは、virt-install に次のように指示します。

   • BIOS の代わりに UEFI を使用して起動するよう仮想マシンに指示します。
   • インストール ISO をマウントします。

   • 最初の手順で作成したハードディスクドライブイメージを使用します。

     Anaconda インストーラーを指定します。RHEL インストーラーが起動し、ISO からキックスタートファイルを読み込み、RHEL for Edge イメージのコミットのインストールなど、コマンドを実行します。インストールが完了すると、RHEL インストーラーはログイン詳細を要求します。

     注記

     Anaconda は、インストール時にコンテナーコミットを使用するように事前設定されています。ただし、ディスクパーティション、タイムゾーンなどのシステム設定を設定する必要があります。

3. virt-viewer を使用して Anaconda GUI に接続し、システム設定をセットアップします。

   $ virt-viewer --connect qemu:///system --wait VM_NAME

4. システムを再起動して、インストールを完了します。
5. ログイン画面で、ユーザーアカウントの認証情報を指定し、Enter をクリックします。

検証手順

1. RHEL for Edge イメージが正常にインストールされているかどうかを確認します。

   $  rpm-ostree status

手順

1. RHEL Image Builder からコンテナーイメージをダウンロードします。

   $ composer-cli compose image <UUI>

2. コンテナーを Podman にインポートします。

   $ skopeo copy oci-archive:<UUI>-container.tar containers-storage:localhost/ostree

3. コンテナーを起動し、ポート 8080 を使用して利用可能にします。

   $ podman run -rm -p 8080:8080 ostree

手順

1. 空のブループリントを作成し、"rhel-93" をディストリビューションとして使用するようにカスタマイズします。

   name = "minimal-rhel93"
   description = "minimal blueprint for ostree commit"
   version = "1.0.0"
   modules = []
   groups = []
   distro = "rhel-93"

2. ブループリントをサーバーにプッシュします。

   # composer-cli blueprints push minimal-rhel93.toml

3. 作成したブループリントから RHEL for Edge Commit (.tar) イメージをビルドします。

   # composer-cli compose start-ostree minimal-rhel93 edge-commit

4. .tar ファイルを取得し、ディスクに解凍します。

   # composer-cli compose image _<rhel-93-uuid>
   $ tar -xf <rhel-93-uuid>.tar -C /usr/share/nginx/html/

   ディスク上の /usr/share/nginx/html/repo が、すべての ref とコミットの一元的な OSTree リポジトリーになります。

5. 別の空のブループリントを作成し、"rhel-89" をディストリビューションとして使用するようにカスタマイズします。

   name = "minimal-rhel89"
   description = "minimal blueprint for ostree commit"
   version = "1.0.0"
   modules = []
   groups = []
   distro = "rhel-89"

6. ブループリントをプッシュし、別の RHEL for Edge Commit (.tar) イメージを作成します。

1. .tar ファイルを取得し、ディスクに解凍します。

   # composer-cli compose image <rhel-89-uuid>
   $ tar -xf <rhel-89-uuid>.tar

2. コミットをローカルリポジトリーにプルします。ostree pull-local を使用すると、あるローカルリポジトリーから別のローカルリポジトリーにコミットデータをコピーできます。

   # ostree --repo=/usr/share/nginx/html/repo pull-local repo

3. オプション: OSTree リポジトリーのステータスを検査します。出力例を以下に示します。

   $ ostree --repo=/usr/share/nginx/html/repo refs
   
   rhel/8/x86_64/edge
   rhel/9/x86_64/edge
   
   $ ostree --repo=/usr/share/nginx/html/repo show rhel/8/x86_64/edge
   commit f7d4d95465fbd875f6358141f39d0c573df6a321627bafde68c73850667e5443
   ContentChecksum:  41bf2f8b442a770e9bf03e096a46a286f5836e0a0702b7c3516ef4e0acec2dea
   Date:  2023-09-15 16:17:04 +0000
   Version: 8.9
   (no subject)
   
   $ ostree --repo=/usr/share/nginx/html/repo show rhel/9/x86_64/edge
   commit 89290dbfd6f749700c77cbc434c121432defb0c1c367532368eee170d9e53ea9
   ContentChecksum:  70235bfb9cae82c53f856183750e809becf0b9b076122b19c40fec92fc6d74c1
   Date:  2023-09-15 15:30:24 +0000
   Version: 9.3
   (no subject)

4. RHEL 9.3 ブループリントを更新して新しいパッケージを追加し、新しいコミットをビルドします。以下に例を示します。

   name = "minimal-rhel93"
   description = "minimal blueprint for ostree commit"
   version = "1.1.0"
   modules = []
   groups = []
   distro = "rhel-93"
   
   [[packages]]
   name = "strace"
   version = "*"

5. 更新されたブループリントをプッシュし、新しい RHEL for Edge Commit (.tar) イメージを作成します。compose が既存の OSTree リポジトリーを参照するようにします。

   # composer-cli blueprints push minimal-rhel93.toml
   # composer-cli compose start-ostree minimal-rhel93 edge-commit --url http://localhost/repo --ref rhel/9/x86_64/edge

6. .tar ファイルを取得し、ディスクに解凍します。

   # rm -rf repo
   # composer-cli compose image <rhel-93-uuid>
   # tar -xf <rhel-93-uuid>.tar

7. コミットをリポジトリーにプルします。

   # ostree --repo=/usr/share/nginx/html/repo pull-local repo

8. オプション: OSTree リポジトリーのステータスを再度検査します。

   $ ostree --repo=/usr/share/nginx/html/repo refs
   rhel/8/x86_64/edge
   rhel/9/x86_64/edge
   
   $ ostree --repo=/usr/share/nginx/html/repo show rhel/8/x86_64/edge
   commit f7d4d95465fbd875f6358141f39d0c573df6a321627bafde68c73850667e5443
   ContentChecksum:  41bf2f8b442a770e9bf03e096a46a286f5836e0a0702b7c3516ef4e0acec2dea
   Date:  2023-09-15 16:17:04 +0000
   Version: 8.9
   (no subject)
   
   $ ostree --repo=/usr/share/nginx/html/repo show rhel/9/x86_64/edge
   commit a35c3b1a9e731622f32396bb1aa84c73b16bd9b9b423e09d72efaca11b0411c9
   Parent:  89290dbfd6f749700c77cbc434c121432defb0c1c367532368eee170d9e53ea9
   ContentChecksum:  2335930df6551bf7808e49f8b35c45e3aa2a11a6c84d988623fd3f36df42a1f1
   Date:  2023-09-15 18:21:31 +0000
   Version: 9.3
   (no subject)
   
   $ ostree --repo=/usr/share/nginx/html/repo log rhel/9/x86_64/edge
   commit a35c3b1a9e731622f32396bb1aa84c73b16bd9b9b423e09d72efaca11b0411c9
   Parent:  89290dbfd6f749700c77cbc434c121432defb0c1c367532368eee170d9e53ea9
   ContentChecksum:  2335930df6551bf7808e49f8b35c45e3aa2a11a6c84d988623fd3f36df42a1f1
   Date:  2023-09-15 18:21:31 +0000
   Version: 9.3
   (no subject)
   
   commit 89290dbfd6f749700c77cbc434c121432defb0c1c367532368eee170d9e53ea9
   ContentChecksum:  70235bfb9cae82c53f856183750e809becf0b9b076122b19c40fec92fc6d74c1
   Date:  2023-09-15 15:30:24 +0000
   Version: 9.3
   (no subject)
   
   $ rpm-ostree db diff --repo=/usr/share/nginx/html/repo 89290dbfd6f749700c77cbc434c121432defb0c1c367532368eee170d9e53ea9 a35c3b1a9e731622f32396bb1aa84c73b16bd9b9b423e09d72efaca11b0411c9
   ostree diff commit from: 89290dbfd6f749700c77cbc434c121432defb0c1c367532368eee170d9e53ea9
   ostree diff commit to:   a35c3b1a9e731622f32396bb1aa84c73b16bd9b9b423e09d72efaca11b0411c9
   Added:
     elfutils-default-yama-scope-0.188-3.el9.noarch
     elfutils-libs-0.188-3.el9.x86_64
     strace-5.18-2.el9.x86_64