mirror of
https://github.com/GNS3/gns3-server.git
synced 2026-10-19 01:12:22 +03:00
Cross-compute links can ride kernel VXLAN tunnels instead of the uBridge
UDP relay: each endpoint creates one VXLAN device (uBridge's rtnetlink
vxlan module) enslaved into the same per-link Linux bridge the same-host
datapath uses, so filters, markers, capture and suspend keep running on
the anchor unchanged. Opt-in (Server.enable_vxlan_cross_compute, default
off) because the tunnel caps the usable MTU at the underlay minus the
outer headers; the relay stays the default and the fallback.
The controller derives what the pair must agree on: one VNI per link
(upper VNI space, per-link random salt) and deterministic device names
(gvl{link}{node}) that make crashed-run leftovers claimable
(show -> delete -> create). Same-host compute pairs, switch endpoints
and serial/unix-socket containers stay on the relay.
A VNI the kernel refuses self-heals on every path it can surface:
interactive create retries a fresh salt then degrades to the relay;
project open re-dispatches refused batch entries the same way; node
start recognises the refused device, stops the half-started node,
re-wires both ends on a fresh VNI (or degrades the link) and retries
the start. The device MTU is derived from the lower device (dev=) and
the per-link bridge inherits it - no configuration. The capability
probe (ubridge_vxlan in /capabilities) runs one scratch create/delete
on a scratch port that never equals the configured dstport.
The e2e scenario runs two computes on one machine (a network namespace
joined by a veth pair as the fabric) and needs root.
81 lines
3.5 KiB
Python
81 lines
3.5 KiB
Python
#
|
|
# Copyright (C) 2020 GNS3 Technologies Inc.
|
|
#
|
|
# This program is free software: you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License as published by
|
|
# the Free Software Foundation, either version 3 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# This program is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
|
|
from typing import List, Optional
|
|
|
|
from pydantic import BaseModel, Field
|
|
|
|
from .nodes import NodeType
|
|
|
|
|
|
class UbridgeTcCapabilities(BaseModel):
|
|
"""
|
|
uBridge tc-module capabilities (kernel-datapath packet filters), probed
|
|
by the compute as its own user.
|
|
"""
|
|
|
|
netem: List[str] = Field(..., description="netem keywords supported by this uBridge's tc module")
|
|
ebpf: bool = Field(..., description="Whether the eBPF stateful classifier loads on this host")
|
|
ebpf_modes: List[str] = Field(
|
|
..., description="eBPF classifier modes usable on this host (ebpf is on and the mode token is declared)"
|
|
)
|
|
cbpf: bool = Field(..., description="Whether classic-BPF match-drop classifiers are available")
|
|
|
|
|
|
class Capabilities(BaseModel):
|
|
"""
|
|
Capabilities properties.
|
|
"""
|
|
|
|
version: str = Field(..., description="Compute version number")
|
|
node_types: List[NodeType] = Field(..., description="Node types supported by the compute")
|
|
platform: str = Field(..., description="Platform where the compute is running")
|
|
cpus: int = Field(..., description="Number of CPUs on this compute")
|
|
memory: int = Field(..., description="Amount of memory on this compute")
|
|
disk_size: int = Field(..., description="Disk size on this compute")
|
|
ubridge_tc: Optional[UbridgeTcCapabilities] = Field(
|
|
None, description="uBridge tc-module capabilities; absent when the probe failed or uBridge has no tc module"
|
|
)
|
|
ubridge_tap: Optional[bool] = Field(
|
|
None,
|
|
description="Whether uBridge can create the persistent TAPs a QEMU adapter anchors on "
|
|
"(needed to wire QEMU links on the kernel datapath); absent when the probe failed",
|
|
)
|
|
ubridge_iol_tap: Optional[bool] = Field(
|
|
None,
|
|
description="Whether uBridge can bind an IOL port to a persistent TAP (iol_bridge add_nio_tap, "
|
|
"the anchor IOU Ethernet ports need to wire IOU links on the kernel datapath); absent when the "
|
|
"probe failed",
|
|
)
|
|
ubridge_bridge_tap: Optional[bool] = Field(
|
|
None,
|
|
description="Whether uBridge's generic bridge module can release a named TAP NIO "
|
|
"(bridge delete_nio_tap, the swappable TAP leg an IOL runner container's per-port bridge "
|
|
"needs to wire its links on the kernel datapath); absent when the probe failed",
|
|
)
|
|
vpcs_tap: Optional[bool] = Field(
|
|
None,
|
|
description="Whether the VPCS binary can anchor a kernel link (tap mode with -n, which "
|
|
"keeps the guest from auto-configuring the host side of the anchor TAP); absent when the "
|
|
"probe failed",
|
|
)
|
|
ubridge_vxlan: Optional[bool] = Field(
|
|
None,
|
|
description="Whether uBridge can create VXLAN devices (the vxlan module, kernel support included) — "
|
|
"the tunnel a cross-compute kernel link rides; absent when the probe failed",
|
|
)
|