安装

流程

1. 在 Storage Configuration 子部分的 Installation Destination 下的图形安装程序中，选择 Custom → Done 以打开用于配置分区和卷的对话框。此时会显示 Manual Partitioning 窗口。
2. 在 New Red Hat Enterprise Linux 9.x Installation 下，选择 Click here to create them automatically。
3. 选择根分区 /，减少 Desired Capacity，以便 VG 有足够的容量供您 PV，然后点 Update Settings。

4. 完成安装。

   注意

   有关分区配置的更多信息，请参阅配置手动分区的额外信息部分中的链接。

5. 以 root 用户身份，运行以下命令来验证系统上可用的 VG 容量：

   $ sudo vgs

   Copy to Clipboard Toggle word wrap

   输出示例：

   VG   #PV #LV #SN Attr   VSize    VFree
   rhel   1   2   0 wz--n- <127.00g 54.94g

   Copy to Clipboard Toggle word wrap

流程

1. 作为 root 用户，运行以下命令来启用 MicroShift 存储库的红帽构建：

   $ sudo subscription-manager repos \
       --enable rhocp-4.16-for-rhel-9-$(uname -m)-rpms \
       --enable fast-datapath-for-rhel-9-$(uname -m)-rpms

   Copy to Clipboard Toggle word wrap

2. 运行以下命令安装 MicroShift 的红帽构建：

   $ sudo dnf install -y microshift

   Copy to Clipboard Toggle word wrap
3. 将安装 pull secret 从 Red Hat Hybrid Cloud Console 下载到临时文件夹，例如 $HOME/openshift-pull-secret。此 pull secret 允许您与提供红帽构建 MicroShift 使用的容器镜像的容器 registry 进行身份验证。

4. 要将 pull secret 复制到 RHEL 机器的 /etc/crio 文件夹，请运行以下命令：

   $ sudo cp $HOME/openshift-pull-secret /etc/crio/openshift-pull-secret

   Copy to Clipboard Toggle word wrap

5. 运行以下命令使 /etc/crio/openshift-pull-secret 文件的所有者成为 root 用户：

   $ sudo chown root:root /etc/crio/openshift-pull-secret

   Copy to Clipboard Toggle word wrap

6. 运行以下命令，使 /etc/crio/openshift-pull-secret 文件可由 root 用户读取和写入：

   $ sudo chmod 600 /etc/crio/openshift-pull-secret

   Copy to Clipboard Toggle word wrap

7. 如果您的 RHEL 机器启用了防火墙，您必须配置几个必需的防火墙规则。对于 firewalld，运行以下命令：

   $ sudo firewall-cmd --permanent --zone=trusted --add-source=10.42.0.0/16

   Copy to Clipboard Toggle word wrap

   $ sudo firewall-cmd --permanent --zone=trusted --add-source=169.254.169.1

   Copy to Clipboard Toggle word wrap

   $ sudo firewall-cmd --reload

   Copy to Clipboard Toggle word wrap

流程

1. 使用以下方法之一访问容器镜像引用列表：

   • 如果在 MicroShift 主机上安装了软件包，请运行以下命令获取文件的位置：

     $ rpm -ql microshift-release-info

     Copy to Clipboard Toggle word wrap

     输出示例

     /usr/share/microshift/release/release-x86_64.json

     Copy to Clipboard Toggle word wrap

   • 如果 MicroShift 主机上没有安装该软件包，请运行以下命令在不安装 RPM 软件包的情况下下载并解包 RPM 软件包：

     $ rpm2cpio microshift-release-info*.noarch.rpm | cpio -idmv

     Copy to Clipboard Toggle word wrap

     输出示例

     /usr/share/microshift/release/release-x86_64.json

     Copy to Clipboard Toggle word wrap

2. 运行以下命令，将容器镜像列表提取到 microshift-container-refs.txt 文件中：

   $ RELEASE_FILE=/usr/share/microshift/release/release-$(uname -m).json

   Copy to Clipboard Toggle word wrap

   $ jq -r '.images | .[]' ${RELEASE_FILE} > microshift-container-refs.txt

   Copy to Clipboard Toggle word wrap

流程

1. 运行以下命令，安装用于复制容器镜像的 skopeo 工具：

   $ sudo dnf install -y skopeo

   Copy to Clipboard Toggle word wrap

2. 设置指向 pull secret 文件的环境变量：

   $ PULL_SECRET_FILE=~/.pull-secret-mirror.json

   Copy to Clipboard Toggle word wrap

3. 设置指向容器镜像列表的环境变量：

   $ IMAGE_LIST_FILE=~/microshift-container-refs.txt

   Copy to Clipboard Toggle word wrap

4. 设置指向用于存储下载数据的目标目录的环境变量：

   $ IMAGE_LOCAL_DIR=~/microshift-containers

   Copy to Clipboard Toggle word wrap

5. 运行以下脚本，将容器镜像下载到 ${IMAGE_LOCAL_DIR} 目录中：

   while read -r src_img ; do
      # Remove the source registry prefix
      dst_img=$(echo "${src_img}" | cut -d '/' -f 2-)
   
      # Run the image download command
      echo "Downloading '${src_img}' to '${IMAGE_LOCAL_DIR}'"
      mkdir -p "${IMAGE_LOCAL_DIR}/${dst_img}"
      skopeo copy --all --quiet \
         --preserve-digests \
         --authfile "${PULL_SECRET_FILE}" \
         docker://"${src_img}" dir://"${IMAGE_LOCAL_DIR}/${dst_img}"
   
   done < "${IMAGE_LIST_FILE}"

   Copy to Clipboard Toggle word wrap
6. 将镜像集传送到目标环境，如 air-gapped 站点。然后，您可以将镜像集上传到镜像 registry 中。

流程

1. 运行以下命令，安装用于复制容器镜像的 skopeo 工具：

   $ sudo dnf install -y skopeo

   Copy to Clipboard Toggle word wrap

2. 设置指向 pull secret 文件的环境变量：

   $ IMAGE_PULL_FILE=~/.pull-secret-mirror.json

   Copy to Clipboard Toggle word wrap

3. 设置指向本地容器镜像目录的环境变量：

   $ IMAGE_LOCAL_DIR=~/microshift-containers

   Copy to Clipboard Toggle word wrap

4. 设置指向镜像 registry URL 的环境变量，以上传容器镜像：

   $ TARGET_REGISTRY=<registry_host>:<port> 

   1

   Copy to Clipboard Toggle word wrap

   1

   将 <registry_host>:<port> 替换为镜像 registry 服务器的主机名和端口。

5. 运行以下脚本，将容器镜像上传到 ${TARGET_REGISTRY} 镜像 registry：

   image_tag=mirror-$(date +%y%m%d%H%M%S)
   image_cnt=1
      # Uses timestamp and counter as a tag on the target images to avoid
      # their overwrite by the 'latest' automatic tagging
   
   pushd "${IMAGE_LOCAL_DIR}" >/dev/null
   while read -r src_manifest ; do
      # Remove the manifest.json file name
      src_img=$(dirname "${src_manifest}")
      # Add the target registry prefix and remove SHA
      dst_img="${TARGET_REGISTRY}/${src_img}"
      dst_img=$(echo "${dst_img}" | awk -F'@' '{print $1}')
   
      # Run the image upload command
      echo "Uploading '${src_img}' to '${dst_img}'"
      skopeo copy --all --quiet \
         --preserve-digests \
         --authfile "${IMAGE_PULL_FILE}" \
         dir://"${IMAGE_LOCAL_DIR}/${src_img}" docker://"${dst_img}:${image_tag}-${image_cnt}"
      # Increment the counter
      (( image_cnt += 1 ))
   
   done < <(find . -type f -name manifest.json -printf '%P\n')
   popd >/dev/null

   Copy to Clipboard Toggle word wrap

流程

1. 登录到您的 MicroShift 主机。

2. 通过完成以下步骤，在访问镜像 registry 的任何主机上启用 SSL 证书信任：

   1. 将 rootCA.pem 文件从镜像 registry （如 < registry_path>/quay-rootCA ）复制到 /etc/pki/ca-trust/source/anchors 目录中的 MicroShift 主机。

   2. 运行以下命令，在系统范围的信任存储配置中启用证书：

      $ sudo update-ca-trust

      Copy to Clipboard Toggle word wrap

3. 创建 /etc/containers/registries.conf.d/999-microshift-mirror.conf 配置文件，将红帽 registry 主机名映射到镜像 registry：

   镜像配置文件示例

   [[registry]]
       prefix = ""
       location = "<registry_host>:<port>" 

   1

   
       mirror-by-digest-only = true
       insecure = false
   
   [[registry]]
       prefix = ""
       location = "quay.io"
       mirror-by-digest-only = true
   [[registry.mirror]]
       location = "<registry_host>:<port>"
       insecure = false
   
   [[registry]]
       prefix = ""
       location = "registry.redhat.io"
       mirror-by-digest-only = true
   [[registry.mirror]]
       location = "<registry_host>:<port>"
       insecure = false
   
   [[registry]]
       prefix = ""
       location = "registry.access.redhat.com"
       mirror-by-digest-only = true
   [[registry.mirror]]
       location = "<registry_host>:<port>"
       insecure = false

   Copy to Clipboard Toggle word wrap

   1

   将 <registry_host>:<port > 替换为镜像 registry 服务器的主机名和端口，例如 < microshift-quay:8443 >。

4. 运行以下命令来启用 MicroShift 服务：

   $ sudo systemctl enable microshift

   Copy to Clipboard Toggle word wrap

5. 运行以下命令来重启主机：

   $ sudo reboot

   Copy to Clipboard Toggle word wrap

流程

1. 运行以下命令来创建 /etc/osbuild-composer/repositories 目录：

   $ sudo mkdir -p /etc/osbuild-composer/repositories

   Copy to Clipboard Toggle word wrap

2. 运行以下命令，将 /usr/share/osbuild-composer/repositories/rhel-9.4.json 文件复制到 /etc/osbuild-composer/repositories 目录中：

   $ sudo cp /usr/share/osbuild-composer/repositories/rhel-9.4.json /etc/osbuild-composer/repositories/rhel-9.4.json

   Copy to Clipboard Toggle word wrap

3. 使用以下值修改 /etc/osbuild-composer/repositories/rhel-9.4.json 文件来更新 baseos 源：

   # ...
   "baseurl": "https://cdn.redhat.com/content/eus/rhel<9>/<9.4>//baseos/os", 

   1

   
   # ...

   Copy to Clipboard Toggle word wrap

   1

   将 <9 > 替换为您要使用的主 RHEL 版本，并将 < 9.4> 替换为 < major.minor> 版本。请确定您选择的 RHEL 版本与您使用的 MicroShift 版本兼容。

4. 可选。运行以下命令来应用 baseos 更新：

   $ sudo sed -i "s,dist/rhel<9>/<9.4>/$(uname -m)/baseos/,eus/rhel<9>/<9.4>/$(uname -m)/baseos/,g" \
   /etc/osbuild-composer/repositories/rhel-<9.4>.json 

   1

   Copy to Clipboard Toggle word wrap

   1

   将 <9 > 替换为您要使用的主 RHEL 版本，并将 < 9.4> 替换为 < major.minor> 版本。请确定您选择的 RHEL 版本与您使用的 MicroShift 版本兼容。

5. 使用以下值修改 /etc/osbuild-composer/repositories/rhel-<major.minor>.json 文件来更新 appstream 源：

   # ...
   "baseurl": "https://cdn.redhat.com/content/eus/rhel<9>/<9.4>//appstream/os", 

   1

   
   # ...

   Copy to Clipboard Toggle word wrap

   1

   将 <9 > 替换为您要使用的主 RHEL 版本，并将 < 9.4> 替换为 < major.minor> 版本。请确定您选择的 RHEL 版本与您使用的 MicroShift 版本兼容。

6. 可选。运行以下命令来应用 appstream 更新：

   $ sudo sed -i "s,dist/rhel<9>/<9.4>/$(uname -m)/appstream/,eus/rhel<9>/<9.4>/$(uname -m)/appstream/,g" \
   /etc/osbuild-composer/repositories/rhel-<9.4>.json 

   1

   Copy to Clipboard Toggle word wrap

   1

   将 <9 > 替换为您要使用的主 RHEL 版本，并将 < 9.4> 替换为 < major.minor> 版本。请确定您选择的 RHEL 版本与您使用的 MicroShift 版本兼容。

1. 运行以下命令验证 baseos 源：

   $ sudo composer-cli sources info baseos | grep 'url ='

   Copy to Clipboard Toggle word wrap

   输出示例

   url = "https://cdn.redhat.com/content/eus/rhel9/9.4/x86_64/baseos/os"

   Copy to Clipboard Toggle word wrap

2. 运行以下命令验证 appstream 源：

   $ sudo composer-cli sources info appstream | grep 'url ='

   Copy to Clipboard Toggle word wrap

   输出示例

   url = "https://cdn.redhat.com/content/eus/rhel9/9.4/x86_64/appstream/os"

   Copy to Clipboard Toggle word wrap

流程

1. 运行以下命令，创建一个镜像构建器配置文件，以添加拉取 MicroShift RPM 所需的 rhocp-4.16 RPM 存储库源：

   cat > rhocp-4.16.toml <<EOF
   id = "rhocp-4.16"
   name = "Red Hat OpenShift Container Platform 4.16 for RHEL 9"
   type = "yum-baseurl"
   url = "https://cdn.redhat.com/content/dist/layered/rhel9/$(uname -m)/rhocp/4.16/os"
   check_gpg = true
   check_ssl = true
   system = false
   rhsm = true
   EOF

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

流程

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

   Copy to Clipboard Toggle word wrap

   1

   <microshift_blueprint.toml > 是 TOML 文件的名称。

   2

   <microshift_blueprint > 是蓝图的名称。

   注意

   命令中的通配符 * 使用最新的 MicroShift RPM。如果您需要特定版本，请替换您想要的版本的通配符。例如，插入 4.16.0 以下载 MicroShift 4.16.0 RPM。

2. 可选。使用安装在您的平台架构的 /usr/share/microshift/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

   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.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

   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 蓝图：

   $ vi <microshift_blueprint.toml> 

   1

   Copy to Clipboard Toggle word wrap

   1

   将 <microshift_blueprint.toml > 替换为用于 MicroShift 服务的蓝图文件的名称。

2. 在蓝图中添加以下示例文本：

   [[packages]] 

   1

   
   name = "<microshift-additional-package-name>" 

   2

   
   version = "*"

   Copy to Clipboard Toggle word wrap

   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

   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

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

   $ sudo composer-cli blueprints push microshift-installer.toml

   Copy to Clipboard Toggle word wrap

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}')

   Copy to Clipboard Toggle word wrap

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

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

   $ sudo composer-cli compose status

   Copy to Clipboard Toggle word wrap

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

   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

   Copy to Clipboard Toggle word wrap

   已完成构建的输出示例

   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

   Copy to Clipboard Toggle word wrap

1. 运行以下命令，使用 ID 下载 ISO：

   $ sudo composer-cli compose image ${BUILDID}

   Copy to Clipboard Toggle word wrap

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

   $ sudo chown $(whoami). ${BUILDID}-installer.iso

   Copy to Clipboard Toggle word wrap

3. 运行以下命令，在镜像中为当前用户添加读取权限：

   $ sudo chmod a+r ${BUILDID}-installer.iso

   Copy to Clipboard Toggle word wrap

先决条件

1. 您已创建了一个 RHEL for Edge Installer (ISO)镜像，其中包含红帽构建的 MicroShift 的 RHEL for Edge 提交。

   1. 此要求包括编写 RFE 容器镜像的步骤，创建 RFE 安装程序蓝图、启动 RFE 容器以及制作 RFE 安装程序镜像。

2. 创建一个 Kickstart 文件或使用现有的。在 Kickstart 文件中，您必须包括：

   1. 有关如何创建用户的详细信息。
   2. 如何获取和部署 RHEL for Edge 镜像。

流程

1. 在 Kickstart 文件的主部分中，更新文件系统的设置，以便它包含一个名为 rhel 的 LVM 卷组，至少有 10GB 系统 root。LVMS CSI 驱动程序保留可用空间，用于存储您的工作负载的数据。

   用于配置文件系统的 kickstart 片段示例

   # Partition disk such that it contains an LVM volume group called `rhel` with a
   # 10GB+ system root but leaving free space for the LVMS CSI driver for storing data.
   #
   # For example, a 20GB disk would be partitioned in the following way:
   #
   # NAME          MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
   # sda             8:0    0  20G  0 disk
   # ├─sda1          8:1    0 200M  0 part /boot/efi
   # ├─sda1          8:1    0 800M  0 part /boot
   # └─sda2          8:2    0  19G  0 part
   #  └─rhel-root  253:0    0  10G  0 lvm  /sysroot
   #
   ostreesetup --nogpg --osname=rhel --remote=edge \
   --url=file:///run/install/repo/ostree/repo --ref=rhel/<RHEL VERSION NUMBER>/x86_64/edge
   zerombr
   clearpart --all --initlabel
   part /boot/efi --fstype=efi --size=200
   part /boot --fstype=xfs --asprimary --size=800
   # Uncomment this line to add a SWAP partition of the recommended size
   #part swap --fstype=swap --recommended
   part pv.01 --grow
   volgroup rhel pv.01
   logvol / --vgname=rhel --fstype=xfs --size=10000 --name=root
   # To add users, use a line such as the following
   user --name=<YOUR_USER_NAME> \
   --password=<YOUR_HASHED_PASSWORD> \
   --iscrypted --groups=<YOUR_USER_GROUPS>

   Copy to Clipboard Toggle word wrap

2. 在 Kickstart 文件的 %post 部分中，添加您的 pull secret 和强制防火墙规则。

   添加 pull secret 和防火墙规则的 Kickstart 片断示例

   %post --log=/var/log/anaconda/post-install.log --erroronfail
   
   # Add the pull secret to CRI-O and set root user-only read/write permissions
   cat > /etc/crio/openshift-pull-secret << EOF
   YOUR_OPENSHIFT_PULL_SECRET_HERE
   EOF
   chmod 600 /etc/crio/openshift-pull-secret
   
   # Configure the firewall with the mandatory rules for MicroShift
   firewall-offline-cmd --zone=trusted --add-source=10.42.0.0/16
   firewall-offline-cmd --zone=trusted --add-source=169.254.169.1
   
   %end

   Copy to Clipboard Toggle word wrap

3. 运行以下命令安装 mkksiso 工具：

   $ sudo yum install -y lorax

   Copy to Clipboard Toggle word wrap

4. 运行以下命令，使用您的新 Kickstart 文件更新 ISO 中的 Kickstart 文件：

   $ sudo mkksiso <your_kickstart>.ks <your_installer>.iso <updated_installer>.iso

   Copy to Clipboard Toggle word wrap

流程

1. 获取您要部署的 MicroShift 版本使用的容器镜像引用列表。您可以按照以下步骤 2 安装 microshift-release-info RPM 软件包，或者按照以下步骤 3 下载并解包 RPM。

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

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

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

      Copy to Clipboard Toggle word wrap

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

   2. 运行以下命令，列出 /usr/share/microshift/release 目录的内容，以验证发行信息文件是否存在：

      $ ls /usr/share/microshift/release

      Copy to Clipboard Toggle word wrap

      输出示例

      release-x86_64.json
      release-aarch64.json

      Copy to Clipboard Toggle word wrap

      如果安装了 microshift-release-info RPM，您可以继续第 4 步。

3. 如果您没有完成第 2 步，请下载并解包 microshift-release-info RPM，而不安装它：

   1. 运行以下命令来下载 RPM 软件包：

      $ sudo dnf download microshift-release-info-<release_version>

      Copy to Clipboard Toggle word wrap

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

      rpm 示例

      microshift-release-info-4.16.0.*.el9.noarch.rpm 

      1

      Copy to Clipboard Toggle word wrap

      1

      * 代表日期和提交 ID。您的输出应同时包含 example -202311101230.p0.g7dc6a00.assembly.4.16.0。

   2. 运行以下命令，在不安装 RPM 软件包的情况下解包 RPM 软件包：

      $ rpm2cpio <my_microshift_release_info> | cpio -idmv 

      1

      
      ./usr/share/microshift/release/release-aarch64.json
      ./usr/share/microshift/release/release-x86_64.json

      Copy to Clipboard Toggle word wrap

      1

      将 <my_microshift_release_info > 替换为上一步中的 RPM 软件包的名称。

4. 运行以下命令，定义包含容器引用信息的 JSON 文件的位置：

   $ RELEASE_FILE=</path/to/your/release-$(uname -m).json>

   Copy to Clipboard Toggle word wrap

   将 </path/to/your/release-$(uname -m).json > 替换为 JSON 文件的完整路径。确保使用您的架构所需的文件。

5. 运行以下命令，定义 TOML 文件的位置，其中包含构建镜像的说明：

   $ BLUEPRINT_FILE=</path/to/your/blueprint.toml>

   Copy to Clipboard Toggle word wrap

   将 </path/to/your/blueprint.toml > 替换为 JSON 文件的完整路径。

6. 运行以下命令，然后在蓝图 TOML 文件中嵌入容器镜像引用：

   $  jq -r '.images | .[] | ("[[containers]]\nsource = \"" + . + "\"\n")' "${RELEASE_FILE}" >> "${BLUEPRINT_FILE}"

   Copy to Clipboard Toggle word wrap

   生成的 &lt ;my_blueprint.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"

   Copy to Clipboard Toggle word wrap

7. 您可以使用以下示例手动将任何容器镜像添加到镜像构建器蓝图中：

   手动将容器镜像嵌入到镜像构建器的部分示例

   [[containers]]
   source = "<my_image_pullspec_with_tag_or_digest>"

   Copy to Clipboard Toggle word wrap

   将 <my_image_pullspec_with_tag_or_digest > 替换为您要部署的 MicroShift 版本使用的容器镜像的确切引用。

流程

1. 通过在 /etc/osbuild-worker/osbuild-worker.toml osbuilder worker 配置文件的 [containers] 部分中设置 auth_file_path，添加用于向 registry 进行身份验证的 pull secret：

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

   Copy to Clipboard Toggle word wrap
2. 重启 osbuild-worker，通过重启主机来应用配置更改。重启主机可确保当前运行的所有 osbuild-worker 服务都已重启。

1. 系统如预期：当 required.d 目录中的所有脚本都成功运行时，greenboot 会运行 /etc/greenboot/green.d 目录中存在的任何脚本。
2. 系统问题：如果 required.d 目录中任何脚本失败，greenboot 会运行 red.d 目录中存在的任何预滚动脚本，然后重新启动系统。

流程

1. 运行以下命令制作目录：

   $ sudo mkdir -p /etc/systemd/journald.conf.d

   Copy to Clipboard Toggle word wrap

2. 运行以下命令来创建配置文件：

   cat <<EOF | sudo tee /etc/systemd/journald.conf.d/microshift.conf &>/dev/null
   [Journal]
   Storage=persistent
   SystemMaxUse=1G
   RuntimeMaxUse=1G
   EOF

   Copy to Clipboard Toggle word wrap
3. 根据您的大小要求编辑配置文件值。