第 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. 将安装程序蓝图添加到镜像构建器中，以创建 rpm-ostree 镜像(ISO)来从其引导。此构建包含 RHEL for Edge 和 MicroShift。
5. 下载了使用 MicroShift 嵌入的 ISO，准备好使用、置备它，然后将其安装到边缘设备中。

流程

1. 运行以下命令，安装 rpmbuild 工具并为其创建 yum 存储库：

   $ sudo dnf install rpmdevtools rpmlint yum-utils createrepo

   Copy to Clipboard Toggle word wrap

2. 运行以下命令，创建构建 RPM 软件包所需的文件树：

   $ rpmdev-setuptree

   Copy to Clipboard Toggle word wrap

流程

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>

   Copy to Clipboard Toggle word wrap

   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>

   Copy to Clipboard Toggle word wrap

流程

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

   $ createrepo ~/rpmbuild/RPMS/

   Copy to Clipboard Toggle word wrap

2. 运行以下命令，为 Image Builder 授予对 RPM 存储库的访问权限：

   $ sudo chmod a+rx ~

   Copy to Clipboard Toggle word wrap
   注意

   您必须确保 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

   Copy to Clipboard Toggle word wrap

   1

   指定创建您选择的位置的路径部分。在后续命令中使用此路径来设置存储库并复制 RPM。

4. 运行以下命令，将存储库添加为镜像构建器的源：

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

   Copy to Clipboard Toggle word wrap

5. 通过添加以下几行，将 RPM 添加到蓝图中：

   …
   [[packages]]
   name = "<application_workload_manifests>" 

   1

   
   version = "*"
   …

   Copy to Clipboard Toggle word wrap

   1

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

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

      Copy to Clipboard Toggle word wrap