7.2. Virtctl 클라이언트 명령

virtctl 클라이언트는 OpenShift Virtualization 리소스를 관리하는 명령줄 유틸리티입니다.

virtctl 명령 목록을 보려면 다음 명령을 실행합니다. 

$ virtctl help

특정 명령과 함께 사용할 수 있는 옵션 목록을 보려면 -h 또는 --help 플래그와 함께 실행합니다. 예를 들면 다음과 같습니다. 

$ virtctl image-upload -h

virtctl 명령과 함께 사용할 수 있는 글로벌 명령 옵션 목록을 보려면 다음 명령을 실행합니다. 

$ virtctl options

다음 표에는 OpenShift Virtualization 설명서 전체에서 사용되는 virtctl 명령이 포함되어 있습니다.

표 7.1. virtctl 클라이언트 명령

명령설명

virtctl start <vm_name>

가상 머신을 시작합니다.

virtctl stop <vm_name>

가상 머신을 중지합니다.

virtctl pause vm|vmi <object_name>

가상 머신 또는 가상 머신 인스턴스를 일시 정지합니다. 머신 상태는 메모리에 유지됩니다.

virtctl unpause vm|vmi <object_name>

가상 머신 또는 가상 머신 인스턴스의 일시 정지를 해제합니다.

virtctl migrate <vm_name>

가상 머신을 마이그레이션합니다.

virtctl restart <vm_name>

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

virtctl expose <vm_name>

가상 머신 또는 가상 머신 인스턴스의 지정된 포트를 전달하고 서비스를 노드의 지정된 포트에 노출하는 서비스를 생성합니다.

virtctl console <vmi_name>

가상 머신 인스턴스의 직렬 콘솔에 연결합니다.

virtctl vnc --kubeconfig=$KUBECONFIG <vmi_name>

가상 머신 인스턴스에 대한 VNC(Virtual Network Client) 연결을 엽니다. 로컬 시스템에 원격 뷰어가 필요한 VNC를 통해 가상 머신 인스턴스의 그래픽 콘솔에 액세스합니다.

virtctl vnc --kubeconfig=$KUBECONFIG --proxy-only=true <vmi-name>

포트 번호를 표시하고 VNC 연결을 통해 뷰어를 사용하여 가상 머신 인스턴스에 수동으로 연결합니다.

virtctl vnc --kubeconfig=$KUBECONFIG --port=<port-number> <vmi-name>

해당 포트를 사용할 수 있는 경우 지정된 포트에서 프록시를 실행할 포트 번호를 지정합니다. 포트 번호를 지정하지 않으면 프록시는 임의의 포트에서 실행됩니다.

virtctl image-upload dv <datavolume_name> --image-path=</path/to/image> --no-create

이미 존재하는 데이터 볼륨에 가상 머신 이미지를 업로드합니다.

virtctl image-upload dv <datavolume_name> --size=<datavolume_size> --image-path=</path/to/image>

가상 머신 이미지를 새 데이터 볼륨에 업로드합니다.

virtctl version

클라이언트 및 서버 버전 정보를 표시합니다.

virtctl help

virtctl 명령의 설명 목록을 표시합니다.

virtctl fslist <vmi_name>

게스트 머신에서 사용 가능한 전체 파일 시스템 목록을 반환합니다.

virtctl guestosinfo <vmi_name>

운영 체제에 대한 게스트 에이전트 정보를 반환합니다.

virtctl userlist <vmi_name>

게스트 머신에 로그인한 전체 사용자 목록을 반환합니다.