安装

流程

1. 在 Storage Configuration 下的图形安装程序中，选择 Custom → Done 打开用于配置分区和卷的对话框。
2. 在 New Red Hat Enterprise Linux 8.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.12-for-rhel-8-$(uname -i)-rpms \
       --enable fast-datapath-for-rhel-8-$(uname -i)-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. 作为 root 用户，输入以下命令启动 MicroShift 服务的红帽构建：

   $ sudo systemctl start microshift

   Copy to Clipboard Toggle word wrap

2. 可选： 要将 RHEL 机器配置为在机器启动时启动 MicroShift 的红帽构建，请输入以下命令：

   $ sudo systemctl enable microshift

   Copy to Clipboard Toggle word wrap

3. 可选： 要在机器启动时自动启动 MicroShift 的红帽构建，请输入以下命令：

   $ sudo systemctl disable microshift

   Copy to Clipboard Toggle word wrap
   注意

   红帽构建的 MicroShift 服务首次启动时，它会下载并初始化 MicroShift 的容器镜像的红帽构建。因此，红帽构建 MicroShift 可能需要几分钟才能首次部署该服务。后续开始 MicroShift 服务的红帽构建会减少引导时间。

流程

1. 输入以下命令停止 MicroShift 服务的红帽构建：

   $ sudo systemctl stop microshift

   Copy to Clipboard Toggle word wrap

2. 在 MicroShift 的红帽构建上部署的工作负载将继续运行，即使红帽构建的 MicroShift 服务已被停止。输入以下命令显示正在运行的工作负载：

   $ sudo crictl ps -a

   Copy to Clipboard Toggle word wrap

3. 输入以下命令停止部署的工作负载：

   $ sudo systemctl stop kubepods.slice

   Copy to Clipboard Toggle word wrap

流程

1. 运行以下命令，在构建主机上启用 MicroShift RPM 存储库的红帽构建：

   $ sudo subscription-manager repos
       --enable rhocp-4.12-for-rhel-8-$(uname -i)-rpms
       --enable fast-datapath-for-rhel-8-$(uname -i)-rpms

   Copy to Clipboard Toggle word wrap

2. 运行以下命令安装 reposync 和 createrepo 工具：

   $ sudo yum install -y yum-utils createrepo

   Copy to Clipboard Toggle word wrap

3. 运行以下命令，将 MicroShift RPM 软件包的红帽构建同步到构建主机上：

   $ sudo reposync --arch=$(uname -i) --arch=noarch --gpgcheck \
       --download-path /var/repos/microshift-local \
       --repo=rhocp-4.12-for-rhel-8-$(uname -i)-rpms \
       --repo=fast-datapath-for-rhel-8-$(uname -i)-rpms

   Copy to Clipboard Toggle word wrap

4. 删除 coreos 软件包以避免出现冲突：

   $ sudo find ${REPO_PATH}/microshift-local -name \*coreos\* -exec rm -f {} \;

   Copy to Clipboard Toggle word wrap

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

   $ sudo createrepo ${REPO_PATH}/microshift-local

   Copy to Clipboard Toggle word wrap

6. 运行以下命令，为这个存储库创建镜像构建器源文件：

   $ sudo tee ${REPO_PATH}/microshift-local/microshift.toml > /dev/null <<EOF
   id = "microshift-local"
   name = "MicroShift local repo"
   type = "yum-baseurl"
   url = "file:///${REPO_PATH}/microshift-local/"
   check_gpg = false
   check_ssl = false
   system = false
   EOF

   Copy to Clipboard Toggle word wrap

7. 运行以下命令，将这个源文件添加到 Image Builder 中：

   $ sudo composer-cli sources add ${REPO_PATH}/microshift-local/microshift.toml

   Copy to Clipboard Toggle word wrap

先决条件

1. 您已创建了包含带有红帽构建的 MicroShift 的 RHEL for Edge 提交的 RHEL for Edge 安装程序(ISO)镜像。

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

   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