更新
MicroShift クラスターの更新
概要
第1章 Red Hat build of MicroShift の更新について
更新は、一般提供バージョン 4.14 以降の Red Hat build of MicroShift でサポートされています。サポートされる更新には、あるマイナーバージョンから次のマイナーバージョンへの連続した更新 (たとえば、4.14 から 4.15 へ) が含まれます。z-stream 間のパッチ更新 (たとえば、4.14.1 から 4.14.2) もサポート対象です。
1.1. MicroShift の更新について
Red Hat build of MicroShift の更新は、エッジにデプロイされる rpm-ostree
ホストと、非 OSTree ホストの両方でサポートされています。更新は次の方法を使用して実行できます。
-
Red Hat Enterprise Linux for Edge (RHEL for Edge) などの新しい
rpm-ostree
システムイメージに、MicroShift の最新バージョンを埋め込みます。* OSTree システムでの更新の適用 を参照してください。 - Red Hat Enterprise Linux (RHEL) などの非 OSTree システムで RPM を手動で更新します。* RPM を使用した手動での更新の適用 を参照してください。
rpm-ostree
更新の場合のみ、自動ロールバックが行われます。
1.1.1. RPM OSTree 更新
RHEL for Edge の rpm-ostree
更新パスを使用すると、更新の一部が失敗した場合に自動バックアップとシステムロールバックを実行できます。新しい rpm-ostree
イメージをビルドし、そのイメージに新しいバージョンの MicroShift を埋め込む必要があります。rpm-ostree
イメージは、同じバージョンまたは更新されたバージョンにすることができます。ただし、RHEL for Edge のバージョンと MicroShift のバージョンとの間に互換性が必要です。
詳細は、次の互換性に関する表を確認してください。
Red Hat Device Edge リリースの互換性に関する表
Red Hat Device Edge の 2 つの製品は、デバイスエッジコンピューティングのための単一のソリューションとして連携して動作します。製品を正しく組み合わせるには、次の表に示すように、それぞれの検証済みリリースを一緒に使用してください。
RHEL for Edge Version(s) | MicroShift バージョン | MicroShift のリリースステータス | MicroShift のサポート対象の更新 |
9.2、9.3 | 4.15 | 一般提供 | 4.15.0 → 4.15.z および 4.15→ 今後のマイナーバージョン |
9.2、9.3 | 4.14 | 一般提供 | 4.14.0 → 4.14.z および 4.14 → 4.15 |
9.2 | 4.13 | テクノロジープレビュー | なし |
8.7 | 4.12 | 開発者プレビュー | なし |
1.1.2. RPM 手動更新
RPM 手動更新パスを使用すると、MicroShift の既存のバージョンを置き換えることができます。RHEL のバージョンと MicroShift のバージョンとの間に互換性が必要です。システムの健全性の確認と追加のシステムバックアップの実行は、手動で行います。
1.1.3. バージョン更新パスの確認
Red Hat Device Edge コンポーネントの更新を試行する前に、MicroShift および RHEL for Edge または RHEL のどのバージョンがインストールされているかを確認してください。それぞれの使用する予定のバージョンを計画してください。
Red Hat build of MicroShift の更新パス
- RHEL for Edge 9.2 または 9.3 で一般提供されるバージョン 4.14 から 4.14.z または 4.15
- RHEL 9.2 または 9.3 で一般提供されるバージョン 4.14 から 4.14.z または 4.15
- RHEL for Edge 9.2 または 9.3 で一般提供されるバージョン 4.15 から 4.15.z
- RHEL 9.2 または 9.3 で一般提供されるバージョン 4.15 から 4.15.z
第2章 Red Hat build of MicroShift と Red Hat Device Edge の更新方法
バージョンの組み合わせがサポートされている場合は、Red Hat build of MicroShift バージョンを更新してもしなくても、Red Hat Enterprise Linux for Edge (RHEL for Edge) イメージまたは Red Hat Enterprise Linux (RHEL) を更新できます。詳細は次の表を参照してください。
Red Hat Device Edge リリースの互換性に関する表
Red Hat Device Edge の 2 つの製品は、デバイスエッジコンピューティングのための単一のソリューションとして連携して動作します。製品を正しく組み合わせるには、次の表に示すように、それぞれの検証済みリリースを一緒に使用してください。
RHEL for Edge Version(s) | MicroShift バージョン | MicroShift のリリースステータス | MicroShift のサポート対象の更新 |
9.2、9.3 | 4.15 | 一般提供 | 4.15.0 → 4.15.z および 4.15→ 今後のマイナーバージョン |
9.2、9.3 | 4.14 | 一般提供 | 4.14.0 → 4.14.z および 4.14 → 4.15 |
9.2 | 4.13 | テクノロジープレビュー | なし |
8.7 | 4.12 | 開発者プレビュー | なし |
2.1. バージョン更新パスの確認
Red Hat Device Edge コンポーネントの更新を試行する前に、MicroShift および RHEL for Edge または RHEL のどのバージョンがインストールされているかを確認してください。それぞれの使用する予定のバージョンを計画してください。
Red Hat build of MicroShift の更新パス
- RHEL for Edge 9.2 または 9.3 で一般提供されるバージョン 4.14 から 4.14.z または 4.15
- RHEL 9.2 または 9.3 で一般提供されるバージョン 4.14 から 4.14.z または 4.15
- RHEL for Edge 9.2 または 9.3 で一般提供されるバージョン 4.15 から 4.15.z
- RHEL 9.2 または 9.3 で一般提供されるバージョン 4.15 から 4.15.z
MicroShift は、あるマイナーバージョンから次のマイナーバージョンに順番に更新する必要があります。たとえば、4.14 から 4.16 に更新することはできません。4.14 を 4.15 などに更新する必要があります。
2.2. MicroShift の単独更新
アプリケーションを再インストールせずに MicroShift を更新できます。既存のオペレーティングシステムと、使用する MicroShift の新しいバージョンとの間に互換性がある限り、MicroShift を更新するために RHEL または RHEL for Edge を更新する必要はありません。
MicroShift はインプレース更新として動作するため、以前のバージョンを削除する必要はありません。アプリケーションの通常の動作に必要なものを超えるデータのバックアップも必要ありません。
2.2.1. RPM-OSTree 更新
新しいバージョンの MicroShift を含む新しいイメージをビルドすることで、RHEL for Edge などの rpm-ostree
システムで MicroShift を更新できます。使用するオペレーティングシステムのバージョンが、更新先の MicroShift の新しいバージョンと互換性があることを確認してください。
RHEL for Edge 更新パスでは、次の機能を利用できます。
- 更新が失敗した場合、システムは自動的に以前の正常なシステム状態にロールバックします。
- アプリケーションを再インストールする必要はありません。
- この更新方式を使用すると、MicroShift を更新せずにアプリケーションを更新できます。
- ビルドするイメージに、必要に応じて他の更新を含めることができます。
RHEL for Edge イメージへの埋め込みによる MicroShift の更新を開始するには、次のドキュメントの手順を使用してください。
Greenboot の詳細は、次のドキュメントを参照してください。
2.2.2. RPM 手動更新
RPM をダウンロードして更新することで、Red Hat Enterprise Linux (RHEL) などの非 OSTree システムで MicroShift を手動で更新できます。このタイプの更新を実行するには、サブスクリプションマネージャーを使用して、新しい RPM が含まれるリポジトリーにアクセスします。RPM 手動更新を開始するには、次のドキュメントの手順を使用してください。
2.3. RHEL for Edge の単独更新
2 つのバージョン間に互換性がある限り、MicroShift を更新しなくても RHEL for Edge または RHEL を更新できます。更新を開始する前に互換性を確認してください。使用する更新パス用の RHEL for Edge ドキュメントを使用してください。
2.4. MicroShift とオペレーティングシステムの同時更新
バージョン間に互換性がある場合、RHEL for Edge または RHEL の更新と MicroShift の更新を同時に行うことができます。更新を開始する前に互換性を確認してください。まず、使用する更新パス固有の RHEL for Edge および RHEL ドキュメントを使用して、オペレーティングシステムを計画および更新します。次に、その更新パスの MicroShift 更新方式を使用します。
第3章 OSTree システムでの Red Hat build of MicroShift RPM の更新について
Red Hat Enterprise Linux for Edge (RHEL for Edge) などの rpm-ostree
システムで Red Hat build of MicroShift を更新するには、新しいバージョンの Red Hat build of MicroShift を含む新しいオペレーティングシステムイメージをビルドする必要があります。Red Hat build of MicroShift を含む rpm-ostree
イメージを用意したら、そのオペレーティングシステムイメージで起動するようシステムに指示します。
マイナーバージョン更新およびパッチ更新の場合も手順は同じです。たとえば、同じ手順を使用して 4.14 から 4.15、または 4.15.0 から 4.15.1 にアップグレードします。
Red Hat Device Edge リリースの互換性に関する表
Red Hat Device Edge の 2 つの製品は、デバイスエッジコンピューティングのための単一のソリューションとして連携して動作します。製品を正しく組み合わせるには、次の表に示すように、それぞれの検証済みリリースを一緒に使用してください。
RHEL for Edge Version(s) | MicroShift バージョン | MicroShift のリリースステータス | MicroShift のサポート対象の更新 |
9.2、9.3 | 4.15 | 一般提供 | 4.15.0 → 4.15.z および 4.15→ 今後のマイナーバージョン |
9.2、9.3 | 4.14 | 一般提供 | 4.14.0 → 4.14.z および 4.14 → 4.15 |
9.2 | 4.13 | テクノロジープレビュー | なし |
8.7 | 4.12 | 開発者プレビュー | なし |
ダウングレードはサポートされていません。次の手順はアップグレード専用です。
3.1. OSTree システムでの更新の適用
Red Hat Enterprise Linux for Edge (RHEL for Edge) などの rpm-ostree
システムで MicroShift を更新するには、新しいバージョンの MicroShift を新しいオペレーティングシステムイメージに埋め込みます。使用する手順は、既存のデプロイメントがどのように設定されているかによって異なります。次の手順では、実行できる一般的なステップと、RHEL for Edge ドキュメントへのリンクを示します。RHEL for Edge ドキュメントは、更新されたオペレーティングシステムイメージのビルドについて詳しく説明しているリソースです。この更新方式では、バックアップとシステムロールバックが自動的に行われます。
このワークフローを使用して、MicroShift クラスターで実行されているアプリケーションを更新することもできます。更新を開始する前に、MicroShift および RHEL for Edge の更新先のバージョンとアプリケーション間の互換性を確認してください。
前提条件
- MicroShift をインストールするためのシステム要件が満たされている。
- ホストへの root ユーザーアクセス権を持っている。
- 使用中の MicroShift のバージョンと使用を準備をしている RHEL for Edge イメージとの間に互換性がある。
このプロセスで MicroShift をダウングレードすることはできません。ダウングレードはサポートされていません。
手順
次のコマンドを実行して、MicroShift の RPM をプルするために必要な
rhocp-4.15
RPM リポジトリーソースを追加するための Image Builder 設定ファイルを作成します。$ cat > rhocp-4.15.toml <<EOF id = "rhocp-4.15" name = "Red Hat OpenShift Container Platform 4.15 for RHEL 9" type = "yum-baseurl" url = "https://cdn.redhat.com/content/dist/layered/rhel9/$(uname -m)/rhocp/4.15/os" check_gpg = true check_ssl = true system = false rhsm = true EOF
次のコマンドを実行して、RPM 更新ソースを Image Builder に追加します。
$ sudo composer-cli sources add rhocp-4.15.toml
新しいバージョンの MicroShift を含む、RHEL for Edge の新しいイメージをビルドします。必要な手順を確認するには、次のドキュメントを使用してください。
RHEL for Edge の新しいイメージを使用するようにホストを更新します。必要な手順を確認するには、次のドキュメントを使用してください。
次のコマンドを実行して、ホストを再起動して更新を適用します。
$ sudo systemctl reboot
第4章 Red Hat build of MicroShift RPM の手動更新について
Red Hat Enterprise Linux (RHEL) などの非 OSTree システムで Red Hat build of MicroShift を更新するには、RPM をダウンロードして更新する必要があります。4.15.1 から 4.15.2 などのパッチリリースの場合は、RPM をダウンロードして更新します。マイナーバージョンリリースの更新の場合は、それに加えて、サブスクリプションマネージャーを使用して更新リポジトリーを有効にする手順を行います。
MicroShift は、あるマイナーバージョンから次のマイナーバージョンに順番に更新します。たとえば、4.14 を 4.15 に更新する必要があります。
パッチ更新またはマイナーバージョン更新によるアップグレードの場合は、必要に応じてアプリケーションデータをバックアップして、データのコピーをセキュアな場所に移動できます。
4.1. RPM を使用したパッチ更新の適用
Red Hat Enterprise Linux (RHEL) などの非 rpm-ostree
システムで MicroShift を更新するには、RPM をダウンロードして更新する必要があります。パッチ更新のためにシステムを再起動する必要はありません。たとえば、4.14.0 から 4.14.1 にアップグレードするには、次の手順を使用します。
前提条件
- MicroShift をインストールするためのシステム要件が満たされている。
- ホストへの root ユーザーアクセス権を持っている。
- 使用中の MicroShift のバージョンと使用を準備しているバージョンとの間にアップグレード互換性がある。
- ホストオペレーティングシステムとインストールを準備している MicroShift のバージョンとの間に互換性があることを確認している。
- システムのバックアップが完了している。
このプロセスで MicroShift をダウングレードすることはできません。ダウングレードはサポートされていません。
手順
次のコマンドを実行して、MicroShift の RPM を更新します。
$ sudo dnf update microshift
この更新方式では、システムヘルスチェックは実行されますが、アクションは実行されません。更新が失敗した場合は、ログを確認するように指示するエラーメッセージが表示されます。
4.2. RPM を使用したマイナーバージョン更新の適用
Red Hat Enterprise Linux (RHEL) などの非 rpm-ostree
システムで MicroShift のマイナーバージョンを更新するには、RPM をダウンロードして更新する必要があります。たとえば、4.14 から 4.15 に更新するには、次の手順を使用します。
MicroShift は、あるバージョンから次のバージョンに順番に更新する必要があります。マイナーバージョンの飛び越しはサポートされていません。たとえば、4.14 を 4.15 に更新する必要があります。
前提条件
- MicroShift をインストールするためのシステム要件が満たされている。
- ホストへの root ユーザーアクセス権を持っている。
- 使用中の MicroShift のバージョンと使用を準備しているバージョンとの間にアップグレード互換性がある。
- ホストオペレーティングシステムとインストールを準備している MicroShift のバージョンとの間に互換性があることを確認している。
- システムのバックアップが完了している。
このプロセスで MicroShift をダウングレードすることはできません。ダウングレードはサポートされていません。
手順
次のコマンドを実行して、MicroShift のリポジトリーを有効にします。
$ sudo subscription-manager repos \ --enable rhocp-4.15-for-rhel-9-$(uname -m)-rpms \ --enable fast-datapath-for-rhel-9-$(uname -m)-rpms
次のコマンドを実行して、MicroShift の RPM を更新します。
$ sudo dnf update microshift
次のコマンドを実行して、ホストを再起動して更新を適用します。
$ sudo systemctl reboot
この更新方式では、システムヘルスチェックは実行されますが、アクションは実行されません。更新が失敗した場合は、ログを確認するように指示するエラーメッセージが表示されます。
検証
次のコマンドを実行し、正常にブートしてヘルスチェックが終了したかどうかを確認します。
$ sudo systemctl status greenboot-healthcheck
次のコマンドを実行して、ヘルスチェックのログを確認します。
$ sudo journalctl -u greenboot-healthcheck
関連情報