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


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

중요
  • SiteConfig CR 는 OpenShift Container Platform 버전 4.18에서 중단되었으며 OpenShift Container Platform 4.21에서 제거되었습니다.
  • ClusterInstance CR 는 Red Hat Advanced Cluster Management (RHACM) 버전 2.12 이상에서 사용할 수 있습니다.

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

ClusterInstance CR 는 클러스터 정의에 대한 보다 통합적이고 일반적인 접근 방식을 제공하며 GitOps ZTP 워크플로우에서 클러스터 구축을 관리하는 선호되는 방법입니다. ClusterInstance Custom Resource(CR)를 관리하는 SiteConfig Operator는 Red Hat Advanced Cluster Management(RHACM) 내에서 추가 기능으로 제공되는 완벽하게 개발된 컨트롤러입니다.

중요

SiteConfig Operator 는 ClusterInstance 객체의 업데이트만 조정합니다. 컨트롤러는 제거된 SiteConfig 객체를 모니터링하거나 관리하지 않습니다.

SiteConfig CR 에서 ClusterInstance CR 으로의 마이그레이션은 확장성 향상 및 클러스터 deployment 방법과 클러스터 매개 변수를 분리하는 등 여러 가지 개선 사항을 제공합니다. 이러한 개선 사항과 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 프로젝트와 애플리케이션을 삭제하고 관련 리소스를 청소합니다.

다음 섹션에서는 SiteConfig CR 를 사용하여 ClusterInstance CR 에 sno1 를 마이그레이션하는 방법에 대해 설명합니다.

다음 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.22/
│   ├──resources/
│   │   ├── active-ocp-version.yaml
│   │   └── kustomization.yaml

└── site-policies/ #Policies and configurations implemented for the clusters
...
Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 소개

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

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 문서 정보

Legal Notice

Theme

© 2026 Red Hat
맨 위로 이동