102 lines
9.4 KiB
Markdown
102 lines
9.4 KiB
Markdown
---
|
|
id: 397c4789-0272-449b-86d6-2c4a3a122401
|
|
kind: QUESTION
|
|
slug: tap-interface-to-vm-mapping
|
|
title: VM1 과 VM2 의 TAP/vnet interface 는 무엇이고 어디에 붙어 있는가
|
|
topic: network-virtualization
|
|
topicName: 네트워크 가상화
|
|
project: virtualization
|
|
status: 초안
|
|
questionStatus: RESOLVED
|
|
lastVerifiedOn: 2026-09-21
|
|
studio: "https://hyeonworks.com/studio/documents/397c4789-0272-449b-86d6-2c4a3a122401/edit"
|
|
sourceRevision: no-commit · 밖에서 반입한 문서 한 편. 고정할 저장소 리비전이 없다
|
|
evidence:
|
|
- ../../../final/evidence/raw/2026-09-21-test-server-revalidation/47-network-backend-host.txt
|
|
source:
|
|
- 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`를 다시 읽는다.
|