嵌入 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

   如果与本例中的值不同，您可以使用的主 RHEL 版本替换 9，并将 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

   如果与本例中的值不同，您可以使用的主 RHEL 版本替换 9，并将 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

   如果与本例中的值不同，您可以使用的主 RHEL 版本替换 9，并将 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

   如果与本例中的值不同，您可以使用的主 RHEL 版本替换 9，并将 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 存储库源：

   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 存储库：

   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. 运行以下命令，将源添加到镜像构建器中：

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

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

流程

1. 使用安装在您的平台架构的 /usr/share/microshift/blueprint 目录中安装的蓝图。有关蓝图部分的说明，请参见以下示例片断：

   生成的镜像构建器蓝图示例片断

   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. 运行以下命令，将蓝图添加到镜像构建器中：

   $ sudo composer-cli blueprints push microshift_blueprint.toml

验证

1. 运行以下命令，验证镜像构建器配置只列出 MicroShift 软件包：

   $ 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. 可选：运行以下命令来验证镜像构建器配置，该配置列出了要安装的所有组件：

   $ 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

   为每个要添加的其他服务包含一个小节。

   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)。

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. 通过完成以下步骤，在端口 8085 上引导要被 ISO 构建使用的 ostree 容器镜像的服务器：

   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. 运行以下命令，将蓝图添加到镜像构建器中：

   $ 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)。

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 软件包，或按照以下步骤下载并解包 RPM。

2. 安装 microshift-release-info RPM 软件包：

   1. 运行以下命令安装 microshift-release-info RPM 软件包：

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

      使用整个版本号（如 4.19.1） 将 < release_version > 替换为您要部署的发行版本的数字值。

   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

      使用整个版本号（如 4.19.1） 将 < release_version > 替换为您要部署的发行版本的数字值。

      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. 您可以使用以下示例将其添加到镜像构建器蓝图文件中来手动嵌入任何容器镜像：

   将容器镜像手动嵌入到蓝图中的示例

   [[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 来添加用于向 registry 进行身份验证的 pull secret：

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

2. 重启主机以应用配置更改。