Files
document-haness/docs/virtualization/tech-log-studio/network-virtualization/question/question-tap-interface-to-vm-mapping.md
T

9.4 KiB

id, kind, slug, title, topic, topicName, project, status, questionStatus, lastVerifiedOn, studio, sourceRevision, evidence, source
id kind slug title topic topicName project status questionStatus lastVerifiedOn studio sourceRevision evidence source
397c4789-0272-449b-86d6-2c4a3a122401 QUESTION tap-interface-to-vm-mapping VM1 과 VM2 의 TAP/vnet interface 는 무엇이고 어디에 붙어 있는가 network-virtualization 네트워크 가상화 virtualization 초안 RESOLVED 2026-09-21 https://hyeonworks.com/studio/documents/397c4789-0272-449b-86d6-2c4a3a122401/edit no-commit · 밖에서 반입한 문서 한 편. 고정할 저장소 리비전이 없다
../../../final/evidence/raw/2026-09-21-test-server-revalidation/47-network-backend-host.txt
final/document.md#122-open-question-oq-2
final/document.md#99-tap의-역할
final/document.md#117-이-구조에서-발생할-수-있는-문제-117-1
final/document.md#118-실제-linux에서-확인할-명령어

VM1 과 VM2 의 TAP/vnet interface 는 무엇이고 어디에 붙어 있는가

2026-09-21 현재 host 쪽 인터페이스는 kc-lab-edge → vnet13, kc-lab-1 → vnet18, kc-lab-2 → vnet19이고 세 인터페이스 모두 virbr0의 forwarding port다. MAC도 DHCP 예약과 일치한다. vnetN 번호는 VM 재생성 과정에서 바뀔 수 있으므로 현재 실행의 관측값으로 기록한다.

세 VM의 vnet mapping

  • 2026-09-21 재검증에서 virsh domiflist, domain XML, ip -brief link, bridge link를 대조했다. vnet13/18/19는 각각 edge/kc-lab-1/kc-lab-2에 대응하며 모두 master virbr0 state forwarding이었다.

  • 「TAP의 역할」에서는 TAP 을 호스트 리눅스 커널이 제공하는 가상 이더넷 네트워크 인터페이스로 적었다. 물리 장치가 아니고, 이름의 예로 tap0 과 vnet0 을 들었다.

  • 「TAP의 역할」에 적은 TAP 의 역할은 가상 머신의 이더넷 프레임과 호스트 리눅스 네트워크를 연결하는 접점이다. 수신 : Linux Bridge → TAP → VM 송신 : VM → TAP → Linux Bridge

  • 「TAP의 역할」에서는 확인 명령으로 ip link · ip tuntap show · bridge link · virsh domiflist 넷을 들었고, 「실제 Linux에서 확인할 명령어」에서는 같은 명령을 계층별 목록으로 다시 적었다. TAP/vnet : ip link · ip tuntap show libvirt VM NIC : virsh domiflist 에 domain 이름을 넣는다 Linux Bridge : ip link show type bridge · bridge link · bridge fdb show

  • 원문의 2번째 확인 항목에는 이 호스트에서 돌릴 명령 네 줄이 적혀 있었다. virsh domiflist vm1 virsh domiflist vm2 ip link bridge link

  • 「TAP의 역할」와 「실제 Linux에서 확인할 명령어」에서는 TAP 확인 명령으로 든 ip tuntap show 는 2번째 확인 항목 의 네 줄에 없다.

  • 「TAP/Bridge 연결 오류」에서는 TAP/Bridge 연결 오류의 증상 셋을 들었다. VM 외부 통신 불가 Host ↔ VM 통신 불가 특정 VM 만 통신 불가

  • 「TAP/Bridge 연결 오류」에서는 그 증상에서 확인하라고 든 명령은 ip link · bridge link · bridge fdb show · virsh domiflist 다.

  • 「현재 Keycloak/K3s 테스트 환경과 연결」에서는 이 테스트 환경의 경로를 펼치면서 TAP 칸을 TAP(vm1) 과 TAP(vm2) 로 적었다. 호스트에서 읽은 이름은 그 그림에도 없다.

  • 「이 부의 출처와 범위」에서는 이 실험대의 게스트를 Debian 12 genericcloud 3대로 적었다. 엣지 1대와 k3s 2노드이고, 원문의 vm1, vm2 표기는 그중 k3s 노드 두 대를 가리킨다.

  • 「철거 — 실제 출력 전문」에서는 2026-09-10 에 돌린 철거 명령의 출력을 그대로 남겼고, 거기서 libvirt domain 이름이 kc-lab-edge · kc-lab-1 · kc-lab-2 로 확인된다. 한 대분 출력의 첫 줄은 Domain 'kc-lab-edge' destroyed 다.

  • 「네트워크 — DHCP 예약의 실제 동작」와 「DHCP 예약 (ip-dhcp-host)과 MAC 52:54:00」에 적은 세 게스트의 MAC 주소와 IP 주소 kc-lab-edge : 52:54:00:aa:bb:10 · 192.168.122.10 kc-lab-1 : 52:54:00:aa:bb:11 · 192.168.122.11 kc-lab-2 : 52:54:00:aa:bb:12 · 192.168.122.12

  • 「DHCP 예약 (ip-dhcp-host)과 MAC 52:54:00」에서는 52:54:00 이 QEMU/KVM 에 할당된 OUI(제조사 식별 접두사)라고 적고, 예약의 mac 과 VM 을 만들 때 준 mac 이 정확히 같아야 한다고 밝혔다. 값이 다르면 예약이 적용되지 않고 게스트가 동적 DHCP 범위의 주소를 받을 수 있다.

  • 「네트워크 — DHCP 예약의 실제 동작」에서는 예약과 리스를 다른 것으로 갈라 적었다. virsh net-dumpxml 의 예약은 줄 의도이고 virsh net-dhcp-leases 는 실제로 준 기록이라 둘이 다를 수 있다. 실제로 준 기록에는 52:54:00:aa:bb:11 이 192.168.122.11/24 을, 52:54:00:aa:bb:12 가 192.168.122.12/24 을 각각 kc-lab-1 과 kc-lab-2 이름으로 받은 줄이 남아 있다.

  • 「이 부의 출처와 범위」와 「libvirt default 네트워크와 virbr0」에서는 게스트가 libvirt 의 default 네트워크에 붙는다고 적었다. 「libvirt default 네트워크와 virbr0」에서는 VM 이 한 대라도 뜨면 그 VM 의 vnetN 인터페이스가 virbr0 에 붙으면서 브리지가 UP 으로 바뀐다고 덧붙였다.

  • 「네트워크 — DHCP 예약의 실제 동작」에서는 VM 세 대가 돌 때 virbr0 이 UP 이고 전부 철거한 뒤에는 DOWN 이라는 출력을 남겼다. 상태가 갈린 이유를 브리지에 붙은 tap 인터페이스가 하나도 없어서라고 적었다.

  • 2026-09-21 재검증에서 VM별 host-side vnetN 이름과 MAC, virbr0 연결을 직접 읽어 대응표를 만들었다.

mapping 확인 조건

  • 호스트에 붙어 virsh 와 ip 계열 명령을 실행할 수 있다고 본다.
  • 원문의 명령에는 vm1, vm2가 쓰였지만 「철거 — 실제 출력 전문」에 남은 실제 domain 이름은 kc-lab-1, kc-lab-2다. 따라서 실제 확인 명령에는 뒤쪽 이름을 쓴다. 「TAP의 역할」와 「실제 Linux에서 확인할 명령어」에서는 같은 명령의 domain 이름을 비워 두었다.
  • virsh domiflist 출력에 인터페이스 이름과 MAC 주소가 함께 나온다고 전제한다. 「TAP의 역할」도 「실제 Linux에서 확인할 명령어」도 이 명령의 출력 형식은 적지 않았다.
  • TAP/vnet 매핑은 가상 머신이 실행 중인 상태에서 확인한다. 종료한 가상 머신의 인터페이스 상태는 이 측정에서 확인하지 않았다.

runtime interface 이름의 수명

VM과 host-side vnet 이름, MAC, bridge의 현재 대응은 해소됐다. 이어진 packet-path 재검증에서는 이 mapping을 다시 읽은 뒤 같은 요청이 host ingress에서 edge vnet13, worker vnet18/19와 guest NIC까지 이동하는 것도 캡처했다. 따라서 host/libvirt 구간에서는 mapping과 실제 흐름이 연결돼 확인됐다. K3s CNI·Service·Pod 내부 경로는 packet-path 질문의 별도 범위로 남는다.

재생성 뒤 다시 읽어야 하는 이유

  • 이 질문의 판정 자체는 이름과 bridge mapping에서 끝낸다. 다만 2026-09-21 후속 packet capture에서 같은 vnetN을 관측 지점으로 사용해 실제 요청 흐름과도 대조했다.
  • 두 가상 머신을 같은 시점에 읽는다. 한쪽을 재시작한 뒤 다른 쪽을 읽으면 이름이 바뀌어도 알 수 없기 때문이다.
  • vnetN 이름은 예시가 아니라 2026-09-21 실행 시점의 실제 값으로 기록한다. VM 재생성이나 재연결 뒤에는 번호가 바뀔 수 있으므로 캡처 직전에 다시 읽는다.
  • 2026-09-21 재검증은 세 VM이 실행 중일 때 수행했다. domain을 내리거나 다시 만들면 host-side vnetN 인터페이스가 사라지거나 번호가 바뀔 수 있다.

어떻게 대조했나

1. libvirt 가 대는 이름을 먼저 받아 호스트에서 대조한다

virsh domiflist로 가상 머신마다 붙은 인터페이스를 받고, 그 이름이 ip link 목록에 실제로 있는지 확인한 뒤 bridge link로 어느 브리지의 포트인지 잡는다. 원문에 적힌 네 줄도 이 순서다. 가상 머신과 인터페이스의 짝이 처음부터 정해져 나오므로 두 대의 것을 헷갈리지 않는다.

libvirt 가 모르는 인터페이스는 이 순서에서 빠진다.

2. 호스트의 인터페이스를 전부 세우고 가상 머신으로 되짚는다

ip link 와 ip tuntap show 로 호스트에 있는 TAP 을 모두 적고, bridge link 로 어느 브리지에 붙었는지 잡는다. 그다음 virsh domiflist 로 각각이 어느 가상 머신의 것인지 되짚는다. libvirt 밖에서 만들어진 TAP 이 있어도 목록에 남는다.

가상 머신이 두 대뿐인데 호스트에 TAP 이 여럿이면 짝짓는 데 MAC 주소를 다시 대조해야 한다.

3. 통신이 안 될 때 「TAP/Bridge 연결 오류」의 확인 목록으로 함께 본다 — 제외

「TAP/Bridge 연결 오류」에서는 증상과 확인 명령을 이미 묶어 두었으니 장애가 났을 때 같이 보자는 방법이다. 지금 필요한 것은 정상일 때의 이름과 붙어 있는 곳이고, 그것이 있어야 장애 때 무엇이 달라졌는지 견줄 수 있다. 증상이 난 뒤에 처음 읽으면 그 값이 원래 그랬는지 그때 바뀐 것인지 가릴 수 없다.

vnet 번호는 고정값이 아니므로 capture 직전에 다시 매핑한다

VM 재생성 뒤에는 vnetN 이름이 바뀔 수 있으므로 packet capture 직전에 virsh domiflist와 bridge link를 다시 읽는다.