Communitygithub.com

AGLz/agl-hostman

QEMU/KVM AGL 가상 머신 관리 스킬

agl-hostman란 무엇인가요?

이 스킬은 Proxmox VE에서 실행되는 QEMU/KVM 기반 AGL(Automotive Grade Linux) 가상 머신을 관리하는 방법을 제공합니다. 주로 AGLSRV1 호스트에서 VM 104(aglwk45)를 대상으로 하며, Tailscale을 통한 원격 접근을 지원합니다. 사용자는 `qm` 명령어를 통해 VM 시작/중지, 스냅샷 생성/롤백, 디스크 관리, 리소스 설정 등의 작업을 SSH를 통해 수행할 수 있습니다. 또한 QEMU Guest Agent를 활용하여 VM 내부에서 명령어를 실행하거나 파일 시스템을 동결하는 등 고급 관리 기능을 제공합니다. 이 스킬은 OpenClaw 게이트웨이를 실행하는 Windows 기반 AGLWK45 VM에 특화되어 있으며, 문제 해결을 위한 다양한 진단 명령어도 포함하고 있습니다. Proxmox 환경에서 QEMU VM을 효율적으로 운영하고자 하는 개발자나 시스템 관리자에게 유용합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add AGLz/agl-hostman

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

QEMU/KVM AGL 가상 머신

AGL QEMU VM

VMID호스트이름역할Tailscale IP
104AGLSRV1aglwk45OpenClaw 작업자 (Windows)192.168.0.245 경유

접근

# AGLSRV1 (QEMU/KVM을 실행하는 Proxmox 호스트)
ssh AGLSRV1  # 192.168.0.245 (LAN) 또는 100.107.113.33 (Tailscale)

QEMU VM 작업 (qm 명령어)

모든 VM 목록 보기

ssh AGLSRV1 "qm list"

VM 시작/중지

# 시작
ssh AGLSRV1 "qm start 104"

# 중지 (ACPI 종료)
ssh AGLSRV1 "qm shutdown 104"

# 강제 중지
ssh AGLSRV1 "qm stop 104"

# 재부팅
ssh AGLSRV1 "qm reboot 104"

VM 상태 확인

ssh AGLSRV1 "qm status 104"
ssh AGLSRV1 "qm list | grep 104"

콘솔 접근

# VNC 콘솔 (VNC 포트 확인)
ssh AGLSRV1 "qm vncproxy 104"

# 시리얼 콘솔 (설정된 경우)
ssh AGLSRV1 "qm terminal 104"

스냅샷

# 스냅샷 생성
ssh AGLSRV1 "qm snapshot 104 pre-update"

# 스냅샷 목록
ssh AGLSRV1 "qm listsnapshot 104"

# 롤백 (VM이 중지되어야 함)
ssh AGLSRV1 "qm stop 104 && qm rollback 104 pre-update && qm start 104"

# 스냅샷 삭제
ssh AGLSRV1 "qm delsnapshot 104 pre-update"

VM 복제

# 전체 복제
ssh AGLSRV1 "qm clone 104 <new-vmid> --name <new-name> --full"

# 연결 복제 (더 빠름, 원본에 의존)
ssh AGLSRV1 "qm clone 104 <new-vmid> --name <new-name>"

리소스 구성

# 메모리 설정
ssh AGLSRV1 "qm set 104 --memory 8192"

# CPU 코어 설정
ssh AGLSRV1 "qm set 104 --cores 4"

# 네트워크 브리지 설정
ssh AGLSRV1 "qm set 104 --net0 virtio,bridge=vmbr0"

QEMU 게스트 에이전트

설치 (VM 내부)

# Windows
# VirtIO 드라이버 ISO에서 qemu-ga 설치

# Linux
apt install qemu-guest-agent  # Debian/Ubuntu
systemctl enable qemu-guest-agent
systemctl start qemu-guest-agent

Proxmox에서 활성화

ssh AGLSRV1 "qm set 104 --agent enabled=1"

게스트 에이전트 사용

# 게스트 에이전트를 통해 VM 정보 가져오기
ssh AGLSRV1 "qm guest exec 104 -- ip a"

# 네트워크 인터페이스 가져오기
ssh AGLSRV1 "qm guest exec 104 -- ip -j addr show" | jq

# VM 내부에서 명령어 실행
ssh AGLSRV1 "qm guest exec 104 -- systemctl status openclaw-gateway"

# 파일 시스템 동결 (스냅샷용)
ssh AGLSRV1 "qm guest cmd 104 fsfreeze-freeze"
ssh AGLSRV1 "qm guest cmd 104 fsfreeze-thaw"

디스크 관리

디스크 목록 보기

ssh AGLSRV1 "qm config 104 | grep virtio"

디스크 크기 조정

ssh AGLSRV1 "qm resize 104 virtio0 +10G"

디스크 이동

# 다른 스토리지로 이동
ssh AGLSRV1 "qm move-disk 104 virtio0 local-lvm"

AGLWK45 (VM104) 관련

AGLWK45의 OpenClaw

# 게스트 실행을 통해 OpenClaw 상태 확인
ssh AGLSRV1 "qm guest exec 104 -- powershell -Command 'Get-Service openclaw'"

# 또는 VM 내부에서 Tailscale을 통해
ssh AGLSRV1 "qm guest exec 104 -- tailscale status"

확인 스크립트

# 리포지토리에서 확인 스크립트 실행
./scripts/verify-aglwk45-fgsrv06.sh

QEMU 직접 실행 (Proxmox 미사용)

독립형 QEMU 사용 시:

# QEMU VM 시작
qemu-system-x86_64 \
  -enable-kvm \
  -m 4096 \
  -smp 4 \
  -drive file=disk.qcow2,format=qcow2 \
  -netdev user,id=net0 -device virtio-net-pci,netdev=net0 \
  -serial mon:stdio \
  -nographic

# VNC 사용
qemu-system-x86_64 -enable-kvm -m 4096 -vnc :0 disk.qcow2

# Tailscale 사용 (VM 내부)
# 원격 접근을 위해 VM 내부에 tailscale 설치

문제 해결

VM이 시작되지 않는 경우

# 잠금 상태 확인
ssh AGLSRV1 "qm status 104"

# 스토리지 공간 확인
ssh AGLSRV1 "pvesm status"

# 로그 확인
ssh AGLSRV1 "qm start 104 2>&1"

게스트 에이전트가 응답하지 않는 경우

# 활성화 여부 확인
ssh AGLSRV1 "qm config 104 | grep agent"

# VM 내부 확인
ssh AGLSRV1 "qm guest exec 104 -- systemctl status qemu-guest-agent"

네트워크 문제

# 브리지 확인
ssh AGLSRV1 "brctl show"

# VM 네트워크 구성 확인
ssh AGLSRV1 "qm guest exec 104 -- ip a"

참고 사항

  • AGLWK45 (VM104)는 OpenClaw 게이트웨이를 실행 중이므로 활성 세션 중에는 재시작을 피하세요.
  • QEMU VM은 Proxmox에서 qm 명령어를 사용합니다 (LXC 컨테이너는 pct).
  • 게스트 에이전트는 Proxmox 호스트에서 파일 복사, 명령어 실행, 파일 시스템 동결을 가능하게 합니다.
  • 주요 변경 전에는 항상 스냅샷을 생성하세요.

관련 스킬