Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

RPM パッケージによるインストール

Red Hat build of MicroShift 4.20

RPM を使用した MicroShift のインストール

Red Hat OpenShift Documentation Team

概要

このドキュメントでは、サポートされているバージョンの RHEL を搭載したマシンに RPM パッケージから MicroShift をインストールする方法を説明します。

第1章 RPM パッケージからのインストール
リンクのコピー

サポート対象バージョンの Red Hat Enterprise Linux (RHEL) を搭載したマシンに RPM パッケージから MicroShift をインストールできます。

1.1. RPM パッケージから MicroShift をインストールする前の準備
リンクのコピー

MicroShift をインストールする前に、メモリー設定と FIPS モード用にホストマシンを準備することを推奨します。

1.1.1. ボリュームグループの設定
リンクのコピー

MicroShift は、永続ボリューム (PV) にストレージを提供するために、論理ボリュームマネージャーストレージ (LVMS) Container Storage Interface (CSI) プラグインを使用します。LVMS は、Linux 論理ボリュームマネージャー (LVM) を利用して、PV のバッキング論理ボリューム (LV) を動的に管理します。このため、マシンには、LVMS がワークロードの PV 用の LV を作成できる未使用スペースのある LVM ボリュームグループ (VG) が必要です。

LVMS がワークロードの PV 用の LV を作成できるようにボリュームグループ (VG) を設定するには、RHEL のインストール中にルートボリュームの 希望サイズ を小さくします。ルートボリュームのサイズを下げると、実行時に LVMS によって作成される追加の LV 用の未割り当て領域がディスク上に確保されます。

1.1.2. FIPS モードの準備
リンクのコピー

ユースケースで MicroShift コンテナーを FIPS モードで実行する必要がある場合は、FIPS を有効にして RHEL をインストールする必要があります。ワーカーマシンが FIPS モードで実行するように設定されると、MicroShift コンテナーも FIPS モードで実行するように自動的に設定されます。

重要

ノードが使用するオペレーティングシステムの初回起動時の前に FIPS を有効にする必要があるため、ノードのデプロイ後に FIPS を有効にすることはできません。

1.2. RPM パッケージから MicroShift をインストールする準備
リンクのコピー

ワークロードの永続ボリューム (PV) に十分な容量を持つ論理ボリュームマネージャー (LVM) ボリュームグループ (VG) を持つように RHEL マシンを設定します。

前提条件

  • MicroShift をインストールするためのシステム要件が満たされている。
  • マシンへの root ユーザーアクセス権がある。
  • ワークロードの PV に必要な容量を使用して LVM VG を設定している。

手順

  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.3. RPM パッケージからの MicroShift のインストール
リンクのコピー

以下の手順を使用して、RPM パッケージから MicroShift をインストールします。

前提条件

  • MicroShift をインストールするためのシステム要件が満たされている。
  • RPM パッケージから MicroShift をインストールするための準備の手順を完了している。

手順

  1. すべてのライフサイクルで、次のコマンドを実行してリリースのリポジトリーを有効にします。 

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

  2. 延長サポート (EUS) リリースの場合は、次のコマンドを実行して EUS リポジトリーも有効にします。 

    $ sudo subscription-manager repos \
    --enable rhel-9-for-$(uname -m)-appstream-eus-rpms \
    --enable rhel-9-for-$(uname -m)-baseos-eus-rpms

  3. 次のコマンドを使用してオペレーティングシステムのバージョンをロックすることにより、サポートされていない設定への意図しない今後の更新を回避します。 

    $ sudo subscription-manager release --set=9.6

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

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

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

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

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

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

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

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

  9. 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
  10. MicroShift 用に準備したボリュームグループ (VG) がデフォルト名 rhel を使用した場合、それ以上の設定は必要ありません。別の名前を使用した場合、またはさらに設定を変更する場合は、「MicroShift 設定ファイルの使用」セクションを参照してください。

第2章 MicroShift の停止と起動
リンクのコピー

新規インストール、オプションの RPM パッケージの追加、トラブルシューティングなど、さまざまな理由で MicroShift を停止または起動できます。

2.1. MicroShift サービスの開始
リンクのコピー

次の手順を使用して、MicroShift サービスを開始します。

前提条件

  • RPM パッケージから MicroShift をインストールしている。

手順

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

    $ sudo systemctl start microshift

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

    $ sudo systemctl enable microshift

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

    $ sudo systemctl disable microshift
    注記

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

2.2. MicroShift サービスの停止
リンクのコピー

次の手順を使用して、MicroShift サービスを停止します。

前提条件

  • MicroShift サービスが実行されている。

手順

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

    $ sudo systemctl stop microshift

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

    $ sudo crictl ps -a

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

    $ sudo systemctl stop kubepods.slice

第3章 MicroShift ノードへの oc アクセス
リンクのコピー

OpenShift CLI (oc) を使用して MicroShift ノードにアクセスします。

3.1. MicroShift ノードへのアクセス方法
リンクのコピー

OpenShift CLI (oc) を使用して MicroShift サービスにアクセスします。

  • MicroShift サービスを実行している同じマシンからでも、リモートの場所からでも、ノードにアクセスできます。
  • このアクセスを使用して、ワークロードを監視および管理できます。
  • 次の手順を使用する場合は、接続するホスト名または IP アドレスが含まれている kubeconfig ファイルを選択し、関連するディレクトリーに配置します。

3.1.1. MicroShift ノードへのローカルアクセス
リンクのコピー

以下の手順に従って、kubeconfig ファイルを使用して MicroShift ノードをローカルでアクセスします。

前提条件

  • OpenShift CLI (oc) がインストールされている。

手順

  1. オプション: Red Hat Enterprise Linux (RHEL) マシンに ~/.kube/ フォルダーがない場合は、次のコマンドを実行してこのフォルダーを作成します。 

    $ mkdir -p ~/.kube/

  2. 次のコマンドを実行して、生成されたローカルアクセス kubeconfig ファイルを ~/.kube/ ディレクトリーにコピーします。 

    $ sudo cat /var/lib/microshift/resources/kubeadmin/kubeconfig > ~/.kube/config

  3. 次のコマンドを実行して、~/.kube/config ファイルの権限を更新します。 

    $ chmod go-r ~/.kube/config

検証

  • 次のコマンドを入力して、MicroShift が実行されていることを確認します。 

    $ oc get pods -A

    出力例

    NAMESPACE                   NAME                                                     READY   STATUS   RESTARTS  AGE
default                     i-06166fbb376f14a8bus-west-2computeinternal-debug-qtwcr  1/1     Running  0		    46m
kube-system                 csi-snapshot-controller-5c6586d546-lprv4                 1/1     Running  0		    51m
openshift-dns               dns-default-45jl7                                        2/2     Running  0		    50m
openshift-dns               node-resolver-7wmzf                                      1/1     Running  0		    51m
openshift-ingress           router-default-78b86fbf9d-qvj9s                          1/1     Running  0		    51m
openshift-ovn-kubernetes    ovnkube-master-5rfhh                                     4/4     Running  0		    51m
openshift-ovn-kubernetes    ovnkube-node-gcnt6                                       1/1     Running  0		    51m
openshift-service-ca        service-ca-bf5b7c9f8-pn6rk                               1/1     Running  0		    51m
openshift-storage           topolvm-controller-549f7fbdd5-7vrmv                      5/5     Running  0		    51m
openshift-storage           topolvm-node-rht2m                                       3/3     Running  0		    50m

    注記

    この出力例は、基本的な MicroShift インストールを示しています。オプションの RPM をインストールした場合は、それらのサービスを実行している Pod のステータスも出力に表示されることが予想されます。

3.1.2. MicroShift ノードへのリモートアクセス用にファイアウォールを開く
リンクのコピー

リモートユーザーが MicroShift サービスにアクセスできるように、次の手順を使用してファイアウォールを開きます。この手順を完了しなければ、ワークステーションユーザーはノードにリモートでアクセスできません。

この手順では、user@microshift は、MicroShift ホストマシン上のユーザーであり、別のワークステーション上のリモートユーザーがアクセスできるようにそのマシンをセットアップする責任があります。

前提条件

  • OpenShift CLI (oc) がインストールされている。
  • クラスター管理者の権限がある。

手順

  • MicroShift ホストの user@microshift として、次のコマンドを実行して、Kubernetes API サーバー (6443/tcp) のファイアウォールポートを開きます。 

    [user@microshift]$ sudo firewall-cmd --permanent --zone=public --add-port=6443/tcp && sudo firewall-cmd --reload

検証

  • user@microshift として次のコマンドを実行して、MicroShift が入力されていることを確認します。 

    $ oc get pods -A

    出力例

    NAMESPACE                   NAME                                                     READY   STATUS   RESTARTS  AGE
default                     i-06166fbb376f14a8bus-west-2computeinternal-debug-qtwcr  1/1     Running  0		    46m
kube-system                 csi-snapshot-controller-5c6586d546-lprv4                 1/1     Running  0		    51m
openshift-dns               dns-default-45jl7                                        2/2     Running  0		    50m
openshift-dns               node-resolver-7wmzf                                      1/1     Running  0		    51m
openshift-ingress           router-default-78b86fbf9d-qvj9s                          1/1     Running  0		    51m
openshift-ovn-kubernetes    ovnkube-master-5rfhh                                     4/4     Running  0		    51m
openshift-ovn-kubernetes    ovnkube-node-gcnt6                                       1/1     Running  0		    51m
openshift-service-ca        service-ca-bf5b7c9f8-pn6rk                               1/1     Running  0		    51m
openshift-storage           topolvm-controller-549f7fbdd5-7vrmv                      5/5     Running  0		    51m
openshift-storage           topolvm-node-rht2m                                       3/3     Running  0		    50m

    注記

    この出力例は、基本的な MicroShift インストールを示しています。オプションの RPM をインストールした場合は、それらのサービスを実行している Pod のステータスも出力に表示されることが予想されます。

3.1.3. MicroShift ノードへのリモートアクセス
リンクのコピー

以下の手順に従って、kubeconfig ファイルを使用してリモートロケーションから MicroShift サービスにアクセスします。

user@workstation ログインは、ホストマシンにリモートからアクセスするのに使用されます。手順の <user> 値は、user@workstation が MicroShift ホストにログインするユーザーの名前になります。

前提条件

  • OpenShift CLI (oc) がインストールされている。
  • user@microshift は、ローカルホストからファイアウォールを開いている。
  • 追加の kubeconfig ファイルが生成した。

手順

  1. user@workstation として、Red Hat Enterprise Linux (RHEL) マシンに ~/.kube/ フォルダーがない場合は、次のコマンドを実行してこのフォルダーを作成します。 

    [user@workstation]$ mkdir -p ~/.kube/

  2. user@workstation として、次のコマンドを実行して、MicroShift ホストのホスト名の変数を設定します。 

    [user@workstation]$ MICROSHIFT_MACHINE=<microshift_hostname>
    1
    1
    <MicroShift_hostname> の値は、実行しているホストの名前または IP アドレスに置き換えます。

  3. user@workstation として、次のコマンドを実行して、MicroShift を実行している RHEL マシンからローカルマシンに接続するホスト名または IP アドレスを含む生成された kubeconfig ファイルをコピーします。 

    [user@workstation]$ ssh <user>@$MICROSHIFT_MACHINE "sudo cat /var/lib/microshift/resources/kubeadmin/$MICROSHIFT_MACHINE/kubeconfig" > ~/.kube/config
    1
    1
    <user> は、SSH ログイン認証情報に置き換えます。

  4. user@workstation として、次のコマンドを実行して ~/.kube/config ファイルのパーミッションを更新します。 

    $ chmod go-r ~/.kube/config

検証

  • user@workstation として、次のコマンドを入力して、MicroShift が実行されていることを確認します。 

    $ oc get pods -A

    出力例

    NAMESPACE                   NAME                                                     READY   STATUS   RESTARTS  AGE
default                     i-06166fbb376f14a8bus-west-2computeinternal-debug-qtwcr  1/1     Running  0		    46m
kube-system                 csi-snapshot-controller-5c6586d546-lprv4                 1/1     Running  0		    51m
openshift-dns               dns-default-45jl7                                        2/2     Running  0		    50m
openshift-dns               node-resolver-7wmzf                                      1/1     Running  0		    51m
openshift-ingress           router-default-78b86fbf9d-qvj9s                          1/1     Running  0		    51m
openshift-ovn-kubernetes    ovnkube-master-5rfhh                                     4/4     Running  0		    51m
openshift-ovn-kubernetes    ovnkube-node-gcnt6                                       1/1     Running  0		    51m
openshift-service-ca        service-ca-bf5b7c9f8-pn6rk                               1/1     Running  0		    51m
openshift-storage           topolvm-controller-549f7fbdd5-7vrmv                      5/5     Running  0		    51m
openshift-storage           topolvm-node-rht2m                                       3/3     Running  0		    50m

    注記

    この出力例は、基本的な MicroShift インストールを示しています。オプションの RPM をインストールした場合は、それらのサービスを実行している Pod のステータスも出力に表示されることが予想されます。

第4章 MicroShift のアンインストール
リンクのコピー

MicroShift をアンインストールする前に、microshift-cleanup-data スクリプトを実行して、すべての MicroShift データと設定をクリーンアップします。

4.1. RPM パッケージからの MicroShift のアンインストール
リンクのコピー

前提条件

  • root ユーザーアクセス権を持つ管理者として MicroShift にログインしている。
  • サポートケースを作成している。
  • MicroShift ノードへのルートアクセス権があります。

手順

  1. 次のコマンドを実行して、すべてのデータを消去します。 

    $ sudo microshift-cleanup-data --all
    1
    1
    --all 引数を指定してスクリプトを実行すると、以下のクリーンアップアクションが実行されます。
    • すべての MicroShift サービスを停止して無効にする
    • すべての MicroShift Pod を削除する
    • すべてのコンテナーイメージストレージを削除する
    • ネットワーク設定をリセットする
    • /var/lib/microshift データディレクトリーを削除する
    • OVN-K ネットワーク設定を削除する

  2. 以下のコマンドを実行します。 

    $ sudo dnf remove -y microshift*

法律上の通知
リンクのコピー

Copyright © 2025 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

Legal Notice

Theme

© 2026 Red Hatトップに戻る