CLI 레퍼런스

15.1 개요

항목	값
바이너리	`bin/pcvctl`
커맨드 수	194 (`routes[]` 기준)
모드	readline REPL + 배치
자동완성	bash/zsh (`make install-completion`)
소켓	`/var/run/purecvisor/daemon.sock`

# 단계적 도움말
pcvctl help             # 32개 명령 그룹 요약
pcvctl help vpc         # VPC 그룹 상세
pcvctl vpc --help       # 같은 VPC 그룹 상세
pcvctl help guest-agent # object·action·설명 검색
pcvctl help all         # 전체 194개 명령

# REPL 모드
pcvctl
pcvctl> vm list
pcvctl> exit

# 배치 모드
pcvctl vm list
pcvctl vm create web-prod --vcpu 4 --memory_mb 8192 --disk_size_gb 50 \
  --qos_min_mbps 0 --qos_max_mbps 1000

기본 도움말은 전체 명령을 한 번에 펼치지 않고 그룹별 개수와 용도를 보여 준다.
그룹 상세는 복사 가능한 pcvctl <object> <action> 형태이며 긴 설명은 같은 설명 열에서 자동 줄바꿈된다.
기존 전체 목록과 부분 검색은 각각 help all, help <검색어>로 유지한다.

15.2 커맨드 분류

VM 관리 (30+)

커맨드	설명
`vm list`	VM 목록
`vm create <name> --vcpu N --memory_mb N --disk_size_gb N`	VM 생성
`vm rename <old_name> <new_name>`	정지된 VM 이름과 표준 디스크/NVRAM 경로 변경
`vm start <name>`	VM 시작
`vm stop <name>`	VM 중지 (graceful)
`vm delete <name>`	VM 삭제
`vm delete-status <name>`	비동기 삭제 상태
`vm clone <source> <clone_name> --mode cow\|full --guest-reset\|--template-prepared`	VM 복제
`vm vnc <name>`	VNC 포트 조회
`snapshot create <name> <snap>`	스냅샷 생성
`snapshot list <name>`	스냅샷 목록
`snapshot rollback <name> <snap>`	스냅샷 롤백
`snapshot delete <name> <snap>`	스냅샷 삭제
`vm snapshot-delete-all <name>`	스냅샷 일괄 삭제
`vm disk-resize <name> <target> <new_size_gb>`	디스크 크기 조정
`vm disk-throttle <name> [--device vda] --read-iops N --write-iops N`	디스크 IOPS 제한
`vm blkio-set <name> [--read_bps N] [--write_bps N] [--read_iops N] [--write_iops N]`	블록 I/O 제한
`vm bandwidth <name> --inbound-kbps N --outbound-kbps N`	VM 네트워크 대역폭 제한
`vm pin-vcpu <name> --vcpu N --cpuset 0-3`	vCPU 피닝
`vm guest-agent-status <name>`	Guest Agent channel/package 상태 진단
`vm guest-agent-ensure-channel <name>`	Guest Agent libvirt channel 보정
`vm guest-ping <name>`	Guest Agent 연결 확인
`vm guest-exec <name> <command>`	Guest Agent 명령 실행
`vm guest-shutdown <name>`	Guest Agent 안전 종료
`vm export-ova <name> --output-dir /tmp`	OVA 내보내기
`vm import-ova <ova_path> <name> [--pool pcvpool/vms]`	OVA 가져오기
`vm usb-list <name>`	USB hostdev 목록
`vm usb-attach <name> <vendor_id> <product_id>`	USB hostdev 연결
`vm usb-detach <name> <vendor_id> <product_id>`	USB hostdev 분리

NIC 관리

커맨드	설명
`nic list <name>`	NIC 목록
`nic add <name> <bridge>`	NIC 추가
`nic remove <name> <mac>`	NIC 제거

ISO 관리

커맨드	설명
`iso list`	ISO 이미지 목록
`iso mount <name> <iso_path>`	ISO 마운트
`iso eject <name>`	ISO 추출

컨테이너 (10+)

커맨드	설명
`container list`	목록
`container create <name> --image <img>`	생성
`container start <name>`	시작
`container stop <name>`	중지
`container destroy <name>`	삭제
`container exec <name> -- <cmd>`	명령 실행
`container metrics <name>`	메트릭
`container snapshot <name> <snap>`	스냅샷

네트워크 (20+)

커맨드	설명
`network list`	브릿지 목록
`network create <name> --mode <mode> ... [--mtu 68..9216]`	관리형 네트워크 생성
`network create <name> --mode bridge --iface <nic> --uplink-mode dedicated --confirm-dedicated-uplink`	전용 L2 물리 브릿지 생성
`network create <name> --mode bridge --iface <nic> --uplink-mode shared --confirm-shared-uplink`	host L3를 보존하는 공유 물리 브릿지 생성
`network bind <name> <nic>`	deprecated·차단 — 위 bridge create 사용
`network delete <name>`	브릿지 삭제
`network mode <name> <nat\|isolated\|routed> <cidr>`	브릿지 모드·대역 수정(canonical)
`network dhcp <name> --enable\|--disable`	브릿지 DHCP 토글
`firewall list`	방화벽 규칙
`firewall add --vm <name> --port <port> --action accept`	규칙 추가
`overlay list`	OVS 오버레이
`ovn status`	OVN 상태
`ovn switch list`	논리 스위치
`ovn router list`	논리 라우터

network edit <name> --mode <mode> --cidr <cidr>는 이전 자동화를 위한 deprecated 호환 별칭이다.
새 호출과 문서는 network mode를 사용한다.
두 표면은 동일한 network.mode_set {name, mode, cidr} 요청을 전송한다.
단, host uplink가 붙은 physical bridge는 live 모드 변경을 지원하지 않으며 안전한 삭제·재생성이 필요하다.

스토리지 (10+)

커맨드	설명
`storage pool list`	ZFS 풀 목록
`storage zvol list`	zvol 목록
`iscsi target list`	iSCSI 타겟
`iscsi target create --pool <p> --name <n> --size <s>`	iSCSI 생성

클러스터 (범위 밖 참고)

다음 항목은 역사 기록 또는 Multi 제어면 참고용이다.
Single Edge 공개판의 운영 명령으로 안내하지 않는다.

커맨드	설명
`cluster status`	클러스터 상태
`cluster vms`	전체 노드 VM
`cluster migrate <name> <dest>`	라이브 마이그레이션
`cluster replicate <name>`	ZFS 복제
`cluster replicate-status`	복제 상태
`cluster failover-test`	페일오버 테스트
`node drain`	노드 드레인
`node resume`	노드 복귀
`node version`	노드 버전

인증 & 보안 (10+)

커맨드	설명
`auth list`	사용자 목록
`auth create <user> <pass> <role>`	사용자 생성
`auth role <user> <role>`	역할 변경
`auth delete <user>`	사용자 삭제
`auth apikey create --name <n>`	API Key 생성
`security-group create <name>`	보안 그룹
`security-group add-rule <sg> ...`	규칙 추가

모니터링 & 알림 (10+)

커맨드	설명
`monitor processes --top N`	프로세스 Top N
`alert list`	알림 히스토리
`alert config`	알림 설정 조회
`alert set --cpu-warn 80 --cpu-crit 95`	알림 임계값

백업 (5+)

커맨드	설명
`backup list`	정책 목록
`backup set <name> --interval N --retention N`	정책 설정
`backup history <name>`	히스토리

클라우드 (5+)

커맨드	설명
`cloud import --ami <id> --vm-name <n>`	EC2 Import
`cloud export --name <n> --region <r>`	EC2 Export
`cloud jobs`	작업 목록
`cloud cancel --name <n>`	작업 취소
`cloud finalize --name <n>`	Near-Live 최종 전환

AI Agent (5+)

커맨드	설명
`agent config`	Agent 설정
`agent set --provider <p> --api-key <k>`	프로바이더 설정
`agent history`	합의 이력

템플릿 (5+)

커맨드	설명
`template list`	프리셋 목록
`template create <name> --vcpu N --memory_mb N --disk_gb N`	생성
`template delete <name>`	삭제

기타

커맨드	설명
`dpdk bind <pci>`	DPDK 바인드
`sriov enable <pf> [num_vfs]`	SR-IOV 활성화
`gpu list`	GPU 목록
`audit list --limit N`	감사 로그
`federation site join <url>`	페더레이션 가입

15.3 자동완성 설치

# 시스템 설치 (root)
sudo make install-completion

# 사용자 로컬 설치
make install-completion-user

# 수동 bash
source completion/pcvctl-completion.bash

# 수동 zsh
source completion/_pcvctl