5.5. 构建并使用 rpm-ostree 镜像进行离线部署

流程

1. 使用以下示例创建自己的蓝图文件：

   自定义镜像构建器蓝图示例

   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。如果您需要特定版本，请替换您想要版本的通配符。例如，插入 4.16.0 以下载 MicroShift 4.16.0 RPM。

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

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

   name = "microshift_blueprint"
   description = "MicroShift 4.16.1 on x86_64 platform"
   version = "0.0.1"
   modules = []
   groups = []
   
   [[packages]] 1
   name = "microshift"
   version = "4.16.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. 运行以下命令，将蓝图添加到镜像构建器中：

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

   1

   将 <microshift_blueprint.toml > 替换为 TOML 文件的名称。

验证

1. 运行以下命令，验证 Image Builder 配置只列出 MicroShift 软件包：

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

   1

   将 <microshift_blueprint > 替换为蓝图的名称。

   输出示例

   blueprint: microshift_blueprint v0.0.1
       microshift-greenboot-4.16.1-202305250827.p0.g4105d3b.assembly.4.16.1.el9.noarch
       microshift-networking-4.16.1-202305250827.p0.g4105d3b.assembly.4.16.1.el9.x86_64
       microshift-release-info-4.16.1-202305250827.p0.g4105d3b.assembly.4.16.1.el9.noarch
       microshift-4.16.1-202305250827.p0.g4105d3b.assembly.4.16.1.el9.x86_64
       microshift-selinux-4.16.1-202305250827.p0.g4105d3b.assembly.4.16.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)。

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