RHEL システムイメージのカスタマイズ
Red Hat Enterprise Linux 9 で RHEL Image Builder を使用してカスタマイズしたシステムイメージを作成する
概要
Red Hat ドキュメントへのフィードバック (英語のみ) リンクのコピーリンクがクリップボードにコピーされました!
Red Hat ドキュメントに関するご意見やご感想をお寄せください。また、改善点があればお知らせください。
Jira からのフィードバック送信 (アカウントが必要)
- Jira の Web サイトにログインします。
- 上部のナビゲーションバーで Create をクリックします。
- Summary フィールドにわかりやすいタイトルを入力します。
- Description フィールドに、ドキュメントの改善に関するご意見を記入してください。ドキュメントの該当部分へのリンクも追加してください。
- ダイアログの下部にある Create をクリックします。
第1章 RHEL Image Builder の説明 リンクのコピーリンクがクリップボードにコピーされました!
システムをデプロイするには、システムイメージを作成します。RHEL システムイメージを作成するには、RHEL Image Builder ツールを使用します。RHEL Image Builder を使用することで、RHEL のカスタマイズされたシステムイメージを作成できます。これには、クラウドプラットフォームへのデプロイメント用に準備されたシステムイメージが含まれます。RHEL Image Builder は、各出力タイプのセットアップの詳細を自動的に処理するため、手動でイメージを作成する方法よりも使いやすく、作業が高速です。RHEL Image Builder の機能には、composer-cli ツールのコマンドライン、または RHEL Web コンソールのグラフィカルユーザーインターフェイスを使用してアクセスできます。
1.1. RHEL Image Builder の用語 リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder は次の概念を使用します。
- ブループリント
ブループリントは、カスタマイズされたシステムイメージの説明です。システムの一部となるパッケージとカスタマイズが一覧表示されます。ブループリントをカスタマイズして編集し、特定のバージョンとして保存できます。ブループリントからシステムイメージを作成すると、イメージは RHEL Image Builder インターフェイスでブループリントに関連付けられます。
ブループリントは TOML 形式で作成します。
- Compose
- コンポーズは、特定のブループリントの特定のバージョンに基づいた、システムイメージの個別のビルドです。用語としての Compose は、システムイメージと、その作成、入力、メタデータ、およびそのプロセス自体のログを指します。
- カスタマイズ
- カスタマイズは、パッケージではないイメージの仕様です。これには、ユーザー、グループ、および SSH 鍵が含まれます。
1.2. RHEL Image Builder の出力形式 リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder は、次の表に示す複数の出力形式でイメージを作成できます。
| 説明 | CLI 名 | ファイル拡張子 |
|---|---|---|
| QEMU イメージ |
|
|
| ディスクアーカイブ |
|
|
| Amazon Web Services |
|
|
| Microsoft Azure |
|
|
| Google Cloud Platform |
|
|
| VMware vSphere |
|
|
| VMware vSphere |
|
|
| Openstack |
|
|
| RHEL for Edge Commit |
|
|
| RHEL for Edge Container |
|
|
| RHEL for Edge Installer |
|
|
| RHEL for Edge Raw イメージ |
|
|
| RHEL for Edge Simplified Installer |
|
|
| RHEL for Edge AMI |
|
|
| RHEL for Edge VMDK |
|
|
| RHEL インストーラー |
|
|
| Oracle Cloud Infrastructure |
|
|
サポートされているタイプを確認するには、次のコマンドを実行します。
composer-cli compose types
# composer-cli compose types
1.3. イメージビルドでサポートされているアーキテクチャー リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder は、次のアーキテクチャーのイメージのビルドをサポートしています。
-
AMD および Intel 64 ビット (
x86_64) -
ARM64 (
aarch64) -
IBM Z (
s390x) - IBM POWER システム
ただし、RHEL Image Builder はマルチアーキテクチャービルドをサポートしていません。実行しているのと同じシステムアーキテクチャーのイメージのみをビルドします。たとえば、RHEL Image Builder が x86_64 システムで実行している場合は、x86_64 アーキテクチャーのイメージのみをビルドできます。
第2章 RHEL Image Builder のインストール リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder を使用する前に、RHEL Image Builder をインストールする必要があります。
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 を使用してください。
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 とその他の必要なパッケージをインストールします。
dnf install osbuild-composer composer-cli cockpit-composer
# dnf install osbuild-composer composer-cli cockpit-composerCopy 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.socketCopy to Clipboard Copied! Toggle word wrap Toggle overflow Web コンソールで RHEL Image Builder を使用する場合は、それを有効にして起動します。
systemctl enable --now cockpit.socket
# systemctl enable --now cockpit.socketCopy 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-cliCopy to Clipboard Copied! Toggle word wrap Toggle overflow
検証
composer-cliを実行して、インストールが動作することを確認します。composer-cli status show
# composer-cli status showCopy to Clipboard Copied! Toggle word wrap Toggle overflow
トラブルシューティング
システムジャーナルを使用して、RHEL Image Builder のアクティビティーを追跡できます。さらに、ファイル内のログメッセージを見つけることができます。
トレースバックのジャーナル出力を見つけるには、次のコマンドを実行します。
journalctl | grep osbuild
$ journalctl | grep osbuildCopy 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.serviceCopy to Clipboard Copied! Toggle word wrap Toggle overflow
第3章 RHEL Image Builder リポジトリーの設定 リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder を使用するには、確実にリポジトリーを設定する必要があります。RHEL Image Builder では、以下のタイプのリポジトリーを使用できます。
- 公式リポジトリーのオーバーライド
- Red Hat Content Delivery Network (CDN) 公式リポジトリー以外の場所 (ネットワーク内のカスタムミラーなど) からベースシステム RPM をダウンロードする場合は、これらを使用します。公式リポジトリーのオーバーライドを使用するとデフォルトのリポジトリーが無効になるため、カスタムミラーには必要なパッケージがすべて含まれている必要があります。
- カスタムサードパーティーリポジトリー
- これらを使用して、公式の RHEL リポジトリーで利用できないパッケージを含めます。
3.1. RHEL Image Builder へのカスタムサードパーティーリポジトリーの追加 リンクのコピーリンクがクリップボードにコピーされました!
カスタムのサードパーティーソースをリポジトリーに追加し、composer-cli 使用してこれらのリポジトリーを管理できます。
前提条件
- カスタムサードパーティーリポジトリーの URL を持っている。
手順
/root/repo.tomlなどのリポジトリーソースファイルを作成します。以下に例を示します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow typeフィールドは、有効な値yum-baseurl、yum-mirrorlist、およびyum-metalinkを受け入れます。- ファイルを TOML 形式で保存します。
新しいサードパーティーソースを RHEL Image Builder に追加します。
composer-cli sources add <file-name>.toml
$ composer-cli sources add <file-name>.tomlCopy to Clipboard Copied! Toggle word wrap Toggle overflow
検証
新しいソースが正常に追加されたかどうかを確認します。
composer-cli sources list
$ composer-cli sources listCopy to Clipboard Copied! Toggle word wrap Toggle overflow 新しいソースコンテンツを確認します。
composer-cli sources info <source_id>
$ composer-cli sources info <source_id>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.2. 特定のディストリビューションを使用した RHEL Image Builder へのサードパーティーリポジトリーの追加 リンクのコピーリンクがクリップボードにコピーされました!
オプションのフィールド distro を使用して、カスタムサードパーティーソースファイル内のディストリビューションのリストを指定できます。リポジトリーファイルは、イメージのビルド中に依存関係を解決する際にディストリビューション文字列リストを使用します。
rhel-9 を指定するリクエストはすべて、このソースを使用します。たとえば、パッケージをリストして rhel-9 を指定すると、このソースが含まれます。ただし、ホストディストリビューションのパッケージのリストには、このソースは含まれません。
前提条件
- カスタムサードパーティーリポジトリーの URL を持っている。
- 指定するディストリビューションのリストがある。
手順
/root/repo.tomlなどのリポジトリーソースファイルを作成します。たとえば、ディストリビューションを指定するには、次のようにします。Copy to Clipboard Copied! Toggle word wrap Toggle overflow - ファイルを TOML 形式で保存します。
新しいサードパーティーソースを RHEL Image Builder に追加します。
composer-cli sources add <file-name>.toml
$ composer-cli sources add <file-name>.tomlCopy to Clipboard Copied! Toggle word wrap Toggle overflow
検証
新しいソースが正常に追加されたかどうかを確認します。
composer-cli sources list
$ composer-cli sources listCopy to Clipboard Copied! Toggle word wrap Toggle overflow 新しいソースコンテンツを確認します。
composer-cli sources info <source_id>
$ composer-cli sources info <source_id>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.3. GPG を使用したリポジトリーのメタデータの確認 リンクのコピーリンクがクリップボードにコピーされました!
破損したパッケージを検出して回避するために、DNF パッケージマネージャーを使用して RPM パッケージの GNU Privacy Guard (GPG) 署名を確認でき、リポジトリーのメタデータが GPG キーで署名されているかどうかも確認できます。
gpgkeys フィールドにキー URL を設定することで、https 経由でチェックを行う gpgkey を入力できます。あるいは、セキュリティーを向上させるために、キー全体を gpgkeys フィールドに埋め込んで、キーを URL から取得する代わりに直接インポートすることもできます。
前提条件
- リポジトリーとして使用するディレクトリーが存在し、パッケージが含まれている。
手順
リポジトリーを作成するフォルダーにアクセスします。
cd repo/
$ cd repo/Copy to Clipboard Copied! Toggle word wrap Toggle overflow createrepo_cを実行して、RPM パッケージからリポジトリーを作成します。createrepo_c .
$ createrepo_c .Copy to Clipboard Copied! Toggle word wrap Toggle overflow リポデータがあるディレクトリーにアクセスします。
cd repodata/
$ cd repodata/Copy to Clipboard Copied! Toggle word wrap Toggle overflow repomd.xmlファイルに署名します。gpg -u <_gpg-key-email_> --yes --detach-sign --armor /srv/repo/example/repomd.xml
$ gpg -u <_gpg-key-email_> --yes --detach-sign --armor /srv/repo/example/repomd.xmlCopy to Clipboard Copied! Toggle word wrap Toggle overflow リポジトリーで GPG 署名チェックを有効にするには、以下を行います。
-
リポジトリーソースで
check_repogpg = trueを設定します。 チェックを行う
gpgkeyを入力します。キーがhttps経由で利用できる場合は、gpgkeysフィールドにキーのキー URL を設定します。URL キーは必要なだけ追加できます。以下に例を示します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 代わりに、たとえば次のように GPG キーを
gpgkeysフィールドに直接追加します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow テストで署名が見つからない場合、GPG ツールは次のようなエラーを表示します。
GPG verification is enabled, but GPG signature is not available.
$ 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)Copy to Clipboard Copied! Toggle word wrap Toggle overflow 署名が無効な場合、GPG ツールは次のようなエラーを表示します。
repomd.xml GPG signature verification error: Bad GPG signature
repomd.xml GPG signature verification error: Bad GPG signatureCopy to Clipboard Copied! Toggle word wrap Toggle overflow
-
リポジトリーソースで
検証
リポジトリーの署名を手動でテストします。
gpg --verify /srv/repo/example/repomd.xml.asc
$ gpg --verify /srv/repo/example/repomd.xml.ascCopy to Clipboard Copied! Toggle word wrap Toggle overflow
3.4. RHEL Image Builder 公式リポジトリーのオーバーライド リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder の osbuild-composer バックエンドは、/etc/yum.repos.d/ にあるシステムのリポジトリーを継承しません。代わりに、/usr/share/osbuild-composer/repositories ディレクトリーに定義された独自の公式リポジトリーのセットがあります。これには、追加のソフトウェアをインストールしたり、すでにインストールされているプログラムを新しいバージョンに更新したりするためのベースシステム RPM が含まれている Red Hat 公式リポジトリーが含まれます。公式リポジトリーをオーバーライドするには、/etc/osbuild-composer/repositories でオーバーライドを定義する必要があります。このディレクトリーはユーザー定義のオーバーライド用であり、ここにあるファイルは /usr/share/osbuild-composer/repositories/ ディレクトリー内のファイルよりも優先されます。
設定ファイルは /etc/yum.repos.d/ 内のファイルから知られている通常の DNF リポジトリー形式ではありません。それらは JSON ファイルです。
3.5. システムリポジトリーのオーバーライド リンクのコピーリンクがクリップボードにコピーされました!
/etc/osbuild-composer/repositories ディレクトリーで、RHEL Image Builder 用のリポジトリーオーバーライドを独自に設定できます。
前提条件
- ホストシステムからアクセスできるカスタムリポジトリーがある。
手順
リポジトリーのオーバーライドを保存する
/etc/osbuild-composer/repositories/ディレクトリーを作成します。sudo mkdir -p /etc/osbuild-composer/repositories
$ sudo mkdir -p /etc/osbuild-composer/repositoriesCopy to Clipboard Copied! Toggle word wrap Toggle overflow RHEL バージョンに対応する名前を使用して、JSON ファイルを作成します。または、配布用のファイルを
/usr/share/osbuild-composer/からコピーして、その内容を変更することもできます。RHEL 9.3 の場合は、
/etc/osbuild-composer/repositories/rhel-93.jsonを使用します。次の構造を JSON ファイルに追加します。次の属性から 1 つだけ文字列形式で指定します。
-
baseurl- リポジトリーのベース URL。 -
metalink- 有効なミラーリポジトリーのリストを含む metalink ファイルの URL。 mirrorlist- 有効なミラーリポジトリーのリストを含む mirrorlist ファイルの URL。gpgkeyやmetadata_expireなどの残りのフィールドはオプションです。以下に例を示します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow あるいは、
rhel-version.jsonを RHEL のバージョン (例: rhel-9.json) に置き換えて、ディストリビューション用の JSON ファイルをコピーすることもできます。cp /usr/share/osbuild-composer/repositories/rhel-version.json /etc/osbuild-composer/repositories/
$ cp /usr/share/osbuild-composer/repositories/rhel-version.json /etc/osbuild-composer/repositories/Copy to Clipboard Copied! Toggle word wrap Toggle overflow
-
オプション: JSON ファイルを確認します。
json_verify < /etc/osbuild-composer/repositories/rhel-version.json
$ json_verify < /etc/osbuild-composer/repositories/rhel-version.jsonCopy to Clipboard Copied! Toggle word wrap Toggle overflow rhel-9.jsonファイル内のbaseurlパスを編集して保存します。以下に例を示します。/etc/osbuild-composer/repositories/rhel-version.json
$ /etc/osbuild-composer/repositories/rhel-version.jsonCopy to Clipboard Copied! Toggle word wrap Toggle overflow osbuild-composer.serviceを再起動します。sudo systemctl restart osbuild-composer.service
$ sudo systemctl restart osbuild-composer.serviceCopy to Clipboard Copied! Toggle word wrap Toggle overflow
検証
リポジトリーが正しい URL を指しているか確認します。
cat /etc/yum.repos.d/redhat.repo
$ cat /etc/yum.repos.d/redhat.repoCopy to Clipboard Copied! Toggle word wrap Toggle overflow リポジトリーは
/etc/yum.repos.d/redhat.repoファイルからコピーされた正しい URL を指していることが分かります。
3.6. サブスクリプションが必要なシステムリポジトリーのオーバーライド リンクのコピーリンクがクリップボードにコピーされました!
/etc/yum.repos.d/redhat.repo ファイルで定義されているシステムサブスクリプションを使用するように osbuild-composer サービスをセットアップできます。osbuild-composer でシステムサブスクリプションを使用するには、次の詳細を含むリポジトリーオーバーライドを定義します。
-
/etc/yum.repos.d/redhat.repoで定義されているリポジトリーと同じbaseurl。 "rhsm": trueの値は、JSON オブジェクトで定義されます。注記osbuild-composerは、/etc/yum.repos.d/で定義されたリポジトリーを自動的に使用するわけではありません。リポジトリーは、システムリポジトリーオーバーライドとして、または追加のsourceとして、composer-cliを使用して手動で指定する必要があります。“BaseOS” および “AppStream” リポジトリーは通常、システムリポジトリーオーバーライドを使用しますが、他のすべてのリポジトリーはcomposer-cliソースを使用します。
前提条件
-
システムに
/etc/yum.repos.d/redhat.repoで定義されたサブスクリプションがある。 - リポジトリーオーバーライドを作成している。システムリポジトリーのオーバーライド を参照してください。
手順
/etc/yum.repos.d/redhat.repoファイルからbaseurlを取得します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 同じ
baseurlを使用するようにリポジトリーオーバーライドを設定し、rhsmを true に設定します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow osbuild-composer.serviceを再起動します。sudo systemctl restart osbuild-composer.service
$ sudo systemctl restart osbuild-composer.serviceCopy to Clipboard Copied! Toggle word wrap Toggle overflow
3.7. Satellite CV をコンテンツソースとして設定および使用する リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder を使用してイメージをビルドするためのリポジトリーとして、Satellite のコンテンツビュー (CV) を使用できます。そのためには、Satellite に登録されているホストで、Red Hat Content Delivery Network (CDN) の公式リポジトリーではなく、Satellite リポジトリーから取得できるようにリポジトリー参照を手動で設定します。
前提条件
- RHEL Image Builder がインストールされている。RHELImage Builder のインストール を参照してください。
- Satellite 6 に登録されたホストで RHEL Image Builder を使用している。「Red Hat Image Builder イメージを使用したプロビジョニング」を参照してください。
手順
現在設定されているリポジトリーからリポジトリー URL を見つけます。
sudo yum -v repolist "-baseos-rpms" | grep -i repo-baseurl
$ sudo yum -v repolist "-baseos-rpms" | grep -i repo-baseurl Repo-baseurl :Copy to Clipboard Copied! Toggle word wrap Toggle overflow 次の出力は例です。
https://satellite6.example.com/pulp/content/YourOrg/YourEnv/YourCV/content/dist/rhel9/9/x86_64/baseos/os
https://satellite6.example.com/pulp/content/YourOrg/YourEnv/YourCV/content/dist/rhel9/9/x86_64/baseos/osCopy to Clipboard Copied! Toggle word wrap Toggle overflow ハードコードされたリポジトリーを Satellite Server に変更します。
0755権限を持つリポジトリーディレクトリーを作成します。sudo mkdir -pvm 0755 /etc/osbuild-composer/repositories
$ sudo mkdir -pvm 0755 /etc/osbuild-composer/repositoriesCopy to Clipboard Copied! Toggle word wrap Toggle overflow /usr/share/osbuild-composer/repositories/*.jsonの内容を、作成したディレクトリーにコピーします。sudo cp /usr/share/osbuild-composer/repositories/*.json /etc/osbuild-composer/repositories/
$ sudo cp /usr/share/osbuild-composer/repositories/*.json /etc/osbuild-composer/repositories/Copy to Clipboard Copied! Toggle word wrap Toggle overflow /content/dist/*行を通じて Satellite URL とファイルの内容を更新します。sudo sed -i -e 's|cdn.redhat.com|satellite6.example.com/pulp/content/YourOrg/YourEnv/YourCV|' /etc/osbuild-composer/repositories/*.json
$ sudo sed -i -e 's|cdn.redhat.com|satellite6.example.com/pulp/content/YourOrg/YourEnv/YourCV|' /etc/osbuild-composer/repositories/*.jsonCopy to Clipboard Copied! Toggle word wrap Toggle overflow 設定が正しく置き換えられたことを確認します。
sudo vi /etc/osbuild-composer/repositories/rhel-9.json
$ sudo vi /etc/osbuild-composer/repositories/rhel-9.jsonCopy to Clipboard Copied! Toggle word wrap Toggle overflow
サービスを再起動します。
sudo systemctl restart osbuild-worker@1.service osbuild-composer.service
$ sudo systemctl restart osbuild-worker@1.service osbuild-composer.serviceCopy to Clipboard Copied! Toggle word wrap Toggle overflow - Red Hat Image Builder 設定で必要なシステムリポジトリーをオーバーライドし、Satellite リポジトリーの URL をベース URL として使用します。システムリポジトリーのオーバーライド を参照してください。
3.8. RHEL Image Builder でイメージをビルドするためのリポジトリーとして Satellite CV を使用する リンクのコピーリンクがクリップボードにコピーされました!
カスタムイメージをビルドするためのリポジトリーとして Satellite のコンテンツビュー (CV) を使用するように RHEL Image Builder を設定します。
前提条件
- RHEL Web コンソールに Satellite が統合されている。Satellite での RHEL Web コンソールの有効化 を参照してください。
手順
- Satellite Web UI で、Content > Products に移動し、Product を選択して、使用するリポジトリーをクリックします。
- Published フィールドで、保護された URL (HTTPS) を検索してコピーします。
- コピーした URL を Red Hat Image Builder リポジトリーのベース URL として使用します。RHEL Image Builder へのカスタムサードパーティーリポジトリーの追加 を参照してください。
第4章 RHEL Image Builder CLI を使用したシステムイメージの作成 リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder は、カスタムのシステムイメージを作成するツールです。RHEL Image Builder を制御し、カスタムシステムイメージを作成するには、コマンドライン (CLI) または Web コンソールインターフェイスを使用できます。
RHEL Image Builder ツールは、RHEL 8 システム上での RHEL 9 イメージのビルドをサポートしていません。イメージは、ホスト配布で使用する以前のバージョンのイメージからのみビルドできます。
4.1. RHEL Image Builder コマンドラインインターフェイスの紹介 リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder コマンドラインインターフェイス (CLI) を使用してブループリントを作成するには、適切なオプションとサブコマンドを指定して composer-cli コマンドを実行します。
コマンドラインのワークフローの概要は次のとおりです。
- ブループリントを作成するか、既存のブループリント定義をプレーンテキストファイルにエクスポート (保存) します。
- テキストエディターでこのファイルを編集します。
- ブループリントテキストファイルを Image Builder にインポートします。
- Compose を実行して、ブループリントからイメージをビルドします。
- イメージファイルをエクスポートしてダウンロードします。
composer-cli コマンドには、ブループリントを作成する基本的なサブコマンドとは別に、設定したブループリントと Compose の状態を調べるための多くのサブコマンドが用意されています。
4.2. RHEL Image Builder を非 root ユーザーとして使用する リンクのコピーリンクがクリップボードにコピーされました!
非 root として composer-cli コマンドを実行するには、ユーザーが weldr グループに属している必要があります。
前提条件
- ユーザーを作成している。
手順
ユーザーを
weldrまたはrootグループに追加するには、次のコマンドを実行します:sudo usermod -a -G weldr user newgrp weldr
$ sudo usermod -a -G weldr user $ newgrp weldrCopy to Clipboard Copied! Toggle word wrap Toggle overflow
4.3. コマンドラインを使用したブループリントの作成 リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder のコマンドラインインターフェイス (CLI) を使用して、新しいブループリントを作成できます。ブループリントには、最終的なイメージと、パッケージやカーネルのカスタマイズなどのそのカスタマイズが記述されています。
前提条件
-
root ユーザーまたは
weldrグループのメンバーであるユーザーとしてログインしている。
手順
次の内容のプレーンテキストファイルを作成します。
name = "BLUEPRINT-NAME" description = "LONG FORM DESCRIPTION TEXT" version = "0.0.1" modules = [] groups = []
name = "BLUEPRINT-NAME" description = "LONG FORM DESCRIPTION TEXT" version = "0.0.1" modules = [] groups = []Copy to Clipboard Copied! Toggle word wrap Toggle overflow BLUEPRINT-NAME および LONG FORM DESCRIPTION TEXT は、ブループリントの名前および説明に置き換えます。
0.0.1 は、セマンティックバージョニングスキームに従ってバージョン番号に置き換えます。
ブループリントに含まれるすべてのパッケージに、次の行をファイルに追加します。
[[packages]] name = "package-name" version = "package-version"
[[packages]] name = "package-name" version = "package-version"Copy to Clipboard Copied! Toggle word wrap Toggle overflow package-name は、
httpd、gdb-doc、coreutilsなどのパッケージ名に置き換えます。必要に応じて、package-version を使用するバージョンに置き換えます。このフィールドは、
dnfバージョンの指定に対応します。- 特定のバージョンについては、8.7.0 などの正確なバージョン番号を使用してください。
- 利用可能な最新バージョンについては、アスタリスク * を使用してください。
- 最新のマイナーバージョンを指定する場合は、8.* などの形式を使用してください。
ニーズに合わせてブループリントをカスタマイズします。たとえば、Simultaneous Multi Threading (SMT) を無効にするには、ブループリントファイルに次の行を追加します。
[customizations.kernel] append = "nosmt=force"
[customizations.kernel] append = "nosmt=force"Copy to Clipboard Copied! Toggle word wrap Toggle overflow その他に利用できるカスタマイズについては、サポートされているイメージのカスタマイズ を参照してください。
[]と[[]]は TOML で表現される異なるデータ構造であることに注意してください。-
[customizations.kernel]ヘッダーは、キーと各値のペアの集合によって定義される単一のテーブルを表します (例:append = "nosmt=force")。 -
[[packages]]ヘッダーはテーブルの配列を表します。最初のインスタンスで、配列とその最初のテーブル要素を定義します (例:name = "package-name"、version = "package-version")。後続の各インスタンスで、指定の順序で、その配列内に新しいテーブル要素を作成して定義します。
-
- たとえば、ファイルを BLUEPRINT-NAME.toml として保存し、テキストエディターを閉じます。
オプション: ブループリント TOML ファイルのすべての設定が正しく解析されているかどうかを確認します。ブループリントを保存し、保存した出力を入力ファイルと比較します。
composer-cli blueprints save BLUEPRINT-NAME.toml
# composer-cli blueprints save BLUEPRINT-NAME.tomlCopy to Clipboard Copied! Toggle word wrap Toggle overflow -
保存した
BLUEPRINT-NAME.tomlファイルを入力ファイルと比較します。
-
保存した
ブループリントをプッシュします。
composer-cli blueprints push BLUEPRINT-NAME.toml
# composer-cli blueprints push BLUEPRINT-NAME.tomlCopy to Clipboard Copied! Toggle word wrap Toggle overflow BLUEPRINT-NAME は、前の手順で使用した値に置き換えます。
注記composer-cliを非 root として使用してイメージを作成するには、ユーザーをweldrまたはrootグループに追加します。usermod -a -G weldr user newgrp weldr
# usermod -a -G weldr user $ newgrp weldrCopy to Clipboard Copied! Toggle word wrap Toggle overflow
検証
ブループリントがプッシュされ存在していることを確認するには、既存のブループリントを一覧表示します。
composer-cli blueprints list
# composer-cli blueprints listCopy to Clipboard Copied! Toggle word wrap Toggle overflow 追加したばかりのブループリント設定を表示します。
composer-cli blueprints show BLUEPRINT-NAME
# composer-cli blueprints show BLUEPRINT-NAMECopy to Clipboard Copied! Toggle word wrap Toggle overflow ブループリントに記載されているコンポーネントおよびバージョンと、その依存関係が有効かどうかを確認します。
composer-cli blueprints depsolve BLUEPRINT-NAME
# composer-cli blueprints depsolve BLUEPRINT-NAMECopy to Clipboard Copied! Toggle word wrap Toggle overflow RHEL Image Builder がカスタムリポジトリーのパッケージの依存関係を解決できない場合は、
osbuild-composerキャッシュを削除します。3sudo rm -rf /var/cache/osbuild-composer/* sudo systemctl restart osbuild-composer
$ sudo rm -rf /var/cache/osbuild-composer/* $ sudo systemctl restart osbuild-composerCopy to Clipboard Copied! Toggle word wrap Toggle overflow
4.4. コマンドラインを使用したブループリントの編集 リンクのコピーリンクがクリップボードにコピーされました!
コマンドライン (CLI) で既存のブループリントを編集して、たとえば、新しいパッケージを追加したり、新しいグループを定義したり、カスタマイズしたイメージを作成したりできます。
前提条件
- ブループリントを作成している。
手順
既存のブループリントをリストします。
composer-cli blueprints list
# composer-cli blueprints listCopy to Clipboard Copied! Toggle word wrap Toggle overflow ブループリントをローカルテキストファイルに保存します。
composer-cli blueprints save BLUEPRINT-NAME
# composer-cli blueprints save BLUEPRINT-NAMECopy to Clipboard Copied! Toggle word wrap Toggle overflow - BLUEPRINT-NAME .toml ファイルをテキストエディターで編集し、変更を加えます。
編集を完了する前に、ファイルが有効なブループリントであることを確認します。
ブループリントに次の行が存在する場合は、それを削除します。
packages = []
packages = []Copy to Clipboard Copied! Toggle word wrap Toggle overflow - たとえば、バージョン番号を 0.0.1 から 0.1.0 に増やします。RHEL Image Builder のブループリントバージョンでは、セマンティックバージョニングスキームを使用する必要があります。また、バージョンを変更しない場合、パッチ バージョンコンポーネントが自動的に増加することにも注意してください。
- ファイルを保存し、テキストエディターを閉じます。
ブループリントを RHEL Image Builder にプッシュして戻します。
composer-cli blueprints push BLUEPRINT-NAME.toml
# composer-cli blueprints push BLUEPRINT-NAME.tomlCopy to Clipboard Copied! Toggle word wrap Toggle overflow 注記ブループリントを RHEL Image Builder にインポートして戻すには、
.toml拡張子を含むファイル名を指定しますが、他のコマンドではブループリント名のみを使用します。
検証
RHEL Image Builder にアップロードした内容が編集内容と一致することを確認するには、ブループリントの内容をリストします。
composer-cli blueprints show BLUEPRINT-NAME
# composer-cli blueprints show BLUEPRINT-NAMECopy to Clipboard Copied! Toggle word wrap Toggle overflow ブループリントに記載されているコンポーネントおよびバージョンと、その依存関係が有効かどうかを確認します。
composer-cli blueprints depsolve BLUEPRINT-NAME
# composer-cli blueprints depsolve BLUEPRINT-NAMECopy to Clipboard Copied! Toggle word wrap Toggle overflow
4.5. RHEL Image Builder コマンドラインでのシステムイメージの作成 リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder のコマンドラインインターフェイスを使用して、カスタマイズした RHEL イメージをビルドできます。そのためには、ブループリントとイメージタイプを指定する必要があります。必要に応じて、ディストリビューションを指定することもできます。ディストリビューションを指定しない場合は、ホストシステムと同じディストリビューションとバージョンが使用されます。アーキテクチャーもホストのアーキテクチャーと同じになります。
前提条件
- イメージにブループリントを用意している。コマンドラインを使用した RHEL Image Builder ブループリントの作成 を 参照してください。
手順
オプション: 作成できるイメージ形式をリストします。
composer-cli compose types
# composer-cli compose typesCopy to Clipboard Copied! Toggle word wrap Toggle overflow Compose を起動します。
composer-cli compose start BLUEPRINT-NAME IMAGE-TYPE
# composer-cli compose start BLUEPRINT-NAME IMAGE-TYPECopy to Clipboard Copied! Toggle word wrap Toggle overflow BLUEPRINT-NAME をブループリントの名前に、IMAGE-TYPE をイメージのタイプに置き換えます。使用可能な値は、
composer-cli compose typesコマンドの出力を参照してください。作成プロセスはバックグラウンドで開始され、作成者の Universally Unique Identifier (UUID) が表示されます。
イメージの作成が完了するまでに最大 10 分かかる場合があります。
Compose のステータスを確認するには、以下のコマンドを実行します。
composer-cli compose status
# composer-cli compose statusCopy to Clipboard Copied! Toggle word wrap Toggle overflow Compose が完了すると、ステータスが FINISHED になります。リスト内の Compose を識別するには、その UUID を使用します。
Compose プロセスが完了したら、作成されたイメージファイルをダウンロードします。
composer-cli compose image UUID
# composer-cli compose image UUIDCopy to Clipboard Copied! Toggle word wrap Toggle overflow UUID は、前の手順で示した UUID 値に置き換えます。
検証
イメージを作成した後、次のコマンドを使用してイメージ作成の進行状況を確認できます。
イメージのメタデータをダウンロードして、Compose 用のメタデータの
.tarファイルを取得します。sudo composer-cli compose metadata UUID
$ sudo composer-cli compose metadata UUIDCopy to Clipboard Copied! Toggle word wrap Toggle overflow イメージのログをダウンロードします。
sudo composer-cli compose logs UUID
$ sudo composer-cli compose logs UUIDCopy to Clipboard Copied! Toggle word wrap Toggle overflow このコマンドは、イメージ作成のログを含む
.tarファイルを作成します。ログが空の場合は、ジャーナルを確認できます。ジャーナルを確認してください。
journalctl | grep osbuild
$ journalctl | grep osbuildCopy to Clipboard Copied! Toggle word wrap Toggle overflow イメージのマニフェストを確認します。
sudo cat /var/lib/osbuild-composer/jobs/job_UUID.json
$ sudo cat /var/lib/osbuild-composer/jobs/job_UUID.jsonCopy to Clipboard Copied! Toggle word wrap Toggle overflow ジャーナルで job_UUID .json を見つけることができます。
4.6. RHEL Image Builder コマンドラインの基本的なコマンド リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder コマンドラインインターフェイスでは、以下のサブコマンドを利用できます。
ブループリント操作
- 利用可能なブループリント一覧の表示
composer-cli blueprints list
# composer-cli blueprints listCopy to Clipboard Copied! Toggle word wrap Toggle overflow - TOML 形式でブループリントの内容の表示
composer-cli blueprints show <BLUEPRINT-NAME>
# composer-cli blueprints show <BLUEPRINT-NAME>Copy to Clipboard Copied! Toggle word wrap Toggle overflow - TOML 形式のブループリントの内容を
BLUEPRINT-NAME.tomlファイルに保存 (エクスポート) composer-cli blueprints save <BLUEPRINT-NAME>
# composer-cli blueprints save <BLUEPRINT-NAME>Copy to Clipboard Copied! Toggle word wrap Toggle overflow - ブループリントの削除
composer-cli blueprints delete <BLUEPRINT-NAME>
# composer-cli blueprints delete <BLUEPRINT-NAME>Copy to Clipboard Copied! Toggle word wrap Toggle overflow - TOML 形式のブループリントファイルを RHEL Image Builder へプッシュ (インポート)
composer-cli blueprints push <BLUEPRINT-NAME>
# composer-cli blueprints push <BLUEPRINT-NAME>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
ブループリントでイメージの設定
- 利用可能なイメージタイプをリスト表示します。
composer-cli compose types
# composer-cli compose typesCopy to Clipboard Copied! Toggle word wrap Toggle overflow - Compose の起動
composer-cli compose start <BLUEPRINT> <COMPOSE-TYPE>
# composer-cli compose start <BLUEPRINT> <COMPOSE-TYPE>Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Compose のリスト表示
composer-cli compose list
# composer-cli compose listCopy to Clipboard Copied! Toggle word wrap Toggle overflow - Compose、およびそのステータスのリスト表示
composer-cli compose status
# composer-cli compose statusCopy to Clipboard Copied! Toggle word wrap Toggle overflow - 実行中の Compose のキャンセル
composer-cli compose cancel <COMPOSE-UUID>
# composer-cli compose cancel <COMPOSE-UUID>Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 完了した Compose の削除
composer-cli compose delete <COMPOSE-UUID>
# composer-cli compose delete <COMPOSE-UUID>Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Compose の詳細情報の表示
composer-cli compose info <COMPOSE-UUID>
# composer-cli compose info <COMPOSE-UUID>Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Compose のイメージファイルのダウンロード
composer-cli compose image <COMPOSE-UUID>
# composer-cli compose image <COMPOSE-UUID>Copy to Clipboard Copied! Toggle word wrap Toggle overflow - サブコマンドとオプションをもっと見る
composer-cli help
# composer-cli helpCopy to Clipboard Copied! Toggle word wrap Toggle overflow
4.7. RHEL Image Builder のブループリント形式 リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder のブループリントは、TOML 形式のプレーンテキストとしてユーザーに表示されます。
一般的なブループリントファイルの要素には、次のものが含まれます。
- ブループリントのメタデータ
name = "<BLUEPRINT-NAME>" description = "<LONG FORM DESCRIPTION TEXT>" version = "<VERSION>"
name = "<BLUEPRINT-NAME>" description = "<LONG FORM DESCRIPTION TEXT>" version = "<VERSION>"Copy to Clipboard Copied! Toggle word wrap Toggle overflow BLUEPRINT-NAME および LONG FORM DESCRIPTION TEXT フィールドは、ブループリントの名前と説明です。
VERSION は、セマンティックバージョニングスキームに従ったバージョン番号であり、ブループリントファイル全体で 1 つだけ存在するものです。
- イメージに追加するグループ
[[groups]] name = "group-name"
[[groups]] name = "group-name"Copy to Clipboard Copied! Toggle word wrap Toggle overflow group エントリーは、イメージにインストールするパッケージのグループを説明します。グループは、次のパッケージカテゴリーを使用します。
- 必須
- デフォルト
任意
group-name は、anaconda-tools、widget、wheel または users などのグループの名前です。ブループリントは、必須パッケージとデフォルトパッケージをインストールします。オプションパッケージを選択するメカニズムはありません。
- イメージに追加するパッケージ
[[packages]] name = "<package-name>" version = "<package-version>"
[[packages]] name = "<package-name>" version = "<package-version>"Copy to Clipboard Copied! Toggle word wrap Toggle overflow package-name は、httpd、gdb-doc、または coreutils などのパッケージの名前です。
package-version は使用するバージョンです。このフィールドは、
dnfバージョンの指定に対応します。- 特定のバージョンについては、8.7.0 などの正確なバージョン番号を使用してください。
- 利用可能な最新バージョンを指定する場合は、アスタリスク (*) を使用します。
最新のマイナーバージョンの場合は、8.* などの形式を使用します。
追加するすべてのパッケージにこのブロックを繰り返します。
RHEL Image Builder ツールのパッケージとモジュールの間に違いはありません。どちらも RPM パッケージの依存関係として扱われます。
4.8. サポートされているイメージのカスタマイズ リンクのコピーリンクがクリップボードにコピーされました!
ブループリントに次のようなカスタマイズを追加することで、イメージをカスタマイズできます。
- RPM パッケージの追加
- サービスの有効化
- カーネルコマンドラインパラメーターのカスタマイズ
とりわけ、ブループリント内ではいくつかのイメージのカスタマイズを使用できます。カスタマイズを使用すると、デフォルトのパッケージでは使用できないパッケージやグループをイメージに追加できます。これらのオプションを使用するには、ブループリントでカスタマイズを設定し、それを RHEL Image Builder にインポート (プッシュ) します。
4.8.1. ディストリビューションの選択 リンクのコピーリンクがクリップボードにコピーされました!
distro フィールドを使用して、イメージを作成するときやブループリント内の依存関係を解決するときに使用するディストリビューションを指定できます。distro フィールドが空白のままの場合、ブループリントはホストのオペレーティングシステムディストリビューションを自動的に使用します。ディストリビューションを指定しない場合、ブループリントはホストディストリビューションを使用します。ホストオペレーティングシステムをアップグレードすると、指定されたディストリビューションがないブループリントは、アップグレードされたオペレーティングシステムのバージョンを使用してイメージをビルドします。
新しいシステムで古いメジャーバージョンのイメージをビルドできます。たとえば、RHEL 10 ホストを使用して、RHEL 9 および RHEL 8 のイメージを作成できます。ただし、古いシステムで新しいメジャーバージョンのイメージをビルドすることはできません。
RHEL Image Builder ホストとは異なるオペレーティングシステムイメージをビルドすることはできません。たとえば、RHEL システムを使用して Fedora または CentOS のイメージをビルドすることはできません。
指定の RHEL イメージを常にビルドするように、RHEL ディストリビューションを使用してブループリントをカスタマイズします。
name = "blueprint_name" description = "blueprint_version" version = "0.1" distro = "different_minor_version"
name = "blueprint_name" description = "blueprint_version" version = "0.1" distro = "different_minor_version"Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以下に例を示します。
name = "tmux" description = "tmux image with openssh" version = "1.2.16" distro = "rhel-9.5"
name = "tmux" description = "tmux image with openssh" version = "1.2.16" distro = "rhel-9.5"Copy to Clipboard Copied! Toggle word wrap Toggle overflow
別のマイナーバージョンをビルドするには、"different_minor_version" を置き換えます。たとえば、RHEL 9.5 イメージをビルドする場合は、distro = "rhel-95" を使用します。RHEL 9.3 イメージでは、RHEL 9.3、RHEL 9.2、およびそれ以前のリリースなどのマイナーバージョンをビルドできます。
4.8.2. パッケージグループの選択 リンクのコピーリンクがクリップボードにコピーされました!
パッケージグループを使用してブループリントをカスタマイズします。イメージにインストールするパッケージのグループを、groups リストに記述します。パッケージグループはリポジトリーのメタデータで定義されます。各グループには、主にユーザーインターフェイスでの表示に使用されるわかりやすい名前と、キックスタートファイルでよく使用される ID があります。この場合、ID を使用してグループをリストする必要があります。グループでは、必須、デフォルト、任意の 3 つの方法でパッケージを分類できます。ブループリントには、必須パッケージとデフォルトパッケージのみがインストールされます。任意のパッケージを選択することはできません。
name 属性は、必須の文字列であり、リポジトリー内のパッケージグループ ID と正確に一致する必要があります。
現在、osbuild-composer のパッケージとモジュールの間に違いはありません。どちらも RPM パッケージの依存関係として扱われます。
パッケージを使用してブループリントをカスタマイズします。
[[groups]] name = "group_name"
[[groups]] name = "group_name"Copy to Clipboard Copied! Toggle word wrap Toggle overflow group_nameは、グループの名前に置き換えます。たとえば、anaconda-toolsです。[[groups]] name = "anaconda-tools"
[[groups]] name = "anaconda-tools"Copy to Clipboard Copied! Toggle word wrap Toggle overflow
4.8.3. コンテナーの埋め込み リンクのコピーリンクがクリップボードにコピーされました!
ブループリントをカスタマイズして、最新の RHEL コンテナーを埋め込むことができます。ソースを含むオブジェクトと、必要に応じて tls-verify 属性をコンテナーリストに含めます。
イメージに埋め込むコンテナーイメージを、コンテナーリストのエントリーに記述します。
-
source- 必須フィールド。これは、レジストリーにあるコンテナーイメージへの参照です。この例では、registry.access.redhat.comレジストリーを使用します。タグのバージョンを指定できます。デフォルトのタグバージョンは latest です。 -
name- ローカルレジストリー内のコンテナーの名前。 -
tls-verify- ブールフィールド。tls-verify ブールフィールドは、Transport Layer Security を制御します。デフォルト値は true です。
埋め込まれたコンテナーは自動的に起動しません。これを起動するには、systemd ユニットファイルまたは quadlets を作成し、ファイルをカスタマイズします。
registry.access.redhat.com/ubi9/ubi:latestのコンテナーとホストのコンテナーを埋め込むには、ブループリントに次のカスタマイズを追加します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow
containers-auth.json ファイルを使用して、保護されたコンテナーリソースにアクセスできます。コンテナーレジストリーの認証情報 を参照してください。
4.8.4. イメージのホスト名の設定 リンクのコピーリンクがクリップボードにコピーされました!
customizations.hostname は、最終イメージのホスト名を設定するために使用できるオプションの文字列です。このカスタマイズはオプションであり、設定しない場合、ブループリントはデフォルトのホスト名を使用します。
ブループリントをカスタマイズしてホスト名を設定します。
[customizations] hostname = "baseimage"
[customizations] hostname = "baseimage"Copy to Clipboard Copied! Toggle word wrap Toggle overflow
4.8.5. 追加ユーザーの指定 リンクのコピーリンクがクリップボードにコピーされました!
ユーザーをイメージに追加し、必要に応じて SSH キーを設定します。このセクションのフィールドは、name を除いてすべてオプションです。
手順
ブループリントをカスタマイズして、イメージにユーザーを追加します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Copy to Clipboard Copied! Toggle word wrap Toggle overflow GID はオプションであり、イメージにすでに存在している必要があります。GID は、必要に応じて、パッケージによって作成されるか、ブループリントによって
[[customizations.group]]エントリーを使用して作成されます。PASSWORD-HASH は、実際の
password hashに置き換えます。password hashを生成するには、次のようなコマンドを使用します。python3 -c 'import crypt,getpass;pw=getpass.getpass();print(crypt.crypt(pw) if (pw==getpass.getpass("Confirm: ")) else exit())'$ python3 -c 'import crypt,getpass;pw=getpass.getpass();print(crypt.crypt(pw) if (pw==getpass.getpass("Confirm: ")) else exit())'Copy to Clipboard Copied! Toggle word wrap Toggle overflow その他のプレースホルダーを、適切な値に置き換えます。
nameの値を入力し、不要な行は省略します。追加するすべてのユーザーにこのブロックを繰り返します。
4.8.6. 追加グループの指定 リンクのコピーリンクがクリップボードにコピーされました!
作成されるシステムイメージのグループを指定します。name 属性と gid 属性は両方とも必須です。
グループを使用してブループリントをカスタマイズします。
[[customizations.group]] name = "GROUP-NAME" gid = NUMBER
[[customizations.group]] name = "GROUP-NAME" gid = NUMBERCopy to Clipboard Copied! Toggle word wrap Toggle overflow 追加するすべてのグループにこのブロックを繰り返します。以下に例を示します。
[[customizations.group]] name = "widget" gid = 1130
[[customizations.group]] name = "widget" gid = 1130Copy to Clipboard Copied! Toggle word wrap Toggle overflow
4.8.7. 既存ユーザーの SSH キーの設定 リンクのコピーリンクがクリップボードにコピーされました!
customizations.sshkey を使用して、最終イメージ内の既存ユーザーの SSH キーを設定できます。user 属性と key 属性は両方とも必須です。
既存ユーザーの SSH キーを設定してブループリントをカスタマイズします。
[[customizations.sshkey]] user = "root" key = "PUBLIC-SSH-KEY"
[[customizations.sshkey]] user = "root" key = "PUBLIC-SSH-KEY"Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以下に例を示します。
[[customizations.sshkey]] user = "root" key = "SSH key for root"
[[customizations.sshkey]] user = "root" key = "SSH key for root"Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記既存ユーザーに対してのみ、
customizations.sshkeyカスタマイズを設定できます。ユーザーを作成して SSH キーを設定するには、追加ユーザーの指定 のカスタマイズを参照してください。
4.8.8. カーネル引数の追加 リンクのコピーリンクがクリップボードにコピーされました!
ブートローダーのカーネルコマンドラインに引数を追加できます。デフォルトでは、RHEL Image Builder はデフォルトのカーネルをイメージにビルドします。ただし、ブループリントでカーネルを設定することでカーネルをカスタマイズできます。
デフォルト設定にカーネルの起動パラメーターオプションを追加します。
[customizations.kernel] append = "KERNEL-OPTION"
[customizations.kernel] append = "KERNEL-OPTION"Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以下に例を示します。
[customizations.kernel] name = "kernel-debug" append = "nosmt=force"
[customizations.kernel] name = "kernel-debug" append = "nosmt=force"Copy to Clipboard Copied! Toggle word wrap Toggle overflow
4.8.9. リアルタイムカーネルを使用した RHEL イメージのビルド リンクのコピーリンクがクリップボードにコピーされました!
リアルタイムカーネル (kernel-rt) を使用して RHEL イメージをビルドするには、デフォルトカーネルとして kernel-rt が正しく選択されたイメージをビルドできるように、リポジトリーをオーバーライドする必要があります。/usr/share/osbuild-composer/repositories/ ディレクトリーの .json を使用してください。その後、ビルドしたイメージをシステムにデプロイし、リアルタイムカーネル機能を使用できます。
リアルタイムカーネルは、Red Hat Enterprise Linux の動作認定を受けた AMD64 および Intel 64 サーバープラットフォームで動作します。
前提条件
- システムが登録され、RHEL が RHEL for Real Time サブスクリプションに割り当てられている。dnf を使用した RHEL for Real Time のインストール を参照してください。
手順
以下のディレクトリーを作成します。
mkdir /etc/osbuild-composer/repositories/
# mkdir /etc/osbuild-composer/repositories/Copy to Clipboard Copied! Toggle word wrap Toggle overflow /usr/share/osbuild-composer/repositories/rhel-9.version.jsonファイルの内容を新しいディレクトリーにコピーします。cp /usr/share/osbuild-composer/repositories/rhel-9.version.json /etc/osbuild-composer/repositories
# cp /usr/share/osbuild-composer/repositories/rhel-9.version.json /etc/osbuild-composer/repositoriesCopy to Clipboard Copied! Toggle word wrap Toggle overflow /etc/osbuild-composer/repositories/rhel-9.version.jsonファイルを編集して、RT カーネルリポジトリーを含めます。Copy to Clipboard Copied! Toggle word wrap Toggle overflow サービスを再起動します。
systemctl restart osbuild-composer
# systemctl restart osbuild-composerCopy to Clipboard Copied! Toggle word wrap Toggle overflow kernel-rtが.jsonファイルに含まれていることを確認します。composer-cli sources list composer-cli sources info kernel-rt
# composer-cli sources list # composer-cli sources info kernel-rtCopy to Clipboard Copied! Toggle word wrap Toggle overflow 以前に設定した URL が表示されます。
ブループリントを作成します。ブループリントに、"[customizations.kernel]" カスタマイズを追加します。以下は、ブループリントに "[customizations.kernel]" を追加した例です。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow ブループリントをサーバーにプッシュします。
composer-cli blueprints push rt-kernel-image.toml
# composer-cli blueprints push rt-kernel-image.tomlCopy to Clipboard Copied! Toggle word wrap Toggle overflow 作成したブループリントからイメージをビルドします。次の例では、(
.qcow2) イメージをビルドします。composer-cli compose start rt-kernel-image qcow2
# composer-cli compose start rt-kernel-image qcow2Copy to Clipboard Copied! Toggle word wrap Toggle overflow - ビルドしたイメージを、リアルタイムカーネル機能を使用するシステムにデプロイします。
検証
イメージから仮想マシンを起動した後、デフォルトのカーネルとして
kernel-rtが正しく選択されたイメージがビルドされていることを確認します。cat /proc/cmdline BOOT_IMAGE=(hd0,got3)/vmlinuz-5.14.0-362.24.1..el9_version_.x86_64+rt...
$ cat /proc/cmdline BOOT_IMAGE=(hd0,got3)/vmlinuz-5.14.0-362.24.1..el9_version_.x86_64+rt...Copy to Clipboard Copied! Toggle word wrap Toggle overflow
4.8.10. タイムゾーンと NTP の設定 リンクのコピーリンクがクリップボードにコピーされました!
ブループリントをカスタマイズして、タイムゾーンと Network Time Protocol (NTP) を設定できます。timezone 属性と ntpservers 属性は両方ともオプションの文字列です。タイムゾーンをカスタマイズしない場合、システムは 協定世界時 (UTC) を使用します。NTP サーバーを設定しない場合、システムはデフォルトのディストリビューションを使用します。
必要な
timezoneとntpserversを使用してブループリントをカスタマイズします。[customizations.timezone] timezone = "TIMEZONE" ntpservers = "NTP_SERVER"
[customizations.timezone] timezone = "TIMEZONE" ntpservers = "NTP_SERVER"Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以下に例を示します。
[customizations.timezone] timezone = "US/Eastern" ntpservers = ["0.north-america.pool.ntp.org", "1.north-america.pool.ntp.org"]
[customizations.timezone] timezone = "US/Eastern" ntpservers = ["0.north-america.pool.ntp.org", "1.north-america.pool.ntp.org"]Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記Google Cloud などの一部のイメージタイプには、すでに NTP サーバーがセットアップされています。そのようなイメージでは、選択されている環境で NTP サーバーを起動する必要があるため、これをオーバーライドすることはできません。ただし、ブループリントでタイムゾーンをカスタマイズできます。
4.8.11. ロケール設定のカスタマイズ リンクのコピーリンクがクリップボードにコピーされました!
作成されるシステムイメージのロケール設定をカスタマイズできます。language 属性と keyboard 属性は両方とも必須です。他の多くの言語を追加できます。最初に追加する言語はプライマリー言語で、他の言語はセカンダリー言語です。
手順
ロケール設定を行います。
[customizations.locale] languages = ["LANGUAGE"] keyboard = "KEYBOARD"
[customizations.locale] languages = ["LANGUAGE"] keyboard = "KEYBOARD"Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以下に例を示します。
[customizations.locale] languages = ["en_US.UTF-8"] keyboard = "us"
[customizations.locale] languages = ["en_US.UTF-8"] keyboard = "us"Copy to Clipboard Copied! Toggle word wrap Toggle overflow 言語でサポートされている値を一覧表示するには、以下のコマンドを実行します。
localectl list-locales
$ localectl list-localesCopy to Clipboard Copied! Toggle word wrap Toggle overflow キーボードでサポートされている値を一覧表示するには、以下のコマンドを実行します。
localectl list-keymaps
$ localectl list-keymapsCopy to Clipboard Copied! Toggle word wrap Toggle overflow
4.8.12. ファイアウォールのカスタマイズ リンクのコピーリンクがクリップボードにコピーされました!
生成されたシステムイメージのファイアウォールを設定します。デフォルトでは、ファイアウォールは、sshd など、ポートを明示的に有効にするサービスを除き、着信接続をブロックします。
[customizations.firewall] または [customizations.firewall.services] を使用したくない場合は、属性を削除するか、空のリスト [] に設定します。デフォルトのファイアウォールセットアップのみを使用する場合は、ブループリントからカスタマイズを省略できます。
Google および OpenStack テンプレートは、環境のファイアウォールを明示的に無効にします。ブループリントを設定してこの動作をオーバーライドすることはできません。
手順
他のポートとサービスを開くには、次の設定を使用してブループリントをカスタマイズします。
[customizations.firewall] ports = ["PORTS"]
[customizations.firewall] ports = ["PORTS"]Copy to Clipboard Copied! Toggle word wrap Toggle overflow ここで、
portsは、ポート、または開くポートとプロトコルの範囲を含む文字列のオプションのリストです。port:protocol形式を使用してポートを設定できます。portA-portB:protocol形式を使用してポート範囲を設定できます。以下に例を示します。[customizations.firewall] ports = ["22:tcp", "80:tcp", "imap:tcp", "53:tcp", "53:udp", "30000-32767:tcp", "30000-32767:udp"]
[customizations.firewall] ports = ["22:tcp", "80:tcp", "imap:tcp", "53:tcp", "53:udp", "30000-32767:tcp", "30000-32767:udp"]Copy to Clipboard Copied! Toggle word wrap Toggle overflow /etc/servicesの数値ポートまたはその名前を使用して、ポートリストを有効または無効にすることができます。customizations.firewall.serviceセクションで、どのファイアウォールサービスを有効または無効にするかを指定します。[customizations.firewall.services] enabled = ["SERVICES"] disabled = ["SERVICES"]
[customizations.firewall.services] enabled = ["SERVICES"] disabled = ["SERVICES"]Copy to Clipboard Copied! Toggle word wrap Toggle overflow 利用可能なファイアウォールサービスを確認できます。
firewall-cmd --get-services
$ firewall-cmd --get-servicesCopy to Clipboard Copied! Toggle word wrap Toggle overflow 以下に例を示します。
[customizations.firewall.services] enabled = ["ftp", "ntp", "dhcp"] disabled = ["telnet"]
[customizations.firewall.services] enabled = ["ftp", "ntp", "dhcp"] disabled = ["telnet"]Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記firewall.servicesにリストされているサービスは、/etc/servicesファイルで使用可能なservice-namesとは異なります。
4.8.13. サービスの有効化または無効化 リンクのコピーリンクがクリップボードにコピーされました!
システムの起動時に有効にするサービスを制御することができます。一部のイメージタイプでは、イメージが正しく機能するようにすでにサービスが有効または無効になっており、このセットアップをオーバーライドすることができません。ブループリントの [customizations.services] 設定はこれらのサービスを置き換えるものではありませんが、イメージテンプレートにすでに存在するサービスのリストにサービスを追加します。
起動時に有効にするサービスをカスタマイズします。
[customizations.services] enabled = ["SERVICES"] disabled = ["SERVICES"]
[customizations.services] enabled = ["SERVICES"] disabled = ["SERVICES"]Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以下に例を示します。
[customizations.services] enabled = ["sshd", "cockpit.socket", "httpd"] disabled = ["postfix", "telnetd"]
[customizations.services] enabled = ["sshd", "cockpit.socket", "httpd"] disabled = ["postfix", "telnetd"]Copy to Clipboard Copied! Toggle word wrap Toggle overflow
4.8.14. キックスタートファイルへの ISO イメージの注入 リンクのコピーリンクがクリップボードにコピーされました!
[customization.installer] ブループリントのカスタマイズを使用すると、ISO インストーラー (image installer や edge installer) のビルドに独自のキックスタートファイルを追加して、ベアメタルデプロイメント用の ISO イメージをビルドする際の柔軟性を高めることができます。
キックスタートはシステム上の最初のディスクを自動的に再フォーマットするように設定されています。そのため、既存のオペレーティングシステムまたはデータを有するマシンで ISO を起動すると、破壊的な結果を招く可能性があります。
次の中から、独自のキックスタートファイルを追加する方法を選択できます。
- インストールプロセス中にすべての値を設定する。
-
キックスタートで
unattended = trueフィールドを有効にし、デフォルト設定を使用した完全に無人のインストールを実行する。 - キックスタートフィールドを使用して独自のキックスタートを注入する。これにより、必須フィールドをすべて指定すると完全に無人インストールになるか、欠落している可能性のあるフィールドが要求される可能性があります。
Anaconda インストーラーの ISO イメージタイプでは、次のブループリントのカスタマイズがサポートされています。
[customizations.installer] unattended = true sudo-nopasswd = ["user", "%wheel"]
[customizations.installer]
unattended = true
sudo-nopasswd = ["user", "%wheel"]
unattended: インストールを完全に自動化するキックスタートファイルを作成します。これには、デフォルトで次のオプションの設定が含まれます。
- テキスト表示モード
- en_US.UTF-8 言語/ロケール
- US キーボードレイアウト
- UTC タイムゾーン
- zerombr、clearpart、autopart による最初のディスクの自動的なワイプおよびパーティション設定
- DHCP と自動アクティブ化を有効にするネットワークオプション
以下に例を示します。
sudo-nopasswd: インストール後に /etc/sudoers.d にドロップインファイルを作成し、指定のユーザーとグループがパスワードなしで sudo を実行できるようにするスニペットをキックスタートファイルに追加します。グループには % という接頭辞を付ける必要があります。たとえば、値を ["user", "%wheel"] に設定すると、次のようなキックスタートの %post セクションが作成されます。
インストーラーキックスタート
または、次のカスタマイズを使用して、カスタムのキックスタートを含めることもできます。
osbuild-composer を使用すると、image-installer または edge-installer イメージタイプに関連する場合に、システムをインストールするコマンド liveimg または ostreesetup が自動的に追加されます。[customizations.installer.kickstart] によるカスタマイズを、他のインストーラーカスタマイズと組み合わせて使用することはできません。
4.8.15. パーティションモードの指定 リンクのコピーリンクがクリップボードにコピーされました!
ビルドするディスクイメージをパーティション設定する方法を選択するには、partitioning_mode 変数を使用します。サポートされている次のモードでイメージをカスタマイズできます。
-
auto-lvm: 1 つ以上のファイルシステムのカスタマイズがない限り、RAW パーティションモードを使用します。ある場合は、LVM パーティションモードを使用します。 -
lvm: 追加のマウントポイントがない場合でも、常に LVM パーティションモードを使用します。 -
raw: マウントポイントが 1 つ以上ある場合でも、RAW パーティションを使用します。 次のカスタマイズを使用して、
partitioning_mode変数を使用してブループリントをカスタマイズできます。[customizations] partitioning_mode = "lvm"
[customizations] partitioning_mode = "lvm"Copy to Clipboard Copied! Toggle word wrap Toggle overflow
4.8.16. カスタムファイルシステム設定の指定 リンクのコピーリンクがクリップボードにコピーされました!
ブループリントでカスタムファイルシステム設定を指定できるため、デフォルトのレイアウト設定ではなく、特定のディスクレイアウトでイメージを作成できます。ブループリントでデフォルト以外のレイアウト設定を使用すると、次の利点が得られます。
- セキュリティーベンチマークへの準拠
- ディスク外エラーに対する保護
- パフォーマンスの向上
- 既存のセットアップとの整合性
OSTree イメージには読み取り専用などの独自のマウントルールがあるため、OSTree システムではファイルシステムのカスタマイズはサポートされません。次のイメージタイプはサポートされません。
-
image-installer -
edge-installer -
edge-simplified-installer
さらに、次のイメージタイプはパーティション設定されたオペレーティングシステムイメージを作成しないため、ファイルシステムのカスタマイズをサポートしません。
-
edge-commit -
edge-container -
tar -
container
ただし、次のイメージタイプではファイルシステムのカスタマイズがサポートされています。
-
simplified-installer -
edge-raw-image -
edge-ami -
edge-vsphere
OSTree システムの一部例外を除き、ファイルシステムの /root レベルで任意のディレクトリー名を選択できます (例: `/local`、`/mypartition`、/$PARTITION)。論理ボリュームでは、これらの変更は LVM パーティションシステム上で行われます。別の論理ボリューム上の /var、`/var/log`、および /var/lib/containers ディレクトリーがサポートされています。root レベルでの例外は次のとおりです。
- "/home": {Deny: true},
- "/mnt": {Deny: true},
- "/opt": {Deny: true},
- "/ostree": {Deny: true},
- "/root": {Deny: true},
- "/srv": {Deny: true},
- "/var/home": {Deny: true},
- "/var/mnt": {Deny: true},
- "/var/opt": {Deny: true},
- "/var/roothome": {Deny: true},
- "/var/srv": {Deny: true},
- "/var/usrlocal": {Deny: true},
RHEL 8.10 および 9.5 より前のリリースディストリビューションの場合、ブループリントは次の mountpoints とそのサブディレクトリーをサポートしています。
-
/- ルートマウントポイント -
/var -
/home -
/opt -
/srv/ -
/usr -
/app -
/data -
/tmp
RHEL 9.5 および 8.10 以降のリリースディストリビューションでは、オペレーティングシステム用に予約されている特定のパスを除き、任意のカスタムマウントポイントを指定できます。
次のマウントポイントとそのサブディレクトリーに任意のカスタムマウントポイントを指定することはできません。
-
/bin -
/boot/efi -
/dev -
/etc -
/lib -
/lib64 -
/lost+found -
/proc -
/run -
/sbin -
/sys -
/sysroot -
/var/lock -
/var/run
ブループリントで /usr カスタムマウントポイントのファイルシステムはカスタマイズできますが、そのサブディレクトリーはカスタマイズできません。
マウントポイントのカスタマイズは、RHEL 9.0 ディストリビューション以降、CLI を使用した場合のみサポートされます。以前のディストリビューションでは、root パーティションをマウントポイントとして指定し、size 引数をイメージ size のエイリアスとして指定することしかできません。
カスタマイズされたイメージに複数のパーティションがある場合、LVM でカスタマイズされたファイルシステムパーティションを使用してイメージを作成し、実行時にそれらのパーティションのサイズを変更できます。これを行うには、ブループリントでカスタマイズされたファイルシステム設定を指定して、必要なディスクレイアウトでイメージを作成します。デフォルトのファイルシステムレイアウトは変更されません。ファイルシステムをカスタマイズせずにプレーンイメージを使用すると、cloud-init によってルートパーティションのサイズが変更されます。
ブループリントは、ファイルシステムのカスタマイズを LVM パーティションに自動的に変換します。
カスタムファイルブループリントのカスタマイズを使用して、新しいファイルを作成したり、既存のファイルを置き換えたりできます。指定するファイルの親ディレクトリーが存在している必要があります。存在しない場合、イメージのビルドが失敗します。[[customizations.directories]] のカスタマイズで親ディレクトリーを指定して、親ディレクトリーが存在することを確認してください。
ファイルのカスタマイズを他のブループリントのカスタマイズと組み合わせると、他のカスタマイズの機能に影響が生じたり、現在のファイルのカスタマイズがオーバーライドされる可能性があります。
4.8.16.1. カスタマイズされたファイルをブループリントで指定する リンクのコピーリンクがクリップボードにコピーされました!
[[customizations.files]] ブループリントのカスタマイズを使用すると、次のことが可能になります。
- 新しいテキストファイルを作成する。
- 既存のファイルを変更する。警告: これにより、既存のコンテンツが上書きされる可能性があります。
- 作成するファイルのユーザーとグループの所有権を設定する。
- モード許可を 8 進数形式で設定する。
以下のファイルは作成または置き換えることはできません。
-
/etc/fstab -
/etc/shadow -
/etc/passwd -
/etc/group
[[customizations.files]] および [[customizations.directories]] ブループリントのカスタマイズを使用して、イメージ内にカスタマイズされたファイルとディレクトリーを作成できます。これらのカスタマイズは、/etc ディレクトリーでのみ使用できます。
これらのブループリントのカスタマイズは、OSTree コミットをデプロイするイメージタイプ (edge-raw-image、edge-installer、edge-simplified-installer など) を除く、すべてのイメージタイプでサポートされます。
mode、user、または group がすでに設定されているイメージ内にすでに存在するディレクトリーパスで customizations.directories を使用すると、イメージビルドで既存のディレクトリーの所有権または権限の変更を防ぐことができません。
4.8.16.2. カスタマイズされたディレクトリーをブループリントで指定する リンクのコピーリンクがクリップボードにコピーされました!
[[customizations.directories]] ブループリントのカスタマイズを使用すると、以下を行うことができます。
- 新しいディレクトリーを作成する。
- 作成するディレクトリーのユーザーとグループの所有権を設定する。
- ディレクトリーモードのパーミッションを 8 進数形式で設定する。
- 必要に応じて親ディレクトリーを作成する。
[[customizations.files]] ブループリントのカスタマイズを使用すると、次のことが可能になります。
- 新しいテキストファイルを作成する。
- 既存のファイルを変更する。警告: これにより、既存のコンテンツが上書きされる可能性があります。
- 作成するファイルのユーザーとグループの所有権を設定する。
- モード許可を 8 進数形式で設定する。
以下のファイルは作成または置き換えることはできません。
-
/etc/fstab -
/etc/shadow -
/etc/passwd -
/etc/group
以下のカスタマイズが可能です。
ブループリントのファイルシステム設定をカスタマイズします。
[[customizations.filesystem]] mountpoint = "MOUNTPOINT" minsize = MINIMUM-PARTITION-SIZE
[[customizations.filesystem]] mountpoint = "MOUNTPOINT" minsize = MINIMUM-PARTITION-SIZECopy to Clipboard Copied! Toggle word wrap Toggle overflow MINIMUM-PARTITION-SIZE値には、デフォルトのサイズ形式はありません。ブループリントのカスタマイズでは、kB から TB、および KiB から TiB の値と単位がサポートされています。たとえば、マウントポイントのサイズをバイト単位で定義できます。[[customizations.filesystem]] mountpoint = "/var" minsize = 1073741824
[[customizations.filesystem]] mountpoint = "/var" minsize = 1073741824Copy to Clipboard Copied! Toggle word wrap Toggle overflow 単位を使用してマウントポイントのサイズを定義します。以下に例を示します。
[[customizations.filesystem]] mountpoint = "/opt" minsize = "20 GiB"
[[customizations.filesystem]] mountpoint = "/opt" minsize = "20 GiB"Copy to Clipboard Copied! Toggle word wrap Toggle overflow [[customizations.filesystem]] mountpoint = "/boot" minsize = "1 GiB"
[[customizations.filesystem]] mountpoint = "/boot" minsize = "1 GiB"Copy to Clipboard Copied! Toggle word wrap Toggle overflow minsizeを設定して最小パーティションを定義します。以下に例を示します。[[customizations.filesystem]] mountpoint = "/var" minsize = 2147483648
[[customizations.filesystem]] mountpoint = "/var" minsize = 2147483648Copy to Clipboard Copied! Toggle word wrap Toggle overflow [[customizations.directories]]を使用して、イメージ用にカスタマイズされたディレクトリーを/etcディレクトリーの下に作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow ブループリントの各エントリーを説明します。
-
path- 必須 - 作成するディレクトリーへのパスを入力します。/etcディレクトリー下の絶対パスである必要があります。 -
mode- オプション - ディレクトリーのアクセスパーミッションを 8 進数形式で設定します。パーミッションを指定しない場合、デフォルトで 0755 に設定されます。先頭のゼロは任意です。 -
user- オプション - ユーザーをディレクトリーの所有者として設定します。ユーザーを指定しない場合は、デフォルトでrootに設定されます。ユーザーは文字列または整数として指定できます。 -
group- オプション - グループをディレクトリーの所有者として設定します。グループを指定しない場合は、デフォルトでrootになります。グループは文字列または整数として指定できます。 -
ensure_parents- オプション - 必要に応じて親ディレクトリーを作成するかどうかを指定します。値を指定しない場合は、デフォルトでfalseに設定されます。
-
[[customizations.directories]]を使用して、イメージ用にカスタマイズされたファイルを/etcディレクトリーの下に作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow ブループリントの各エントリーを説明します。
-
path- 必須 - 作成するファイルへのパスを入力します。/etcディレクトリー下の絶対パスである必要があります。 -
mode- オプション - ファイルのアクセスパーミッションを 8 進数形式で設定します。パーミッションを指定しない場合、デフォルトで 0644 に設定されます。先頭のゼロは任意です。 -
user- オプション - ユーザーをファイルの所有者として設定します。ユーザーを指定しない場合は、デフォルトでrootに設定されます。ユーザーは文字列または整数として指定できます。 -
group- オプション - グループをファイルの所有者として設定します。グループを指定しない場合は、デフォルトでrootになります。グループは文字列または整数として指定できます。 -
data- オプション - プレーンテキストファイルの内容を指定します。コンテンツを指定しない場合は、空のファイルが作成されます。
-
4.8.17. ブループリントでボリュームグループと論理ボリュームの命名を指定する リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder は次の操作に使用できます。
-
高度なパーティションレイアウトを使用して RHEL ディスクイメージを作成します。カスタムのマウントポイント、LVM ベースのパーティション、LVM ベースの SWAP を使用してディスクイメージを作成できます。たとえば、
config.tomlファイルを使用して、/および/bootディレクトリーのサイズを変更できます。 -
使用するファイルシステムを選択します。
ext4とxfsのどちらかを選択できます。 - スワップパーティションと LV を追加します。ディスクイメージに LV ベースの SWAP を含めることができます。
- LVM エンティティーの名前を変更します。イメージ内の論理ボリューム (LV) とボリュームグループ (VG) にカスタム名を付けることができます。
次のオプションはサポートされていません。
- 1 つのイメージに複数の PV または VG を含める
- SWAP ファイル
-
/dev/shmや/tmpなどの非物理パーティションのマウントオプション
例: ファイルシステムが存在する VG および LG のカスタマイズ名の追加
4.9. RHEL Image Builder によってインストールされるパッケージ リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder を使用してシステムイメージを作成すると、システムは一連のベースパッケージグループをインストールします。
ブループリントにコンポーネントを追加する場合は、追加したコンポーネント内のパッケージが他のパッケージコンポーネントと競合しないようにしてください。そうしないと、システムは依存関係を解決できず、カスタマイズされたイメージの作成に失敗します。次のコマンドを実行して、パッケージ間に競合がないかどうかを確認できます。
composer-cli blueprints depsolve BLUEPRINT-NAME
# composer-cli blueprints depsolve BLUEPRINT-NAME
| イメージタイプ | デフォルトパッケージ |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
4.10. カスタムイメージで有効なサービス リンクのコピーリンクがクリップボードにコピーされました!
Image Builder を使用してカスタムイメージを設定する場合、イメージが使用するデフォルトのサービスは次のように決定されます。
-
osbuild-composerユーティリティーを使用する RHEL リリース - イメージの種類
たとえば、ami イメージタイプは、デフォルトで sshd、chronyd、および cloud-init サービスを有効にします。これらのサービスが有効になっていない場合、カスタムイメージは起動しません。
| イメージタイプ | デフォルトで有効化されているサービス |
|---|---|
|
| sshd, cloud-init, cloud-init-local, cloud-config, cloud-final |
|
| sshd, cloud-init, cloud-init-local, cloud-config, cloud-final |
|
| cloud-init |
|
| デフォルトでは、追加のサービスは有効になりません。 |
|
| デフォルトでは、追加のサービスは有効になりません。 |
|
| sshd, chronyd, waagent, cloud-init, cloud-init-local, cloud-config, cloud-final |
|
| sshd、chronyd、vmtoolsd、cloud-init |
注記: システムの起動時に有効にするサービスをカスタマイズできます。ただし、カスタマイズは、前述のイメージタイプに対してデフォルトで有効になっているサービスを上書きしません。
第5章 RHEL Image Builder Web コンソールインターフェイスを使用したシステムイメージの作成 リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder は、カスタムのシステムイメージを作成するツールです。RHEL Image Builder を制御してカスタムシステムイメージを作成する場合は、Web コンソールインターフェイスを使用できます。
5.1. RHEL Web コンソールでの RHEL Image Builder ダッシュボードへのアクセス リンクのコピーリンクがクリップボードにコピーされました!
RHEL Web コンソール用の cockpit-composer プラグインを使用すると、グラフィカルインターフェイスを使用して Image Builder のブループリントと設定を管理できます。
前提条件
- システムへの root アクセス権限がある。
- RHEL Image Builder がインストールされている。
-
cockpit-composerパッケージがインストールされている。
手順
-
ホスト上で、Web ブラウザーで
https://<_localhost_>:9090/を開きます。 - root ユーザーとして Web コンソールにログインします。
RHEL Image Builder のコントロールを表示するには、ウィンドウの左上隅にある ボタンをクリックします。
RHEL Image Builder ダッシュボードが開き、既存のブループリントがあればそれがリストされます。
5.2. Web コンソールインターフェイスでのブループリントの作成 リンクのコピーリンクがクリップボードにコピーされました!
カスタマイズした RHEL システムイメージをビルドするには、ブループリントを作成する必要があります。利用可能なカスタマイズはすべて任意です。次の方法を使用して、カスタマイズしたブループリントを作成できます。
- CLI を使用する。サポートされているイメージのカスタマイズ を参照してください。
- Web コンソールを使用する。次の手順に従ってください。
これらのブループリントのカスタマイズは、Red Hat Enterprise Linux 9.2 以降のバージョンおよび Red Hat Enterprise Linux 8.8 以降のバージョンで利用できます。
前提条件
- ブラウザーの Web コンソールから RHEL Image Builder アプリケーションを開いている。RHEL Web コンソールでの RHEL Image Builder GUI へのアクセス を参照してください。
手順
右上隅にある をクリックします。
ブループリントの名前と説明のフィールドを含むダイアログウィザードが開きます。
Detailsページで以下を行います。- ブループリントの名前と、必要に応じてその説明を入力します。
- をクリックします。
オプション:
Packagesページで、以下を行います。-
Available packagesの検索で、パッケージ名を入力します。 - ボタンをクリックして Chosen packages フィールドに移動します。
- 前の手順を繰り返して、必要な数のパッケージを検索して含めます。
をクリックします。
注記特に指定がない限り、これらのカスタマイズはすべてオプションです。
-
-
Kernelページで、カーネル名とコマンドライン引数を入力します。 File systemページで、お使いのイメージファイルシステムに合わせてUse automatic partitioningまたはManually configure partitionsを選択します。パーティションを手動で設定するには、次の手順を実行します。ボタンをクリックします。
Configure partitionsセクションが開き、Red Hat 標準およびセキュリティーガイドに基づく設定が表示されます。ドロップダウンメニューから、パーティションを設定するための詳細を入力します。
Mount pointフィールドに、以下のマウントポイントタイプオプションのいずれかを選択します。-
/- ルートマウントポイント -
/app -
/boot -
/data -
/home -
/opt -
/srv/ -
/usr -
/usr/local /var/tmpなどの追加のパスをMount pointに追加することもできます。例: 接頭辞/varと、追加パス/tmpで、/var/tmpになります。注記選択した Mount point のタイプに応じて、ファイルシステムのタイプが
xfsに変わります。
-
ファイルシステムの
Minimum size partitionフィールドに、必要な最小パーティションサイズを入力します。Minimum size ドロップダウンメニューでは、GiB、MiB、KiBなどの一般的なサイズ単位を使用できます。デフォルトの単位はGiBです。注記Minimum sizeとは、作業用イメージの作成には小さすぎる場合にも RHEL Image Builder がパーティションサイズを増加できるという意味です。
さらにパーティションを追加するには、 ボタンをクリックします。エラーメッセージ
Duplicate partitions: Only one partition at each mount point can be created.が表示された場合は、以下を行います。- ボタンをクリックして、重複したパーティションを削除します。
- 作成するパーティションの新しいマウントポイントを選択します。
- パーティションの設定が完了したら、 をクリックします。
Servicesページで、サービスを有効または無効にします。- 有効または無効にするサービス名をコンマまたはスペースで区切るか、 キーを押して入力します。 をクリックします。
-
Enabled servicesを入力します。 -
Disabled servicesを入力します。
Firewallページで、ファイアウォールを設定します。-
Portsと、有効または無効にするファイアウォールサービスを入力します。 - ボタンをクリックして、各ゾーンのファイアウォールルールを個別に管理します。 をクリックします。
-
Usersページで、以下の手順に従ってユーザーを追加します。- をクリックします。
-
Username、Password、およびSSH keyを入力します。Server administratorチェックボックスをクリックして、ユーザーを特権ユーザーとしてマークすることもできます。 をクリックします。
Groupsページで、次の手順を実行してグループを追加します。ボタンをクリックします。
-
Group nameとGroup IDを入力します。グループをさらに追加できます。 をクリックします。
-
SSH keysページで、キーを追加します。ボタンをクリックします。
- SSH キーを入力します。
-
Userを入力します。 をクリックします。
Timezoneページで、タイムゾーンを設定します。Timezoneフィールドに、システムイメージに追加するタイムゾーンを入力します。たとえば、タイムゾーン形式 "US/Eastern" を追加します。タイムゾーンを設定しない場合、システムはデフォルトとして協定世界時 (UTC) を使用します。
-
NTP serversを入力します。 をクリックします。
Localeページで、以下の手順を実行します。-
Keyboard検索フィールドに、システムイメージに追加するパッケージ名を入力します。たとえば、["en_US.UTF-8"] と入力します。 -
Languages検索フィールドに、システムイメージに追加するパッケージ名を入力します。たとえば、"us" と入力します。 をクリックします。
-
Othersページで、次の手順を実行します。-
Hostnameフィールドに、システムイメージに追加するホスト名を入力します。ホスト名を追加しない場合、オペレーティングシステムによってホスト名が決定されます。 -
Simplifier インストーラーイメージの場合のみ必須:
Installation Devicesフィールドに、システムイメージの有効なノードを入力します。たとえば、dev/sda1と入力します。 をクリックします。
-
FDO 用のイメージをビルドする場合のみ必須:
FIDO Device Onboardingページで、次の手順を実行します。Manufacturing server URLフィールドに、次の情報を入力します。-
DIUN public key insecureフィールドに、セキュアでない公開鍵を入力します。 -
DIUN public key hashフィールドに、公開鍵ハッシュを入力します。 -
DIUN public key root certsフィールドに、公開鍵ルート証明書を入力します。 をクリックします。
-
OpenSCAPページで、次の手順を実行します。-
Datastreamフィールドに、システムイメージに追加するdatastream修復手順を入力します。 -
Profile IDフィールドに、システムイメージに追加するprofile_idセキュリティープロファイルを入力します。 をクリックします。
-
Ignition を使用するイメージをビルドする場合にのみ必須:
Ignitionページで、次の手順を実行します。-
Firstboot URLフィールドに、システムイメージに追加するパッケージ名を入力します。 -
Embedded Dataフィールドに、ファイルをドラッグまたはアップロードします。 をクリックします。
-
-
.
Reviewページで、ブループリントの詳細を確認します。 をクリックします。
RHEL Image Builder ビューが開き、既存のブループリントのリストが表示されます。
5.3. RHEL Image Builder Web コンソールインターフェイスでのブループリントのインポート リンクのコピーリンクがクリップボードにコピーされました!
既存のブループリントをインポートして使用できます。システムがすべての依存関係を自動的に解決します。
前提条件
- ブラウザーの Web コンソールから RHEL Image Builder アプリケーションを開いている。
- RHEL Image Builder Web コンソールインターフェイスで使用するためにインポートするブループリントがある。
手順
-
RHEL Image Builder ダッシュボードで、 をクリックします。
Import blueprintが開きます。 -
Uploadフィールドから、既存のブループリントをドラッグまたはアップロードします。TOMLとJSONのどちらかの形式のブループリントを使用できます。 - をクリックします。ダッシュボードに、インポートしたブループリントがリストされます。
検証
インポートしたブループリントをクリックすると、インポートしたブループリントのすべてのカスタマイズを含むダッシュボードにアクセスできます。
インポートしたブループリント用に選択されているパッケージを確認するには、
Packagesタブに移動します。- すべてのパッケージの依存関係を一覧表示するには、 をクリックします。リストは検索可能で、並べ替えることもできます。
次のステップ
オプション: カスタマイズを変更するには、以下を実行します。
-
Customizationsダッシュボードから、変更するカスタマイズをクリックします。必要に応じて、 をクリックして、利用可能なすべてのカスタマイズオプションに移動できます。
-
5.4. RHEL Image Builder Web コンソールインターフェイスからのブループリントのエクスポート リンクのコピーリンクがクリップボードにコピーされました!
ブループリントをエクスポートして、別のシステムでカスタマイズを使用できます。ブループリントは TOML または JSON 形式でエクスポートできます。どちらの形式も CLI だけでなく API インターフェイスでも使用できます。
前提条件
- ブラウザーの Web コンソールから RHEL Image Builder アプリケーションを開いている。
- エクスポートするブループリントがある。
手順
- Image Builder ダッシュボードで、エクスポートするブループリントを選択します。
-
Export blueprintをクリックします。Export blueprintが開きます。 ボタンをクリックしてブループリントをファイルとしてダウンロードするか、 ボタンをクリックしてブループリントをクリップボードにコピーします。
- オプション: ブループリントをコピーするには、 ボタンをクリックします。
検証
- エクスポートしたブループリントをテキストエディターで開き、検査して確認します。
5.5. Web コンソールインターフェイスで RHEL Image Builder を使用してシステムイメージを作成する リンクのコピーリンクがクリップボードにコピーされました!
次の手順を実行すると、ブループリントからカスタマイズされた RHEL システムイメージを作成できます。
前提条件
- ブラウザーの Web コンソールから RHEL Image Builder アプリケーションを開いている。
- ブループリントを作成している。
手順
- RHEL Image Builder ダッシュボードで、blueprint タブをクリックします。
- ブループリントのテーブルで、イメージをビルドするブループリントを見つけます。
- 選択したブループリントの右側で、 をクリックします。Create image ダイアログウィザードが開きます。
Image output ページで、次の手順を実行します。
- Select a blueprint リストから、必要なイメージのタイプを選択します。
Image output type リストから、必要なイメージの出力タイプを選択します。
選択したイメージの種類に応じて、さらに詳細を追加する必要があります。
- をクリックします。
Review ページで、イメージの作成に関する詳細を確認し、 をクリックします。
イメージのビルドが開始され、完了するまでに最大 20 分かかります。
検証
イメージのビルドが完了したら、次のことが可能になります。
イメージをダウンロードします。
- RHEL Image Builder ダッシュボードで、Node options (⫶) メニューをクリックし、Download image を選択します。
イメージのログをダウンロードして要素を検査し、問題がないかどうかを確認します。
- RHEL Image Builder ダッシュボードで、Node options (⫶) メニューをクリックし、Download logs を選択します。
第6章 RHEL Image Builder を使用したブート ISO インストーラーイメージの作成 リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder を使用して、起動可能な ISO インストーラーイメージを作成できます。これらのイメージは、ルートファイルシステムを含む .tar ファイルで構成されます。起動可能な ISO イメージを使用して、ファイルシステムをベアメタルサーバーにインストールすることができます。
RHEL Image Builder は、ルートファイルシステムを含むブート ISO を作成するマニフェストを作成します。ISO イメージを作成するには、イメージタイプ image-installer を選択します。RHEL Image Builder は、次の内容の .tar ファイルをビルドします。
- 標準の Anaconda インストーラー ISO
- 組み込みの RHEL システム tar ファイル
- 最小限のデフォルト要件でコミットをインストールするデフォルトのキックスタートファイル
作成されたインストーラー ISO イメージには、ベアメタルサーバーに直接インストールできる設定済みのシステムイメージが含まれています。
6.1. RHEL Image Builder CLI を使用したブート ISO インストーラーイメージの作成 リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder コマンドラインインターフェイスを使用して、カスタマイズしたブート ISO インストーラーイメージを作成できます。その結果、Image Builder は、オペレーティングシステム用にインストールできる .tar ファイルを含む .iso ファイルをビルドします。.iso ファイルは、Anaconda を起動し、tar ファイルをインストールしてシステムをセットアップするように設定されています。作成した ISO イメージファイルをハードディスク上で使用したり、HTTP ブートや USB インストールなどで仮想マシンを起動したりできます。
インストーラー (.iso) イメージタイプはパーティションのカスタマイズを受け入れません。ファイルシステムのカスタマイズを手動で設定しようとしても、インストーラーイメージによってビルドされたシステムには適用されません。RHEL Image Builder ファイルシステムのカスタマイズでビルドした ISO イメージをマウントすると、キックスタートでエラーが発生し、インストールは自動的に再起動しません。詳細は、Red Hat ナレッジベースソリューション Automate a RHEL ISO installation generated by image builder を参照してください。
前提条件
- ユーザーを含むイメージのブループリントを作成してカスタマイズし、RHEL Image Builder にプッシュしている。ブループリントのカスタマイズ を参照してください。
手順
ISO イメージを作成します。
composer-cli compose start BLUEPRINT-NAME image-installer
# composer-cli compose start BLUEPRINT-NAME image-installerCopy to Clipboard Copied! Toggle word wrap Toggle overflow - BLUEPRINT-NAME は作成したブループリントの名前です。
image-installer はイメージタイプです。
Compose プロセスはバックグラウンドで開始し、Compose の UUID が表示されます。Compose が完成するまで待ちます。これには数分かかる場合があります。
Compose のステータスを確認します。
composer-cli compose status
# composer-cli compose statusCopy to Clipboard Copied! Toggle word wrap Toggle overflow Compose が完了すると、ステータスが FINISHED となります。
リスト内の Compose をその UUID で識別します。
composer-cli compose list
# composer-cli compose listCopy to Clipboard Copied! Toggle word wrap Toggle overflow Compose が完了したら、作成したイメージファイルをカレントディレクトリーにダウンロードします。
composer-cli compose image UUID
# composer-cli compose image UUIDCopy to Clipboard Copied! Toggle word wrap Toggle overflow UUID は、前の手順で取得した UUID 値に置き換えます。
RHEL Image Builder は
.tarファイルを含む.isoファイルをビルドします。.tarファイルは、オペレーティングシステム用にインストールされるイメージです。.isoは、Anaconda を起動し、tarファイルをインストールしてシステムをセットアップするように設定されています。
次のステップ
イメージファイルをダウンロードしたディレクトリーで、以下を実行します。
-
ダウンロードした
.isoイメージを見つけます。 ISO をマウントします。
mount -o ro path_to_ISO /mnt
$ mount -o ro path_to_ISO /mntCopy to Clipboard Copied! Toggle word wrap Toggle overflow .tarファイルは/mnt/liveimg.tar.gzディレクトリーにあります。.tarファイルの内容をリスト表示します。tar ztvf /mnt/liveimg.tar.gz
$ tar ztvf /mnt/liveimg.tar.gzCopy to Clipboard Copied! Toggle word wrap Toggle overflow
6.2. GUI で RHEL Image Builder を使用してブート ISO インストーラーイメージを作成する リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder GUI を使用して、カスタマイズしたブート ISO インストーラーイメージをビルドできます。作成された ISO イメージファイルは、ハードディスク上で使用することも、仮想マシンで起動することもできます。たとえば、HTTP ブートや USB インストールなどで起動できます。
インストーラー (.iso) イメージタイプはパーティションのカスタマイズを受け入れません。ファイルシステムのカスタマイズを手動で設定しようとしても、インストーラーイメージによってビルドされたシステムには適用されません。RHEL Image Builder ファイルシステムのカスタマイズでビルドした ISO イメージをマウントすると、キックスタートでエラーが発生し、インストールは自動的に再起動しません。詳細は、Red Hat ナレッジベースソリューション Automate a RHEL ISO installation generated by image builder を参照してください。
前提条件
- ブラウザーの Web コンソールから RHEL Image Builder アプリケーションを開いている。
- イメージのブループリントを作成している。Web コンソールインターフェイスでの RHEL Image Builder ブループリントの作成 を参照してください。
手順
- RHEL Image Builder のダッシュボードで、イメージのビルドに使用するブループリントを見つけます。必要に応じて、ブループリント名またはその一部を左上の検索ボックスに入力し、 をクリックします。
ブループリントの右側で、対応する ボタンをクリックします。
Create image ダイアログウィザードが開きます。
Create image ダイアログウィザードで:
-
Image Type リストで、
"RHEL Installer (.iso)"を選択します。 - をクリックします。
Review タブで をクリックします。
RHEL Image Builder は、RHEL ISO イメージの Compose をキューに追加します。
プロセスが完了すると、Image build complete のステータスが表示されます。RHEL Image Builder は ISO イメージを作成します。
-
Image Type リストで、
検証
イメージが正常に作成されたら、ダウンロードできます。
-
Download をクリックして、
"RHEL Installer (.iso)"イメージをシステムに保存します。 -
"RHEL Installer (.iso)"イメージをダウンロードしたフォルダーに移動します。 - ダウンロードした .tar イメージを見つけます。
"RHEL Installer (.iso)"イメージの内容を展開します。tar -xf content.tar
$ tar -xf content.tarCopy to Clipboard Copied! Toggle word wrap Toggle overflow
6.3. 起動可能な ISO をメディアにインストールして起動する リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder を使用して作成した起動可能な ISO イメージをベアメタルシステムにインストールします。
前提条件
- RHEL Image Builder を使用して起動可能な ISO イメージを作成している。コマンドラインで RHEL Image Builder を使用してブート ISO インストーラーイメージを作成する を参照してください。
- 起動可能な ISO イメージをダウンロードしました。
-
ddツールをインストールしました。 - ISO イメージに十分な容量の USB フラッシュドライブがある。必要なサイズはブループリントで選択したパッケージによって異なりますが、推奨される最小サイズは 8 GB です。
手順
ddツールを使用して、ブート可能な ISO イメージを USB ドライブに直接書き込みます。以下に例を示します。dd if=installer.iso of=/dev/sdX
dd if=installer.iso of=/dev/sdXCopy to Clipboard Copied! Toggle word wrap Toggle overflow ここで、
installer.isoは ISO イメージファイル名、/dev/sdXは USB フラッシュドライブのデバイスパスです。- 起動するコンピューターの USB ポートにフラッシュドライブを挿入します。
USB フラッシュドライブから ISO イメージを起動します。
インストール環境が開始したら、デフォルトの Red Hat Enterprise Linux インストールと同様に、インストールの手動完了が必要になることがあります。
第7章 RHEL Image Builder OpenSCAP 統合によるハードニング済みイメージの作成 リンクのコピーリンクがクリップボードにコピーされました!
OpenSCAP 統合の RHEL Image Builder オンプレミスサポートを使用すると、特定のセキュリティープロファイルを使用してカスタマイズしたブループリントを作成し、そのブループリントを使用してハードニング済みイメージをビルドできます。このハードニング済みイメージを使用して、特定のプロファイルに準拠させる必要があるシステムをデプロイできます。ブループリントは、パッケージやアドオンファイルのセットを追加してカスタマイズできます。これにより、カスタマイズしたハードニング済み RHEL イメージをビルドし、プロファイルに準拠したシステムをデプロイする準備を整えることができます。
イメージのビルドプロセス中に、OSBuild oscap.remediation ステージが、ファイルシステムツリー上の chroot 環境で OpenSCAP ツールを実行します。OpenSCAP ツールは、選択したプロファイルの標準評価を実行し、修復をイメージに適用します。これにより、イメージを初めて起動する前でも、セキュリティープロファイルの要件に従って設定されたイメージをビルドできます。
Red Hat は、現在のデプロイメントガイドラインを満たすことができるように、システムを構築するときに選択できるセキュリティーハードニングプロファイルの定期的に更新されたバージョンを提供します。
7.1. OpenSCAP ブループリントのカスタマイズ リンクのコピーリンクがクリップボードにコピーされました!
OpenSCAP によるブループリントのカスタマイズのサポートにより、特定のセキュリティープロファイルの `scap-security-guide` コンテンツからブループリントを生成し、そのブループリントを使用して独自のハードニング済みイメージをビルドできます。
OpenSCAP を使用してカスタマイズしたブループリントを作成するには、次の主な手順を実行します。
- 特定の要件に応じてマウントポイントを変更し、ファイルシステムレイアウトを設定します。
- ブループリントで、OpenSCAP プロファイルを選択します。これにより、選択したプロファイルに従って、イメージのビルド中に修復をトリガーするようにイメージが設定されます。また、イメージのビルド中に、OpenSCAP が初回起動前の修復を適用します。
イメージブループリントで OpenSCAP ブループリントのカスタマイズを使用するには、次の情報を提供する必要があります。
-
datastream修復手順へのデータストリームパス。scap-security-guideパッケージのデータストリームファイルは、/usr/share/xml/scap/ssg/content/ディレクトリーにあります。 -
必要なセキュリティープロファイルの
profile_id。profile_idフィールドの値は、長い形式と短い形式の両方を受け入れます。たとえば、cisやxccdf_org.ssgproject.content_profile_cisを受け入れることができます。詳細は、RHEL 9 でサポートされている SCAP セキュリティーガイドプロファイル を参照してください。
次の例は、OpenSCAP 修復ステージのスニペットです。
[customizations.openscap] # If you want to use the data stream from the 'scap-security-guide' package # the 'datastream' key could be omitted. # datastream = "/usr/share/xml/scap/ssg/content/ssg-rhel9-ds.xml" profile_id = "xccdf_org.ssgproject.content_profile_cis"
[customizations.openscap]
# If you want to use the data stream from the 'scap-security-guide' package
# the 'datastream' key could be omitted.
# datastream = "/usr/share/xml/scap/ssg/content/ssg-rhel9-ds.xml"
profile_id = "xccdf_org.ssgproject.content_profile_cis"
次のコマンドを使用すると、scap-security-guide パッケージの SCAP ソースデータストリームの詳細 (データストリームによって提供されるセキュリティープロファイルのリストを含む) を確認できます。
oscap info /usr/share/xml/scap/ssg/content/ssg-rhel9-ds.xml
# oscap info /usr/share/xml/scap/ssg/content/ssg-rhel9-ds.xml
ユーザーの便宜のために、OpenSCAP ツールでは、scap-security-guide データストリームで利用可能な任意のプロファイルのハードニングブループリントを生成できます。
たとえば、次のコマンドを実行します。
oscap xccdf generate fix --profile=cis --fix-type=blueprint /usr/share/xml/scap/ssg/content/ssg-rhel9-ds.xml
# oscap xccdf generate fix --profile=cis --fix-type=blueprint /usr/share/xml/scap/ssg/content/ssg-rhel9-ds.xml
次のような CIS プロファイルのブループリントを生成します。
このブループリントスニペットは、イメージのハードニングにそのまま使用しないでください。完全なプロファイルを反映するものではありません。Red Hat は scap-security-guide パッケージ内の各プロファイルのセキュリティー要件を継続的に更新および改良しています。そのため、システムに提供されるデータストリームの最新バージョンを使用して初期テンプレートを常に再生成することを推奨します。
これで、ブループリントをカスタマイズすることも、そのまま使用してイメージをビルドすることもできます。
RHEL Image Builder は、ブループリントのカスタマイズに基づいて、osbuild ステージに必要な設定を生成します。さらに、RHEL Image Builder は 2 つのパッケージをイメージに追加します。
-
openscap-scanner-OpenSCAPツール。 scap-security-guide- 修復および評価の手順が含まれるパッケージ。注記このパッケージはデフォルトでイメージにインストールされるため、修復ステージではデータストリームに
scap-security-guideパッケージを使用します。別のデータストリームを使用する場合は、必要なパッケージをブループリントに追加し、oscap設定でデータストリームへのパスを指定します。
7.2. RHEL Image Builder を使用したハードニング済みイメージの作成 リンクのコピーリンクがクリップボードにコピーされました!
OpenSCAP と RHEL Image Builder の統合により、特定のプロファイルに準拠したハードニング済みイメージを作成し、それを仮想マシンやベアメタル環境などにデプロイできます。
前提条件
-
root ユーザーまたは
weldrグループのメンバーであるユーザーとしてログインしている。 -
openscapおよびscap-security-guideパッケージがインストールされている。
手順
OpenSCAPツールとscap-security-guideコンテンツを使用して、TOML 形式でハードニングブループリントを作成し、必要に応じて変更します。oscap xccdf generate fix --profile=<profileID> --fix-type=<blueprint> /usr/share/xml/scap/ssg/content/ssg-rhel9-ds.xml > cis.toml
# oscap xccdf generate fix --profile=<profileID> --fix-type=<blueprint> /usr/share/xml/scap/ssg/content/ssg-rhel9-ds.xml > cis.tomlCopy to Clipboard Copied! Toggle word wrap Toggle overflow <profileID>は、システムが準拠する必要があるプロファイル ID (例:cis) に置き換えます。composer-cliツールを使用して、ブループリントをosbuild-composerにプッシュします。composer-cli blueprints push <blueprint_name>.toml
# composer-cli blueprints push <blueprint_name>.tomlCopy to Clipboard Copied! Toggle word wrap Toggle overflow ハードニング済みイメージのビルドを開始します。
composer-cli compose start <blueprint_name> <image_type>
# composer-cli compose start <blueprint_name> <image_type>Copy to Clipboard Copied! Toggle word wrap Toggle overflow <image_type>は、任意のイメージタイプ (例:qcow2) に置き換えます。イメージビルドの準備ができたら、デプロイメントでハードニング済みイメージを使用できます。仮想マシンの作成 を参照してください。
検証
ハードニング済みイメージをデプロイした後、設定コンプライアンススキャンを実行して、イメージが選択したセキュリティープロファイルに準拠していることを確認できます。
設定コンプライアンススキャンを実行しても、システムが準拠しているとは限りません。詳細は、設定コンプライアンススキャン を参照してください。
7.3. RHEL Image Builder を使用したハードニング済みイメージのカスタマイズ リンクのコピーリンクがクリップボードにコピーされました!
セキュリティープロファイルをカスタマイズするには、特定のルール (パスワードの最小長など) のパラメーターを変更し、別の方法で対象とするルールを削除し、追加のルールを選択して内部ポリシーを実装できます。プロファイルをカスタマイズして新しいルールの定義はできません。
そのブループリントからイメージをビルドすると、新しいテーラリングプロファイル ID を持つテーラリングファイルが作成され、/usr/share/xml/osbuild-oscap-tailoring/tailoring.xml としてイメージに保存されます。新しいプロファイル ID は、ベース ID に _osbuild_tailoring 接尾辞を追加したものです。たとえば、CIS (cis) ベースプロファイルをカスタマイズする場合、プロファイル ID は xccdf_org.ssgproject.content_profile_cis_osbuild_tailoring になります。
前提条件
-
root ユーザーまたは
weldrグループのメンバーであるユーザーとしてログインしている。 -
openscapおよびscap-security-guideパッケージがインストールされている。
手順
選択したプロファイルから TOML 形式でハードニングブループリントを作成します。
oscap xccdf generate fix --profile=<profileID> --fix-type=blueprint /usr/share/xml/scap/ssg/content/ssg-rhel9-ds.xml > <profileID>-tailored.toml
# oscap xccdf generate fix --profile=<profileID> --fix-type=blueprint /usr/share/xml/scap/ssg/content/ssg-rhel9-ds.xml > <profileID>-tailored.tomlCopy to Clipboard Copied! Toggle word wrap Toggle overflow テーラリングファイルをブループリントに追加します。テーラリングによるカスタマイズは、カスタマイズのベースとなるプロファイル内の選択済みおよび未選択のルールのデフォルト状態にのみ影響します。プロファイル内のルールの選択または選択解除は行いますが、他のルールの状態を変更することはありません。
Blueprint for CIS Red Hat Enterprise Linux 9 Benchmark for Level 2 - Server ...
# Blueprint for CIS Red Hat Enterprise Linux 9 Benchmark for Level 2 - Server # ... [customizations.openscap.tailoring] selected = [ "xccdf_org.ssgproject.content_bind_crypto_policy" ] unselected = [ "grub2_password" ]Copy to Clipboard Copied! Toggle word wrap Toggle overflow composer-cliツールを使用して、ブループリントをosbuild-composerにプッシュします。composer-cli blueprints push <blueprintProfileID>-tailored.toml
# composer-cli blueprints push <blueprintProfileID>-tailored.tomlCopy to Clipboard Copied! Toggle word wrap Toggle overflow ハードニング済みイメージのビルドを開始します。
composer-cli compose start <blueprintProfileID> <image_type>
# composer-cli compose start <blueprintProfileID> <image_type>Copy to Clipboard Copied! Toggle word wrap Toggle overflow <image_type>は、任意のイメージタイプ (例:qcow2) に置き換えます。イメージのビルドが準備できたら、デプロイメントでハードニング済みイメージを使用します。
検証
ハードニング済みイメージをデプロイした後、設定コンプライアンススキャンを実行して、イメージが選択したセキュリティープロファイルに準拠していることを確認できます。
設定コンプライアンススキャンを実行しても、システムが準拠しているとは限りません。詳細は、設定コンプライアンススキャン を参照してください。
第8章 RHEL Image Builder を使用した FIPS モードの有効化 リンクのコピーリンクがクリップボードにコピーされました!
カスタマイズしたイメージを作成し、FIPS 対応の RHEL イメージを起動できます。イメージを作成する前に、ブループリント内の fips ディレクティブの値を変更する必要があります。
前提条件
-
root ユーザーまたは
weldrグループのメンバーであるユーザーとしてログインしている。
手順
次の内容を含む、Tom’s Obvious, Minimal Language (TOML) 形式のプレーンテキストファイルを作成します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow ブループリントを RHEL Image Builder サーバーにインポートします。
composer-cli blueprints push <blueprint-name>.toml
# composer-cli blueprints push <blueprint-name>.tomlCopy to Clipboard Copied! Toggle word wrap Toggle overflow 既存のブループリントをリスト表示して、作成されたブループリントが正常にインポートされて存在するかどうかを確認します。
composer-cli blueprints show <blueprint-name>
# composer-cli blueprints show <blueprint-name>Copy to Clipboard Copied! Toggle word wrap Toggle overflow ブループリントに記載されているコンポーネントおよびバージョンと、その依存関係が有効かどうかを確認します。
composer-cli blueprints depsolve <blueprint-name>
# composer-cli blueprints depsolve <blueprint-name>Copy to Clipboard Copied! Toggle word wrap Toggle overflow カスタマイズした RHEL イメージをビルドします。
composer-cli compose start \ <blueprint-name> \ <image-type> \
# composer-cli compose start \ <blueprint-name> \ <image-type> \Copy to Clipboard Copied! Toggle word wrap Toggle overflow イメージのステータスを確認します。
composer-cli compose status <UUID> FINISHED <date> <blueprint-name> <blueprint-version> <image-type>
# composer-cli compose status … $ <UUID> FINISHED <date> <blueprint-name> <blueprint-version> <image-type> …Copy to Clipboard Copied! Toggle word wrap Toggle overflow イメージをダウンロードします。
composer-cli compose image <UUID>
# composer-cli compose image <UUID>Copy to Clipboard Copied! Toggle word wrap Toggle overflow RHEL Image Builder により、イメージがカレントディレクトリーパスにダウンロードされます。UUID 番号とともにイメージサイズが表示されます。
<UUID-image-name.type>: <size> MB
$ <UUID-image-name.type>: <size> MBCopy to Clipboard Copied! Toggle word wrap Toggle overflow
検証
- ブループリントで設定したユーザー名とパスワードを使用してシステムイメージにログインします。
FIPS モードが有効になっているかどうかを確認します。
fips-mode-setup --check
$ fips-mode-setup --check FIPS mode is enabled.Copy to Clipboard Copied! Toggle word wrap Toggle overflow
第9章 RHEL Image Builder を使用した KVM ゲストイメージの準備とデプロイ リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder を使用して、カーネルベースの仮想マシン (KVM) をベースとしたハイパーバイザーにデプロイできる、専用の .qcow2 を作成します。
カスタマイズされた KVM ゲストイメージの作成には、以下の手順が含まれます。
-
.qcow2イメージのブループリントの作成 -
RHEL Image Builder を使用した
.qcow2イメージの作成 - KVM ゲストイメージからの仮想マシンの作成
9.1. RHEL Image Builder を使用したカスタマイズされた KVM ゲストイメージの作成 リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder を使用して、カスタマイズした .qcow2 KVM ゲストイメージを作成できます。以下では GUI での手順を示していますが、CLI を使用することもできます。
前提条件
-
システムにアクセスするには、
rootまたはweldrグループに属している必要があります。 -
cockpit-composerパッケージがインストールされている。 - RHEL システムで、Web コンソールの RHEL Image Builder ダッシュボードを開いている。
- ブループリントを作成している。Web コンソールインターフェイスでのブループリントの作成 を参照してください。
手順
- 作成したブループリント名をクリックします。
- Images タブを選択します。
- Create Image をクリックして、カスタマイズしたイメージを作成します。Create Image ウィンドウが開きます。
-
Type ドロップダウンメニューリストから、
QEMU Image (.qcow2)を選択します。 - インスタンス化するときのイメージのサイズを設定し、Create をクリックします。
- ウィンドウの右上にある小さなポップアップに、イメージの作成がキューに追加されたことが表示されます。イメージ作成プロセスが完了すると、Image build complete のステータスが表示されます。
検証
-
パンくずリストのアイコンをクリックして、Download オプションを選択します。RHEL Image Builder は、KVM ゲストイメージ
.qcow2ファイルをデフォルトのダウンロード場所にダウンロードします。
9.2. KVM ゲストイメージからの仮想マシンの作成 リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder を使用すると、.qcow2 イメージをビルドし、KVM ゲストイメージを使用して仮想マシンを作成できます。RHEL Image Builder を使用して作成した KVM ゲストイメージでは、cloud-init がすでにインストールされ、有効になっています。
前提条件
-
RHEL Image Builder を使用して
.qcow2イメージを作成している。Web コンソールインターフェイスでのブループリントの作成 を参照してください。 -
qemu-kvmパッケージがシステムにインストールされている。/dev/kvmデバイスがシステムで使用可能かどうか、および仮想化機能が BIOS で有効になっているかどうかを確認できる。 -
システムに
libvirtおよびvirt-installパッケージがインストールされている。 -
xorrisoパッケージによって提供されるgenisoimageユーティリティーがシステムにインストールされている。
手順
-
RHEL Image Builder を使用して作成した
.qcow2イメージを/var/lib/libvirt/images/ディレクトリーに移動します。 ディレクトリー (
cloudinitisoなど) を作成し、新規に作成したそのディレクトリーに移動します。mkdir cloudinitiso cd cloudinitiso
$ mkdir cloudinitiso $ cd cloudinitisoCopy to Clipboard Copied! Toggle word wrap Toggle overflow meta-dataという名前のファイルを作成します。このファイルに以下の情報を追加します。instance-id: citest local-hostname: vmname
instance-id: citest local-hostname: vmnameCopy to Clipboard Copied! Toggle word wrap Toggle overflow user-dataという名前のファイルを作成します。以下の情報をファイルに追加します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow ssh_authorized_keysは SSH 公開鍵です。~/.ssh/<id_rsa.pub>\で SSH 公開鍵を確認できます。genisoimageユーティリティーを使用して、user-dataファイルおよびmeta-dataファイルを含む ISO イメージを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow virt-installコマンドを使用して、KVM ゲストイメージから新しい仮想マシンを作成します。仮想マシンイメージへのアタッチメントとして、手順 4 で作成した ISO イメージを含めます。Copy to Clipboard Copied! Toggle word wrap Toggle overflow - --graphics none - ヘッドレス RHEL 9 仮想マシンであることを意味します。
- --vcpus 4 - 4 つの仮想 CPU を使用することを意味します。
- --memory 4096 - 4096 MB のメモリーを使用することを意味します。
仮想マシンのインストールが起動します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
検証
起動が完了すると、仮想マシンにテキストログインインターフェイスが表示されます。仮想マシンのローカルコンソールにログインするには、user-data ファイルのユーザーの詳細を使用します。
-
ユーザー名として
adminと入力し、 を押します。 passwordとしてパスワードを入力し、 を押します。ログイン認証が完了すると、CLI を使用して仮想マシンにアクセスできます。
第10章 コンテナーをレジストリーにプッシュしてイメージに埋め込む リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder を使用すると、OpenSCAP ツールを使用してセキュリティーが強化されたイメージをビルドできます。ブループリントでコンテナーのカスタマイズがサポートされていることを利用して、コンテナーを作成し、作成したイメージに直接埋め込むことができます。
10.1. コンテナーをイメージに埋め込むブループリントのカスタマイズ リンクのコピーリンクがクリップボードにコピーされました!
registry.access.redhat.com レジストリーからコンテナーを埋め込むには、ブループリントにコンテナーのカスタマイズを追加する必要があります。以下に例を示します。
[[containers]] source = "registry.access.redhat.com/ubi9/ubi:latest" name = "local-name" tls-verify = true
[[containers]]
source = "registry.access.redhat.com/ubi9/ubi:latest"
name = "local-name"
tls-verify = true
-
source- 必須フィールド。これは、レジストリーにあるコンテナーイメージへの参照です。この例では、registry.access.redhat.comレジストリーを使用します。タグのバージョンを指定できます。デフォルトのタグバージョンはlatestです。 -
name- ローカルレジストリー内のコンテナーの名前。 tls-verify- ブールフィールド。tls-verifyブールフィールドは、Transport Layer Security を制御します。デフォルト値はtrueです。RHEL Image Builder は、イメージのビルド中にコンテナーをプルし、コンテナーをイメージに格納します。デフォルトのローカルコンテナーストレージの場所は、イメージの種類によって異なります。そのため、Podman などのすべてのサポート
container-toolsがそれを使用できます。組み込みコンテナーは開始されません。保護されたコンテナーリソースにアクセスするには、containers-auth.jsonファイルを使用できます。
10.2. コンテナーレジストリーの認証情報 リンクのコピーリンクがクリップボードにコピーされました!
osbuild-worker@.service は、複数のサービスインスタンスを開始できるテンプレートサービスです。デフォルトでは、osbuild-composer サービスは必ず 1 つのローカル osbuild-worker (具体的には osbuild-worker@1.service) のみで起動します。osbuild-worker サービスは、コンテナーレジストリーとの通信を担当します。サービスを有効にするには、/etc/osbuild-worker/osbuild-worker.toml 設定ファイルを設定します。
/etc/osbuild-worker/osbuild-worker.toml 設定ファイルを設定した後、osbuild-worker サービスを再起動する必要があります。osbuild-worker サービスは起動時に一度だけ /etc/osbuild-worker/osbuild-worker.toml 設定ファイルを読み取るためです。
サービスインスタンスを停止するには、次のコマンドで systemd サービスを再起動します。
systemctl restart osbuild-worker@*
$ systemctl restart osbuild-worker@*
これにより、osbuild-worker の開始済みのすべてのインスタンス (具体的には、実行されている可能性がある唯一のサービスである osbuild-worker@1.service) が再起動されます。
/etc/osbuild-worker/osbuild-worker.toml 設定ファイルの containers セクションには、auth_field_path エントリーがあります。このエントリーは、保護されたリソースへのアクセスに使用される containers-auth.json ファイルのパスを参照する文字列です。コンテナーレジストリーの認証情報は、コンテナーをイメージに埋め込むときに、コンテナーイメージをレジストリーからプルするためにのみ使用されます。
以下に例を示します。
[containers] auth_file_path = "/etc/osbuild-worker/containers-auth.json"
[containers]
auth_file_path = "/etc/osbuild-worker/containers-auth.json"
10.3. コンテナーアーティファクトをコンテナーレジストリーに直接プッシュする リンクのコピーリンクがクリップボードにコピーされました!
RHEL for Edge Container イメージなどのコンテナーアーティファクトは、RHEL Image Builder CLI を使用して、ビルド後にコンテナーレジストリーに直接プッシュできます。
前提条件
-
quay.io レジストリー へのアクセス。この例では、ターゲットレジストリーとして
quay.ioコンテナーレジストリーを使用していますが、任意のコンテナーレジストリーを使用できます。
手順
コンテナープロバイダーを選択するために、
registry-config.tomlファイルをセットアップします。認証情報はオプションです。provider = "container_provider" [settings] tls_verify = false username = "admin" password = "your_password"
provider = "container_provider" [settings] tls_verify = false username = "admin" password = "your_password"Copy to Clipboard Copied! Toggle word wrap Toggle overflow ブループリントを
.toml形式で作成します。これは、ブループリントにnginxパッケージをインストールするコンテナーのブループリントです。Copy to Clipboard Copied! Toggle word wrap Toggle overflow ブループリントをプッシュします。
composer-cli blueprints push blueprint.toml
# composer-cli blueprints push blueprint.tomlCopy to Clipboard Copied! Toggle word wrap Toggle overflow レジストリーとリポジトリーを
composer-cliツールに引数として渡し、コンテナーイメージをビルドします。composer-cli compose start simple-container container "quay.io:8080/osbuild/repository" registry-config.toml
# composer-cli compose start simple-container container "quay.io:8080/osbuild/repository" registry-config.tomlCopy to Clipboard Copied! Toggle word wrap Toggle overflow - simple-container - ブループリント名です。
- コンテナー - イメージの種類です。
"quay.io:8080/osbuild/repository" -
quay.ioはターゲットレジストリー、osbuildは組織、repositoryはビルドが完了したときにコンテナーをプッシュする場所です。オプションで、tagを設定できます。:tagの値を設定しない場合、デフォルトで:latestタグが使用されます。注記コンテナーイメージのビルドには、カスタマイズされたパッケージの依存関係を解決するため時間がかかります。
- イメージのビルドが完了すると、作成したコンテナーが quay.io で使用できるようになります。
検証
quay.io を開き、
Repository Tagsをクリックします。You can see details about the container you created, such as: - last modified - image size - the `manifest ID`, that you can copy to the clipboard.
You can see details about the container you created, such as: - last modified - image size - the `manifest ID`, that you can copy to the clipboard.Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
manifest IDの値をコピーして、コンテナーを埋め込むイメージをビルドします。
10.4. イメージのビルドとコンテナーのイメージへのプル リンクのコピーリンクがクリップボードにコピーされました!
コンテナーイメージを作成したら、カスタマイズしたイメージをビルドし、コンテナーイメージをそこにプルできます。そのためには、ブループリントで コンテナーのカスタマイズ を指定し、最終的なイメージの コンテナー名 を指定する必要があります。ビルドプロセス中に、コンテナーイメージが取得され、ローカルの Podman コンテナーストレージに配置されます。
前提条件
-
コンテナーイメージを作成し、それをローカルの
quay.ioコンテナーレジストリーインスタンスにプッシュしました。コンテナーアーティファクトをコンテナーレジストリーに直接プッシュする を参照してください。 - registry.access.redhat.com にアクセスできます。
-
コンテナー
manifest IDを持っています。 -
qemu-kvmおよびqemu-imgパッケージがインストールされている。
手順
qcow2イメージをビルドするためのブループリントを作成します。このブループリントには、"" カスタマイズを含める必要があります。Copy to Clipboard Copied! Toggle word wrap Toggle overflow ブループリントをプッシュします。
composer-cli blueprints push blueprint-image.toml
# composer-cli blueprints push blueprint-image.tomlCopy to Clipboard Copied! Toggle word wrap Toggle overflow コンテナーイメージをビルドします。
composer-cli start compose image qcow2
# composer-cli start compose image qcow2Copy to Clipboard Copied! Toggle word wrap Toggle overflow - image はブループリントの名前です。
qcow2はイメージタイプです。注記quay.ioレジストリーでコンテナーをチェックするため、イメージのビルドに時間がかかります。
Compose のステータスを確認するには、以下のコマンドを実行します。
composer-cli compose status
# composer-cli compose statusCopy to Clipboard Copied! Toggle word wrap Toggle overflow Compose が完了すると、ステータスが FINISHED になります。リスト内の Compose を識別するには、その UUID を使用します。
Compose プロセスが完了したら、作成したイメージファイルをデフォルトのダウンロード先にダウンロードします。
composer-cli compose image UUID
# composer-cli compose image UUIDCopy to Clipboard Copied! Toggle word wrap Toggle overflow UUID は、前の手順で示した UUID 値に置き換えます。
作成してダウンロードした
qcow2イメージを使用して、仮想マシンを作成できます。
検証
ダウンロードした qcow2 イメージで、次の手順を実行します。
-
仮想マシンで
qcow2イメージを起動します。KVM ゲストイメージからの仮想マシンの作成 を参照してください。 qemuウィザードが開きます。qcow2イメージにログインします。-
ユーザー名とパスワードを入力します。
.qcow2ブループリントの "customizations.user" セクションで設定したユーザー名とパスワード、またはcloud-initを使用して起動時に作成したユーザー名とパスワードを使用できます。
-
ユーザー名とパスワードを入力します。
コンテナーイメージを実行し、コンテナー内でシェルプロンプトを開きます。
podman run -it registry.access.redhat.com/ubi9:8080/osbuild/repository /bin/bash/
# podman run -it registry.access.redhat.com/ubi9:8080/osbuild/repository /bin/bash/Copy to Clipboard Copied! Toggle word wrap Toggle overflow registry.access.redhat.comはターゲットレジストリー、osbuildは組織、repositoryはビルドの完了時にコンテナーをプッシュする場所です。ブループリントに追加したパッケージが利用可能であることを確認します。
type -a nginx
# type -a nginxCopy to Clipboard Copied! Toggle word wrap Toggle overflow 出力には、
nginxパッケージのパスが表示されます。
第11章 RHEL Image Builder を使用したクラウドイメージの準備とアップロード リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder は、さまざまなクラウドプラットフォームですぐに使用できるカスタムシステムイメージを作成できます。カスタマイズした RHEL システムイメージをクラウドで使用するには、指定の出力タイプを使用して RHEL Image Builder でシステムイメージを作成し、イメージをアップロードするようにシステムを設定し、クラウドアカウントへイメージをアップロードします。RHEL Web コンソールの Image Builder アプリケーションを介して、カスタマイズされたイメージクラウドをプッシュできます。これは、AWS や Microsoft Azure クラウドなど、Red Hat サポート対象のサービスプロバイダーの一部で利用できます。AWS Cloud AMI に直接イメージを作成して自動的にアップロードする および Microsoft Azure クラウドに直接 VHD イメージを作成して自動的にアップロードする を参照してください。
11.1. AMI イメージの準備と AWS へのアップロード リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder を使用してカスタムイメージを作成し、そのイメージを手動または自動で AWS クラウドにアップロードできます。
11.1.1. AWS AMI イメージを手動でアップロードする準備 リンクのコピーリンクがクリップボードにコピーされました!
AWS AMI イメージをアップロードする前に、イメージをアップロードするためのシステムを設定する必要があります。
前提条件
- AWS IAM アカウントマネージャー にアクセスキー ID を設定している。
- 書き込み可能な S3 bucket を準備する必要があります。Creating S3 bucket を参照してください。
手順
Python 3 および
pipツールをインストールします。dnf install python3 python3-pip
# dnf install python3 python3-pipCopy to Clipboard Copied! Toggle word wrap Toggle overflow pip で
AWS コマンドラインツールをインストールします。pip3 install awscli
# pip3 install awscliCopy to Clipboard Copied! Toggle word wrap Toggle overflow プロファイルを設定します。ターミナルで、認証情報、リージョン、および出力形式を指定するように求められます。
aws configure
$ aws configure AWS Access Key ID [None]: AWS Secret Access Key [None]: Default region name [None]: Default output format [None]:Copy to Clipboard Copied! Toggle word wrap Toggle overflow バケットの名前を定義し、バケットを作成します。
BUCKET=bucketname aws s3 mb s3://$BUCKET
$ BUCKET=bucketname $ aws s3 mb s3://$BUCKETCopy to Clipboard Copied! Toggle word wrap Toggle overflow bucketnameは、実際のバケット名に置き換えます。この名前は、グローバルで一意となるように指定する必要があります。上記で、バケットが作成されます。S3 バケットへのアクセス許可を付与するには、AWS Identity and Access Management (IAM) で
vmimportS3 ロールを作成します (まだ作成していない場合)。信頼ポリシーの設定で、JSON 形式で
trust-policy.jsonファイルを作成します。以下に例を示します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow ロールポリシーの設定を含む
role-policy.jsonファイルを JSON 形式で作成します。以下に例を示します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow trust-policy.jsonファイルを使用して、Amazon Web Services アカウントのロールを作成します。aws iam create-role --role-name vmimport --assume-role-policy-document file://trust-policy.json
$ aws iam create-role --role-name vmimport --assume-role-policy-document file://trust-policy.jsonCopy to Clipboard Copied! Toggle word wrap Toggle overflow role-policy.jsonファイルを使用して、インラインポリシードキュメントを埋め込みます。aws iam put-role-policy --role-name vmimport --policy-name vmimport --policy-document file://role-policy.json
$ aws iam put-role-policy --role-name vmimport --policy-name vmimport --policy-document file://role-policy.jsonCopy to Clipboard Copied! Toggle word wrap Toggle overflow
11.1.2. CLI を使用して AMI イメージを AWS に手動でアップロードする リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder を使用して ami イメージをビルドし、CLI を使用して Amazon AWS Cloud サービスプロバイダーに直接手動でアップロードすることができます。
前提条件
-
AWS IAM アカウントマネージャーに
Access Key IDを設定している。 - 書き込み可能な S3 bucket を準備する必要があります。Creating S3 bucket を参照してください。
- 定義済みの青写真がある。
手順
テキストエディターを使用して、次の内容の設定ファイルを作成します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow フィールドの値を
accessKeyID、secretAccessKey、bucket、およびregionの認証情報に置き換えます。IMAGE_KEY値は、EC2 にアップロードする仮想マシンイメージの名前です。- ファイルを CONFIGURATION-FILE.toml として保存し、テキストエディターを閉じます。
Compose を開始して AWS にアップロードします。
composer-cli compose start blueprint-name image-type image-key configuration-file.toml
# composer-cli compose start blueprint-name image-type image-key configuration-file.tomlCopy to Clipboard Copied! Toggle word wrap Toggle overflow 以下のように置き換えます。
- blueprint-name は、作成したブループリントの名前に置き換えます。
-
image-type は、
amiイメージタイプに置き換えます。 - image-key は、EC2 にアップロードする仮想マシンイメージの名前に置き換えます。
configuration-file.toml は、クラウドプロバイダーの設定ファイルの名前に置き換えます。
注記カスタマイズしたイメージの送信先となるバケットの正しい AWS Identity and Access Management (IAM) 設定が必要です。イメージをアップロードする前にバケットにポリシーを設定しておく必要があります。
イメージビルドのステータスを確認します。
composer-cli compose status
# composer-cli compose statusCopy to Clipboard Copied! Toggle word wrap Toggle overflow イメージのアップロードプロセスが完了すると、"FINISHED" ステータスが表示されます。
検証
イメージのアップロードが成功したことを確認するには、以下を行います。
-
メニューで EC2 にアクセスし、AWS コンソールで正しいリージョンを選択します。イメージが正常にアップロードされたことを示すには、イメージが
availableステータスになっている必要があります。 - ダッシュボードでイメージを選択し、 をクリックします。
11.1.3. イメージを作成して AWS Cloud AMI に自動的にアップロードする リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder を使用して (.raw) イメージを作成し、Upload to AWS チェックボックスをオンにして、作成した出力イメージを Amazon AWS Cloud AMI サービスプロバイダーに直接自動的にプッシュすることができます。
前提条件
-
rootまたはwheelグループでシステムにアクセスできる。 - ブラウザーで、RHEL Web コンソールの RHEL Image Builder インターフェイスを開いている。
- ブループリントを作成している。Web コンソールインターフェイスでのブループリントの作成 を参照してください。
- AWS IAM アカウントマネージャーにアクセスキー ID を設定している。
- 書き込み可能な S3 バケット を用意している。
手順
- RHEL Image Builder のダッシュボードで、以前に作成した ブループリント名 をクリックします。
- タブを選択します。
をクリックして、カスタマイズしたイメージを作成します。
Create Image ウィンドウが開きます。
-
Type ドロップダウンメニューから、
Amazon Machine Image Disk (.raw)を選択します。 - イメージを AWS Cloud にアップロードするには、Upload to AWS チェックボックスをオンして、 をクリックします。
AWS へのアクセスを認証するには、対応するフィールドに
AWS access key IDおよびAWS secret access keyを入力します。 をクリックします。注記新規アクセスキー ID を作成する場合にのみ、AWS シークレットアクセスキーを表示できます。秘密鍵が分からない場合は、新しいアクセスキー ID を生成します。
-
Image nameフィールドにイメージ名を、Amazon S3 bucket nameフィールドに Amazon バケット名を入力して、カスタマイズイメージを追加するバケットのAWS regionフィールドを入力します。 をクリックします。 情報を確認し、 をクリックします。
必要に応じて、 をクリックして誤った情報を変更します。
注記カスタマイズイメージを送信するバケットの正しい IAM 設定が必要です。この手順では IAM のインポートとエクスポートを使用するため、バケットにイメージをアップロードする前にバケットに ポリシー を設定する必要があります。詳細は、IAM ユーザーの必要なパーミッション を参照してください。
-
Type ドロップダウンメニューから、
右上のポップアップで、保存の進行状況が通知されます。イメージ作成の開始、イメージ作成の進捗、およびその後の AWS Cloud にアップロードに関する情報も通知されます。
プロセスが完了すると、Image build complete のステータスが表示されます。
ブラウザーで、Service→EC2 にアクセスします。
-
AWS コンソールのダッシュボードメニューで、正しいリージョン を選択します。イメージのステータスは、アップロードされていることを示す
Availableでなければなりません。 - AWS ダッシュボードでイメージを選択し、 をクリックします。
-
AWS コンソールのダッシュボードメニューで、正しいリージョン を選択します。イメージのステータスは、アップロードされていることを示す
- 新しいウィンドウが開きます。イメージを開始するために必要なリソースに応じて、インスタンスタイプを選択します。 をクリックします。
- インスタンスの開始の詳細を確認します。変更が必要な場合は、各セクションを編集できます。 をクリックします。
インスタンスを起動する前に、インスタンスにアクセスするための公開鍵を選択します。
既存のキーペアを使用するか、キーペアーを新規作成します。
次の手順に従って、EC2 で新規キーペアを作成し、新規インスタンスにアタッチします。
- ドロップダウンメニューリストから、Create a new key pair を選択します。
- 新しいキーペアに名前を入力します。新しいキーペアが生成されます。
- Download Key Pair をクリックして、新しいキーペアをローカルシステムに保存します。
をクリックしてインスタンスを起動します。
Initializing と表示されるインスタンスのステータスを確認できます。
- インスタンスのステータスが running になると、 ボタンが有効になります。
をクリックします。ウィンドウが表示され、SSH を使用して接続する方法の説明が表示されます。
- 優先する接続方法として スタンドアロン SSH クライアント を選択し、ターミナルを開きます。
秘密鍵を保存する場所で、SSH が機能するために鍵が公開されていることを確認してください。これには、以下のコマンドを実行します。
chmod 400 <_your-instance-name.pem_>
$ chmod 400 <_your-instance-name.pem_>Copy to Clipboard Copied! Toggle word wrap Toggle overflow パブリック DNS を使用してインスタンスに接続します。
ssh -i <_your-instance-name.pem_> ec2-user@<_your-instance-IP-address_>
$ ssh -i <_your-instance-name.pem_> ec2-user@<_your-instance-IP-address_>Copy to Clipboard Copied! Toggle word wrap Toggle overflow yesと入力して、接続の続行を確定します。その結果、SSH 経由でインスタンスに接続されます。
検証
- SSH でインスタンスに接続している間にアクションが実行できるかどうかを確認します。
11.2. VHD イメージを準備して Microsoft Azure にアップロードする リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder を使用すると、カスタムイメージを作成し、そのイメージを手動または自動で Microsoft Azure クラウドにアップロードできます。
11.2.1. Microsoft Azure VHD イメージを手動でアップロードする準備 リンクのコピーリンクがクリップボードにコピーされました!
Microsoft Azure クラウドに手動でアップロードできる VHD イメージを作成するには、RHEL Image Builder を使用できます。
前提条件
- Microsoft Azure リソースグループとストレージアカウントがある。
-
Python がインストールされている。
AZ CLIツールは Python に依存しています。
手順
Microsoft リポジトリーキーをインポートします。
*rpm --import https://packages.microsoft.com/keys/microsoft.asc*
# *rpm --import https://packages.microsoft.com/keys/microsoft.asc*Copy to Clipboard Copied! Toggle word wrap Toggle overflow packages-microsoft-prodパッケージをインストールして、Microsoft Productionリポジトリーを追加します。dnf install -y https://packages.microsoft.com/config/rhel/9.0/packages-microsoft-prod.rpm
# dnf install -y https://packages.microsoft.com/config/rhel/9.0/packages-microsoft-prod.rpmCopy to Clipboard Copied! Toggle word wrap Toggle overflow Microsoft Azure CLI をインストールします。
dnf install azure-cli
# dnf install azure-cliCopy to Clipboard Copied! Toggle word wrap Toggle overflow 注記Microsoft Azure CLI パッケージのダウンロードバージョンは、現在利用可能なバージョンによって異なる場合があります。
Microsoft Azure CLI を実行します。
*az login*
$ *az login*Copy to Clipboard Copied! Toggle word wrap Toggle overflow ターミナルに次のメッセージが表示されます。
Note, we have launched a browser for you to login.For old experience with device code, use "az login --use-device-code次に、ターミナルは、ログインできる場所から https://microsoft.com/devicelogin へのリンクのあるブラウザーを開きます。注記リモート (SSH) セッションを実行している場合、ログインページのリンクはブラウザーで開きません。この場合、リンクをブラウザーにコピーしてログインし、リモートセッションを認証できます。サインインするには、Web ブラウザーを使用してページ https://microsoft.com/devicelogin を開き、デバイスコードを入力して認証します。
Microsoft Azure のストレージアカウントのキーをリスト表示します。
az storage account keys list --resource-group <resource_group_name> --account-name <storage_account_name>
$ az storage account keys list --resource-group <resource_group_name> --account-name <storage_account_name>Copy to Clipboard Copied! Toggle word wrap Toggle overflow resource-group-name を Microsoft Azure リソースグループの名前に置き換え、storage-account-name を Microsoft Azure ストレージアカウントの名前に置き換えます。
注記次のコマンドを使用して、使用可能なリソースを一覧表示できます。
az resource list
$ az resource listCopy to Clipboard Copied! Toggle word wrap Toggle overflow 上記のコマンドの出力にある値
key1をメモします。ストレージコンテナーを作成します。
az storage container create --account-name <storage_account_name>\ --account-key <key1_value> --name <storage_account_name>
$ az storage container create --account-name <storage_account_name>\ --account-key <key1_value> --name <storage_account_name>Copy to Clipboard Copied! Toggle word wrap Toggle overflow storage-account-name は、ストレージアカウント名に置き換えます。
11.2.2. VHD イメージを Microsoft Azure クラウドに手動でアップロードする リンクのコピーリンクがクリップボードにコピーされました!
カスタマイズした VHD イメージを作成したら、それを手動で Microsoft Azure クラウドにアップロードできます。
前提条件
- Microsoft Azure VHD イメージをアップロードするようにシステムを設定している。Microsoft Azure VHD イメージのアップロードの準備 を参照してください。
RHEL Image Builder で Microsoft Azure VHD イメージを作成している。
-
GUI で、
Azure Disk Image (.vhd)イメージタイプを使用します。 -
CLI で、
vhd出力タイプを使用します。
-
GUI で、
CLI を使用して .vhd イメージを作成すると、Image Builder は一時ファイルを /var サブディレクトリーに書き込みます。.vhd イメージの作成が失敗しないようにするには、/var サブディレクトリーの容量を少なくとも 15 から 20 GB の空き領域に増やし、可用性を確保します。
手順
イメージを Microsoft Azure にプッシュし、そこからインスタンスを作成します。
az storage blob upload --account-name <_account_name_> --container-name <_container_name_> --file <_image_-disk.vhd> --name <_image_-disk.vhd> --type page
$ 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 Copied! Toggle word wrap Toggle overflow Microsoft Azure Blob ストレージへのアップロードが完了したら、そこから Microsoft Azure イメージを作成します。
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
$ 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 Copied! Toggle word wrap Toggle overflow 注記RHEL Image Builder で作成するイメージは、V1 = BIOS と V2 = UEFI の両方のインスタンスタイプをサポートするハイブリッドイメージを生成するため、
--hyper-v-generation引数を指定できます。デフォルトのインスタンスタイプは V1 です。
検証
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
$ 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 Copied! Toggle word wrap Toggle overflow -
秘密鍵を使用して、SSH 経由で、作成されたインスタンスにアクセスします。
azure-userとしてログインします。このユーザー名は前の手順で設定したものです。
11.2.3. VHD イメージを作成して Microsoft Azure クラウドに自動的にアップロードする リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder を使用して .vhd イメージを作成すると、Microsoft Azure クラウドサービスプロバイダーの Blob Storage に自動的にアップロードされます。
前提条件
- システムへの root アクセス権があります。
- RHEL Web コンソールの RHEL Image Builder インターフェイスにアクセスできる。
- ブループリントを作成している。Web コンソールインターフェイスでの RHEL Image Builder ブループリントの作成 を参照してください。
- Microsoft ストレージアカウント が作成されました。
- 書き込み可能な Blob Storage が準備されました。
手順
- RHEL Image Builder ダッシュボードで、使用するブループリントを選択します。
- タブをクリックします。
をクリックして、カスタマイズした
.vhdイメージを作成します。Create image ウィザードが開きます。
-
Type ドロップダウンメニューリストから
Microsoft Azure (.vhd)を選択します。 - イメージを Microsoft Azure クラウドにアップロードするには、Upload to Azure チェックボックスをオンします。
- Image Size を入力し、 をクリックします。
-
Type ドロップダウンメニューリストから
Upload to Azure ページで、次の情報を入力します。
認証ページで、次のように入力します。
- Storage account の名前。これは、Microsoft Azure portal の Storage account ページにあります。
- Storage access key: これは、Access Key ストレージページにあります。
- をクリックします。
Authentication ページで、次のように入力します。
- イメージ名
- Storage container。これは、イメージのアップロード先の Blob コンテナーです。Microsoft Azure portal の Blob service セクションにあります。
- をクリックします。
Review ページで をクリックします。RHEL Image Builder が起動し、アップロードプロセスが開始します。
Microsoft Azure Cloud にプッシュしたイメージにアクセスします。
- Microsoft Azure ポータル にアクセスします。
- 検索バーに "storage account" と入力し、リストから Storage accounts をクリックします。
- 検索バーに "Images" と入力し、Services の下にある最初のエントリーを選択します。Image Dashboard にリダイレクトされます。
- ナビゲーションパネルで、Containers をクリックします。
-
作成したコンテナーを見つけます。コンテナー内には、RHEL Image Builder を使用して作成およびプッシュした
.vhdファイルがあります。
検証
仮想マシンイメージを作成して起動できることを確認します。
- 検索バーに images account と入力し、リストから Images をクリックします。
- をクリックします。
- ドロップダウンリストから、前に使用したリソースグループを選択します。
- イメージの名前を入力します。
- OS type で Linux を選択します。
- VM generation で Gen 2 を選択します。
- Storage Blob で をクリックし、VHD ファイルに到達するまでストレージアカウントとコンテナーをクリックします。
- ページの最後にある Select をクリックします。
- Account Type を選択します (例: Standard SSD)。
- をクリックし、 をクリックします。イメージが作成されるまでしばらく待機します。
仮想マシンを起動するには、次の手順に従います。
- をクリックします。
- ヘッダーのメニューバーから をクリックします。
- 仮想マシンの名前を入力します。
- Size セクションと Administrator account セクションに入力します。
をクリックし、 をクリックします。デプロイメントの進行状況を確認できます。
デプロイメントが完了したら、仮想マシン名をクリックしてインスタンスのパブリック IP アドレスを取得し、SSH を使用して接続します。
- ターミナルを開いて SSH 接続を作成し、仮想マシンに接続します。
11.3. VMDK カスタムイメージの準備と vSphere へのアップロード リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder を使用してカスタムイメージを作成し、そのイメージを手動または自動で VMware vSphere クラウドにアップロードできます。
11.3.1. Image Builder を使用してカスタマイズした RHEL VMDK イメージを作成し、自動的にアップロードする リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder を使用すると、Open virtualization format (.ova) 形式のカスタマイズしたシステムイメージを作成し、そのイメージを VMware vSphere クライアントに自動的にアップロードできます。Open virtualization format (.ova) は、仮想ハードウェアに関する追加のメタデータを含む .vmdk イメージです。このイメージには、vSphere へのイメージのインポートを容易にする最小限のテンプレートが含まれています。vSphere .ova イメージには、.ovf (Open Virtualization Format) パッケージが含まれています。RHEL Image Builder による vSphere クライアントへの .ova イメージのインポートを完了したら、そのイメージをネットワーク、ディスク、CD-ROM などの追加ハードウェアを使用して設定できます。
Open virtualization format (.ova) イメージは、vSphere GUI または govc クライアントを使用してインポートできます。govc クライアントを使用してイメージをアップロードするには、VMDK イメージのアップロードと vSphere での RHEL 仮想マシンの作成 を参照してください。
前提条件
- ブラウザーの Web コンソールから RHEL Image Builder アプリケーションを開いている。
- ブループリントを作成している。
手順
-
RHEL Image Builder ダッシュボードで、
Blueprintタブをクリックします。 - ブループリントのテーブルで、イメージをビルドするブループリントを見つけます。
- 選択したブループリントの右側で、 をクリックします。Create image ダイアログウィザードが開きます。
Image output ページで、次の手順を実行します。
- Select a blueprint リストから、必要なイメージのタイプを選択します。
- Image output type リストから、必要なイメージの出力タイプを選択します。
- オプション: イメージを VMware に直接アップロードするには、Upload to VMware チェックボックスをオンにします。
- イメージのサイズを入力します。
- をクリックします。
Upload to VMware ページで、次の情報を入力します。
- Image name: イメージ名を入力します。
- Host: イメージファイルをアップロードする VMware vSphere インスタンスの URL を入力します。
- Cluster: イメージをアップロードするクラスター名のページを入力します。
- Datacenter: イメージをアップロードするデータセンター名。
- Datastore: イメージをアップロードするデータストア名。
- Folder: イメージをアップロードするフォルダー名。
- をクリックします。
Review ページで、イメージの作成に関する詳細を確認し、 をクリックします。
イメージの作成が開始し、このイメージ作成の進捗が表示されます。その後、VMware vSphere クライアントへのアップロードが行われます。
11.3.2. VMDK イメージのアップロードと vSphere での RHEL 仮想マシンの作成 リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder を使用すると、カスタマイズした VMware vSphere システムイメージを Open virtualization format (.ova) または Virtual disk (.vmdk) 形式で作成できます。これらのイメージを VMware vSphere クライアントにアップロードできます。govc import.vmdk CLI ツールを使用して、.vmdk または .ova イメージを VMware vSphere にアップロードできます。作成した vmdk には、インストール済みの cloud-init パッケージが含まれています。このパッケージを使用して、たとえばユーザーデータを使用してユーザーをプロビジョニングできます。
VMware vSphere GUI を使用した vmdk イメージのアップロードはサポートされていません。
前提条件
- ユーザー名とパスワードをカスタマイズしたブループリントを作成している。
-
RHEL Image Builder を使用して VMware vSphere イメージを
.ovaまたは.vmdk形式で作成し、ホストシステムにダウンロードしている。 -
govcCLI ツールをインストールして設定し、import.vmdkコマンドが使用可能である。
手順
GOVC 環境変数を使用して、ユーザー環境で次の値を設定します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - VMware vSphere イメージをダウンロードしたディレクトリーに移動します。
次の手順に従って、vSphere で VMware vSphere イメージを起動します。
VMware vSphere イメージを vSphere にインポートします。
govc import.vmdk ./composer-api.vmdk foldername
$ govc import.vmdk ./composer-api.vmdk foldernameCopy to Clipboard Copied! Toggle word wrap Toggle overflow .ova形式の場合:govc import.ova ./composer-api.ova foldername
$ govc import.ova ./composer-api.ova foldernameCopy to Clipboard Copied! Toggle word wrap Toggle overflow 電源をオンにせずに vSphere に仮想マシンを作成します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow .ova形式の場合は、行-firmware=efi -disk=”foldername/composer-api.vmdk” \を `-firmware=efi -disk=”foldername/composer-api.ova” \ に置き換えます。仮想マシンの電源をオンにします。
govc vm.power -on vmname
govc vm.power -on vmnameCopy to Clipboard Copied! Toggle word wrap Toggle overflow 仮想マシンの IP アドレスを取得します。
govc vm.ip vmname
govc vm.ip vmnameCopy to Clipboard Copied! Toggle word wrap Toggle overflow ブループリントで指定したユーザー名とパスワードで、SSH を使用して、仮想マシンにログインします。
ssh admin@<_ip_address_of_the_vm_>
$ ssh admin@<_ip_address_of_the_vm_>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記govc datastore.uploadコマンドを使用してローカルホストから宛先に.vmdkイメージをコピーしても、コピーして作成したイメージを使用することはできません。vSphere GUI にはimport.vmdkコマンドを使用するオプションがないため、vSphere GUI は直接アップロードをサポートしません。そのため、.vmdkイメージを vSphere GUI から使用することはできません。
11.3.3. Image Builder GUI を使用して VMDK イメージを作成し、vSphere に自動的にアップロードする リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder GUI ツールを使用して VMware イメージをビルドし、そのイメージを vSphere インスタンスに直接自動的にプッシュできます。これにより、イメージファイルをダウンロードして手動でプッシュする必要がなくなります。作成した vmdk には、インストール済みの cloud-init パッケージが含まれています。このパッケージを使用して、たとえばユーザーデータを使用してユーザーをプロビジョニングできます。RHEL Image Builder を使用して .vmdk イメージをビルドし、vSphere インスタンスサービスプロバイダーに直接プッシュするには、次の手順に従います。
前提条件
-
rootまたはweldrグループのメンバーである。 - ブラウザーで https://localhost:9090/RHEL Image Builder を開いている。
- ブループリントを作成している。Web コンソールインターフェイスでの RHEL Image Builder ブループリントの作成 を参照してください。
- vSphere アカウント がある。
手順
- 作成したブループリントの タブをクリックします。
をクリックして、カスタマイズしたイメージを作成します。
イメージタイプウィンドウが開きます。
Image type ウィンドウで、以下を実行します。
- ドロップダウンメニューからタイプ (VMware vSphere (.vmdk)) を選択します。
- Upload to VMware チェックボックスをチェックして、イメージを vSphere にアップロードします。
- 必要に応じて、インスタンス化するイメージのサイズを設定します。最小のデフォルトサイズは 2 GB です。
- をクリックします。
Upload to VMware ウィンドウの Authentication の下に以下の情報を入力します。
- ユーザー名: vSphere アカウントのユーザー名。
- パスワード: vSphere アカウントのパスワード。
Upload to VMware ウィンドウの Destination の下に、イメージのアップロード先に関する以下の情報を入力します。
- Image name: イメージの名前。
- Host: VMware vSphere の URL。
- Cluster: クラスターの名前。
- Data center: データセンターの名前。
- Data store: データストアの名前。
- Next をクリックします。
確認 ウィンドウで、イメージ作成の詳細を確認し、 をクリックします。
をクリックして、誤った情報を変更できます。
RHEL Image Builder は、RHEL vSphere イメージの Compose をキューに追加し、指定した vSphere インスタンスのクラスターにイメージを作成してアップロードします。
注記イメージビルドおよびアップロードプロセスの完了には数分かかります。
プロセスが完了すると、Image build complete のステータスが表示されます。
検証
イメージステータスのアップロードが正常に完了したら、アップロードしたイメージから仮想マシン (VM) を作成し、ログインできます。これを行うには、以下を行います。
- VMware vSphere クライアントにアクセスします。
- 指定した vSphere インスタンスのクラスターでイメージを検索します。
- アップロードしたイメージを選択します。
- 選択したイメージを右クリックします。
New Virtual Machineをクリックします。New Virtual Machine ウィンドウが開きます。
New Virtual Machine ウィンドウで、以下の詳細を指定します。
-
New Virtual Machineを選択します。 - 仮想マシンの名前とフォルダーを選択します。
- コンピューターリソースの選択: この操作の宛先コンピューターリソースを選択します
- ストレージの選択: たとえば NFS-Node1 を選択します。
- 互換性の選択: イメージは BIOS 専用でなければなりません。
- ゲストオペレーティングシステムを選択します。たとえば、Linux および Red Hat Fedora (64-bit) を選択します。
- ハードウェアのカスタマイズ: 仮想マシンを作成する場合は、右上の Device Configuration ボタンでデフォルトの New Hard Disk を削除し、ドロップダウンを使用して Existing Hard Disk ディスクイメージを選択します。
- 準備完了: 詳細を確認し、Finish をクリックしてイメージを作成します。
-
VMs タブに移動します。
- リストから、作成した仮想マシンを選択します。
- パネルから Start ボタンをクリックします。仮想マシンイメージを読み込み中であることを示す新しいウィンドウが表示されます。
- ブループリント用に作成した認証情報を使用してログインします。
ブループリントに追加したパッケージがインストールされていることを確認できます。以下に例を示します。
rpm -qa | grep firefox
$ rpm -qa | grep firefoxCopy to Clipboard Copied! Toggle word wrap Toggle overflow
11.4. カスタム GCE イメージの準備と GCP へのアップロードする リンクのコピーリンクがクリップボードにコピーされました!
カスタムイメージを作成してから、RHEL Image Builder を使用して Google Cloud Platform (GCP)インスタンスにそれらを自動的に更新できます。
11.4.1. RHEL Image Builder を使用した GCP へのイメージのアップロード リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder を使用すると、gce イメージをビルドし、ユーザーまたは GCP サービスアカウントの認証情報を指定して、gce イメージを GCP 環境に直接アップロードできます。
11.4.1.1. CLI を使用して gce イメージを設定して GCP にアップロードする リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder CLI を使用して、gce イメージを GCP にアップロードするための認証情報を含む設定ファイルを設定します。
イメージが起動しなくなるため、gce イメージを GCP に手動でインポートすることはできません。アップロードするには、gcloud または RHEL Image Builder を使用する必要があります。
前提条件
イメージを GCP にアップロードするための有効な Google アカウントと認証情報がある。認証情報は、ユーザーアカウントまたはサービスアカウントから取得できます。認証情報に関連付けられたアカウントには、少なくとも次の IAM ロールが割り当てられている必要があります。
-
roles/storage.admin- ストレージオブジェクトの作成と削除 -
roles/compute.storageAdmin- 仮想マシンイメージの Compute Engine へのインポート
-
- 既存の GCP バケットがあります。
手順
テキストエディターを使用して、次の内容の
gcp-config.toml設定ファイルを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
GCP_BUCKETは既存のバケットを指します。アップロード中のイメージの中間ストレージオブジェクトを格納するために使用されます。 -
GCP_STORAGE_REGIONは、通常の Google ストレージリージョンであり、デュアルまたはマルチリージョンです。 -
OBJECT_KEYは、中間ストレージオブジェクトの名前です。アップロード前に存在してはならず、アップロードプロセスが完了すると削除されます。オブジェクト名が.tar.gzで終わらない場合、拡張子がオブジェクト名に自動的に追加されます。 GCP_CREDENTIALSは、GCP からダウンロードした認証情報 JSON ファイルのBase64エンコードされたスキームです。認証情報によって、GCP がイメージをアップロードするプロジェクトが決まります。注記GCP での認証に別のメカニズムを使用する場合、
gcp-config.tomlファイルでのGCP_CREDENTIALSの指定は任意です。他の認証方法は、Authenticating with GCP を参照してください。
-
GCP からダウンロードした JSON ファイルから
GCP_CREDENTIALSを取得します。sudo base64 -w 0 cee-gcp-nasa-476a1fa485b7.json
$ sudo base64 -w 0 cee-gcp-nasa-476a1fa485b7.jsonCopy to Clipboard Copied! Toggle word wrap Toggle overflow 追加のイメージ名とクラウドプロバイダープロファイルを使用して Compose を作成します。
sudo composer-cli compose start BLUEPRINT-NAME gce IMAGE_KEY gcp-config.toml
$ sudo composer-cli compose start BLUEPRINT-NAME gce IMAGE_KEY gcp-config.tomlCopy to Clipboard Copied! Toggle word wrap Toggle overflow イメージビルド、アップロード、およびクラウド登録プロセスは、完了に最大 10 分かかる場合があります。
検証
イメージのステータスが FINISHED であることを確認します。
sudo composer-cli compose status
$ sudo composer-cli compose statusCopy to Clipboard Copied! Toggle word wrap Toggle overflow
11.4.1.2. RHEL Image Builder によるさまざまな GCP 認証情報の認証順序の並べ替え リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder でいくつかの異なる種類の認証情報を使用して、GCP で認証できます。複数の認証情報セットを使用して GCP で認証するように RHEL Image Builder が設定されている場合、次の優先順位で認証情報が使用されます。
-
設定ファイルで
composer-cliコマンドで指定された認証情報。 -
osbuild-composerワーカー設定で設定された認証情報。 次の方法で認証方法を自動的に見つけようとする、
Google GCP SDKライブラリーからのApplication Default Credentials。- GOOGLE_APPLICATION_CREDENTIALS 環境変数が設定されている場合、Application Default Credentials は、変数が指すファイルから認証情報を読み込んで使用しようとします。
Application Default Credentials は、コードを実行しているリソースに関連付けられたサービスアカウントを使用して認証を試みます。たとえば、Google Compute Engine 仮想マシンです。
注記イメージをアップロードする GCP プロジェクトを決定するには、GCP 認証情報を使用する必要があります。したがって、すべてのイメージを同じ GCP プロジェクトにアップロードする場合を除き、
composer-cliコマンドを使用してgcp-config.toml設定ファイルに認証情報を指定する必要があります。
11.4.1.2.1. composer-cli コマンドで GCP 認証情報を指定する リンクのコピーリンクがクリップボードにコピーされました!
アップロードターゲット設定の gcp-config.toml ファイルで、GCP 認証情報を指定できます。時間を節約するために、Google アカウント認証情報の JSON ファイルの Base64 エンコードスキームを使用します。
手順
GOOGLE_APPLICATION_CREDENTIALS環境変数に保存されているパスを使用して、Google アカウント認証情報ファイルのエンコードされたコンテンツを取得するには、次のコマンドを実行します。base64 -w 0 "${GOOGLE_APPLICATION_CREDENTIALS}"$ base64 -w 0 "${GOOGLE_APPLICATION_CREDENTIALS}"Copy to Clipboard Copied! Toggle word wrap Toggle overflow アップロードターゲット設定の
gcp-config.tomlファイルで、認証情報を設定します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow
11.4.1.2.2. osbuild-composer ワーカー設定で認証情報を指定する リンクのコピーリンクがクリップボードにコピーされました!
すべてのイメージビルドでグローバルに GCP に使用される GCP 認証認証情報を設定できます。このようにして、イメージを同じ GCP プロジェクトにインポートする場合、GCP へのすべてのイメージのアップロードに同じ認証情報を使用できます。
手順
/etc/osbuild-worker/osbuild-worker.tomlワーカー設定で、次の認証情報の値を設定します。[gcp] credentials = "PATH_TO_GCP_ACCOUNT_CREDENTIALS"
[gcp] credentials = "PATH_TO_GCP_ACCOUNT_CREDENTIALS"Copy to Clipboard Copied! Toggle word wrap Toggle overflow
11.5. カスタムイメージの準備と OCI への直接アップロード リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder を使用してカスタムイメージを作成し、そのイメージを Oracle Cloud Infrastructure (OCI) インスタンスに自動的にアップロードできます。
11.5.1. カスタムイメージを作成して OCI に自動的にアップロードする リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder を使用すると、カスタマイズしたイメージをビルドし、そのイメージを Oracle Cloud Infrastructure (OCI) インスタンスに直接自動的にプッシュできます。その後、OCI ダッシュボードからイメージインスタンスを開始できます。
前提条件
-
システムに対して
rootまたはweldrグループのユーザーアクセスがある。 - Oracle Cloud アカウントを持っている。
- 管理者によって OCI ポリシー でセキュリティーアクセスが許可されている必要があります。
-
選択した
OCI_REGIONに OCI バケットを作成しました。
手順
- ブラウザーで Web コンソールの RHEL Image Builder インターフェイスを開きます。
- をクリックします。Create blueprint ウィザードが開きます。
- Details ページで、ブループリントの名前を入力し、必要に応じて説明を入力します。 をクリックします。
- Packages ページで、イメージに含めるコンポーネントとパッケージを選択します。 をクリックします。
- Customizations ページで、ブループリントに必要なカスタマイズを設定します。 をクリックします。
- Review ページで をクリックします。
- イメージを作成するには、 をクリックします。Create image ウィザードが開きます。
Image output ページで、次の手順を実行します。
- "Select a blueprint" ドロップダウンメニューから、必要なブループリントを選択します。
-
"Image output type" ドロップダウンメニューから、
Oracle Cloud Infrastructure (.qcow2)を選択します。 - イメージを OCI にアップロードするには、Upload OCI チェックボックスをオンにします。
- "image size" を入力します。 をクリックします。
Upload to OCI - Authentication ページで、次の必須の詳細を入力します。
- ユーザー OCID: ユーザーの詳細を表示するページのコンソールで確認できます。
- 秘密鍵
Upload to OCI - Destination ページで、次の必須の詳細を入力し、 をクリックします。
- イメージ名: アップロードするイメージの名前。
- OCI バケット
- バケット namespace
- バケットリージョン
- バケットコンパートメント
- バケットテナンシー
- ウィザードの詳細を確認し、 をクリックします。
RHEL Image Builder が、RHEL .qcow2 イメージの Compose をキューに追加します。
検証
- OCI ダッシュボード → カスタムイメージにアクセスします。
- イメージに指定した Compartment を選択し、Import image テーブルでイメージを見つけます。
- イメージ名をクリックして、イメージ情報を確認します。
11.6. カスタマイズした QCOW2 イメージを準備して OpenStack に直接アップロードする リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder を使用してカスタムの .qcow2 イメージを作成し、OpenStack クラウドデプロイメントに手動でアップロードできます。
11.6.1. OpenStack への QCOW2 イメージのアップロード リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder ツールを使用すると、OpenStack クラウドデプロイメントにアップロードし、そこでインスタンスを起動するのに適した、カスタマイズした .qcow2 イメージを作成できます。RHEL Image Builder は QCOW2 フォーマットでイメージを作成しますが、OpenStack に固有の変更がさらに加えられています。
RHEL Image Builder を OpenStack イメージタイプで使用して作成する一般的な QCOW2 イメージタイプの出力フォーマットを間違えないでください。これも QCOW2 フォーマットですが、OpenStack に固有の変更がさらに含まれています。
前提条件
- ブループリントを作成している。
手順
QCOW2イメージの作成を開始します。composer-cli compose start blueprint_name openstack
# composer-cli compose start blueprint_name openstackCopy to Clipboard Copied! Toggle word wrap Toggle overflow ビルドの状態を確認します。
composer-cli compose status
# composer-cli compose statusCopy to Clipboard Copied! Toggle word wrap Toggle overflow イメージのビルドが完了したら、イメージをダウンロードできます。
QCOW2イメージをダウンロードします。composer-cli compose image UUID
# composer-cli compose image UUIDCopy to Clipboard Copied! Toggle word wrap Toggle overflow - OpenStack ダッシュボードにアクセスし、 をクリックします。
-
左側のメニューで、
Adminタブを選択します。 System PanelからImageをクリックします。Create An Imageウィザードが開きます。Create An Imageウィザードで、以下を行います。- イメージの名前を入力します。
-
BrowseをクリックしてQCOW2イメージをアップロードします。 -
Formatドロップダウンリストから、QCOW2 - QEMU Emulatorを選択します。 をクリックします。
左側のメニューで
Projectタブを選択します。-
ComputeメニューからInstancesを選択します。 ボタンをクリックします。
インスタンスの
Launch Instanceが開きます。-
Detailsページで、インスタンスの名前を入力します。 をクリックします。 -
Sourceページで、アップロードしたイメージの名前を選択します。 をクリックします。 Flavorページで、ニーズに最適なマシンリソースを選択します。 をクリックします。
-
-
イメージから任意のメカニズム (CLI または OpenStack Web UI) を使用して、イメージインスタンスを実行できます。秘密鍵を使用して、SSH 経由で、作成されたインスタンスにアクセスします。
cloud-userとしてログインします。
11.7. カスタマイズした RHEL イメージを準備して Alibaba Cloud にアップロードする リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder で作成した、カスタマイズしれた .ami イメージを Alibaba Cloud にアップロードできます。
11.7.1. カスタマイズされた RHEL イメージを Alibaba Cloud にアップロードする準備 リンクのコピーリンクがクリップボードにコピーされました!
カスタマイズされた RHEL イメージを Alibaba Cloud にデプロイするには、まずカスタマイズされたイメージを検証する必要があります。Alibaba Cloud は、イメージを使用する前に特定の要件を満たすようにカスタムイメージを要求するため、イメージが正常に起動するように特別な設定が必要になります。
RHEL Image Builder は、Alibaba の要件に準拠したイメージを生成します。ただし、Red Hat は、Alibaba image_check ツール を使用して、イメージのフォーマット準拠を確認することも推奨します。
前提条件
- RHEL Image Builder を使用して Alibaba イメージを作成している。
手順
- Alibaba の image_check ツールを使用して、チェックするイメージを含むシステムに接続します。
image_check ツールをダウンロードします。
curl -O https://docs-aliyun.cn-hangzhou.oss.aliyun-inc.com/assets/attach/73848/cn_zh/1557459863884/image_check
$ curl -O https://docs-aliyun.cn-hangzhou.oss.aliyun-inc.com/assets/attach/73848/cn_zh/1557459863884/image_checkCopy to Clipboard Copied! Toggle word wrap Toggle overflow イメージのコンプライアンスツールのファイルパーミッションを変更します。
chmod +x image_check
# chmod +x image_checkCopy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを実行して、イメージコンプライアンスツールのチェックを起動します。
./image_check
# ./image_checkCopy to Clipboard Copied! Toggle word wrap Toggle overflow このツールは、システム設定を検証し、画面に表示されるレポートを生成します。image_check ツールは、イメージのコンプライアンスツールが実行されているフォルダーにこのレポートを保存します。
トラブルシューティング
いずれかの 検出項目 が失敗した場合は、ターミナルの指示に従って修正してください。
11.7.2. カスタマイズされた RHEL イメージを Alibaba にアップロードする リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder で作成した、カスタマイズした AMI イメージを Object Storage Service (OSS) にアップロードできます。
前提条件
- Alibaba イメージのアップロードを設定している。Alibaba にイメージをアップロードするための準備 を参照してください。
-
RHEL Image Builder を使用して
amiイメージを作成している。 - バケットがある。Creating a bucket を参照してください。
- アクティブな Alibaba アカウント がある。
- OSS をアクティベートしている。
手順
- OSS コンソール にログインします。
- 左側のバケットメニューで、イメージをアップロードするバケットを選択します。
- 右上のメニューで、Files タブをクリックします。
をクリックします。右側のダイアログウィンドウが開きます。以下を設定します。
- アップロード先 - これを選択すると、現在 のディレクトリーまたは 指定した ディレクトリーにファイルをアップロードします。
- ファイル ACL - アップロードしたファイルのパーミッションのタイプを選択します。
- をクリックします。
- OSS コンソールにアップロードするイメージを選択します。
- をクリックします。
11.7.3. Alibaba Cloud へのイメージのインポート リンクのコピーリンクがクリップボードにコピーされました!
RHEL Image Builder で作成した、カスタマイズした Alibaba RHEL イメージを Elastic Compute Service (ECS) にインポートするには、次の手順に従います。
前提条件
- Alibaba イメージのアップロードを設定している。Alibaba にイメージをアップロードするための準備 を参照してください。
-
RHEL Image Builder を使用して
amiイメージを作成している。 - バケットがある。Creating a bucket を参照してください。
- アクティブな Alibaba アカウント がある。
- OSS をアクティベートしている。
- イメージを OSS (Object Storage Service) にアップロードしている。Alibaba へのイメージのアップロード を参照してください。
手順
ECS コンソール にログインします。
- 左側のメニューで、 をクリックします。
- 右上にある をクリックします。ダイアログウィンドウが開きます。
イメージが含まれる正しいリージョンを設定していることを確認します。以下の情報を入力します。
-
OSS Object Address- OSS Object Address を参照 -
Image Name -
オペレーティングシステム -
System Disk Size -
システムアーキテクチャー -
Platform: Red Hat
-
オプション: 次の詳細を入力します。
-
Image Format- アップロードしたイメージの形式に応じてqcow2またはami。 -
Image Description Add Images of Data Disksアドレスは、OSS 管理コンソールで確認できます。左側のメニューで必要なバケットを選択した後:
-
-
Filesセクションを選択します。 適切なイメージの右側にある Details リンクをクリックします。
画面右側にウィンドウが表示され、イメージの詳細が表示されます。
OSSオブジェクトアドレスはURLボックスにあります。をクリックします。
注記インポートプロセスの時間は、イメージのサイズによって異なります。
カスタマイズされたイメージが ECS コンソールにインポートされます。
11.7.4. Alibaba Cloud を使用したカスタマイズされた RHEL イメージのインスタンスの作成 リンクのコピーリンクがクリップボードにコピーされました!
Alibaba ECS コンソールを使用して、カスタマイズされた RHEL イメージのインスタンスを作成できます。
前提条件
- OSS をアクティベートして、カスタムイメージをアップロードしている。
- イメージを ECS コンソールに正常にインポートしている。Alibaba へのイメージのインポート を参照してください。
手順
- ECS コンソール にログインします。
- 左側のメニューで、インスタンス を選択します。
- 右上隅にある インスタンスの作成 をクリックします。新しいウィンドウにリダイレクトされます。
- 必要な情報をすべて完了します。詳細は、Creating an instance by using the wizard を参照してください。
Create Instance をクリックして、順番を確認します。
注記サブスクリプションによっては、Create Instance ではなく Create Order が表示されます。
その結果、アクティブなインスタンスを Alibaba ECS Console からデプロイする準備が整いました。