第4章 Red Hat build of MicroShift アプリケーションの埋め込みのチュートリアル

1. MicroShift を RHEL for Edge に埋め込むために、MicroShift リポジトリーを Image Builder に追加しました。
2. MicroShift の追加など、必要なすべての RPM、コンテナーイメージ、ファイル、およびカスタマイズを宣言するブループリントを作成しました。
3. ブループリントを Image Builder に追加し、Image Builder CLI ツール (composer-cli) を使用してビルドを実行しました。この手順では、コンテナーイメージの作成に使用される rpm-ostree コミットを作成しました。このイメージには RHEL for Edge が含まれていました。
4. インストーラーブループリントを Image Builder に追加して、起動元の rpm-ostree イメージ (ISO) を作成しました。このビルドには、RHEL for Edge と MicroShift の両方が含まれていました。
5. MicroShift が埋め込まれた ISO をダウンロードし、使用できるように準備し、プロビジョニングして、エッジデバイスにインストールしました。

手順

1. rpmbuild ツールをインストールし、以下のコマンドを実行してその yum リポジトリーを作成します。

   $ sudo dnf install rpmdevtools rpmlint yum-utils createrepo

2. 次のコマンドを実行して、RPM パッケージの構築に必要なファイルツリーを作成します。

   $ rpmdev-setuptree

手順

1. ~/rpmbuild/SPECS ディレクトリーに、次のテンプレートを使用して <application_workload_manifests.spec> などのファイルを作成します。

   仕様ファイルの例

   Name: <application_workload_manifests>
   Version: 0.0.1
   Release: 1%{?dist}
   Summary: Adds workload manifests to microshift
   BuildArch: noarch
   License: GPL
   Source0: %{name}-%{version}.tar.gz
   #Requires: microshift
   %description
   Adds workload manifests to microshift
   %prep
   %autosetup
   %install 1
   rm -rf $RPM_BUILD_ROOT
   mkdir -p $RPM_BUILD_ROOT/%{_prefix}/lib/microshift/manifests
   cp -pr ~/manifests $RPM_BUILD_ROOT/%{_prefix}/lib/microshift/
   %clean
   rm -rf $RPM_BUILD_ROOT
   
   %files
   %{_prefix}/lib/microshift/manifests/**
   %changelog
   * <DDD MM DD YYYY username@domain - V major.minor.patch>
   - <your_change_log_comment>

   1

   %install セクションは、RPM パッケージ内にターゲットディレクトリー /usr/lib/microshift/manifests/ を作成し、ソースホームディレクトリー ~/manifests からマニフェストをコピーします。

   重要

   必要な YAML ファイルはすべて、ソースホームディレクトリー ~/manifests に置かれている必要があります (kustomize を使用している場合は kustomize.yaml ファイルも含まれます)。

2. 以下のコマンドを実行して、~/rpmbuild/RPMS ディレクトリーに RPM パッケージをビルドします。

   $ rpmbuild -bb ~/rpmbuild/SPECS/<application_workload_manifests.spec>

手順

1. 次のコマンドを実行して、ローカル RPM リポジトリーを作成します。

   $ createrepo ~/rpmbuild/RPMS/

2. 次のコマンドを実行して、Image Builder に RPM リポジトリーへのアクセス権限を付与します。

   $ sudo chmod a+rx ~

   注記

   イメージ構築に必要なファイル全てにアクセスする必須のパーミッションが Image Builder に割り当てられている必要があります。そうでないと、ビルドを続行できません。

3. 次のテンプレートを使用して、ブループリントファイル repo-local-rpmbuild.toml を作成します。

   id = "local-rpm-build"
   name = "RPMs build locally"
   type = "yum-baseurl"
   url = "file://<path>/rpmbuild/RPMS" 1
   check_gpg = false
   check_ssl = false
   system = false

   1

   選択したロケーションを作成するパスの一部を指定します。後のコマンドでこのパスを使用して、リポジトリーを設定し、RPM をコピーします。

4. 次のコマンドを実行して、Image Builder のソースとしてリポジトリーを追加します。

   $ sudo composer-cli sources add repo-local-rpmbuild.toml

5. 以下の行を追加して、RPM をブループリントに追加します。

   …
   [[packages]]
   name = "<application_workload_manifests>" 1
   version = "*"
   …

   1

   ワークロードの名前をここに追加します。

6. 次のコマンドを実行して、更新されたブループリントを Image Builder にプッシュします。

   $ sudo composer-cli blueprints push repo-local-rpmbuild.toml

7. この時点で、Image Builder を実行して ISO を作成するか、オフラインで使用するためにコンテナーイメージを埋め込むことができます。

   1. ISO を作成するには、次のコマンドを実行して Image Builder を起動します。

      $ sudo composer-cli compose start-ostree repo-local-rpmbuild edge-commit