6장. SiteConfig CR에서 ClusterInstance CR로 마이그레이션


SiteConfig CR(사용자 정의 리소스)에서 ClusterInstance CR로 단일 노드 OpenShift 클러스터를 점진적으로 마이그레이션할 수 있습니다. 마이그레이션 중에 기존 및 새 파이프라인이 병렬로 실행되므로 제어 및 단계적 방식으로 한 번에 하나 이상의 클러스터를 마이그레이션할 수 있습니다.

중요
  • SiteConfig CR은 OpenShift Container Platform 버전 4.18에서 더 이상 사용되지 않으며 향후 버전에서 제거됩니다.
  • ClusterInstance CR은 RHACM(Red Hat Advanced Cluster Management) 버전 2.12 이상에서 사용할 수 있습니다.

6.1. SiteConfig CR에서 ClusterInstance CR로 마이그레이션 개요

ClusterInstance CR은 클러스터를 정의하는 데 보다 통합되고 일반적인 접근 방식을 제공하며 GitOps ZTP 워크플로에서 클러스터 배포를 관리하는 데 권장되는 방법입니다. ClusterInstance CR(사용자 정의 리소스)을 관리하는 SiteConfig Operator는 RHACM(Red Hat Advanced Cluster Management) 내에서 애드온으로 제공되는 완전히 개발된 컨트롤러입니다.

중요

SiteConfig Operator는 ClusterInstance 오브젝트에 대한 업데이트만 조정합니다. 컨트롤러는 더 이상 사용되지 않는 site Config 개체를 모니터링하거나 관리하지 않습니다.

SiteConfig CR에서 ClusterInstance CR로 마이그레이션하면 확장성 향상 및 클러스터 배포 방법에서 클러스터 매개변수를 명확하게 분리할 수 있습니다. 이러한 개선사항 및 siteConfig Operator에 대한 자세한 내용은 site Config를 참조하십시오.

마이그레이션 프로세스에는 다음과 같은 고급 단계가 포함됩니다.

  1. 리포지토리에서 새 Git 폴더 구조를 준비하고 해당 Argo CD 프로젝트 및 애플리케이션을 생성하여 병렬 파이프라인을 설정합니다.
  2. 클러스터를 점진적으로 마이그레이션하려면 먼저 이전 파이프라인에서 연결된 siteConfig CR을 제거합니다. 그런 다음 해당 ClusterInstance CR을 새 파이프라인에 추가합니다.

    참고

    초기 Argo CD 애플리케이션에서 prune=false 동기화 정책을 사용하면 이 애플리케이션에서 대상 클러스터를 제거한 후에도 이 파이프라인에서 관리하는 리소스는 그대로 유지됩니다. 이 방법을 사용하면 마이그레이션 프로세스 중에 기존 클러스터 리소스가 계속 작동합니다.

    1. 선택적으로 siteconfig-converter 툴을 사용하여 기존 SiteConfig CR을 ClusterInstance CR로 자동으로 변환합니다.
  3. 클러스터 마이그레이션을 완료하면 원래 Argo 프로젝트 및 애플리케이션을 삭제하고 관련 리소스를 정리합니다.

다음 섹션에서는 SiteConfig CR을 사용할 때 예제 클러스터 sno1ClusterInstance 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은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat