RHEL システムイメージのカスタマイズ

手順

1. RHEL Image Builder とその他の必要なパッケージをインストールします。

   # dnf install image-builder cockpit-image-builder

   Copy to Clipboard Toggle word wrap
   • image-builder は、カスタマイズされた RHEL オペレーティングシステムイメージをビルドし、CLI インターフェイスへのアクセスを可能にするサービスです。
   • cockpit-image-builder は、Web UI インターフェイスへのアクセスを可能にするパッケージです。Web コンソールは、cockpit-image-builder パッケージの依存関係としてインストールされます。

2. Web コンソールで RHEL Image Builder を使用する場合は、それを有効にして起動します。

   # systemctl enable --now cockpit.socket

   Copy to Clipboard Toggle word wrap

   image-builder と cockpit サービスは、初回アクセス時に自動的に起動します。

手順

1. * イメージをビルドし、追加のリポジトリーを RHEL Image Builder に加えます。

   $ image-builder build <image-type> \
   --force-repo=<file:///path/to/my/repo> \

   Copy to Clipboard Toggle word wrap
   警告

   ここで定義したリポジトリーがすべての依存関係を解決するために使用されることに注意してください。これにより、システムに問題が発生する可能性があります。

手順

1. 現在設定されている Satellite リポジトリーの中から、リポジトリーの URL を確認します。

   次の出力は例です。

   https://satellite6.example.com/pulp/content/<your_org>/<your_env>/<your_cv>/content/dist/rhel10/10/x86_64/baseos/os

   Copy to Clipboard Toggle word wrap

2. イメージをビルドし、Satellite リポジトリーを RHEL Image Builder に加えます。

   $ image-builder build <image-type> \
   --add-repo=<file:///path/to/satellite/repo> \

   Copy to Clipboard Toggle word wrap

手順

1. Satellite Web UI で、Content に移動し、Products を見つけて、Product を選択し、使用するリポジトリーをクリックします。
2. Published フィールドで、セキュアな URL (HTTPS) を検索してコピーします。
3. コピーした URL を Red Hat Image Builder リポジトリーのベース URL として使用します。RHEL Image Builder へのカスタムサードパーティーリポジトリーの追加 を参照してください。

1. ブループリントを作成するか、既存のブループリント定義をプレーンテキストファイルにエクスポートします。
2. オプション: このファイルをテキストエディターで編集します。
3. ブループリントテキストファイルを Image Builder にインポートします。
4. Compose を実行してブループリントからイメージをビルドします。
5. イメージファイルをエクスポートしてダウンロードします。

手順

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

   name = "<blueprint_name>"
   description = "<long_form_description>"
   version = "<0.0.1>"
   modules = []
   groups = []

   Copy to Clipboard Toggle word wrap

   <blueprint_name> と <long_form_description> は、ブループリントの名前と説明に置き換えます。

   <0.0.1> は、セマンティックバージョニングスキームに従ったバージョン番号に置き換えます。

2. ブループリントに含まれるすべてのパッケージに、次の行をファイルに追加します。

   [[packages]]
   name = "<package_name>"
   version = "<package_version>"

   Copy to Clipboard Toggle word wrap

   <package_name> は、httpd、gdb-doc、coreutils などのパッケージ名に置き換えます。

   必要に応じて、<package_version> は使用するバージョンに置き換えます。このフィールドは、dnf のバージョン指定に対応しています。

   • 特定のバージョンの場合は、9.6.0 などの正確なバージョン番号を使用します。
   • 最新バージョンの場合は、アスタリスク * を使用します。
   • 最新のマイナーバージョンの場合は、9.* などの形式を使用します。

3. ニーズに合わせてブループリントをカスタマイズします。たとえば、Simultaneous Multi Threading (SMT) を無効にするには、ブループリントファイルに次の行を追加します。

   [customizations.kernel]
   append = "nosmt=force"

   Copy to Clipboard Toggle word wrap

   利用可能な追加のカスタマイズは、サポートされているイメージのカスタマイズ を参照してください。

   [] と [[]] は TOML で表現される異なるデータ構造であることに注意してください。

   • [customizations.kernel] ヘッダーは、キーとキーに対応する値のペアの集合によって定義される単一のテーブルを表します (例: append = "nosmt=force")。
   • [[packages]] ヘッダーはテーブルの配列を表します。最初のインスタンスで、配列とその最初のテーブル要素を定義します (例: name = "package-name"、version = "package-version")。後続の各インスタンスで、指定の順序で、その配列内に新しいテーブル要素を作成して定義します。
4. ファイルを、たとえば <blueprint_name>.toml として保存し、テキストエディターを閉じます。

手順

1. オプション: 作成できるイメージ形式をリストします。

   # image-builder list

   Copy to Clipboard Toggle word wrap

2. Compose を起動します。

   # image-builder build <image_type> --blueprint <blueprint_name>

   Copy to Clipboard Toggle word wrap

   <blueprint_name> はブループリントの名前に置き換え、<image_type> はイメージのタイプに置き換えます。
   ディストリビューションを指定しない場合、インストールされているものと同じディストリビューションが image-builder によって使用されます。

   Compose プロセスが開始します。完了するまでに数分かかります。イメージの準備ができるまで、イメージビルドの進行状況を追うことができます。

   イメージのビルドプロセスが完了すると、作成先のディレクトリーでイメージを使用できるようになります。

手順

1. kernel.json ファイルを作成し、RT カーネルリポジトリーを含めます。

       {
         "name": "kernel-rt",
         "baseurl": "https://cdn.redhat.com/content/dist/rhel10/10/x86_64/rt/os",
         "gpgkey": "-----BEGIN PGP PUBLIC KEY BLOCK-----\n\nmQINBEr………fg==\n=UZd/\n-----END PGP PUBLIC KEY BLOCK-----\n",
         "rhsm": true,
         "check_gpg": true
       },

   Copy to Clipboard Toggle word wrap

2. ブループリントを作成します。ブループリントに、"[customizations.kernel]" カスタマイズを追加します。以下は、ブループリントに "[customizations.kernel]" を追加した例です。

   name = "rt-kernel-image"
   description = ""
   version = "2.0.0"
   modules = []
   groups = []
   distro = "rhel-10.0"
   [[customizations.user]]
   name = "admin"
   password = "admin"
   groups = ["users", "wheel"]
   [customizations.kernel]
   name = "kernel-rt"
   append = ""

   Copy to Clipboard Toggle word wrap

3. 作成したブループリントからイメージをビルドします。次の例では、.qcow2 イメージをビルドします。

   # image-builder build qcow2 -- blueprint rt-kernel-image --data-dir kernel.json

   Copy to Clipboard Toggle word wrap
4. ビルドしたイメージを、リアルタイムカーネル機能を使用するシステムにデプロイします。

手順

1. ホスト上で、Web ブラウザーで https://localhost:9090/ を開きます。
2. root ユーザーとして Web コンソールにログインします。

3. RHEL Image Builder のコントロールを表示するには、ウィンドウの左上隅にある Image Builder ボタンをクリックします。

   RHEL Image Builder ダッシュボードが開き、既存のブループリントがあればそれがリストされます。

手順

1. 右上隅にある Create Blueprint をクリックします。

   Images ダイアログボックスが開きます。

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

   1. Release バージョンと Architecture を選択します。
   2. ターゲット環境を 1 つまたは複数選択します。
   3. Next をクリックします。

3. オプション: File system configuration ページで、イメージファイルシステムのパーティションを Use automatic partitioning または Manually configure partitions を選択します。パーティションを手動で設定するには、次の手順を実行します。

   1. Manually configure partitions ボタンをクリックします。

   2. ドロップダウンメニューから、パーティションを設定するための詳細を入力します。

      • Mount point フィールドに、以下のマウントポイントタイプオプションのいずれかを選択します。

        • /app
        • /boot
        • /data
        • /home
        • /opt
        • /srv
        • /tmp
        • /usr

        • /var

          Mount point に追加のパスを追加することもできます。たとえば、マウントポイントとして /var を選択し、追加のパスとして /tmp を加えると、/var/tmp になります。選択したマウントポイントの種類によっては、ファイルシステムの種類が xfs に変更されます。

      • ファイルシステムの Minimum size partition フィールドに、必要な最小パーティションサイズを入力します。Minimum size ドロップダウンメニューでは、GB、MB、KB などの一般的なサイズ単位を使用できます。デフォルトの単位は GB です。

        Minimum size を設定するのは、パーティションサイズが小さすぎて正常に機能するイメージを作成できない場合に、RHEL Image Builder がパーティションサイズを拡張することがあるためです。

   3. パーティションを追加するには、Add partition ボタンをクリックします。"Duplicate partitions: Only one partition at each mount point can be created." というエラーメッセージが表示される場合は、次のいずれかの操作を実行すると修正できます。

      • Remove ボタンをクリックして、重複したパーティションを削除します。
      • 作成するパーティションの新しいマウントポイントを選択します。
   4. パーティション設定が完了したら、Next をクリックします。

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

   1. Available packages の検索で、パッケージ名を入力します。
   2. ボタンをクリックして、Chosen packages フィールドに移動します。
   3. 前のステップを繰り返して、必要な数のパッケージを検索して含めます。
   4. Next をクリックします。

5. オプション: Users ページで、ユーザーを追加します。

   1. Add user をクリックします。
   2. Username、Password、および SSH key を入力します。また、Administrator チェックボックスをクリックして、そのユーザーを特権ユーザーとして指定することもできます。
   3. Next をクリックします。

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

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

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

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

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

   1. Languages 検索フィールドに、システムイメージに追加するロケール識別子を入力します。たとえば、"us" と入力します。
   2. Keyboard 検索フィールドに、システムイメージに追加するロケール識別子を入力します。たとえば、["en_US.UTF-8"] と入力します。
   3. Next をクリックします。
8. オプション: Hostname ページでホスト名を追加し、Next をクリックします。

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

   1. カーネル名を入力します。
   2. カーネルのコマンドライン引数を追加します。
   3. Next をクリックします。

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

    1. port 番号を入力します。
    2. 有効または無効にするファイアウォールサービスを追加します。
    3. Next をクリックします。

11. オプション: Systemd services ページで、有効または無効にするサービスを追加します。

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

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

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

13. Review ページでブループリントの詳細を確認し、ドロップダウンメニューから次のいずれかのオプションを選択します。

    • Create blueprint をクリックします。

    • Create blueprint and build image(s) をクリックします。

      RHEL Image Builder ビューが開き、既存のブループリントがリスト表示されます。

手順

1. RHEL Image Builder ダッシュボードで、Import blueprint をクリックします。Import blueprint が開きます。
2. Upload フィールドから、既存のブループリントをドラッグまたはアップロードします。TOML と JSON のどちらかの形式のブループリントを使用できます。
3. Import をクリックします。ダッシュボードに、インポートしたブループリントがリストされます。

手順

1. Image Builder ダッシュボードで、エクスポートするブループリントを選択します。
2. Export blueprint をクリックします。Export blueprint が開きます。

3. Export ボタンをクリックしてブループリントをファイルとしてダウンロードするか、Copy ボタンをクリックしてブループリントをクリップボードにコピーします。

   1. オプション: ブループリントをコピーするには、Copy ボタンをクリックします。

手順

1. RHEL Image Builder ダッシュボードで、blueprint タブをクリックします。
2. ブループリントのテーブルで、イメージをビルドするブループリントを見つけます。
3. 選択したブループリントの右側で、Create Image をクリックします。Create image ダイアログウィザードが開きます。

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

   1. Select a blueprint リストから、必要なイメージのタイプを選択します。

   2. Image output type リストから、必要なイメージの出力タイプを選択します。

      選択したイメージの種類に応じて、さらに詳細を追加する必要があります。

5. Next をクリックします。

6. Review ページで、イメージの作成に関する詳細を確認し、Create image をクリックします。

   イメージのビルドが開始され、完了するまでに最大 20 分かかります。

手順

1. ISO イメージを作成します。

   # image-builder build iso --blueprint <blueprint_name>

   Copy to Clipboard Toggle word wrap
   • <blueprint_name> は作成したブループリントの名前です。

   • <image_installer> はイメージタイプです。

     Compose プロセスが開始します。完了するまでに数分かかる場合があります。

     RHEL Image Builder により、.tar ファイルを含む .iso ファイルがビルドされます。.tar ファイルは、オペレーティングシステム用にインストールされるイメージです。.iso は、Anaconda を起動し、.tar ファイルをインストールしてシステムをセットアップするように設定されています。

1. 作成した .iso イメージを見つけます。

2. ISO イメージをマウントします。

   $ mount -o ro <path_to_iso> /mnt

   Copy to Clipboard Toggle word wrap

   .tar ファイルは /mnt/liveimg.tar.gz ディレクトリーにあります。

3. .tar ファイルの内容をリスト表示します。

   $ tar ztvf /mnt/liveimg.tar.gz

   Copy to Clipboard Toggle word wrap

手順

1. RHEL Image Builder のダッシュボードで、イメージのビルドに使用するブループリントを見つけます。必要に応じて、左上の検索ボックスにブループリント名またはその一部を入力し、Enter を押します。

2. ブループリントの右側で、対応する Create Image ボタンをクリックします。

   Create image ダイアログウィザードが開きます。

3. Create image ダイアログウィザードで:

   1. Image Type リストで、"RHEL Installer (.iso)" を選択します。
   2. Next をクリックします。

   3. Review タブで Create をクリックします。

      RHEL Image Builder は、RHEL ISO イメージの Compose をキューに追加します。

      プロセスが完了すると、Image build complete のステータスが表示されます。RHEL Image Builder は ISO イメージを作成します。

1. Download をクリックして、"RHEL Installer (.iso)" イメージをシステムに保存します。
2. "RHEL Installer (.iso)" イメージをダウンロードしたフォルダーに移動します。
3. ダウンロードした .tar イメージを見つけます。

4. "RHEL Installer (.iso)" イメージの内容を展開します。

   $ tar -xf <content>.tar

   Copy to Clipboard Toggle word wrap

手順

1. dd ツールを使用して、ブート可能な ISO イメージを USB ドライブに直接書き込みます。以下に例を示します。

   dd if=installer.iso of=/dev/sdX

   Copy to Clipboard Toggle word wrap

   ここで、installer.iso は ISO イメージファイル名、/dev/sdX は USB フラッシュドライブのデバイスパスです。

2. 起動するコンピューターの USB ポートにフラッシュドライブを挿入します。

3. USB フラッシュドライブから ISO イメージを起動します。

   インストール環境が開始したら、デフォルトの Red Hat Enterprise Linux インストールと同様に、インストールの手動完了が必要になることがあります。

手順

1. OpenSCAP ツールと scap-security-guide コンテンツを使用して、TOML 形式でハードニングブループリントを作成し、必要に応じて変更します。

   # oscap xccdf generate fix --profile=<profileID> --fix-type=<blueprint> /usr/share/xml/scap/ssg/content/ssg-rhel10-ds.xml > cis.toml

   Copy to Clipboard Toggle word wrap

   <profileID> は、システムが準拠する必要があるプロファイル ID (例: cis) に置き換えます。

2. ハードニング済みイメージのビルドを開始します。

   # image-builder build <image_type> --blueprint <blueprint_name>

   Copy to Clipboard Toggle word wrap

   <image_type> は、任意のイメージタイプ (例: qcow2) に置き換えます。

   イメージビルドの準備ができたら、デプロイメントでハードニング済みイメージを使用できます。KVM ゲストイメージからの仮想マシンの作成 を参照してください｡

手順

1. 選択したプロファイルから TOML 形式でハードニングブループリントを作成します。以下に例を示します。

   # oscap xccdf generate fix --profile=<profileID> --fix-type=blueprint /usr/share/xml/scap/ssg/content/ssg-rhel10-ds.xml > <profileID>tailored.toml

   Copy to Clipboard Toggle word wrap

2. カスタマイズしたルールセットを含むテーラリングセクションをブループリントに追加します。テーラリングカスタマイズでは、ルールを選択または選択解除します。これが反映されるのは、カスタマイズのベースとなるプロファイルに含まれるルールのデフォルトの選択状態または選択解除状態だけです。他のルールの状態は変更されないことに注意してください。

   # Blueprint for CIS Red Hat Enterprise Linux 10.0 Benchmark for Level 2 - Server
   # ...
   [customizations.openscap.tailoring]
   selected = [ "xccdf_org.ssgproject.content_bind_crypto_policy" ]
   unselected = [ "grub2_password" ]

   Copy to Clipboard Toggle word wrap

3. ハードにング済みイメージのビルドを開始します。

   # *image-builder build <image_type> --blueprint <blueprintProfileID> *

   Copy to Clipboard Toggle word wrap

   <image_type> は、任意のイメージタイプ (例: qcow2) に置き換えます。

   イメージのビルドが準備できたら、デプロイメントでハードニング済みイメージを使用します。

手順

1. 作成したブループリント名をクリックします。
2. Images タブを選択します。
3. Create Image をクリックして、カスタマイズしたイメージを作成します。Create Image ウィンドウが開きます。
4. Type ドロップダウンメニューリストから、QEMU Image(.qcow2) を選択します。
5. インスタンス化するときのイメージのサイズを設定し、Create をクリックします。
6. ウィンドウの右上にある小さなポップアップに、イメージの作成がキューに追加されたことが表示されます。イメージ作成プロセスが完了すると、Image build complete のステータスが表示されます。

手順

1. RHEL Image Builder を使用して作成した .qcow2 イメージを /var/lib/libvirt/images/ ディレクトリーに移動します。

2. たとえば、cloudinitiso というディレクトリーを作成し、新しく作成したこのディレクトリーに移動します。

   $ mkdir cloudinitiso
   $ cd cloudinitiso

   Copy to Clipboard Toggle word wrap

3. meta-data という名前のファイルを作成します。このファイルに以下の情報を追加します。

   instance-id: citest
   local-hostname: vmname

   Copy to Clipboard Toggle word wrap

4. user-data という名前のファイルを作成します。以下の情報をファイルに追加します。

   # cloud-config
   user: admin
   password: password
   chpasswd: {expire: False}
   ssh_pwauth: True
   ssh_authorized_keys:
     - ssh-rsa AAA...fhHQ== your.email@example.com

   Copy to Clipboard Toggle word wrap

   ssh_authorized_keys は SSH 公開鍵です。SSH 公開鍵は ~/.ssh/id_rsa.pub\ にあります。

5. genisoimage ユーティリティーを使用して、user-data ファイルおよび meta-data ファイルを含む ISO イメージを作成します。

   # genisoimage -output cloud-init.iso -volid cidata -joliet -rock user-data meta-data
   
   I: -input-charset not specified, using utf-8 (detected in locale settings)
   Total translation table size: 0
   Total rockridge attributes bytes: 331
   Total directory bytes: 0
   Path table size(bytes): 10
   Max brk space used 0
   183 extents written (0 MB)

   Copy to Clipboard Toggle word wrap

6. virt-install コマンドを使用して、KVM ゲストイメージから新しい仮想マシンを作成します。ステップ 4 で作成した ISO イメージを、仮想マシンイメージへのアタッチメントとして含めます。

   # virt-install \
       --memory 4096 \
       --vcpus 4 \
       --name myvm \
       --disk rhel-10-x86_64-kvm.qcow2,device=disk,bus=virtio,format=qcow2 \
       --disk cloud-init.iso,device=cdrom \
       --os-variant rhel 10 \
       --virt-type kvm \
       --graphics none \
       --import

   Copy to Clipboard Toggle word wrap
   • --graphics none は、ヘッドレス RHEL 10 仮想マシンであることを意味します。
   • --vcpus 4 は 4 つの仮想 CPU を使用することを意味します。
   • --memory 4096 は 4096 MB の RAM を使用することを意味します。

7. 仮想マシンのインストールが起動します。

   Starting install...
   Connected to domain mytestcivm
   ...
   [  OK  ] Started Execute cloud user/final scripts.
   [  OK  ] Reached target Cloud-init target.
   
   Red Hat Enterprise Linux 10 (Ootpa)
   Kernel 4.18.0-221.el8.x86_64 on an x86_64

   Copy to Clipboard Toggle word wrap

1. ユーザー名として admin と入力し、Enter を押します。

2. password としてパスワードを入力し、Enter を押します。

   ログイン認証が完了すると、CLI を使用して仮想マシンにアクセスできるようになります。

手順

1. Vagrant ボックスイメージをビルドします。

   • libvirt の場合:

     $ sudo image-builder build --distro rhel-10.0 vagrant-libvirt

     Copy to Clipboard Toggle word wrap

   • VirtualBox の場合:

     $ sudo image-builder build - -distro <distro-name> vagrant-virtualbox

     Copy to Clipboard Toggle word wrap

     これにより、.box ファイルが作成されます。

2. 新しい .box ファイルをローカルの Vagrant 環境にインポートします。provider を明示的に virtualbox に設定する必要があります。virtualbox は標準のプロバイダーではないためです。

   $ vagrant box add --provider=virtualbox <path/to/box> --name=<box-name>

   Copy to Clipboard Toggle word wrap

   path/to/image-name.box はファイルへの実際のパスに置き換え、<box_name> は rhel10-vagrant などの名前に置き換えます。

3. プロジェクト用の新しいディレクトリーを作成し、Vagrant を初期化します。

   $ mkdir <my_vagrant_project>
   $ cd <my_vagrant_project>
   $ vagrant init <box-name>

   Copy to Clipboard Toggle word wrap

   これにより、Vagrantfile 設定ファイルが作成され、そのデフォルトボックスが <box-name> に設定されます。

4. Vagrant を使用して仮想マシンを起動します。

   $ vagrant up

   Copy to Clipboard Toggle word wrap

手順

1. コンテナープロバイダーを選択するために、registry-config.toml ファイルをセットアップします。認証情報はオプションです。

   provider = "<container_provider>"
   [settings]
   tls_verify = false
   username = "<admin>"
   password = "<your_password>"

   Copy to Clipboard Toggle word wrap

2. ブループリントを .toml 形式で作成します。これは、ブループリントに nginx パッケージをインストールするコンテナーのブループリントです。

   name = "simple-container"
   description = "Simple RHEL container"
   version = "0.0.1"
   [[packages]]
   name = "nginx"
   version = "*"

   Copy to Clipboard Toggle word wrap

3. レジストリーとリポジトリーを image-builder ツールに引数として渡し、コンテナーイメージをビルドします。

   # image-builder build --blueprint <simple-container> --extra-repo "quay.io:8080/<namespace>/<repository>" --extra-repo registry-config.toml

   Copy to Clipboard Toggle word wrap
   注記

   コンテナーイメージのビルドには、カスタマイズされたパッケージの依存関係を解決するため時間がかかります。

4. イメージのビルドが完了すると、作成したコンテナーが quay.io で使用できるようになります。

検証

1. quay.io を開き、Repository Tags をクリックします。作成したコンテナーに関する次のような詳細が表示されます。

   • 最終更新日
   • イメージサイズ
   • クリップボードにコピーできる manifest ID
2. manifest ID の値をコピーして、コンテナーを埋め込むイメージをビルドします。

手順

1. qcow2 イメージをビルドするためのブループリントを作成します。このブループリントには、[[containers]] のカスタマイズを含める必要があります。

   name = "image"
   description = "A qcow2 image with a container"
   version = "0.0.1"
   distro = "rhel-10"
   [[packages]]
   name = "podman"
   version = "*"
   [[containers]]
   source = "registry.access.redhat.com/ubi10:8080/image/container/container-image@sha256:manifest-ID-from-Repository-tag: tag-version"
   name =  "source"
   tls-verify = true

   Copy to Clipboard Toggle word wrap

2. コンテナーイメージをビルドします。

   # image-builder build qcow2 --blueprint <blueprint>

   Copy to Clipboard Toggle word wrap
   注記

   quay.io レジストリーでコンテナーをチェックするため、イメージのビルドに時間がかかります。

   作成してダウンロードした qcow2 イメージを使用して、仮想マシンを作成できます。

検証

1. 生成された qcow2 イメージを見つけます。
2. 仮想マシンで qcow2 イメージを起動します。KVM ゲストイメージからの仮想マシンの作成 を参照してください｡
3. qemu ウィザードが開きます。ユーザー名とパスワードを入力して qcow2 イメージにログインします。customizations.user セクションの .qcow2 ブループリントで設定したユーザー名とパスワードか、cloud-init を使用して起動時に作成したユーザー名とパスワードを使用できます。

4. コンテナーイメージを実行し、コンテナー内でシェルプロンプトを開きます。

   # podman run -it registry.access.redhat.com/ubi10:8080/<organization>/<repository>/bin/bash/

   Copy to Clipboard Toggle word wrap

   registry.access.redhat.com はターゲットレジストリー、<organization> は組織、repository はビルドの完了時にコンテナーをプッシュする場所です。

5. ブループリントに追加したパッケージが利用可能であることを確認します。

   # type -a nginx

   Copy to Clipboard Toggle word wrap

   出力には、nginx パッケージのパスが表示されます。

手順

1. Python 3 と pip ツールをインストールします。

   # dnf install python3 python3-pip

   Copy to Clipboard Toggle word wrap

2. pip を使用して AWS コマンドラインツール をインストールします。

   # pip3 install awscli

   Copy to Clipboard Toggle word wrap

3. プロファイルを設定します。ターミナルで、認証情報、リージョン、および出力形式を指定するように求められます。

   $ aws configure
   AWS Access Key ID [None]:
   AWS Secret Access Key [None]:
   Default region name [None]:
   Default output format [None]:

   Copy to Clipboard Toggle word wrap

4. バケットの名前を定義し、バケットを作成します。

   $ BUCKET=bucketname
   $ aws s3 mb s3://$BUCKET

   Copy to Clipboard Toggle word wrap

   bucketname は、実際のバケット名に置き換えます。この名前は、グローバルで一意となるように指定する必要があります。上記で、バケットが作成されます。

5. S3 バケットへのアクセス許可を付与するには、AWS Identity and Access Management (IAM) で vmimport S3 ロールを作成します (まだ作成していない場合)。

   1. 信頼ポリシー設定を含む trust-policy.json ファイルを JSON 形式で作成します。以下に例を示します。

      {
          "Version": "2022-10-17",
          "Statement": [{
              "Effect": "Allow",
              "Principal": {
                  "Service": "vmie.amazonaws.com"
              },
              "Action": "sts:AssumeRole",
              "Condition": {
                  "StringEquals": {
                      "sts:Externalid": "vmimport"
                  }
              }
          }]
      }

      Copy to Clipboard Toggle word wrap

   2. ロールポリシーの設定を含む role-policy.json ファイルを JSON 形式で作成します。以下に例を示します。

      {
          "Version": "2012-10-17",
          "Statement": [{
              "Effect": "Allow",
              "Action": ["s3:GetBucketLocation", "s3:GetObject", "s3:ListBucket"],
              "Resource": ["arn:aws:s3:::%s", "arn:aws:s3:::%s/"] }, { "Effect": "Allow", "Action": ["ec2:ModifySnapshotAttribute", "ec2:CopySnapshot", "ec2:RegisterImage", "ec2:Describe"],
              "Resource": "*"
          }]
      }
      $BUCKET $BUCKET

      Copy to Clipboard Toggle word wrap

   3. trust-policy.json ファイルを使用して、Amazon Web Services アカウントのロールを作成します。

      $ aws iam create-role --role-name vmimport --assume-role-policy-document file://trust-policy.json

      Copy to Clipboard Toggle word wrap

   4. role-policy.json ファイルを使用して、インラインポリシードキュメントを埋め込みます。

      $ aws iam put-role-policy --role-name vmimport --policy-name vmimport --policy-document file://role-policy.json

      Copy to Clipboard Toggle word wrap

手順

1. イメージをビルドします。

   # image-builder build ami \
   --blueprint blueprint-name \
   --aws-region us-east-1 \
   --aws-bucket <example-bucket> \
   --aws-ami-name <image-name> \

   Copy to Clipboard Toggle word wrap

2. イメージを AWS にアップロードします。

   # image-builder upload <image-name> \

   Copy to Clipboard Toggle word wrap

検証

1. メニューの EC2 にアクセスし、AWS コンソールで正しいリージョンを選択して、イメージのアップロードが成功したことを確認します。イメージのステータスが、正常にアップロードされたことを示す available になっているはずです。
2. ダッシュボードでイメージを選択し、Launch をクリックします。

手順

1. RHEL Image Builder のダッシュボードで、以前に作成した ブループリント名 をクリックします。
2. Images タブを選択します。

3. Create Image をクリックして、カスタマイズしたイメージを作成します。

   Create Image ウィンドウが開きます。

   1. Type ドロップダウンメニューから、Amazon Machine Image Disk (.raw) を選択します。
   2. イメージを AWS Cloud にアップロードするには、Upload to AWS チェックボックスをオンして、Next をクリックします。

   3. AWS へのアクセスを認証するには、対応するフィールドに AWS access key ID および AWS secret access key を入力します。Next をクリックします。

      注記

      新規アクセスキー ID を作成する場合にのみ、AWS シークレットアクセスキーを表示できます。秘密鍵が分からない場合は、新しいアクセスキー ID を生成します。

   4. Image name フィールドにイメージ名を、Amazon S3 bucket name フィールドに Amazon バケット名を入力して、カスタマイズしたイメージを追加するバケットの AWS region フィールドに入力します。Next をクリックします。

   5. 情報を確認し、Finish をクリックします。

      必要に応じて、Back をクリックして、誤った情報を変更します。

      注記

      カスタマイズイメージを送信するバケットの正しい IAM 設定が必要です。この手順では IAM インポートとエクスポートを使用するため、イメージをアップロードする前にバケットの ポリシー を設定する必要があります。詳細は、IAM ユーザーの必要なパーミッション を参照してください。

4. 右上のポップアップで、保存の進行状況が通知されます。また、イメージ作成が開始されたこと、このイメージ作成の進行状況、およびその後の AWS クラウドへのアップロードについても通知されます。

   プロセスが完了すると、Image build complete のステータスが表示されます。

5. ブラウザーで、Service→EC2 にアクセスします。

   1. AWS コンソールのダッシュボードメニューで、正しいリージョン を選択します。イメージのステータスが、アップロードされたことを示す Available になっているはずです。
   2. AWS ダッシュボードでイメージを選択し、Launch をクリックします。
6. 新しいウィンドウが開きます。イメージを開始するために必要なリソースに応じて、インスタンスタイプを選択します。Review and Launch をクリックします。
7. インスタンスの開始の詳細を確認します。変更が必要な場合は、各セクションを編集できます。Launch をクリックします。

8. インスタンスを起動する前に、インスタンスにアクセスするための公開鍵を選択します。

   既存の鍵ペアを使用することも、新しい鍵ペアを作成することもできます。

   次の手順に従って、EC2 で新しい鍵ペアを作成し、新しいインスタンスにアタッチします。

   1. ドロップダウンメニューリストから、Create a new key pair を選択します。
   2. 新しい鍵ペアの名前を入力します。新しい鍵ペアが生成されます。
   3. Download Key Pair をクリックして、新しい鍵ペアをローカルシステムに保存します。

9. Launch Instance をクリックしてインスタンスを起動します。

   Initializing と表示されるインスタンスのステータスを確認できます。

10. インスタンスのステータスが running になると、Connect ボタンが有効になります。

11. Connect をクリックします。ウィンドウが表示され、SSH を使用して接続する方法の説明が表示されます。

    1. ターミナルを開くために、使用する接続方法として A standalone SSH client を選択します。

    2. 秘密鍵の保存先で、SSH が機能するように鍵が公開されていることを確認します。これには、以下のコマンドを実行します。

       $ chmod 400 <your_instance_name>.pem

       Copy to Clipboard Toggle word wrap

    3. パブリック DNS を使用してインスタンスに接続します。

       $ ssh -i <your-instance_name>.pem ec2-user@<your-instance-IP-address>

       Copy to Clipboard Toggle word wrap

    4. yes と入力して、接続の続行を確定します。

       その結果、SSH 経由でインスタンスに接続されます。

手順

1. Microsoft リポジトリーキーをインポートします。

   $ sudo rpm --import https://packages.microsoft.com/keys/microsoft-2025.asc

   Copy to Clipboard Toggle word wrap

2. packages-microsoft-com-prod リポジトリーを作成します。

   [azure-cli]
   name=Azure CLI
   baseurl=https://packages.microsoft.com/yumrepos/packages.microsoft.com/rhel/10/prod/
   enabled=1
   gpgcheck=1
   gpgkey=https://packages.microsoft.com/keys/microsoft.asc

   Copy to Clipboard Toggle word wrap

3. Microsoft Azure CLI をインストールします。ダウンロードした Microsoft Azure CLI パッケージのバージョンは、現在利用可能なバージョンによって異なる場合があります。

   $ sudo dnf install azure-cli

   Copy to Clipboard Toggle word wrap

4. Microsoft Azure CLI を実行します。

   $ az login

   Copy to Clipboard Toggle word wrap

   ターミナルに次のメッセージが表示されます。Note, we have launched a browser for you to login. For old experience with device code, use az login --use-device-code。その後、ターミナルで Login 画面が開き、そこからログインできるようになります。

   注記

   リモート (SSH) セッションを実行している場合、ログインページのリンクがブラウザーで開きません。この場合、リンクをブラウザーにコピーしてログインし、リモートセッションを認証できます。サインインするには、Web ブラウザーを使用して Login ページを開き、デバイスコードを入力して認証してください。

5. Microsoft Azure のストレージアカウントのキーをリスト表示し、コマンドの出力から key1 の値をメモします。

   $ az storage account keys list --resource-group <resource_group_name> --account-name <account_name>

   Copy to Clipboard Toggle word wrap

   resource-group-name は、Microsoft Azure リソースグループの名前に、storage-account-name は Microsoft Azure ストレージアカウントの名前に置き換えます。

   1. 利用可能なリソースをリスト表示するには、次のコマンドを使用します。

      $ az resource list

      Copy to Clipboard Toggle word wrap

6. ストレージコンテナーを作成します。

   $ az storage container create --account-name <storage_account_name> \
   --account-key <key1_value> --name <storage_account_name>

   Copy to Clipboard Toggle word wrap

   storage-account-name はストレージアカウントの名前に置き換えます。

手順

1. イメージをビルドします。

   $ image-builder build <image-type>

   Copy to Clipboard Toggle word wrap

2. イメージを Microsoft Azure にプッシュし、そこからインスタンスを作成します。

   $ az storage blob upload --account-name account_name --container-name container_name --file image_disk.vhd --name image-disk.vhd --type page

   Copy to Clipboard Toggle word wrap

3. Microsoft Azure Blob ストレージへのアップロードが完了したら、そこから Microsoft Azure イメージを作成します。RHEL Image Builder で作成したイメージは、V1 = BIOS と V2 = UEFI の両方のインスタンスタイプをサポートするハイブリッドイメージとして生成されます。そのため、--hyper-v-generation 引数を指定できます。デフォルトのインスタンスタイプは V1 です。

   $ az image create --resource-group resource_group_name --name image-disk.vhd --os-type linux --location location \
   --source https://$account_name.blob.core.windows.net/container_name/image-disk.vhd
   - Running

   Copy to Clipboard Toggle word wrap

検証

1. Microsoft Azure ポータル、または以下のようなコマンドを使用して、インスタンスを作成します。

   $ az vm create --resource-group resource_group_name --location location --name vm_name --image image-disk.vhd(--admin-username azure-user --generate-ssh-keys*
   - Running

   Copy to Clipboard Toggle word wrap
2. SSH を使用して秘密鍵を使用し、作成したインスタンスにアクセスします。azure-user としてログインします。このユーザー名は前の手順で設定したものです。

手順

1. RHEL Image Builder ダッシュボードで、使用するブループリントを選択します。
2. Images タブをクリックします。

3. Create Image をクリックして、カスタマイズした .vhd イメージを作成します。

   Create image ウィザードが開きます。

   1. Type ドロップダウンメニューリストから Microsoft Azure (.vhd) を選択します。
   2. イメージを Microsoft Azure クラウドにアップロードするには、Upload to Azure チェックボックスをオンします。
   3. Image Size を入力し、Next をクリックします。

4. Upload to Azure ページで、次の情報を入力します。

   1. 認証ページで、次のように入力します。

      1. Storage account の名前。Microsoft Azure portal の Storage account ページにあります。
      2. Storage access key: これは、Access Key ストレージページにあります。
      3. Next をクリックします。

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

      1. イメージ名
      2. Storage container。これは、イメージのアップロード先の Blob コンテナーです。Microsoft Azure portal の Blob service セクションにあります。
      3. Next をクリックします。

5. Review ページで Create をクリックします。RHEL Image Builder が起動し、アップロードプロセスが開始します。

   Microsoft Azure Cloud にプッシュしたイメージにアクセスします。

6. Microsoft Azure ポータル にアクセスします。
7. 検索バーに "storage account" と入力し、リストから Storage accounts をクリックします。
8. 検索バーに "Images" と入力し、Services の下にある最初のエントリーを選択します。Image Dashboard にリダイレクトされます。
9. ナビゲーションパネルで、Containers をクリックします。
10. 作成したコンテナーを見つけます。コンテナー内には、RHEL Image Builder を使用して作成およびプッシュした .vhd ファイルがあります。

検証

1. 仮想マシンイメージを作成して起動できることを確認します。

   1. 検索バーに images account と入力し、リストから Images をクリックします。
   2. +Create をクリックします。
   3. ドロップダウンリストから、前に使用したリソースグループを選択します。
   4. イメージの名前を入力します。
   5. OS type で Linux を選択します。
   6. VM generation で Gen 2 を選択します。
   7. Storage Blob で Browse をクリックし、VHD ファイルに到達するまでストレージアカウントとコンテナーをクリックします。
   8. ページの最後にある Select をクリックします。
   9. Account Type を選択します (例: Standard SSD)。
   10. Review + Create をクリックし、Create をクリックします。イメージが作成されるまでしばらく待機します。

2. 仮想マシンを起動するには、次の手順に従います。

   1. Go to resource をクリックします。
   2. ヘッダーのメニューバーから + Create VM をクリックします。
   3. 仮想マシンの名前を入力します。
   4. Size セクションと Administrator account セクションに入力します。

   5. Review + Create をクリックし、Create をクリックします。デプロイメントの進行状況を確認できます。

      デプロイメントが完了したら、仮想マシン名をクリックしてインスタンスのパブリック IP アドレスを取得し、SSH を使用して接続します。

   6. ターミナルを開いて SSH 接続を作成し、仮想マシンに接続します。

手順

1. RHEL Image Builder ダッシュボードで、Blueprint タブをクリックします。
2. ブループリントのテーブルで、イメージをビルドするブループリントを見つけます。
3. 選択したブループリントの右側で、Create Image をクリックします。Create image ダイアログウィザードが開きます。

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

   1. Select a blueprint リストから、必要なイメージのタイプを選択します。
   2. Image output type リストから、必要なイメージの出力タイプを選択します。
   3. オプション: イメージを VMware に直接アップロードするには、Upload to VMware チェックボックスをオンにします。
   4. イメージのサイズを入力します。
   5. Next をクリックします。

5. Upload to VMware ページで、次の情報を入力します。

   1. Image name: イメージ名を入力します。
   2. Host: イメージファイルをアップロードする VMware vSphere インスタンスの URL を入力します。
   3. Cluster: イメージをアップロードするクラスター名のページを入力します。
   4. Datacenter: イメージをアップロードするデータセンター名。
   5. Datastore: イメージをアップロードするデータストア名。
   6. Folder: イメージをアップロードするフォルダー名。
   7. Next をクリックします。

6. Review ページで、イメージの作成に関する詳細を確認し、Create をクリックします。

   イメージの作成が開始し、イメージ作成の進捗と、それに続く VMware vSphere クライアントへのアップロードの進捗が表示されます。