OpenShift 가상화 애드온 관리
가상 사설 클라우드 4.21 그리고 나중에 베어 메탈 워커 노드만 RHCOS 전용
openshift-virtualization 애드온은 OpenShift 가상화 서비스 클러스터에서 가상화 플랫폼을 설정할 수 있는 원클릭 환경을 제공합니다. 이 애드온은 모든 가상화 서비스 클러스터에서 기본적으로 자동으로 활성화됩니다.
OpenShift 가상화 애드온 이해하기
OpenShift 가상화 애드온은 가상화 서비스 클러스터에서 가상 머신 기능을 사용할 수 있도록 다음 오퍼레이터의 배포 및 관리를 조정합니다:
- OpenShift 가상화 운영 담당자 (하이퍼컨버지드)
- 가상 머신을 실행하고 관리하는 데 필요한 핵심 가상화 기능을 제공합니다. 자세한 내용은 ‘ OpenShift 가상화 설치’를 참조하십시오.
- NMState 운영자
- 가상 머신 및 노드의 네트워크 구성을 관리합니다. 자세한 내용은 ‘ Kubernetes NMState Operator 정보’를 참조하십시오.
- Node 유지보수 담당자
- 가상 머신 워크로드에 대한 노드 유지 관리 작업을 처리합니다. 자세한 내용은 Node 의 ‘유지보수 운영자’ 항목을 참조하십시오.
Red Hat ( OperatorHub )에서 제공하는 이러한 연산자의 설치는 Virtualization Service 클러스터에서 차단됩니다. 이 애드온은 모든 운영자 설치 및 업데이트를 관리합니다.
추가 기능
OpenShift 가상화 애드온은 다음과 같은 특징을 가지고 있습니다:
- 자동 활성화
- 가상화 서비스 클러스터를 생성하면 이 애드온이 자동으로 활성화됩니다. CLI나 콘솔을 통해 이 애드온을 수동으로 활성화할 수 없습니다.
- 비활성화할 수 없습니다
- 이 애드온을 비활성화하는 기능은 지원되지 않습니다. 콘솔에서는 이 옵션을 사용할 수 없으며, CLI를 통해 비활성화하려고 하면 오류가 발생합니다.
- 설정 옵션 없음
- 이 애드온에는 사용자가 설정할 수 있는 매개변수가 없습니다.
- 버전 바인딩
- 애드온 버전은 가상화 서비스 클러스터 버전(예: 4.21 )에 연동되어 있습니다. 이 애드온은 현재 소버전과 다음 소버전을 지원합니다( n+1 ). 예를 들어, 애드온 버전 4.21 은 가상화 서비스 버전 4.21 및 4.22 과 함께 사용할 수 있습니다.
- 자동 패치 업데이트
- 자동 승인 전략을 사용하면 패치 업데이트가 클러스터에 자동으로 적용됩니다. IBM 변경 사항에 대한 세부 정보를 포함하여, 서비스 출시 최소 1주일 전에 알려드립니다. 미러링된 오퍼레이터 카탈로그에 새 버전이 있는 경우, 모든 종속 오퍼레이터가 자동으로 업데이트됩니다. 이 애드온은 모든 운영자 업데이트에 대해
stable채널을 사용합니다. - 수동 버전 업그레이드
- 애드온을 최신 버전으로 업그레이드하려면(예: 4.20 에서 4.21 로), 먼저 가상화 서비스 클러스터를 대상 버전으로 업그레이드한 다음, CLI 명령어
ibmcloud ks cluster addon update openshift-virtualization --cluster CLUSTER_NAME_OR_ID --version VERSION를 사용하여 애드온 버전을 수동으로 업데이트해야 합니다. - 채널 업데이트
- 이 애드온은 업데이트를 위해
stable채널을 사용하며, 이 채널에서는 버그 수정 및 보안 문제 해결을 위한 Z-stream 업데이트를 제공합니다. - 버전 호환성
- 각 애드온 버전은 현재 가상화 서비스 버전(n)과 다음 마이너 버전( n+1 )을 지원합니다. 예를 들어, 애드온 버전 4.20 은 가상화 서비스 버전 4.20 및 4.21 을 지원합니다.
- 사용자 정의 카탈로그
- 애드온 활성화 과정에서 종속 연산자가 미러링된 사용자 지정 카탈로그가 자동으로 설정되며, 이는 ‘
openshift-marketplace’ 네임스페이스에 배치됩니다.
설치된 리소스
애드온이 활성화되면 다음 리소스가 생성됩니다:
- 상위 운영자 네임스페이스
ibm-openshift-virt-operator네임스페이스에는ibmopenshiftvirtualizations.openshiftvirt.ibm.io유형의 사용자 정의 리소스를 포함하여 상위 연산자와 관련된 모든 리소스가 포함되어 있습니다.- 사용자 정의 카탈로그
- 사용자 정의 카탈로그는
openshift-marketplace네임스페이스에 위치합니다. - 종속 연산자
- 상위 연산자는 메타 연산자 역할을 하며, 조정 과정에서 다음과 같은 종속 연산자들을 설치합니다:
- OpenShift 가상화 (
openshift-cnv네임스페이스 내) - NMState (
openshift-nmstate네임스페이스 내) - Node 유지보수 운영자 (
openshift-operators네임스페이스 내)
- OpenShift 가상화 (
추가 기능 정보 보기
계정에 해당 기능 플래그가 활성화된 경우, CLI를 사용하여 ‘ OpenShift ’ 가상화 애드온에 대한 정보를 확인할 수 있습니다. 기능 플래그가 활성화되어 있지 않은 경우, 콘솔과 클러스터 세부 정보를 통해 애드온 상태를 확인하십시오.
설치된 애드온 목록
가상화 서비스 클러스터에 설치된 모든 애드온을 나열합니다.
ibmcloud ks cluster addon ls --cluster CLUSTER_NAME_OR_ID
출력 예:
Name Version Health State Health Status
ibm-storage-operator 1.0 normal Addon Ready. For more info: http://ibm.biz/addon-state (H1500)
openshift-virtualization 4.21 normal Addon Ready. For more info: http://ibm.biz/addon-state (H1500)
추가 기능 정보 확인하기
계정에 해당 기능 플래그가 활성화되어 있다면, ‘ OpenShift ’ 가상화 애드온에 대한 자세한 정보를 확인하세요.
ibmcloud ks cluster addon get --addon openshift-virtualization --cluster CLUSTER_NAME_OR_ID
출력 예:
name: openshift-virtualization
Version: 4.21
Health State: normal
Health Status: Addon Ready. For more info: http://ibm.biz/addon-state (H1500)
사용 가능한 애드온 버전 목록
계정에 해당 기능 플래그가 활성화된 경우, ‘ OpenShift ’ 가상화 애드온의 사용 가능한 버전을 나열합니다.
ibmcloud ks cluster addon versions --addon openshift-virtualization
출력 예:
Name Version Supported Kubernetes Range Supported OpenShift Range Kubernetes Default OpenShift Default
openshift-virtualization 4.19 unsupported >=4.19.0 <4.21.0 - >=4.19.0 <4.21.0
openshift-virtualization 4.21 unsupported >=4.21.0 <4.23.0 - >=4.21.0 <4.23.0
이 출력 결과는 각 애드온 버전에서 지원되는 가상화 서비스 버전을 보여줍니다.
구성 옵션 확인
귀하의 계정에서 해당 기능 플래그가 활성화된 경우, ‘ OpenShift ’ 가상화 애드온이 구성 옵션을 지원하지 않는다는 사실을 확인할 수 있습니다.
ibmcloud ks cluster addon options --addon openshift-virtualization
출력 예:
FAILED
No addon installation options are available for openshift-virtualization.
추가 기능 업데이트
OpenShift 가상화 애드온은 두 가지 유형의 업데이트를 지원합니다:
자동 패치 업데이트
패치 업데이트(예: 4.21.1 에서 4.21.2 로의 변경)는 모든 클러스터에 자동으로 적용됩니다. 이번 업데이트에는 버그 수정 및 보안 패치가 포함되어 있습니다. IBM 프로덕션 환경에 패치 업데이트를 배포하기 최소 일주일 전에 사전 통지를 제공합니다.
자동 패치 업데이트 프로세스는 다음과 같은 작업을 수행합니다:
- 상위 연산자를 다시 시작합니다
- 카탈로그 소스를 조정합니다
stable채널 구독 내역을 기반으로 모든 하위 연산자를 업데이트합니다
수동 버전 업그레이드
OpenShift 가상화 애드온을 더 새로운 소버전으로 업그레이드하려면(예: 4.20 에서 4.21 로), 먼저 가상화 서비스 클러스터를 대상 버전으로 업그레이드해야 합니다. 사용자 계정에서 해당 기능 플래그가 활성화되어 있지 않은 경우, CLI 업데이트를 시도하기 전에 IBM 지원팀에 문의하십시오.
-
가상화 서비스 클러스터를 목표 버전으로 업그레이드하십시오. 자세한 내용은 클러스터 업데이트를 참조하십시오.
-
클러스터 업그레이드가 완료되면 애드온을 해당 버전으로 업데이트하십시오.
ibmcloud ks cluster addon update openshift-virtualization --cluster CLUSTER_NAME_OR_ID --version VERSION예를 들어, 버전으로 업데이트하려면 4.21:
ibmcloud ks cluster addon update openshift-virtualization --cluster my-rovs-cluster --version 4.21
최상의 호환성과 지원을 위해 클러스터 버전과 일치하도록 애드온 버전을 업데이트하는 것이 좋습니다.
애드온 비활성화
OpenShift 가상화 애드온을 비활성화하는 기능은 가상화 서비스 클러스터(1단계)에서는 지원되지 않습니다. 이 애드온은 가상화 서비스의 핵심 구성 요소이므로 제거할 수 없습니다. 사용자 계정에 해당 기능 플래그가 활성화되어 있는 상태에서 CLI 명령어를 실행하면 오류가 발생합니다.
ibmcloud ks cluster addon disable openshift-virtualization --cluster CLUSTER_NAME_OR_ID
2단계에서는 표준 ROKS 클러스터에 대한 애드온 제거 기능이 지원될 예정입니다.
애드온 문제 해결
OpenShift 가상화 애드온과 관련하여 문제가 발생할 경우, 지원 요청을 제출하기 전에 다음 정보를 미리 준비해 주십시오.
애드온 정보 수집
OpenShift 가상화 애드온 및 이에 종속된 오퍼레이터에 대한 세부 정보를 확인하려면 다음 명령을 실행하십시오.
-
IBM 의 ‘ OpenShift ’ 가상화 사용자 정의 리소스를 다운로드하세요.
oc get ibmopenshiftvirtualizations.openshiftvirt.ibm.io -n ibm-openshift-virt-operator -o yaml -
상위 연산자 네임스페이스에 있는 모든 리소스를 나열합니다.
oc get all -n ibm-openshift-virt-operator -
OpenShift 가상화 운영자의 상태를 확인하십시오.
oc get csv -n openshift-cnv -
HyperConverged 리소스에 대한 세부 정보를 확인하세요.
oc get hco -n openshift-cnv kubevirt-hyperconverged -o yaml -
OpenShift 가상화 네임스페이스에 있는 모든 리소스를 나열합니다.
oc get all -n openshift-cnv -
NMState 운영 상태를 확인하십시오.
oc get csv -n openshift-nmstate -
NMState 네임스페이스에 속한 모든 리소스를 나열합니다.
oc get all -n openshift-nmstate -
NMState 리소스 세부 정보를 확인하세요.
oc get nmstate nmstate -o yaml -
NodeNetworkConfigurationPolicy 리소스를 나열합니다.
oc get nncp -
Node 유지보수 운영자 상태를 확인하십시오.
oc get csv -n openshift-operators -
operators 네임스페이스에 있는 모든 리소스를 나열합니다.
oc get all -n openshift-operators -
사용자 정의 카탈로그 소스를 확인하십시오.
oc get catalogsource custom-redhat-operators-openshiftvirt -n openshift-marketplace -
사용자 정의 카탈로그의 패키지 매니페스트를 나열합니다.
oc get packagemanifests -n openshift-marketplace | grep "Custom Redhat Operators for Openshift Virtualization"
지원 케이스 열기
문제가 해결되지 않으면 지원 요청을 제출하고 문제 해결 명령어의 실행 결과를 함께 첨부해 주십시오. 자세한 정보는 지원 받기를 참조하십시오.