feat(compute): report uBridge tc capabilities and gate filters on them

Consume uBridge's ebpf_modes contract (feature/tc-window 40c36ae): a
stateful mode is usable iff ebpf=1 and its token is listed; builds
predating the field keep their shipped modes (nth/quota/flow), so the
pre-correction window semantics can never be installed silently.

- gns3server/utils/tc_capabilities.py: shared reply parser, mode
  policy and filter-type mappings (compute and controller gate on the
  same rules)
- gns3server/compute/ubridge/tc_probe.py: standalone probe spawning a
  throwaway uBridge as the server's own user, cached by binary
  identity (path/mtime/size - the version string cannot distinguish
  rebuilds); failures cache as unknown
- GET /v3/compute/capabilities gains ubridge_tc {netem, ebpf,
  ebpf_modes, cbpf}; the controller forwards it (Compute.capabilities)
  and available_filters hides kernel-datapath filter types an endpoint
  compute cannot run (both ends apply their own filters, so one
  incapable compute hides the type); computes without a report keep
  the full list and apply-time 409 stays the guard
- docker: _ubridge_apply_ebpf_drops gates per mode token; the cleanup
  path only sends "off" for modes the build declares
- split DockerVM's kernel-datapath machinery (veth lifecycle, carrier,
  marker primitives, tc filter translation, kernel NIO teardown) into
  compute/docker/docker_kernel_datapath.py (DockerKernelDatapathMixin)
This commit is contained in:
YueGuobin committed 2026-10-06 00:21:08 +08:00
1 parent 48dbdbe4a9
commit b4e4739d52
18 files changed
+1280 -571

No files matched your search

+18 -1
View File
@@ -92,7 +92,15 @@ class Compute:
self._disk_usage_percent = 0
self._last_error = None
self._ssl_context = ssl_context
self._capabilities = {"version": "", "platform": "", "cpus": 0, "memory": 0, "disk_size": 0, "node_types": []}
self._capabilities = {
"version": "",
"platform": "",
"cpus": 0,
"memory": 0,
"disk_size": 0,
"node_types": [],
"ubridge_tc": None,
}
self.name = name
# Cache of interfaces on remote host
self._interfaces_cache = None
@@ -288,6 +296,15 @@ class Compute:
def disk_usage_percent(self):
return self._disk_usage_percent
@property
def capabilities(self) -> dict:
"""
Capabilities reported by this compute (fetched from GET /capabilities
at connect time).
"""
return self._capabilities
def asdict(self, topology_dump=False):
"""
:param topology_dump: Filter to keep only properties require for saving on disk
+40 -5
View File
@@ -736,11 +736,15 @@ class Link:
filter_node = self._get_filter_node()
if filter_node:
if self.kernel_datapath:
# Kernel-datapath links serve every filter type: netem for
# delay/loss/corrupt and the netem extensions, cls_bpf for
# bpf, the eBPF classifier for frequency_drop, quota and
# window_drop.
return FILTERS
# Kernel-datapath links serve every filter type in principle:
# netem for delay/loss/corrupt and the netem extensions,
# cls_bpf for bpf, the eBPF classifier for frequency_drop,
# quota and window_drop. What is offered is gated on the
# endpoints' computes reporting a uBridge that can run each
# type; computes that report nothing (older servers, failed
# probe) keep the full list — update_filters still rejects
# with 409 on apply.
return [f for f in FILTERS if self._filter_supported_by_computes(f["type"])]
# Relay links: hide the kernel-only types the relay cannot run
# (they would be rejected with 409 on update).
from gns3server.utils.packet_filter_validation import KERNEL_ONLY_FILTERS
@@ -748,6 +752,37 @@ class Link:
return [f for f in FILTERS if f["type"] not in KERNEL_ONLY_FILTERS]
return []
def _filter_supported_by_computes(self, filter_type):
"""
Whether every endpoint's compute reports a uBridge able to run
*filter_type* on a kernel-datapath link (both ends apply their own
filters, so one incapable compute is enough to hide the type).
Computes without a uBridge tc report impose no constraint.
"""
from gns3server.utils.tc_capabilities import FILTER_EBPF_MODES, FILTER_NETEM_KEYWORDS
reported = []
for side in self._nodes:
capabilities = side["node"].compute.capabilities
if isinstance(capabilities, dict) and capabilities.get("ubridge_tc"):
reported.append(capabilities["ubridge_tc"])
if not reported:
return True
for caps in reported:
if filter_type in FILTER_EBPF_MODES:
if FILTER_EBPF_MODES[filter_type] not in caps["ebpf_modes"]:
return False
elif filter_type == "bpf":
if not caps["cbpf"]:
return False
elif filter_type in FILTER_NETEM_KEYWORDS:
if FILTER_NETEM_KEYWORDS[filter_type] not in caps["netem"]:
return False
# the remaining types (delay, packet_loss, corrupt) run on any
# build that reports tc capabilities at all
return True
def _get_filter_node(self):
"""
Return the node where the filter will run