使用 RHEL 镜像模式安装

流程

1. 创建一个包含以下指令的 Containerfile ：

   RHEL 镜像模式的 Containerfile 示例

   FROM registry.redhat.io/rhel9/rhel-bootc:9.4
   
   ARG USHIFT_VER=4.17
   RUN dnf config-manager \
           --set-enabled rhocp-${USHIFT_VER}-for-rhel-9-$(uname -m)-rpms \
           --set-enabled fast-datapath-for-rhel-9-$(uname -m)-rpms
   RUN dnf install -y firewalld microshift && \
       systemctl enable microshift && \
       dnf clean all
   
   # Create a default 'redhat' user with the specified password.
   # Add it to the 'wheel' group to allow for running sudo commands.
   ARG USER_PASSWD
   RUN if [ -z "${USER_PASSWD}" ] ; then \
           echo USER_PASSWD is a mandatory build argument && exit 1 ; \
       fi
   RUN useradd -m -d /var/home/redhat -G wheel redhat && \
       echo "redhat:${USER_PASSWD}" | chpasswd
   
   # Mandatory firewall configuration
   RUN firewall-offline-cmd --zone=public --add-port=22/tcp && \
       firewall-offline-cmd --zone=trusted --add-source=10.42.0.0/16 && \
       firewall-offline-cmd --zone=trusted --add-source=169.254.169.1
   
   # Create a systemd unit to recursively make the root filesystem subtree
   # shared as required by OVN images
   RUN cat > /etc/systemd/system/microshift-make-rshared.service <<'EOF'
   [Unit]
   Description=Make root filesystem shared
   Before=microshift.service
   ConditionVirtualization=container
   [Service]
   Type=oneshot
   ExecStart=/usr/bin/mount --make-rshared /
   [Install]
   WantedBy=multi-user.target
   EOF
   RUN systemctl enable microshift-make-rshared.service

   Copy to Clipboard Toggle word wrap

   重要

   在构建容器镜像时，Podman 使用容器内的主机订阅信息和存储库。如果主机上没有 rhocp 和 fast-datapath 存储库，则构建会失败。

2. 运行以下 image build 命令创建本地 bootc 镜像：

   PULL_SECRET=~/.pull-secret.json
   USER_PASSWD=<your_redhat_user_password> 

   1

   
   IMAGE_NAME=microshift-4.17-bootc
   
   $ sudo podman build --authfile "${PULL_SECRET}" -t "${IMAGE_NAME}" \
       --build-arg USER_PASSWD="${USER_PASSWD}" \
       -f Containerfile

   Copy to Clipboard Toggle word wrap

   1

   将 <your_redhat_user_password& gt; 替换为您的密码。

   注意

   在镜像构建过程中如何使用 secret：

   • 需要 podman-- authfile 参数从 registry.redhat.io registry 中拉取基础 rhel-bootc:9.4 镜像。
   • build USER_PASSWD 参数用于为 redhat 用户设置密码。

验证

1. 运行以下命令验证本地 bootc 镜像是否已创建：

   $ sudo podman images "${IMAGE_NAME}"

   Copy to Clipboard Toggle word wrap

   输出示例

   REPOSITORY                       TAG         IMAGE ID      CREATED        SIZE
   localhost/microshift-4.17-bootc  latest      193425283c00  2 minutes ago  2.31 GB

   Copy to Clipboard Toggle word wrap

流程

1. 运行以下命令登录到您的远程 registry：

   REGISTRY_URL=quay.io
   
   $ sudo podman login "${REGISTRY_URL}" 

   1

   Copy to Clipboard Toggle word wrap

   1

   将 REGISTRY_URL 替换为您的 registry 的 URL。

2. 运行以下命令来发布镜像：

   REGISTRY_IMG=<myorg/mypath>/"${IMAGE_NAME}" 

   1

   2

   
   IMAGE_NAME=<microshift-4.17-bootc> 

   3

   
   
   $ sudo podman push localhost/"${IMAGE_NAME}" "${REGISTRY_URL}/${REGISTRY_IMG}"

   Copy to Clipboard Toggle word wrap

   1

   将 <myorg/mypath > 替换为您的远程 registry 机构名称和路径。

   2

   将 <microshift-4.17-bootc > 替换为您要发布的镜像的名称。

验证

1. 使用推送到 registry 的镜像运行容器，如 "Running the MicroShift bootc container" 部分所述。

流程

1. 输入以下命令为 MicroShift 服务运行容器：

   PULL_SECRET=~/.pull-secret.json
   IMAGE_NAME=microshift-4.17-bootc
   
   $ sudo podman run --rm -it --privileged \
       -v "${PULL_SECRET}":/etc/crio/openshift-pull-secret:ro \
       -v /var/lib/containers/storage:/var/lib/containers/storage \
       --name "${IMAGE_NAME}" \
       "${IMAGE_NAME}"

   Copy to Clipboard Toggle word wrap
   注意

   如果主机内核版本与 bootc 镜像内核版本不同，systemd-modules-load 服务将无法在容器中启动。可以安全地忽略此故障，因为主机已加载了所有必要的内核模块。

2. MicroShift 启动后，终端会显示登录提示。
3. 使用您的用户凭据登录正在运行的容器。

4. 运行以下命令，验证所有 MicroShift pod 是否正在运行，且没有错误：

   $ watch sudo oc get pods -A \
       --kubeconfig /var/lib/microshift/resources/kubeadmin/kubeconfig

   Copy to Clipboard Toggle word wrap

   输出示例

   NAMESPACE                  NAME                                       READY   STATUS    RESTARTS      AGE
   kube-system                csi-snapshot-controller-7cfb9df49c-kc9dx   1/1     Running   0             31s
   kube-system                csi-snapshot-webhook-5c6b978878-jzk5r      1/1     Running   0             28s
   openshift-dns              dns-default-rpnlt                          2/2     Running   0             14s
   openshift-dns              node-resolver-rxvdk                        1/1     Running   0             31s
   openshift-ingress          router-default-69cd7b5545-7zcw7            1/1     Running   0             29s
   openshift-ovn-kubernetes   ovnkube-master-c7hlh                       4/4     Running   1 (16s ago)   31s
   openshift-ovn-kubernetes   ovnkube-node-mkpht                         1/1     Running   1 (17s ago)   31s
   openshift-service-ca       service-ca-5d5d96459d-5pd5s                1/1     Running   0             28s
   openshift-storage          topolvm-controller-677cbfcdb9-28dqr        5/5     Running   0             31s
   openshift-storage          topolvm-node-6fzbl                         3/3     Running   0             14s

   Copy to Clipboard Toggle word wrap

5. 现在，您可以使用在容器中运行的 MicroShift，与使用任何其他 MicroShift 集群一样。

流程

1. 使用以下命令清理 loop 设备和其他卷组：

   1. 输入以下命令分离 loop 设备：

      $ sudo losetup -d "${VGLOOP}"

      Copy to Clipboard Toggle word wrap

   2. 输入以下命令删除 LVM 卷组文件：

      $ sudo rm -f "${VGFILE}"

      Copy to Clipboard Toggle word wrap