2.2.3. ClusterObjectSets


중요

ClusterObjectSets는 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.

Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

OLM(Operator Lifecycle Manager) v1의 일부로 operator-controller는 ClusterExtension 오브젝트로 콘텐츠를 설치하거나 업그레이드할 때 ClusterObjectSet 리소스를 생성합니다. ClusterObjectSet 오브젝트를 사용하면 Kubernetes 리소스의 단계적 롤아웃을 안전하게 사용할 수 있습니다.

ClusterObjectSet 오브젝트는 클러스터 범위 리소스입니다. 설치하는 것은 만족스럽지 않습니다. ClusterExtension 오브젝트의 한 버전에 대한 컨트롤러의 내부 레코드입니다. 단계 간에 기본 제공 준비 상태로 관련 리소스를 순차적으로 롤아웃합니다.

ClusterObjectSet 오브젝트는 관련 Kubernetes 리소스 세트를 관리할 때 여러 문제를 해결합니다.

변경할 수 없는 버전 콘텐츠
버전 번호, 단계, 오브젝트 및 충돌 보호 전략은 변경할 수 없습니다. 즉, 설정한 후에는 변경할 수 없습니다. 이는 각 버전에 배포된 사항에 대한 명확한 감사 추적을 제공합니다.
단계적 롤아웃
리소스는 배포 전에 CRD와 같이 단계(예: CRD)로 그룹화되며 순차적으로 배포됩니다. 단계는 모든 오브젝트가 준비 상태 프로브를 통과한 후에만 진행됩니다. 매니페스트는 클러스터에 적용되는 단계로 구성되며 다음 단계로 진행하기 전에 일부 상태 프로브를 전달해야 합니다. 이렇게 하면 불완전한 설치가 발생하지 않습니다.
안전한 전환
업그레이드하는 동안 새 버전이 성공할 때까지 이전 버전과 새 버전이 모두 활성 상태로 유지됩니다. 버전 간 오브젝트 소유권이 자동으로 전환됩니다.
단일 소유권
각 리소스는 한 번에 하나의 ClusterObjectSet 에서만 관리할 수 있으므로 충돌을 방지할 수 있습니다.
대규모 리소스 지원
오브젝트 매니페스트는 인라인으로 저장하거나 시크릿에 외부화할 수 있으므로 etcd 1.5MiB 오브젝트 크기 제한보다 큰 번들이 허용됩니다.
참고

Archived ClusterObjectSet 버전은 ClusterExtension 오브젝트에 적용된 내용의 기록으로 클러스터에 남아 있습니다.

ClusterObjectSet 에는 다음 내용이 포함되어 있습니다.

버전 번호
버전을 식별하는 영구적인 순차적 정수입니다. 번들 버전이 변경되면 새 버전이 생성됩니다. 업그레이드하는 동안 새 버전이 완료될 때까지 이전 버전과 새 버전을 모두 활성화할 수 있습니다. 이전 버전은 보관되어 있습니다.
라이프사이클 상태
그러면 Active (관리 및 조정) 또는 아카이브 가 될 수 있는 ClusterObjectSet 의 상태가 표시됩니다. lifecycleStateActive 에서 Archived 로 전환되지만 다시는 전환되지 않습니다.
단계 목록
ClusterObjectSet 내의 개체는 단계별로 구성됩니다. 각 단계 그룹 관련 리소스 및 단계는 순차적으로 적용됩니다. 단계 내에서 모든 오브젝트는 특정 순서로 동시에 적용됩니다.
충돌 보호 전략
ClusterObjectSet 이 클러스터에서 기존 오브젝트를 채택할 수 있는지 여부를 제어합니다.
상태 조건
버전이 적극적으로 롤아웃 중인지 여부를 나타내며 롤아웃 진행 상황, 가용성 및 성공을 보고합니다.

대부분의 ClusterObjectSet 은 한 번에 지정된 클러스터 오브젝트를 관리합니다. 매우 큰 번들이 매니페스트를 Secret 오브젝트에 저장하므로 크기 제한이 설치 또는 업그레이드를 차단하지 않습니다.

또한 ClusterObjectSet 에서 생성한 대규모 오브젝트 번들 관리에 대한 지원이 제공됩니다. ClusterObjectSet embeds Kubernetes manifests in .spec.phases[].objects[].object. 현재 단계당 최대 20단계 및 50개의 오브젝트를 사용하면 etcd 1.5MiB 오브젝트 크기 제한을 초과할 수 있습니다. 많은 CRD, 배포, RBAC 규칙 및 Webhook 구성이 있는 대규모 Operator는 이 제한에 자주 도달하여 API 서버가 ClusterObjectSet 을 거부하고 설치 또는 업그레이드에 실패합니다.

이 문제를 해결하려면 오브젝트별 참조를 사용하여 오브젝트를 Secret 리소스로 외부화할 수 있습니다. 단계 데이터는 변경할 수 없으며 리버전 조정기에서만 소비되므로 외부화에 적합합니다.

Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 소개

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

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

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

Red Hat 문서 정보

Legal Notice

Theme

© 2026 Red Hat
맨 위로 이동