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

流程

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

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

   cat > <microshift_blueprint.toml> <<EOF 

   1

   
   name = "<microshift_blueprint>" 

   2

   
   
   description = ""
   version = "0.0.1"
   modules = []
   groups = []
   
   [[packages]]
   name = "microshift"
   version = "4.18.1" 

   3

   
   
   [customizations.services]
   enabled = ["microshift"]
   EOF

   Copy to Clipboard Toggle word wrap

   1

   TOML 文件的名称。

   2

   蓝图的名称。

   3

   替换您想要的版本的值。例如，插入 4.18.1 以下载 MicroShift 4.18.1 RPM。

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

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

   name = "microshift_blueprint"
   description = "MicroShift 4.17.1 on x86_64 platform"
   version = "0.0.1"
   modules = []
   groups = []
   
   [[packages]] 

   1

   
   name = "microshift"
   version = "4.17.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

   Copy to Clipboard Toggle word wrap

   1

   使用与 microshift-release-info RPM 兼容的同一版本，所有非可选 MicroShift RPM 软件包的引用。

   2

   有关在系统引导时自动启用 MicroShift 并应用默认网络设置的引用。

   3

   对离线部署所需的所有非可选 MicroShift 容器镜像的引用。

3. 运行以下命令，将蓝图添加到镜像构建器中：

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

   1

   Copy to Clipboard Toggle word wrap

   1

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

验证

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

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

   1

   Copy to Clipboard Toggle word wrap

   1

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

   输出示例

   blueprint: microshift_blueprint v0.0.1
       microshift-greenboot-4.17.1-202305250827.p0.g4105d3b.assembly.4.17.1.el9.noarch
       microshift-networking-4.17.1-202305250827.p0.g4105d3b.assembly.4.17.1.el9.x86_64
       microshift-release-info-4.17.1-202305250827.p0.g4105d3b.assembly.4.17.1.el9.noarch
       microshift-4.17.1-202305250827.p0.g4105d3b.assembly.4.17.1.el9.x86_64
       microshift-selinux-4.17.1-202305250827.p0.g4105d3b.assembly.4.17.1.el9.noarch

   Copy to Clipboard Toggle word wrap

2. 可选：通过运行以下命令验证镜像构建器配置列出了要安装的所有组件：

   $ sudo composer-cli blueprints depsolve <microshift_blueprint> 

   1

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

   1

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

   此命令还会返回用于监控构建的标识(ID)。

2. 您可以运行以下命令来定期检查构建的状态：

   $ sudo composer-cli compose status

   Copy to Clipboard Toggle word wrap

   正在运行的构建的输出示例

   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

   Copy to Clipboard Toggle word wrap

   已完成的构建的输出示例

   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

   Copy to Clipboard Toggle word wrap

   注意

   如果您熟悉如何启动和停止构建，您可以使用 watch 命令来监控您的构建。

3. 运行以下命令，使用 ID 下载容器镜像并使镜像可供使用：

   $ sudo composer-cli compose image ${BUILDID}

   Copy to Clipboard Toggle word wrap

4. 运行以下命令，将下载的容器镜像的所有权更改为当前用户：

   $ sudo chown $(whoami). ${BUILDID}-container.tar

   Copy to Clipboard Toggle word wrap

5. 运行以下命令，将当前用户的读取权限添加到镜像中：

   $ sudo chmod a+r ${BUILDID}-container.tar

   Copy to Clipboard Toggle word wrap

6. 通过完成以下步骤，在端口 8085 上引导要被 ISO 构建使用的 ostree 容器镜像的服务器：

   1. 运行以下命令来获取 IMAGEID 变量结果：

      $ IMAGEID=$(cat < "./${BUILDID}-container.tar" | sudo podman load | grep -o -P '(?<=sha256[@:])[a-z0-9]*')

      Copy to Clipboard Toggle word wrap

   2. 运行以下命令，使用 IMAGEID 变量结果来执行 podman 命令步骤：

      $ sudo podman run -d --name=minimal-microshift-server -p 8085:8080 ${IMAGEID}

      Copy to Clipboard Toggle word wrap

      此命令还会返回保存在 IMAGEID 变量中用于监控的容器 ID。

7. 运行以下命令来生成安装程序蓝图文件：

   cat > microshift-installer.toml <<EOF
   name = "microshift-installer"
   
   description = ""
   version = "0.0.0"
   modules = []
   groups = []
   packages = []
   EOF

   Copy to Clipboard Toggle word wrap