9장. virtctl 및 libguestfs CLI 툴 사용

virtctl 명령줄 툴을 사용하여 OpenShift Virtualization 리소스를 관리할 수 있습니다.

virtctl 을 사용하여 libguestfs-tools 컨테이너를 배포할 수도 있습니다. libguestfs는 VM(가상 머신) 디스크 이미지에 액세스하고 수정하기 위한 툴 세트입니다.

9.1. virtctl 설치

Linux, Windows 및 MacOS 운영 체제에 virtctl 을 설치하려면 virtctl 바이너리 파일을 다운로드하여 설치합니다.

RHEL(Red Hat Enterprise Linux)에 virtctl 을 설치하려면 OpenShift Virtualization 리포지토리를 활성화한 다음 kubevirt-virtctl 패키지를 설치합니다.

9.1.1. Linux, Windows 및 macOS에 virtctl 설치

운영 체제에 대한 virtctl 바이너리를 다운로드하여 설치합니다.

절차

  1. OpenShift Container Platform 웹 콘솔에서 가상화 → 개요 페이지로 이동합니다.
  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

9.1.2. RHEL에 virtctl 설치

OpenShift Virtualization 리포지토리를 활성화하고 kubevirt- virtctl 패키지를 설치하여 RHEL(Red Hat Enterprise Linux)에 virtctl RPM을 설치합니다.

사전 요구 사항

  • 클러스터의 각 호스트는 RHSM(Red Hat Subscription Manager)에 등록되어 있어야 하며 유효한 OpenShift Container Platform 서브스크립션이 있어야 합니다.

절차

  • subscription-manager CLI 툴을 사용하여 운영 체제에 적절한 OpenShift Virtualization 리포지토리를 활성화합니다.

    • RHEL 9:

      # subscription-manager repos --enable cnv-4.13-for-rhel-9-x86_64-rpms
    • RHEL 8:

      # subscription-manager repos --enable cnv-4.13-for-rhel-8-x86_64-rpms
  • kubevirt-virtctl 패키지를 설치합니다.

    # yum install kubevirt-virtctl