インストール

手順

1. Storage Configuration サブセクションの Installation Destination の下にあるグラフィカルインストーラーで、Custom → Done を選択して、パーティションとボリュームを設定するためのダイアログを開きます。手動パーティショニングウィンドウが表示されます。
2. New Red Hat Enterprise Linux 9.x Installation で、Click here to create them automatically を選択します。
3. ルートパーティション / を選択し、PV 用に十分な容量が VG に指定されるように 必要な容量 を減らし、Update Settings をクリックします。

4. インストールを完了します。

   注記

   パーティション設定のその他のオプションは、手動パーティション設定の追加情報セクションにリンクされているガイドを参照してください。

5. root ユーザーとして、次のコマンドを実行して、システムで使用可能な VG 容量を確認します。

   $ sudo vgs

   出力例:

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

手順

1. root ユーザーとして、次のコマンドを実行して MicroShift リポジトリーを有効にします。

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

2. 次のコマンドを実行して MicroShift をインストールします。

   $ sudo dnf install -y microshift

3. オプション: 次のコマンドを実行して、MicroShift の greenboot をインストールします。

   $ sudo dnf install -y microshift-greenboot

4. インストールのプルシークレットを Red Hat Hybrid Cloud Console から $HOME/openshift-pull-secret などの一時フォルダーにダウンロードします。このプルシークレットを使用すると、MicroShift で使用されるコンテナーイメージを提供するコンテナーレジストリーで認証できます。

5. 次のコマンドを実行して、プルシークレットを RHEL マシンの /etc/crio フォルダーにコピーします。

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

6. 以下のコマンドを実行して、root ユーザーを /etc/crio/openshift-pull-secret ファイルの所有者にします。

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

7. 以下のコマンドを実行して、root ユーザーのみが /etc/crio/openshift-pull-secret ファイルを読み取りおよび書き込み可能にします。

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

8. RHEL マシンでファイアウォールが有効になっている場合は、必須のファイアウォールルールをいくつか設定する必要があります。firewalld の場合は、次のコマンドを実行します。

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

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

   $ sudo firewall-cmd --reload

手順

1. root ユーザーとして、次のコマンドを入力して MicroShift サービスを開始します。

   $ sudo systemctl start microshift

2. オプション: マシンの起動時に MicroShift を開始するように RHEL マシンを設定するには、次のコマンドを入力します。

   $ sudo systemctl enable microshift

3. オプション: マシンの起動時に MicroShift が自動的に起動しないようにするには、次のコマンドを入力します。

   $ sudo systemctl disable microshift

   注記

   MicroShift サービスが初めて開始されると、MicroShift のコンテナーイメージがダウンロードされて初期化されます。その結果、サービスの初回デプロイ時には MicroShift が起動されるまでに数分かかる場合があります。それ以降は、MicroShift サービスの起動時間が短縮されます。

手順

1. 次のコマンドを入力して、MicroShift サービスを停止します。

   $ sudo systemctl stop microshift

2. MicroShift にデプロイされたワークロードは、MicroShift サービスが停止した後も引き続き実行されます。次のコマンドを入力して、実行中のワークロードを表示します。

   $ sudo crictl ps -a

3. 次のコマンドを入力して、デプロイされたワークロードを停止します。

   $ sudo systemctl stop kubepods.slice

手順

1. 次のコマンドを実行して、MicroShift の RPM をプルするために必要な rhocp-4.17 RPM リポジトリーソースを追加するための Image Builder 設定ファイルを作成します。

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

2. 次のコマンドを実行して、fast-datapath RPM リポジトリーを追加するための Image Builder 設定ファイルを作成します。

   $ 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

3. 次のコマンドを実行して、Image Builder にソースを追加します。

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

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

手順

1. 次の例を使用して、ブループリントを作成します。

   Image Builder のブループリントの例

   $ cat > minimal-microshift.toml <<EOF
   name = "minimal-microshift"
   
   description = ""
   version = "0.0.1"
   modules = []
   groups = []
   
   [[packages]]
   name = "microshift"
   version = "*"
   
   [[packages]]
   name = "microshift-greenboot" 1
   version = "*"
   
   [customizations.services]
   enabled = ["microshift"]
   EOF

   1

   オプションの microshift-greenboot RPM。詳細は、「アプリケーションの実行」セクションの「Greenboot ヘルスチェック」ガイドを参照してください。

   注記

   コマンドのワイルドカード * は、最新の MicroShift RPM を使用します。特定のバージョンが必要な場合は、ワイルドカードを必要なバージョンに置き換えます。たとえば、MicroShift 4.16.0 RPM をダウンロードするには、4.16.0 を挿入します。

2. 次のコマンドを実行して、Image Builder にブループリントを追加します。

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

検証

1. 次のコマンドを実行して、MicroShift パッケージのみをリストした Image Builder 設定を確認します。

   $ sudo composer-cli blueprints depsolve minimal-microshift | grep microshift

   出力例

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

2. オプション: 次のコマンドを実行して、インストールするすべてのコンポーネントをリストした Image Builder 設定を確認します。

   $ sudo composer-cli blueprints depsolve minimal-microshift

手順

1. 以下のコマンドを実行して ostree コンテナーイメージビルドを開始します。

   $ BUILDID=$(sudo composer-cli compose start-ostree --ref "rhel/9/$(uname -m)/edge" minimal-microshift edge-container | awk '{print $2}')

   このコマンドは、監視対象のビルドの ID (ID) も返します。

2. 次のコマンドを実行して、ビルドのステータスを定期的に確認できます。

   $ sudo composer-cli compose status

   実行中のビルドの出力例

   ID                                     Status     Time                      Blueprint            Version   Type               Size
   cc3377ec-4643-4483-b0e7-6b0ad0ae6332   RUNNING    Wed Jun 7 12:26:23 2023   minimal-microshift   0.0.1     edge-container

   完了したビルドの出力例

   ID                                     Status     Time                      Blueprint            Version   Type               Size
   cc3377ec-4643-4483-b0e7-6b0ad0ae6332   FINISHED   Wed Jun 7 12:32:37 2023   minimal-microshift   0.0.1     edge-container

   注記

   起動および停止方法を理解している場合は、watch コマンドを使用してビルドを監視できます。

3. ID を使用してコンテナーイメージをダウンロードし、次のコマンドを実行して、使用可能なイメージを取得します。

   $ sudo composer-cli compose image ${BUILDID}

4. 次のコマンドを実行して、ダウンロードしたコンテナーイメージの所有権を現在のユーザーに変更します。

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

5. 次のコマンドを実行して、現在のユーザーの読み取り権限をイメージに追加します。

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

6. 以下の手順を実行して、ostree コンテナーイメージが ISO ビルドで使用されるようにポート 8085 でサーバーをブートストラップします。

   1. 次のコマンドを実行して、IMAGEID 変数の結果を取得します。

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

   2. IMAGEID 変数の結果をもとに、以下のコマンドを実行して podman コマンドを実行します。

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

      このコマンドは、監視用に IMAGEID 変数に保存されているコンテナーの ID も返します。

7. 次のコマンドを実行して、インストーラーブループリントファイルを生成します。

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

1. 次のコマンドを実行して、Image Builder にブループリントを追加します。

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

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

   このコマンドは、監視対象のビルドの ID (ID) も返します。

3. 次のコマンドを実行して、ビルドのステータスを定期的に確認できます。

   $ sudo composer-cli compose status

   実行中のビルドの出力例

   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

   完了したビルドの出力例

   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

1. 以下のコマンドを実行して、ID を使用して ISO をダウンロードします。

   $ sudo composer-cli compose image ${BUILDID}

2. 次のコマンドを実行して、ダウンロードしたコンテナーイメージの所有権を現在のユーザーに変更します。

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

3. 次のコマンドを実行して、現在のユーザーの読み取り権限をイメージに追加します。

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

前提条件

1. RHEL for Edge Commit を含む RHEL for Edge インストーラー (ISO) イメージを MicroShift で作成している。

   1. この要件には、RFE コンテナーイメージの作成、RFE インストーラブループリントの作成、RFE コンテナーの起動、および RFE インストーライメージの作成の手順が含まれます。

2. キックスタートファイルを作成しているか、既存のファイルを使用している。キックスタートファイルには、以下を含める必要があります。

   1. ユーザーの作成方法に関する詳細な手順
   2. RHEL for Edge イメージをフェッチしてデプロイする方法

手順

1. キックスタートファイルのメインセクションで、システムルートに少なくとも 10GB が指定されている rhel という名前の LVM ボリュームグループが含まれるように、ファイルシステムのセットアップを更新します。LVMS CSI ドライバーがワークロードのデータを格納するために使用する空き領域を残します。

   ファイルシステムを設定するためのキックスタートスニペットの例

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

2. キックスタートファイルの %post セクションで、プルシークレットと必須のファイアウォールルールを追加します。

   プルシークレットとファイアウォールルールを追加するためのキックスタートスニペットの例

   %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

3. 次のコマンドを実行して、mkksiso ツールをインストールします。

   $ sudo yum install -y lorax

4. 次のコマンドを実行して、ISO のキックスタートファイルを新しいキックスタートファイルで更新します。

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

1. システムが想定どおりの場合: required.d ディレクトリー内のすべてのスクリプトが成功すると、greenboot は /etc/greenboot/green.d ディレクトリーにあるすべてのスクリプトを実行します。
2. システムに問題が発生している場合: required.d ディレクトリー内のいずれかのスクリプトが失敗した場合、greenboot は red.d ディレクトリー内に存在するプレロールバックスクリプトを実行してから、システムを再起動します。

手順

1. 次のコマンドを実行してディレクトリーを作成します。

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

2. 次のコマンドを実行して、設定ファイルを作成します。

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

3. サイズ要件に合わせて設定ファイルの値を編集します。