[컨테이너] RHOCP4 에서 virtctl 설치 및 사용법

2025. 6. 4. 23:45·깐돌의 클라우드 도구함
728x90

RHOCP 4.8에서 virtctl 클라이언트 설치 가이드

OpenShift Virtualization(CNV) 환경에서 가상 머신(VM) 리소스를 효율적으로 관리하기 위한 필수 도구인 **virtctl** 클라이언트에 대해 알아보겠습니다. virtctl은 Kubernetes 클러스터의 가상 머신 관련 작업을 제어하는 명령줄 유틸리티로, 리눅스, macOS, Windows 등 다양한 운영체제에서 사용할 수 있습니다.

이 가이드에서는 virtctl을 설치하는 두 가지 주요 방법을 상세히 설명합니다: OpenShift Container Platform(RHOCP) 콘솔을 통한 다운로드 방식과 리포지토리를 통한 설치 방식입니다. 현재 RHOCP 버전 4.8을 기준으로 설명하며, RHEL 8 환경에 초점을 맞춥니다.


목차

  1. virtctl 클라이언트란?
  2. RHOCP 콘솔을 통해 virtctl 설치하는 방법
    1. 명령줄 도구 메뉴 접근
    2. virtctl 클라이언트 다운로드
    3. 다운로드 파일 업로드 및 설치
  3. Repository를 통한 virtctl 설치 방법
    1. OpenShift Virtualization 리포지토리 확인
    2. virtctl 클라이언트 설치

1. virtctl 클라이언트란?

virtctl 클라이언트는 OpenShift Virtualization 환경에서 가상 머신 인스턴스(VMI), 가상 머신(VM), 데이터 볼륨(DataVolume)과 같은 리소스를 명령줄에서 직접 제어할 수 있게 해주는 유틸리티입니다. kubectl이 Kubernetes 리소스를 관리하는 것처럼, virtctl은 가상화 관련 리소스를 관리합니다.

주요 기능은 다음과 같습니다:

  • 가상 머신 시작/중지/재시작/일시 정지/재개
  • 가상 머신 콘솔 및 VNC 연결
  • 볼륨 추가/제거
  • VM 이미지 업로드 (DataVolume/PVC)
  • 가상 머신 마이그레이션
  • 게스트 OS 정보 및 파일 시스템, 사용자 목록 확인

virtctl은 리눅스, macOS, Windows 등 다양한 운영체제용으로 제공되므로, 개발 및 운영 환경에 맞춰 선택하여 사용할 수 있습니다.


2. RHOCP 콘솔을 통해 virtctl 설치하는 방법

가장 일반적이고 권장되는 virtctl 설치 방법 중 하나는 OpenShift Container Platform(RHOCP) 웹 콘솔을 이용하는 것입니다. 이 방법을 통해 현재 RHOCP 버전에 맞는 virtctl 클라이언트를 쉽게 다운로드할 수 있습니다.

2.1. 명령줄 도구 메뉴 접근

RHOCP 웹 콘솔에 로그인한 후, 우측 상단의 **'?' (도움말)** 메뉴를 선택합니다. 드롭다운 메뉴에서 **'명령줄 도구(Command Line Tools)'**를 선택합니다.

 

 


2.2. virtctl 클라이언트 다운로드

'명령줄 도구' 페이지로 이동하면, oc, odo 등 다양한 클라이언트 도구의 다운로드 링크를 확인할 수 있습니다. 페이지를 아래로 스크롤하여 **'virtctl'** 섹션을 찾습니다. 'virtctl'에 연결된 다운로드 링크를 선택합니다.

 

다운로드 페이지에서 **RHOCP 버전에 맞는 virtctl 클라이언트**를 선택해야 합니다. 현재 RHOCP 4.8 버전이므로, **'4.8 for RHEL8'**을 선택한 후 **"CNV v4.8 Linux Client"** 섹션에서 해당 파일을 다운로드합니다. 이 파일을 다운로드하려면 Red Hat 계정으로 로그인해야 할 수 있습니다.

 

2.3. 다운로드 파일 업로드 및 설치

다운로드한 kubevirt-virtctl-redistributable-linux-4.8.0-226.el8.x86_64.tar.gz와 같은 압축 파일을 클러스터에 접근 가능한 **bastion 서버(또는 작업할 리눅스 서버)**로 FTP 등을 통해 업로드합니다. 업로드 후, 서버에 접속하여 파일이 정상적으로 위치하는지 확인합니다.

[root@bastion ~]#ls
anaconda-ks.cfg  cluster-infra                                                       ocp                openshift-client-linux.tar.gz   user-info.txt  virt.yaml
backup           kubevirt-virtctl-redistributable-linux-4.8.0-226.el8.x86_64.tar.gz  openshift-ansible  openshift-install-linux.tar.gz  virt-1.yaml

압축 파일을 해제합니다. 압축 해제 후 virtctl 바이너리 파일이 생성됩니다.

[root@bastion ~]#tar xvf kubevirt-virtctl-redistributable-linux-4.8.0-226.el8.x86_64.tar.gz

생성된 virtctl 바이너리를 시스템의 PATH 환경 변수에 포함된 디렉토리 중 하나로 복사하여, 어느 위치에서든 virtctl 명령어를 실행할 수 있도록 합니다. 일반적으로 /usr/local/bin 또는 /usr/bin과 같은 경로가 적합합니다. 현재 PATH를 확인하고 적절한 위치로 복사합니다.

[root@bastion ~]#echo $PATH
/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/root/bin

[root@bastion ~]#cp -pr virtctl /usr/local/bin

복사 후 virtctl --help 명령어를 실행하여 virtctl이 정상적으로 설치되고 실행 가능한지 확인합니다. 도움말 메시지가 출력되면 성공적으로 설치된 것입니다.

[root@bastion ~]#virtctl --help
virtctl controls virtual machine related operations on your kubernetes cluster.

Available Commands:
  addvolume    add a volume to a running VM
  console      Connect to a console of a virtual machine instance.
  expose       Expose a virtual machine instance, virtual machine, or virtual machine instance replica set as a new service.
  fslist       Return full list of filesystems available on the guest machine.
  guestosinfo  Return guest agent info about operating system.
  help         Help about any command
  image-upload Upload a VM image to a DataVolume/PersistentVolumeClaim.
  migrate      Migrate a virtual machine.
  pause        Pause a virtual machine
  removevolume remove a volume from a running VM
  restart      Restart a virtual machine.
  start        Start a virtual machine.
  stop         Stop a virtual machine.
  unpause      Unpause a virtual machine
  userlist     Return full list of logged in users on the guest machine.
  version      Print the client and server version information.
  vnc          Open a vnc connection to a virtual machine instance.

3. Repository를 통한 virtctl 설치 방법

OpenShift Virtualization은 Red Hat Enterprise Linux 8 및 Red Hat Enterprise Linux 7용으로 특정 리포지토리를 제공합니다. 이 리포지토리를 시스템에 추가하면 dnf (RHEL 8) 또는 yum (RHEL 7) 패키지 관리자를 통해 virtctl 클라이언트를 쉽게 설치할 수 있습니다.

3.1. OpenShift Virtualization 리포지토리 확인

Red Hat에서 제공하는 OpenShift Virtualization 리포지토리 정보는 다음과 같습니다. 현재 RHEL 8 환경이므로 cnv-4.8-for-rhel-8-x86_64-rpms 리포지토리를 사용합니다.

  • Red Hat Enterprise Linux 8 repository: cnv-4.8-for-rhel-8-x86_64-rpms
  • Red Hat Enterprise Linux 7 repository: rhel-7-server-cnv-4.8-rpms

해당 리포지토리를 시스템에 등록하는 방법은 Red Hat Subscription Management(RHSM) 또는 Satellite 서버를 통해 이루어집니다. 시스템이 올바르게 구독되어 있고 해당 리포지토리가 활성화되어 있는지 확인해야 합니다.

3.2. virtctl 클라이언트 설치

리포지토리가 활성화되었다면, 다음 명령어를 사용하여 virtctl 클라이언트를 설치할 수 있습니다.

yum install kubevirt-virtctl

RHEL 8에서는 dnf 명령어를 사용하는 것이 일반적이지만, yum 명령어도 호환성을 위해 여전히 작동합니다. 이 명령은 필요한 모든 의존성과 함께 virtctl 바이너리를 시스템에 자동으로 설치합니다.

설치 완료 후, virtctl --help 명령어를 다시 실행하여 정상적으로 설치되었는지 확인할 수 있습니다.


두 가지 방법 모두 virtctl 클라이언트를 성공적으로 설치할 수 있습니다. RHOCP 콘솔을 통한 다운로드 방식은 특정 버전을 직접 제어할 수 있다는 장점이 있고, 리포지토리 방식은 패키지 관리자를 통한 의존성 해결 및 업데이트가 용이하다는 장점이 있습니다. 사용 환경에 맞는 방법을 선택하여 virtctl을 설치하고 OpenShift Virtualization 리소스 관리를 시작해 보세요!

728x90
반응형

'깐돌의 클라우드 도구함' 카테고리의 다른 글

[컨테이너] RHOCP 4.8 API 테스트 가이드  (0) 2025.06.10
[Linux] Ctrl+Alt+Del 재시작 기능 비활성화하기  (1) 2025.06.05
[컨테이너] Harbor 컨테이너 레지스트리: 프로젝트 생성부터 이미지 푸시까지 완벽 가이드  (0) 2025.06.04
[컨테이너] RHEL 8.4에 Harbor 컨테이너 레지스트리 설치하기  (1) 2025.06.03
[Linux] du 명령어로 디렉토리(폴더)별 디스크 사용량 확인하기  (0) 2025.06.03
'깐돌의 클라우드 도구함' 카테고리의 다른 글
  • [컨테이너] RHOCP 4.8 API 테스트 가이드
  • [Linux] Ctrl+Alt+Del 재시작 기능 비활성화하기
  • [컨테이너] Harbor 컨테이너 레지스트리: 프로젝트 생성부터 이미지 푸시까지 완벽 가이드
  • [컨테이너] RHEL 8.4에 Harbor 컨테이너 레지스트리 설치하기
깐돌씨
깐돌씨
하루하루를 기록하는 공간. 일상에서 얻은 영감, 좋아하는 취미, 그리고 클라우드 업무 팁까지 함께 나눕니다.
  • 깐돌씨
    조용한 깐돌이네
    깐돌씨
  • 전체
    오늘
    어제
    • 분류 전체보기 (134) N
      • 깐돌일기 (59) N
      • 취미탐험대 (19)
      • 깐돌의 클라우드 도구함 (56)
  • 블로그 메뉴

    • 홈
    • 방명록
  • 링크

  • 공지사항

  • 인기 글

  • 태그

    rhocp
    리눅스 가상화
    IPMI
    Docker
    리눅스 서버
    에스엔시스
    2025민생회복소비쿠폰
    공모주분석
    리눅스
    공모주청약
    rhel
    private registry
    RHEL8
    신규상장주
    KVM
  • 최근 댓글

  • 최근 글

  • 반응형
  • hELLO· Designed By정상우.v4.10.3
깐돌씨
[컨테이너] RHOCP4 에서 virtctl 설치 및 사용법

개인정보

  • 티스토리 홈
  • 포럼
  • 로그인
상단으로

티스토리툴바

단축키

내 블로그

내 블로그 - 관리자 홈 전환
Q
Q
새 글 쓰기
W
W

블로그 게시글

글 수정 (권한 있는 경우)
E
E
댓글 영역으로 이동
C
C

모든 영역

이 페이지의 URL 복사
S
S
맨 위로 이동
T
T
티스토리 홈 이동
H
H
단축키 안내
Shift + /
⇧ + /

* 단축키는 한글/영문 대소문자로 이용 가능하며, 티스토리 기본 도메인에서만 동작합니다.