프로세스

1. 관리자로 Operator → OperatorHub를 클릭합니다.
2. 키워드로 필터링 필드에 OpenShift Virtualization을 입력합니다.
3. OpenShift Virtualization 타일을 선택합니다.
4. Operator에 대한 정보를 확인하고 Install을 클릭합니다.

5. Operator 설치 페이지에서 다음을 수행합니다.

   1. 사용 가능한 업데이트 채널 옵션 목록에서 stable을 선택합니다. 이렇게 하면 OpenShift Container Platform 버전과 호환되는 OpenShift Virtualization 버전을 설치할 수 있습니다.

   2. 설치된 네임스페이스의 경우 Operator 권장 네임스페이스 옵션이 선택되어 있는지 확인합니다. 그러면 필수 openshift-cnv 네임스페이스에 Operator가 설치되고, 해당 네임스페이스가 존재하지 않는 경우 자동으로 생성됩니다.

      주의

      openshift-cnv 이외의 네임스페이스에 OpenShift Virtualization Operator를 설치하려고 하면 설치가 실패합니다.

   3. 승인 전략의 경우 기본값인 자동을 선택하여 OpenShift Virtualization이 안정적인 업데이트 채널에서 새 버전을 사용할 수 있을 때 자동으로 업데이트되도록 하는 것이 좋습니다.

      수동 승인 전략을 선택할 수 있지만 클러스터의 지원 가능성 및 기능에 미칠 위험이 높기 때문에 이 방법은 권장할 수 없습니다. 이러한 위험을 완전히 이해하고 자동을 사용할 수 없는 경우에만 수동을 선택합니다.

      주의

      해당 OpenShift Container Platform 버전과 함께 사용할 때만 OpenShift Virtualization을 지원하므로 누락된 OpenShift Virtualization 업데이트가 없으면 클러스터가 지원되지 않을 수 있습니다.

6. openshift-cnv 네임스페이스에서 Operator를 사용할 수 있도록 설치를 클릭합니다.
7. Operator가 설치되면 HyperConverged 생성을 클릭합니다.
8. 선택 사항: OpenShift Virtualization 구성 요소에 대한 Infra 및 워크로드 노드 배치 옵션을 구성합니다.
9. 생성을 클릭하여 OpenShift Virtualization을 시작합니다.

절차

1. 다음 매니페스트를 포함하는 YAML 파일을 만듭니다.

   apiVersion: v1
   kind: Namespace
   metadata:
     name: openshift-cnv
   ---
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: kubevirt-hyperconverged-group
     namespace: openshift-cnv
   spec:
     targetNamespaces:
       - openshift-cnv
   ---
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: hco-operatorhub
     namespace: openshift-cnv
   spec:
     source: redhat-operators
     sourceNamespace: openshift-marketplace
     name: kubevirt-hyperconverged
     startingCSV: kubevirt-hyperconverged-operator.v4.12.1
     channel: "stable" 1

   1

   stable 채널을 사용하면 OpenShift Container Platform 버전과 호환되는 OpenShift Virtualization 버전을 설치할 수 있습니다.

2. 다음 명령을 실행하여 OpenShift Virtualization에 필요한 Namespace, OperatorGroup 및 Subscription 오브젝트를 생성합니다.

   $ oc apply -f <file name>.yaml

절차

1. 다음 매니페스트를 포함하는 YAML 파일을 만듭니다.

   apiVersion: hco.kubevirt.io/v1beta1
   kind: HyperConverged
   metadata:
     name: kubevirt-hyperconverged
     namespace: openshift-cnv
   spec:

2. 다음 명령을 실행하여 OpenShift Virtualization Operator를 배포합니다.

   $ oc apply -f <file_name>.yaml

절차

1. OpenShift Container Platform 웹 콘솔에서 Virtualization > Overview 로 이동합니다.
2. 페이지 오른쪽 상단에 있는 Download virtctl 링크를 클릭하고 운영 체제용 virtctl 클라이언트를 다운로드합니다.

3. install virtctl:

   • Linux의 경우:

     1. 아카이브 파일의 압축을 풉니다.

        $ tar -xvf <virtctl-version-distribution.arch>.tar.gz

     2. 다음 명령을 실행하여 virtctl 바이너리를 실행할 수 있도록 합니다.

        $ chmod +x <path/virtctl-file-name>

     3. virtctl 바이너리를 PATH 환경 변수의 디렉터리로 이동합니다.

        다음 명령을 실행하여 경로를 확인할 수 있습니다.

        $ echo $PATH

     4. KUBECONFIG 환경 변수를 설정합니다.

        $ export KUBECONFIG=/home/<user>/clusters/current/auth/kubeconfig

   • Windows의 경우:

     1. 아카이브 파일의 압축을 풉니다.
     2. 추출된 폴더 계층 구조로 이동하고 virtctl 실행 파일을 두 번 클릭하여 클라이언트를 설치합니다.

     3. virtctl 바이너리를 PATH 환경 변수의 디렉터리로 이동합니다.

        다음 명령을 실행하여 경로를 확인할 수 있습니다.

        C:\> path

   • macOS의 경우:

     1. 아카이브 파일의 압축을 풉니다.

     2. virtctl 바이너리를 PATH 환경 변수의 디렉터리로 이동합니다.

        다음 명령을 실행하여 경로를 확인할 수 있습니다.

        echo $PATH

1. HyperConverged CR을 삭제합니다.
2. OpenShift Virtualization Operator를 삭제합니다.
3. openshift-cnv 네임스페이스를 삭제합니다.
4. OpenShift Virtualization CRD(사용자 정의 리소스 정의)를 삭제합니다.

절차

1. HyperConverged 사용자 정의 리소스를 삭제합니다.

   $ oc delete HyperConverged kubevirt-hyperconverged -n openshift-cnv

2. OpenShift Virtualization Operator 서브스크립션을 삭제합니다.

   $ oc delete subscription kubevirt-hyperconverged -n openshift-cnv

3. OpenShift Virtualization ClusterServiceVersion 리소스를 삭제합니다.

   $ oc delete csv -n openshift-cnv -l operators.coreos.com/kubevirt-hyperconverged.openshift-cnv

4. 시험 실행 옵션을 사용하여 oc delete crd 명령을 실행하여 OpenShift Virtualization CRD(사용자 정의 리소스 정의) 를 나열합니다.

   $ oc delete crd --dry-run=client -l operators.coreos.com/kubevirt-hyperconverged.openshift-cnv

   출력 예

   customresourcedefinition.apiextensions.k8s.io "cdis.cdi.kubevirt.io" deleted (dry run)
   customresourcedefinition.apiextensions.k8s.io "hostpathprovisioners.hostpathprovisioner.kubevirt.io" deleted (dry run)
   customresourcedefinition.apiextensions.k8s.io "hyperconvergeds.hco.kubevirt.io" deleted (dry run)
   customresourcedefinition.apiextensions.k8s.io "kubevirts.kubevirt.io" deleted (dry run)
   customresourcedefinition.apiextensions.k8s.io "networkaddonsconfigs.networkaddonsoperator.network.kubevirt.io" deleted (dry run)
   customresourcedefinition.apiextensions.k8s.io "ssps.ssp.kubevirt.io" deleted (dry run)
   customresourcedefinition.apiextensions.k8s.io "tektontasks.tektontasks.kubevirt.io" deleted (dry run)

5. dry-run 옵션 없이 oc delete crd 명령을 실행하여 CRD를 삭제합니다.

   $ oc delete crd -l operators.coreos.com/kubevirt-hyperconverged.openshift-cnv

절차

1. OpenShift Container Platform 웹 콘솔의 관리자 관점에서 Operator → 설치된 Operator로 이동합니다.
2. 보류 중인 업데이트가 있는 Operator에 업그레이드 사용 가능 상태가 표시됩니다. 업데이트할 Operator 이름을 클릭합니다.
3. 서브스크립션 탭을 클릭합니다. 승인이 필요한 업데이트는 업그레이드 상태 옆에 표시됩니다. 예를 들어 1 승인 필요가 표시될 수 있습니다.
4. 1 승인 필요를 클릭한 다음 설치 계획 프리뷰를 클릭합니다.
5. 업데이트에 사용할 수 있는 것으로 나열된 리소스를 검토합니다. 문제가 없는 경우 승인을 클릭합니다.
6. Operator → 설치된 Operator 페이지로 다시 이동하여 업데이트 진행 상황을 모니터링합니다. 완료되면 상태가 성공 및 최신으로 변경됩니다.

절차

1. 다음 명령을 실행합니다.

   $ oc get csv -n openshift-cnv

2. PHASE 필드를 확인하여 출력을 검토합니다. 예를 들면 다음과 같습니다.

   출력 예

   VERSION  REPLACES                                        PHASE
   4.9.0    kubevirt-hyperconverged-operator.v4.8.2         Installing
   4.9.0    kubevirt-hyperconverged-operator.v4.9.0         Replacing

3. 선택 사항: 다음 명령을 실행하여 모든 OpenShift Virtualization 구성 요소 조건을 집계한 상태를 모니터링합니다.

   $ oc get hco -n openshift-cnv kubevirt-hyperconverged \
   -o=jsonpath='{range .status.conditions[*]}{.type}{"\t"}{.status}{"\t"}{.message}{"\n"}{end}'

   업그레이드가 완료되면 다음과 같은 결과가 나타납니다.

   출력 예

   ReconcileComplete  True  Reconcile completed successfully
   Available          True  Reconcile completed successfully
   Progressing        False Reconcile completed successfully
   Degraded           False Reconcile completed successfully
   Upgradeable        True  Reconcile completed successfully

절차

1. 웹 콘솔의 도움말 메뉴에서 빠른 시작을 선택합니다.
2. 빠른 시작 카탈로그에서 타일을 클릭합니다. 예: Red Hat Linux Enterprise Linux 가상 머신 생성.
3. 기능 둘러보기의 지침에 따라 운영 체제 이미지를 가져오고 가상 머신을 생성하는 작업을 완료합니다. 가상화 → VirtualMachines 페이지에 가상 머신이 표시됩니다.

절차

1. 사이드 메뉴에서 가상화 → 카탈로그 를 클릭합니다.

2. 부팅 소스가 있는 템플릿을 필터링하려면 사용 가능한 부팅 소스를 클릭합니다.

   참고

   기본적으로 템플릿 목록은 기본 템플릿 만 표시합니다. 필터링 시 모든 항목을 클릭하여 선택한 필터에 사용 가능한 모든 템플릿을 확인합니다.

3. 템플릿을 클릭하여 세부 정보를 확인합니다.

4. 빠른 생성 VirtualMachine 를 클릭하여 템플릿에서 VM을 생성합니다.

   가상 머신 세부 정보 페이지가 배포 상태와 함께 표시됩니다.

검증

1. 이벤트를 클릭하여 VM이 프로비저닝될 때 이벤트 스트림을 확인합니다.
2. 콘솔을 클릭하여 VM이 성공적으로 부팅되었는지 확인합니다.

절차

1. 웹 콘솔에서 템플릿을 선택합니다.

   1. 사이드 메뉴에서 가상화 → 카탈로그 를 클릭합니다.
   2. 선택 사항: 프로젝트, 키워드, 운영 체제 또는 워크로드 프로필로 템플릿을 필터링합니다.
   3. 사용자 지정할 템플릿을 클릭합니다.
2. Customize VirtualMachine 를 클릭합니다.
3. Name 및 Disk 소스를 포함하여 VM의 매개변수를 지정합니다. 선택적으로 복제할 데이터 소스를 지정할 수 있습니다.

검증

1. 이벤트를 클릭하여 VM이 프로비저닝될 때 이벤트 스트림을 확인합니다.
2. 콘솔을 클릭하여 VM이 성공적으로 부팅되었는지 확인합니다.

절차

1. VM의 VirtualMachine 매니페스트를 편집합니다. 예를 들어 다음 매니페스트에서는 RHEL(Red Hat Enterprise Linux) VM을 구성합니다.

   예 10.1. RHEL VM의 매니페스트 예

   apiVersion: kubevirt.io/v1
   kind: VirtualMachine
   metadata:
     labels:
       app: <vm_name> 1
     name: <vm_name>
   spec:
     dataVolumeTemplates:
     - apiVersion: cdi.kubevirt.io/v1beta1
       kind: DataVolume
       metadata:
         name: <vm_name>
       spec:
         sourceRef:
           kind: DataSource
           name: rhel9
           namespace: openshift-virtualization-os-images
         storage:
           resources:
             requests:
               storage: 30Gi
     running: false
     template:
       metadata:
         labels:
           kubevirt.io/domain: <vm_name>
       spec:
         domain:
           cpu:
             cores: 1
             sockets: 2
             threads: 1
           devices:
             disks:
             - disk:
                 bus: virtio
               name: rootdisk
             - disk:
                 bus: virtio
               name: cloudinitdisk
             interfaces:
             - masquerade: {}
               name: default
             rng: {}
           features:
             smm:
               enabled: true
           firmware:
             bootloader:
               efi: {}
           resources:
             requests:
               memory: 8Gi
         evictionStrategy: LiveMigrate
         networks:
         - name: default
           pod: {}
         volumes:
         - dataVolume:
             name: <vm_name>
           name: rootdisk
         - cloudInitNoCloud:
             userData: |-
               #cloud-config
               user: cloud-user
               password: '<password>' 2
               chpasswd: { expire: False }
           name: cloudinitdisk

   1

   가상 머신의 이름을 지정합니다.

   2

   cloud-user의 암호를 지정합니다.

2. 매니페스트 파일을 사용하여 가상 머신을 생성합니다.

   $ oc create -f <vm_manifest_file>.yaml

3. 선택 사항: 가상 머신을 시작합니다.

   $ virtctl start <vm_name>

절차

1. 웹 콘솔에서 가상화 → VirtualMachines 로 이동합니다.
2. 가상 머신을 선택하여 VirtualMachine 세부 정보 페이지를 엽니다.
3. 필드를 편집할 수 있음을 나타내는 연필 아이콘이 있는 필드를 클릭합니다. 예를 들어 BIOS 또는 UEFI와 같은 현재 부팅 모드 설정을 클릭하여 부팅 모드 창을 열고 목록에서 옵션을 선택합니다.
4. 저장을 클릭합니다.

절차

1. 사이드 메뉴에서 가상화 → VirtualMachine를 클릭합니다.
2. 가상 머신을 선택합니다.
3. YAML 탭을 클릭하여 편집 가능한 구성을 표시합니다.
4. 선택 사항: 다운로드를 클릭하여 YAML 파일을 현재 상태에서 로컬로 다운로드할 수 있습니다.
5. 파일을 편집하고 저장을 클릭합니다.

절차

1. 다음 명령을 실행하여 가상 머신 구성을 업데이트합니다.

   $ oc edit <object_type> <object_ID>

2. 오브젝트 구성을 엽니다.
3. YAML을 편집합니다.

4. 실행 중인 가상 머신을 편집하는 경우 다음 중 하나를 수행해야 합니다.

   • 가상 머신을 재시작합니다.

   • 새 구성을 적용하려면 다음 명령을 실행합니다.

     $ oc apply <object_type> <object_ID>

절차

1. 사이드 메뉴에서 가상화 → VirtualMachine를 클릭합니다.
2. 가상 머신을 선택하여 VirtualMachine 세부 정보 화면을 엽니다.
3. 디스크 탭을 클릭한 다음 디스크 추가를 클릭합니다.

4. 디스크 추가 창에서 소스 ,이름 , 크기,유형,인터페이스 및 스토리지 클래스를 지정합니다.

   1. 선택 사항: 빈 디스크 소스를 사용하고 데이터 볼륨을 생성할 때 최대 쓰기 성능이 필요한 경우 사전 할당을 활성화할 수 있습니다. 이를 수행하려면 사전 할당 활성화 확인란을 선택합니다.
   2. 선택 사항: 최적화된 StorageProfile 설정을 지워 지워 가상 디스크의 볼륨 모드 및 액세스 모드 를 변경할 수 있습니다. 이러한 매개변수를 지정하지 않으면 kubevirt-storage-class-defaults 구성 맵의 기본값이 사용됩니다.
5. 추가를 클릭합니다.

절차

1. 사이드 메뉴에서 가상화 → VirtualMachine를 클릭합니다.
2. 가상 머신을 선택하여 VirtualMachine 세부 정보 화면을 엽니다.
3. 네트워크 인터페이스 탭을 클릭합니다.
4. 네트워크 인터페이스 추가를 클릭합니다.
5. 네트워크 인터페이스 추가 창에서 네트워크 인터페이스의 이름, 모델, 네트워크, 유형, MAC 주소를 지정합니다.
6. 추가를 클릭합니다.

절차

1. 사이드 메뉴에서 가상화 → VirtualMachine를 클릭합니다.
2. 가상 머신을 선택하여 VirtualMachine 세부 정보 페이지를 엽니다.
3. 세부 정보 탭을 클릭합니다.
4. 부팅 순서 오른쪽에 있는 연필 아이콘을 클릭합니다. YAML 구성이 존재하지 않거나 처음으로 부팅 순서 목록을 생성하는 경우 다음 메시지가 표시됩니다. 선택된 리소스가 없습니다. VM은 YAML 파일에 나타나는 순서에 따라 디스크에서 부팅하려고 합니다.
5. 소스 추가를 클릭하고 가상 시스템의 부팅 가능한 디스크 또는 NIC(네트워크 인터페이스 컨트롤러)를 선택합니다.
6. 부팅 순서 목록에 추가 디스크 또는 NIC를 추가합니다.
7. 저장을 클릭합니다.

절차

1. 사이드 메뉴에서 가상화 → VirtualMachine를 클릭합니다.
2. 가상 머신을 선택하여 VirtualMachine 세부 정보 페이지를 엽니다.
3. 세부 정보 탭을 클릭합니다.
4. 부팅 순서 오른쪽에 있는 연필 아이콘을 클릭합니다.

5. 부팅 순서 목록에서 항목을 이동하는 적절한 방법을 선택합니다.

   • 화면 판독기를 사용하지 않는 경우 이동할 항목 옆에 있는 화살표 아이콘 위로 마우스를 가져가서 항목을 위 또는 아래로 끌어 원하는 위치에 놓습니다.
   • 화면 판독기를 사용하는 경우 위쪽 화살표 키 또는 아래쪽 화살표 키를 눌러 부팅 순서 목록에서 항목을 이동합니다. 그런 다음 Tab 키를 눌러 원하는 위치에 항목을 놓습니다.
6. 저장을 클릭합니다.

절차

1. 다음 명령을 실행하여 가상 머신의 YAML 구성 파일을 엽니다.

   $ oc edit vm example

2. YAML 파일을 편집하고 디스크 또는 NIC(네트워크 인터페이스 컨트롤러)와 연결된 부팅 순서 값을 수정합니다. 예를 들면 다음과 같습니다.

   disks:
     - bootOrder: 1 1
       disk:
         bus: virtio
       name: containerdisk
     - disk:
         bus: virtio
       name: cloudinitdisk
     - cdrom:
         bus: virtio
       name: cd-drive-1
   interfaces:
     - boot Order: 2 2
       macAddress: '02:96:c4:00:00'
       masquerade: {}
       name: default

   1

   디스크에 지정된 부팅 순서 값입니다.

   2

   네트워크 인터페이스 컨트롤러에 지정된 부팅 순서 값입니다.

3. YAML 파일을 저장합니다.
4. 컨텐츠 다시 로드를 클릭하여 YAML 파일의 업데이트된 부팅 순서 값을 웹 콘솔의 부팅 순서 목록에 적용합니다.

절차

1. 사이드 메뉴에서 가상화 → VirtualMachine를 클릭합니다.
2. 가상 머신을 선택하여 VirtualMachine 세부 정보 페이지를 엽니다.
3. 세부 정보 탭을 클릭합니다.
4. 부팅 순서 오른쪽에 있는 연필 아이콘을 클릭합니다.
5. 해당 항목 옆에 있는 제거 아이콘 을 클릭합니다. 항목이 부팅 순서 목록에서 제거되고 사용 가능한 부팅 소스 목록에 저장됩니다. 부팅 순서 목록의 모든 항목을 제거하면 다음 메시지가 표시됩니다. 선택된 리소스가 없습니다. VM은 YAML 파일에 나타나는 순서에 따라 디스크에서 부팅하려고 합니다.

절차

1. OpenShift Container Platform 콘솔 의 사이드 메뉴에서 가상화 → VirtualMachine 를 클릭합니다.

2. 삭제할 가상 머신의 옵션 메뉴 를 클릭하고 삭제 를 선택합니다.

   • 또는 가상 머신 이름을 클릭하여 VirtualMachine 세부 정보 페이지를 열고 작업 → 삭제 를 클릭합니다.
3. 확인 팝업 창에서 삭제를 클릭하여 가상 머신을 영구적으로 삭제합니다.

절차

1. 다음 예에 따라 VirtualMachine , VirtualMachine Snapshot 또는 PersistentVolumeClaim CR에서 볼륨을 내보내고 example-export.yaml 로 저장할 VirtualMachineExport 매니페스트를 생성합니다.

   VirtualMachineExport 예

   apiVersion: export.kubevirt.io/v1alpha1
   kind: VirtualMachineExport
   metadata:
     name: example-export
   spec:
     source:
       apiGroup: "kubevirt.io" 1
       kind: VirtualMachine 2
       name: example-vm
     ttlDuration: 1h 3

   1

   적절한 API 그룹을 지정합니다.

   • VirtualMachine 의 "kubevirt.io ".
   • VirtualMachineSnapshot 의 "snapshot.kubevirt.io ".
   • PersistentVolumeClaim 의 "".

   2

   VirtualMachine,VirtualMachineSnapshot 또는 PersistentVolumeClaim 을 지정합니다.

   3

   선택사항입니다. 기본 기간은 2 시간입니다.

2. VirtualMachineExport CR을 생성합니다.

   $ oc create -f example-export.yaml

3. VirtualMachineExport CR을 가져옵니다.

   $ oc get vmexport example-export -o yaml

   내보낸 볼륨의 내부 및 외부 링크는 상태 스탠자에 표시됩니다.

   출력 예

   apiVersion: export.kubevirt.io/v1alpha1
   kind: VirtualMachineExport
   metadata:
     name: example-export
     namespace: example
   spec:
     source:
       apiGroup: ""
       kind: PersistentVolumeClaim
       name: example-pvc
     tokenSecretRef: example-token
   status:
     conditions:
     - lastProbeTime: null
       lastTransitionTime: "2022-06-21T14:10:09Z"
       reason: podReady
       status: "True"
       type: Ready
     - lastProbeTime: null
       lastTransitionTime: "2022-06-21T14:09:02Z"
       reason: pvcBound
       status: "True"
       type: PVCReady
     links:
       external: 1
         cert: |-
           -----BEGIN CERTIFICATE-----
           ...
           -----END CERTIFICATE-----
         volumes:
         - formats:
           - format: raw
             url: https://vmexport-proxy.test.net/api/export.kubevirt.io/v1alpha1/namespaces/example/virtualmachineexports/example-export/volumes/example-disk/disk.img
           - format: gzip
             url: https://vmexport-proxy.test.net/api/export.kubevirt.io/v1alpha1/namespaces/example/virtualmachineexports/example-export/volumes/example-disk/disk.img.gz
           name: example-disk
       internal:  2
         cert: |-
           -----BEGIN CERTIFICATE-----
           ...
           -----END CERTIFICATE-----
         volumes:
         - formats:
           - format: raw
             url: https://virt-export-example-export.example.svc/volumes/example-disk/disk.img
           - format: gzip
             url: https://virt-export-example-export.example.svc/volumes/example-disk/disk.img.gz
           name: example-disk
     phase: Ready
     serviceName: virt-export-example-export

   1

   외부 링크는 Ingress 또는 경로를 사용하여 클러스터 외부에서 액세스할 수 있습니다.

   2

   내부 링크는 클러스터 내에서만 유효합니다.