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 클라이언트란?
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 리소스 관리를 시작해 보세요!
'깐돌의 클라우드 도구함' 카테고리의 다른 글
[컨테이너] 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 |