5.5. オフラインデプロイ用の rpm-ostree イメージのビルドと使用

手順

1. 次の例を使用して、独自のブループリントファイルを作成します。

   Custom Image Builder ブループリントの例

   cat > <microshift_blueprint.toml> <<EOF 1
   name = "<microshift_blueprint>" 2
   
   description = ""
   version = "0.0.1"
   modules = []
   groups = []
   
   [[packages]]
   name = "microshift"
   version = "*"
   
   [customizations.services]
   enabled = ["microshift"]
   EOF

   1

   <microshift_blueprint.toml> は TOML ファイルの名前です。

   2

   <microshift_blueprint> はブループリントの名前です。

   注記

   コマンドのワイルドカード * は、最新の MicroShift RPM を使用します。特定のバージョンが必要な場合は、ワイルドカードを必要なバージョンに置き換えます。たとえば、MicroShift 4.15.0 RPM をダウンロードするには、4.15.0 を挿入します。

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

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

   name = "microshift_blueprint"
   description = "MicroShift 4.15.1 on x86_64 platform"
   version = "0.0.1"
   modules = []
   groups = []
   
   [[packages]] 1
   name = "microshift"
   version = "4.15.1"
   ...
   ...
   
   [customizations.services] 2
   enabled = ["microshift"]
   
   [customizations.firewall]
   ports = ["22:tcp", "80:tcp", "443:tcp", "5353:udp", "6443:tcp", "30000-32767:tcp", "30000-32767:udp"]
   ...
   ...
   
   [[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 コンテナーイメージの参照。

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

   $ sudo composer-cli blueprints push <microshift_blueprint.toml> 1

   1

   <microshift_blueprint.toml> を TOML ファイルの名前に置き換えます。

検証

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

   $ sudo composer-cli blueprints depsolve <microshift_blueprint> | grep microshift 1

   1

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

   出力例

   blueprint: microshift_blueprint v0.0.1
       microshift-greenboot-4.15.1-202305250827.p0.g4105d3b.assembly.4.15.1.el9.noarch
       microshift-networking-4.15.1-202305250827.p0.g4105d3b.assembly.4.15.1.el9.x86_64
       microshift-release-info-4.15.1-202305250827.p0.g4105d3b.assembly.4.15.1.el9.noarch
       microshift-4.15.1-202305250827.p0.g4105d3b.assembly.4.15.1.el9.x86_64
       microshift-selinux-4.15.1-202305250827.p0.g4105d3b.assembly.4.15.1.el9.noarch

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

   $ sudo composer-cli blueprints depsolve <microshift_blueprint> 1

   1

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

手順

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

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