RHEL for Edge イメージへの埋め込み

手順

1. 次のコマンドを実行して、/etc/osbuild-composer/repositories ディレクトリーを作成します。

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

2. 次のコマンドを実行して、/usr/share/osbuild-composer/repositories/rhel-9.6.json ファイルを /etc/osbuild-composer/repositories ディレクトリーにコピーします。

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

3. 次の値で /etc/osbuild-composer/repositories/rhel-9.6.json ファイルを変更して、baseos ソースを更新します。

   # ...
   "baseurl": "https://cdn.redhat.com/content/eus/rhel9/9.6//baseos/os", 

   1

   
   # ...

   1

   この例の値と異なる場合は、9 を、使用している RHEL のメジャーバージョンに置き換え、9.6 を <major.minor> バージョンに置き換えることができます。選択した RHEL バージョンが、使用している MicroShift バージョンと互換性があることを確認してください。

4. オプション: 以下のコマンドを実行して baseos 更新を適用します。

   $ sudo sed -i "s,dist/rhel9/9.6/$(uname -m)/baseos/,eus/rhel9/9.6/$(uname -m)/baseos/,g" \
   /etc/osbuild-composer/repositories/rhel-9.6.json 

   1

   1

   この例の値と異なる場合は、9 を、使用している RHEL のメジャーバージョンに置き換え、9.6 を <major.minor> バージョンに置き換えることができます。選択した RHEL バージョンが、使用している MicroShift バージョンと互換性があることを確認してください。

5. /etc/osbuild-composer/repositories/rhel-<major.minor>.json ファイルを次の値に変更して、appstream ソースを更新します。

   # ...
   "baseurl": "https://cdn.redhat.com/content/eus/rhel9/9.6//appstream/os", 

   1

   
   # ...

   1

   この例の値と異なる場合は、9 を、使用している RHEL のメジャーバージョンに置き換え、9.6 を <major.minor> バージョンに置き換えることができます。選択した RHEL バージョンが、使用している MicroShift バージョンと互換性があることを確認してください。

6. オプション: 以下のコマンドを実行して appstream の更新を適用します。

   $ sudo sed -i "s,dist/rhel9/9.6/$(uname -m)/appstream/,eus/rhel9/9.6/$(uname -m)/appstream/,g" \
   /etc/osbuild-composer/repositories/rhel-9.6.json 

   1

   1

   この例の値と異なる場合は、9 を、使用している RHEL のメジャーバージョンに置き換え、9.6 を <major.minor> バージョンに置き換えることができます。選択した RHEL バージョンが、使用している MicroShift バージョンと互換性があることを確認してください。

1. 以下のコマンドを実行して baseos ソースを確認します。

   $ sudo composer-cli sources info baseos | grep 'url ='

   出力例

   url = "https://cdn.redhat.com/content/eus/rhel9/9.6/x86_64/baseos/os"

2. 以下のコマンドを実行して appstream ソースを確認します。

   $ sudo composer-cli sources info appstream | grep 'url ='

   出力例

   url = "https://cdn.redhat.com/content/eus/rhel9/9.6/x86_64/appstream/os"

手順

1. 次のコマンドを実行して、MicroShift の RPM をプルするために必要な rhocp-4.19 RPM リポジトリーソースを追加するための Image Builder 設定ファイルを作成します。

   cat > rhocp-4.19.toml <<EOF
   id = "rhocp-4.19"
   name = "Red Hat OpenShift Container Platform 4.19 for RHEL 9"
   type = "yum-baseurl"
   url = "https://cdn.redhat.com/content/dist/layered/rhel9/$(uname -m)/rhocp/4.19/os"
   check_gpg = true
   check_ssl = true
   system = false
   rhsm = true
   EOF

2. 次のコマンドを実行して、fast-datapath RPM リポジトリーを追加した Image Builder 設定ファイルを作成します。

   cat > fast-datapath.toml <<EOF
   id = "fast-datapath"
   name = "Fast Datapath for RHEL 9"
   type = "yum-baseurl"
   url = "https://cdn.redhat.com/content/dist/layered/rhel9/$(uname -m)/fast-datapath/os"
   check_gpg = true
   check_ssl = true
   system = false
   rhsm = true
   EOF

3. 次のコマンドを実行して、Image Builder にソースを追加します。

   $ sudo composer-cli sources add rhocp-4.19.toml

   $ sudo composer-cli sources add fast-datapath.toml

手順

1. /usr/share/microshift/blueprint ディレクトリーにインストールされている、プラットフォームアーキテクチャーに固有のブループリントを使用します。ブループリントセクションの説明は、次のサンプルスニペットを参照してください。

   生成された Image Builder ブループリントのサンプルスニペット

   name = "microshift_blueprint"
   description = "MicroShift 4.19.1 on x86_64 platform"
   version = "0.0.1"
   modules = []
   groups = []
   
   [[packages]] 

   1

   
   name = "microshift"
   version = "4.19.1"
   ...
   ...
   
   [customizations.services] 

   2

   
   enabled = ["microshift"]
   
   [customizations.firewall]
   ports = ["ssh"]
   ...
   ...
   
   [[containers]] 

   3

   
   source = "quay.io/openshift-release-dev/ocp-v4.0-art-dev@sha256:f41e79c17e8b41f1b0a5a32c3e2dd7cd15b8274554d3f1ba12b2598a347475f4"
   
   [[containers]]
   source = "quay.io/openshift-release-dev/ocp-v4.0-art-dev@sha256:dbc65f1fba7d92b36cf7514cd130fe83a9bd211005ddb23a8dc479e0eea645fd"
   ...
   …
   EOF

   1

   microshift-release-info RPM と互換性のある同じバージョンを使用する、オプション以外のすべての MicroShift RPM パッケージの参照。

   2

   システム起動時に MicroShift を自動的に有効にし、デフォルトのネットワーク設定を適用するための参照。

   3

   オフラインデプロイメントに必要なオプション以外のすべての MicroShift コンテナーイメージの参照。SHA は使用しているリリースにより異なります。

2. 次のコマンドを実行して、Image Builder にブループリントを追加します。

   $ sudo composer-cli blueprints push microshift_blueprint.toml

検証

1. 次のコマンドを実行して、MicroShift パッケージのみをリストした Image Builder 設定を確認します。

   $ sudo composer-cli blueprints depsolve microshift_blueprint | grep microshift

   出力例

   blueprint: microshift_blueprint v0.0.1
       microshift-release-info-4.19.1-202511250827.p0.g4105d3b.assembly.4.19.1.el9.noarch
       microshift-4.19.1-202511250827.p0.g4105d3b.assembly.4.19.1.el9.x86_64

2. オプション: 次のコマンドを実行して、インストールするすべてのコンポーネントをリストした Image Builder 設定を確認します。

   $ sudo composer-cli blueprints depsolve microshift_blueprint

手順

1. 次のコマンドを実行して、ostree ブループリントを編集します。

   $ vi <microshift_blueprint.toml> 

   1

   1

   <microshift_blueprint.toml> は、MicroShift サービスに使用されるブループリントファイルの名前に置き換えます。

2. 以下のサンプルテキストをブループリントに追加します。

   [[packages]] 

   1

   
   name = "<microshift-additional-package-name>" 

   2

   
   version = "*"

   1

   追加するサービスごとに 1 つのスタンザを含めます。

   2

   <microshift-additional-package-name> は、追加するサービスの RPM の名前に置き換えます。たとえば、microshift-olm です。

次のステップ

1. 必要に応じて、ブループリントにカスタム証明局を追加します。

2. ブループリントへの追加が完了したら、新しい ostree システムを構築してクライアントにデプロイすることで、マニフェストをアクティブなクラスターに適用できます。

   • ISO の作成
   • ブループリントの追加、ISO のビルド
   • ISO のダウンロードおよび使用準備
   • 必要なプロビジョニングの実行

手順

1. 次のコマンドを実行して、ostree コンテナーイメージビルドを開始します。

   $ BUILDID=$(sudo composer-cli compose start-ostree --ref "rhel/{op-system-version-major}/$(uname -m)/edge" <microshift_blueprint> edge-container | awk '/^Compose/ {print $2}') 

   1

   1

   <microshift_blueprint> は、ブループリントの名前に置き換えます。

   このコマンドは、監視対象のビルドの ID (ID) も返します。

2. 次のコマンドを実行して、ビルドのステータスを定期的に確認できます。

   $ sudo composer-cli compose status

   実行中のビルドの出力例

   ID                                     Status     Time                     Blueprint                 Version   Type               Size
   cc3377ec-4643-4483-b0e7-6b0ad0ae6332   RUNNING    Wed Jun 7 12:26:23 2023  microshift_blueprint      0.0.1     edge-container

   完了したビルドの出力例

   ID                                     Status     Time                      Blueprint              Version   Type               Size
   cc3377ec-4643-4483-b0e7-6b0ad0ae6332   FINISHED   Wed Jun 7 12:32:37 2023   microshift_blueprint   0.0.1     edge-container

   注記

   起動および停止方法を理解している場合は、watch コマンドを使用してビルドを監視できます。

3. ID を使用してコンテナーイメージをダウンロードし、次のコマンドを実行して、使用可能なイメージを取得します。

   $ sudo composer-cli compose image ${BUILDID}

4. 次のコマンドを実行して、ダウンロードしたコンテナーイメージの所有権を現在のユーザーに変更します。

   $ sudo chown $(whoami). ${BUILDID}-container.tar

5. 次のコマンドを実行して、現在のユーザーの読み取り権限をイメージに追加します。

   $ sudo chmod a+r ${BUILDID}-container.tar

6. 次の手順を実行して、ostree コンテナーイメージが ISO ビルドで使用されるようにポート 8085 でサーバーをブートストラップします。

   1. 次のコマンドを実行して、IMAGEID 変数の結果を取得します。

      $ IMAGEID=$(cat < "./${BUILDID}-container.tar" | sudo podman load | grep -o -P '(?<=sha256[@:])[a-z0-9]*')

   2. IMAGEID 変数の結果をもとに、次のコマンドを実行して podman コマンドを実行します。

      $ sudo podman run -d --name=minimal-microshift-server -p 8085:8080 ${IMAGEID}

      このコマンドは、監視用に IMAGEID 変数に保存されているコンテナーの ID も返します。

7. 次のコマンドを実行して、インストーラーブループリントファイルを生成します。

   cat > microshift-installer.toml <<EOF
   name = "microshift-installer"
   
   description = ""
   version = "0.0.0"
   modules = []
   groups = []
   packages = []
   EOF

1. 次のコマンドを実行して、Image Builder にブループリントを追加します。

   $ sudo composer-cli blueprints push microshift-installer.toml

2. 以下のコマンドを実行して ostree ISO ビルドを開始します。

   $ BUILDID=$(sudo composer-cli compose start-ostree --url http://localhost:8085/repo/ --ref "rhel/9/$(uname -m)/edge" microshift-installer edge-installer | awk '{print $2}')

   このコマンドは、監視対象のビルドの ID (ID) も返します。

3. 次のコマンドを実行して、ビルドのステータスを定期的に確認できます。

   $ sudo composer-cli compose status

   実行中のビルドの出力例

   ID                                     Status     Time                      Blueprint              Version   Type               Size
   c793c24f-ca2c-4c79-b5b7-ba36f5078e8d   RUNNING    Wed Jun 7 13:22:20 2023   microshift-installer   0.0.0     edge-installer

   完了したビルドの出力例

   ID                                     Status     Time                      Blueprint              Version   Type               Size
   c793c24f-ca2c-4c79-b5b7-ba36f5078e8d   FINISHED   Wed Jun 7 13:34:49 2023   microshift-installer   0.0.0     edge-installer

1. 以下のコマンドを実行して、ID を使用して ISO をダウンロードします。

   $ sudo composer-cli compose image ${BUILDID}

2. 次のコマンドを実行して、ダウンロードしたコンテナーイメージの所有権を現在のユーザーに変更します。

   $ sudo chown $(whoami). ${BUILDID}-installer.iso

3. 次のコマンドを実行して、現在のユーザーの読み取り権限をイメージに追加します。

   $ sudo chmod a+r ${BUILDID}-installer.iso

手順

1. デプロイする MicroShift バージョンで使用されるコンテナーイメージ参照の正確なリストを取得します。手順 2 に従って microshift-release-info RPM パッケージをインストールするか、手順 3 に従って RPM をダウンロードして展開します。

2. microshift-release-info RPM パッケージをインストールするには、以下を実行します。

   1. 次のコマンドを実行して、microshift-release-info RPM パッケージをインストールします。

      $ sudo dnf install -y microshift-release-info-<release_version>

      <release_version> は、デプロイするリリースの番号に置き換えます。完全なバージョン番号 (4.19.1 など) を使用してください。

   2. 次のコマンドを実行して、/usr/share/microshift/release ディレクトリーの内容をリスト表示し、リリース情報ファイルの存在を確認します。

      $ sudo ls /usr/share/microshift/release

      出力例

      release-x86_64.json
      release-aarch64.json

      microshift-release-info RPM をインストールした場合は、ステップ 4 に進みます。

3. 手順 2 を完了していない場合は、microshift-release-info RPM をインストールせずにダウンロードして展開します。

   1. 次のコマンドを実行して、RPM パッケージをダウンロードします。

      $ sudo dnf download microshift-release-info-<release_version> 

      1

      1

      <release_version> は、デプロイするリリースの番号に置き換えます。完全なバージョン番号 (4.19.1 など) を使用してください。

      RPM の出力例

      microshift-release-info-4.18.1.-202511101230.p0.g7dc6a00.assembly.4.18.1.el9.noarch.rpm

   2. 次のコマンドを実行して、RPM パッケージをインストールせずに展開します。

      $ rpm2cpio <my_microshift_release_info> | cpio -idmv 

      1

      
      ./usr/share/microshift/release/release-aarch64.json
      ./usr/share/microshift/release/release-x86_64.json

      1

      <my_microshift_release_info> は、前の手順の RPM パッケージの名前に置き換えます。

4. 次のコマンドを実行して、コンテナー参照情報が含まれる JSON ファイルの場所を定義します。

   $ RELEASE_FILE=</path/to/your/release-$(uname -m).json> 

   1

   1

   </path/to/your/release-$(uname -m).json> は、JSON ファイルへのフルパスに置き換えます。必ずアーキテクチャーに必要なファイルを使用してください。

5. 次のコマンドを実行して、イメージをビルドする手順が含まれる TOML ファイルの場所を定義します。

   $ BLUEPRINT_FILE=</path/to/your/blueprint.toml> 

   1

   1

   </path/to/your/blueprint.toml> は、TOML ファイルへのフルパスに置き換えます。

6. 次のコマンドを実行して、コンテナーイメージ参照を生成し、ブループリント TOML ファイルに埋め込みます。

   $  jq -r '.images | .[] | ("[[containers]]\nsource = \"" + . + "\"\n")' "${RELEASE_FILE}" >> "${BLUEPRINT_FILE}"

   コンテナー参照を示す生成された TOML フラグメントの例

   [[containers]]
   source = "quay.io/openshift-release-dev/ocp-v4.0-art-dev@sha256:82cfef91557f9a70cff5a90accba45841a37524e9b93f98a97b20f6b2b69e5db"
   
   [[containers]]
   source = "quay.io/openshift-release-dev/ocp-v4.0-art-dev@sha256:82cfef91557f9a70cff5a90accba45841a37524e9b93f98a97b20f6b2b69e5db"

7. 次の例を使用して、Image Builder のブループリントファイルに追加して、コンテナーイメージを手動で埋め込むことができます。

   コンテナーイメージをブループリントに手動で埋め込むセクションの例

   [[containers]]
   source = "<my_image_pullspec_with_tag_or_digest>"

   <my_image_pullspec_with_tag_or_digest> は、デプロイする MicroShift バージョンで使用されるコンテナーイメージへの正確な参照に置き換えます。

手順

1. /etc/osbuild-worker/osbuild-worker.toml 設定ファイルの [containers] セクションで auth_file_path を設定して、レジストリーへの認証用のプルシークレットを追加します。

   [containers]
   auth_file_path = "/etc/osbuild-worker/pull-secret.json"

2. 設定の変更を適用するには、ホストを再起動します。