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

第6章 SiteConfig CR から ClusterInstance CR への移行

シングルノードの OpenShift クラスターを SiteConfig カスタムリソース (CR) から ClusterInstance CR に段階的に移行できます。移行中は、既存のパイプラインと新しいパイプラインが並行して実行されるため、制御された段階的な方法で一度に 1 つ以上のクラスターを移行できます。

重要
  • SiteConfig CR は OpenShift Container Platform バージョン 4.18 から非推奨となり、今後のバージョンでは削除される予定です。
  • ClusterInstance CR は、Red Hat Advanced Cluster Management (RHACM) バージョン 2.12 以降で利用できます。

6.1. SiteConfig CR から ClusterInstance CR への移行の概要
リンクのコピー

ClusterInstance CR は、クラスターを定義するためのより統一された汎用的な方法を提供します。これは、GitOps ZTP ワークフローでクラスターデプロイメントを管理するための推奨される方法です。ClusterInstance カスタムリソース (CR) を管理する SiteConfig Operator は、Red Hat Advanced Cluster Management (RHACM) 内のアドオンとして出荷される開発が完了したコントローラーです。

重要

SiteConfig Operator は ClusterInstance オブジェクトの更新のみをリコンサイルします。コントローラーは、非推奨の SiteConfig オブジェクトを監視または管理しません。

SiteConfig CR から ClusterInstance CR への移行により、スケーラビリティーの強化や、クラスターパラメーターとクラスターデプロイメント方法の明確な分離など、いくつかの点が改善されました。これらの改善点と SiteConfig Operator の詳細は、SiteConfig を参照してください。

移行プロセスには、大まかに次のステップが含まれます。

  1. リポジトリーに新しい Git フォルダー構造を準備し、対応する Argo CD プロジェクトとアプリケーションを作成して、並列パイプラインを設定します。

  2. クラスターを段階的に移行するには、まず、古いパイプラインから関連する SiteConfig CR を削除します。次に、対応する ClusterInstance CR を新しいパイプラインに追加します。

    注記

    初期 Argo CD アプリケーションで prune=false 同期ポリシーを使用すると、このアプリケーションからターゲットクラスターを削除した後でも、このパイプラインによって管理されるリソースはそのまま残ります。このアプローチにより、既存のクラスターリソースは移行プロセス中も確実に動作を継続します。

    1. 必要に応じて、siteconfig-converter ツールを使用して、既存の SiteConfig CR を ClusterInstance CR に自動的に変換します。
  3. クラスターの移行が完了したら、元の Argo プロジェクトとアプリケーションを削除し、関連するリソースをクリーンアップします。

次のセクションでは、サンプルクラスターである sno1 を、SiteConfig CR から ClusterInstance CR に移行する方法について説明します。

この移行例の基礎として、次の Git リポジトリーフォルダー構造が使用されます。 

├── site-configs/
│   ├── kustomization.yaml
│   ├── hub-1/
│   │   └── kustomization.yaml
│   │   ├── sno1.yaml
│   │   ├── sno2.yaml
│   │   ├── sno3.yaml
│   │   ├── extra-manifest/
│   │   │   ├── enable-crun-master.yaml
│   │   │   └── enable-crun-worker.yaml
│   ├── pre-reqs/
│   │   ├── kustomization.yaml
│   │   ├── sno1/
│   │   │   ├── bmc-credentials.yaml
│   │   │   ├── kustomization.yaml
│   │   │   └── pull-secret.yaml
│   │   ├── sno2/
│   │   │   ├── bmc-credentials.yaml
│   │   │   ├── kustomization.yaml
│   │   │   └── pull-secret.yaml
│   │   └── sno3/
│   │       ├── bmc-credentials.yaml
│   │       ├── kustomization.yaml
│   │       └── pull-secret.yaml
│   ├── reference-manifest/
│   │   └── 4.20/
│   ├──resources/
│   │   ├── active-ocp-version.yaml
│   │   └── kustomization.yaml

└── site-policies/ #Policies and configurations implemented for the clusters
...
Copy to Clipboard Toggle word wrap
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

Theme

© 2025 Red Hat