第 4 章 嵌入 MicroShift 应用程序教程

1. 要在 RHEL for Edge 上嵌入 MicroShift，请将 MicroShift 存储库添加到 Image Builder 中。
2. 您创建了声明所有 RPM、容器镜像、文件和自定义的蓝图，包括添加 MicroShift。
3. 将蓝图添加到镜像构建器中，并使用 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 目录中，使用以下模板创建一个文件，如 & lt;application_workload_manifests.spec > ：

   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.yaml 文件，包括 kustomize.yaml 文件。

2. 运行以下命令，在 ~/rpmbuild/RPMS 目录中构建 RPM 软件包：

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

流程

1. 运行以下命令来创建本地 RPM 存储库：

   $ createrepo ~/rpmbuild/RPMS/

2. 运行以下命令，授予镜像构建器对 RPM 存储库的访问权限：

   $ sudo chmod a+rx ~

   注意

   您必须确保镜像构建器具有访问镜像构建所需的所有文件的所有必要权限，或者无法继续构建。

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. 运行以下命令，将存储库添加为镜像构建器的源：

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

5. 通过添加以下行来在蓝图中添加 RPM：

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

   1

   在此处添加工作负载的名称。

6. 运行以下命令，将更新的蓝图推送到镜像构建器：

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

7. 此时，您可以运行镜像构建器来创建 ISO，或嵌入容器镜像以离线使用。

   1. 要创建 ISO，请运行以下命令启动镜像构建器：

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