RHEL Image Mode を使用したインストール

手順

1. 以下の命令を含む Containerfile を作成します。

   RHEL Image mode の Containerfile の例

   Copy to Clipboard Toggle word wrap

   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

   重要

   Podman は、コンテナーイメージをビルドするときに、コンテナー内のホストのサブスクリプション情報とリポジトリーを使用します。rhocp および fast-datapath リポジトリーがホスト上で利用できないと、ビルドは失敗します。

2. 次のイメージビルドコマンドを実行して、ローカル bootc イメージを作成します。

   Copy to Clipboard Toggle word wrap

   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

   1

   <your_redhat_user_password> を自分のパスワードに置き換えます。

   注記

   イメージビルド中にシークレットが使用される方法

   • registry.redhat.io レジストリーからベース rhel-bootc:9.4 イメージをプルするには、podman --authfile 引数が必要です。
   • ビルド USER_PASSWD 引数は、redhat ユーザーのパスワードを設定するために使用されます。

検証

1. 次のコマンドを実行して、ローカル bootc イメージが作成されたことを確認します。

   Copy to Clipboard Toggle word wrap

   $ 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

手順

1. 次のコマンドを実行して、リモートレジストリーにログインします。

   Copy to Clipboard Toggle word wrap

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

   1

   1

   REGISTRY_URL を、レジストリーの URL に置き換えます。

2. 以下のコマンドを実行してイメージを公開します。

   Copy to Clipboard Toggle word wrap

   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}"

   1

   <myorg/mypath> を、リモートレジストリーの組織名とパスに置き換えます。

   2

   <microshift-4.17-bootc> を、公開するイメージの名前に置き換えます。

検証

1. 「MicroShift bootc コンテナーの実行」セクションで説明されているように、レジストリーにプッシュしたイメージを使用してコンテナーを実行します。

手順

1. 次のコマンドを入力して、MicroShift サービスのコンテナーを実行します。

   Copy to Clipboard Toggle word wrap

   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}"

   注記

   ホストカーネルバージョンが bootc イメージカーネルバージョンと異なると、コンテナー内で systemd-modules-load サービスが起動しません。必要なカーネルモジュールはすべてホストによってロードされているため、この障害は無視しても問題ありません。

2. MicroShift が起動すると、ターミナルにログインプロンプトが表示されます。
3. ユーザー認証情報を使用して、実行中のコンテナーにログインします。

4. 次のコマンドを実行して、すべての MicroShift Pod がエラーなく起動して実行されていることを確認します。

   Copy to Clipboard Toggle word wrap

   $ 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

5. これで、他の MicroShift クラスターを使用する場合と同じ方法で、コンテナー内で実行されている MicroShift を使用できるようになります。

手順

1. 次のコマンドを使用して、ループデバイスと追加のボリュームグループをクリーンアップします。

   1. 次のコマンドを入力して、ループデバイスをデタッチします。

      Copy to Clipboard Toggle word wrap

      $ sudo losetup -d "${VGLOOP}"

   2. 次のコマンドを入力して、LVM ボリュームグループファイルを削除します。

      Copy to Clipboard Toggle word wrap

      $ sudo rm -f "${VGFILE}"