1.6. 切断されたネットワーク環境でのアップグレード
切断されたネットワーク環境で Red Hat Advanced Cluster Management for Kubernetes をアップグレードする手順と情報を参照してください。
注記: この情報は、アップグレード のアップグレード手順に従います。その手順を確認してから、次の情報を参照してください。
インストールまたはアップグレード中に、Red Hat Advanced Cluster Management とマルチクラスターエンジン Operator 間の相互依存性に関連する重要な情報が表示される場合があります。インストールまたはアップグレード時の考慮事項については 非接続環境でのインストール を参照してください。
接続されたネットワーク環境でのアップグレードの場合と同様に、Red Hat Advanced Cluster Management for Kubernetes の Operator Lifecycle Manager サブスクリプションのアップグレードチャネルを新しいリリースのアップグレードチャネルに変更することで、アップグレードプロセスが開始されます。
ただし、ネットワークに接続されていない環境の特性は特殊であるため、更新チャネルを変更してアップグレードプロセスを開始する前に、次のミラーリング要件に対処する必要があります。
必要なパッケージがミラーカタログで更新されていることを確認します。
インストール時または以前の更新時に、切断されたネットワーク環境に Red Hat Advanced Cluster Management for Kubernetes をインストールするために必要な Operator パッケージとイメージを含むミラーカタログとレジストリーを作成しています。アップグレードするには、ミラーカタログとレジストリーを更新して、更新されたバージョンの Operator パッケージを取得する必要があります。
インストールアクションと同様に、ミラーカタログとレジストリーに含まれる、または更新される Operator のリストに、次の Operator パッケージが含まれていることを確認する必要があります。
-
advanced-cluster-manager -
multicluster-engine
-
MutliclusterHubリソースインスタンスを確認します。インストール時または以前の更新時に、
MulticlusterHubリソースのインスタンスを作成し、切断された環境用んい、そのリソースにmce-subscription-specアノテーションを追加しています。ミラーカタログとレジストリーの更新手順を行い、
CatalogSourceを使用して OpenShift Container Platform クラスターで利用できるカタログが、以前に使用していた名前と同じになった場合に、MulticlusterHubリソースに更新して、mce-subscriptino-specアノテーションを更新する必要はありません。ただし、ミラーリングされたカタログとレジストリーを更新する手順を実行した結果、新しい名前の
CatalogSourceが作成された場合は、MulticlusterHubリソースのmce-subscription-specアノテーションを更新して、新しいカタログソース名を反映させます。
1.6.1. カタログミラーリングによるアップグレード
Red Hat Advanced Cluster Management は、関連するマルチクラスターエンジン Operator 機能を使用して、製品の一部として提供される基本サービスを提供します。Red Hat Advanced Cluster Management は、ハブクラスターのインストールとアップグレードの一環として、必要なマルチクラスターエンジン Operator と MulticlusterEngine リソースインスタンスを自動的にインストールして管理します。
接続されたネットワーク環境では、クラスター管理者は、特別なミラーカタログやカタログソースなしで、Red Hat Advanced Cluster Management をインストールまたはアップグレードできます。ただし、(前のセクションで説明したように) 切断された環境で Operator Lifecycle Manager Operator をインストールするには、特殊なミラーカタログとカタログソースを使用する必要があるため、インストール後にいくつかの追加手順が必要です。
ミラーカタログを作成するための手順を更新します。
Red Hat Advanced Cluster Management のインストール時にミラーリング手順によって Red Hat Operators カタログの完全なコピーが作成された場合は、特別なミラーリング更新は必要ありません。カタログを更新して、新しい Operator リリースの更新されたコンテンツを取得します。
実行した手順でミラーカタログが フィルタリング された状態で生成された場合には、ミラーリングの手順を更新して、
advanced-cluster-managementパッケージに加えて、multcluster-engineoperator パッケージがミラーカタログに含まれていることを確認します。ミラーカタログに必要な Operator パッケージを含める トピックを参照してください。これには、ミラーカタログを設定するときに使用するオプションの例が示されています。これらの新しい要件に一致するように、実行した手順で使用される Operator パッケージリストを更新します。
MutliclusterHubリソースインスタンスを更新します。切断されたネットワーク環境でのインストール のトピックで説明されているように、切断された環境でハブクラスターをインストールまたはアップグレードする場合は、
MulticlusterHubリソースに新しいアノテーションが必要です。ベストプラクティス: アップグレードを開始するために、Operator Lifecycle Manager サブスクリプションの Operator Lifecycle Manager 更新チャネルを
advanced-cluster-managementOperator パッケージに変更する前に、MulticlusterHubリソースインスタンスを更新して必要なアノテーションを含めます。この更新により、アップグレードを遅滞なく進めることができます。次の例に示すように、
oc editコマンドを使用してMulticlusterubリソースを更新し、mce-subscription-specアノテーションを追加します。metadata: annotations: installer.open-cluster-management.io/mce-subscription-spec: '{"source": "<my-mirror-catalog-source>"}'例の
<my-mirr-catalog-source>は、ミラーカタログのopenshift-marketplacenamespace にあるCatalogSourceリソースの名前に置き換えます。
重要: アノテーションを追加する前にアップグレードを開始すると、アップグレードは開始されますが、Operator がバックグラウンドで multicluster-engine へのサブスクリプションをインストールしようとすると停止します。この間、MulticlusterHub リソースのステータスは引き続き アップグレード を表示します。
この問題を解決するには、oc edit を実行して、前に示したように mce-subscription-spec アノテーションを追加します。
