virsh + cloud-init VM 생성 가이드

Mon, 29 Jun 2026 00:00:00 +0000

작성일: 2026-03-05 환경: Ubuntu 24.04 호스트, libvirt/KVM, cloud-init

사전 조건

호스트에 br-host 브릿지가 구성되어 있어야 함 (203.0.113.0/24 대역)
원본 클라우드 이미지: /var/lib/libvirt/images/noble-server-cloudimg-amd64.img
cloud-init 설정 디렉토리: /var/lib/libvirt/cloud-init/

디렉토리 구조

/var/lib/libvirt/
├── images/
│   ├── noble-server-cloudimg-amd64.img   ← 원본 (수정 금지)
│   ├── k8s-cp1.qcow2                     ← VM별 디스크
│   └── ...
└── cloud-init/
    ├── k8s-cp1-user-data.yaml
    ├── k8s-cp1-network-config.yaml
    ├── k8s-cp1-cidata.iso
    └── ...

생성 절차

1. 변수 설정

NAME=k8s-worker1         # VM 이름
IP=203.0.113.71          # 할당할 IP
MEM=2048                 # 메모리 (MB)
VCPU=2                   # vCPU 수
DISK_SIZE=20G            # 디스크 크기
BASE_IMG=/var/lib/libvirt/images/noble-server-cloudimg-amd64.img
IMG=/var/lib/libvirt/images/${NAME}.qcow2
CLOUD_INIT_DIR=/var/lib/libvirt/cloud-init

2. user-data.yaml 작성

sudo tee ${CLOUD_INIT_DIR}/${NAME}-user-data.yaml > /dev/null <<'EOF'
#cloud-config
hostname: k8s-worker1
manage_etc_hosts: true
users:
  - name: kube
    sudo: ALL=(ALL) NOPASSWD:ALL
    shell: /bin/bash
    ssh_authorized_keys:
      - ssh-ed25519 AAAA...REPLACE-WITH-YOUR-PUBLIC-KEY... user@host
package_update: true
packages:
  - curl
  - wget
  - vim
  - net-tools
  - jq
  - tree
  - tcpdump
  - socat
  - conntrack
  - ipset
EOF

주의: 첫 줄의 #cloud-config은 반드시 포함해야 한다. 없으면 cloud-init이 동작하지 않는다.

virsh를 이용한 KVM/QEMU VM 관리 가이드

Mon, 29 Jun 2026 00:00:00 +0000

현재 환경 상태

항목	값
libvirt	10.0.0
QEMU	8.2.2
연결 URI	`qemu:///session` (사용자 세션 모드)
사용자 그룹	`kvm`, `libvirt` 포함
스토리지 풀	`default` → `~/.local/share/libvirt/images/`
OS	Ubuntu 24.04.4 LTS (Kernel 6.17)
CPU	AMD Ryzen 9 5900X (12c/24t)
RAM	40 GB

session vs system 모드: qemu:///session은 일반 사용자 권한으로 동작하며 네트워크 기능이 제한됩니다. 브릿지 네트워크 등 고급 네트워킹이 필요하면 qemu:///system을 사용해야 합니다.

Virsh on homelab89

virsh + cloud-init VM 생성 가이드

사전 조건

디렉토리 구조

생성 절차

1. 변수 설정

2. user-data.yaml 작성

virsh를 이용한 KVM/QEMU VM 관리 가이드

현재 환경 상태