1
0
Fork 0
mirror of https://github.com/retspen/webvirtcloud synced 2026-11-08 11:16:47 +00:00
webvirtcloud/networks/forms.py
catborise 0c9a002ef4 fix(networks): a network's addresses are read as libvirt writes them, and its changes keep each other
Reviewed with Codex against libvirt's network format and driver.

- Addresses: wvmNetwork found a network's <ip> by its text, so one
  written as <ip .../> or <ip><dhcp>... without whitespace had none,
  and a second address of a family overwrote the first. ip_networks
  reads every <ip> in order, its index being libvirt's parentIndex:
  family (ipv4 when written), address, subnet, DHCP (a <dhcp>, also
  with fixed addresses only), first range and fixed addresses. The
  parentIndex was guessed from the number of families, wrong when IPv6
  comes first; changes now name the address by its index.
- One read: the page read the network's XML once per getter, ten or
  more round trips; it reads it once (a cached_property of the
  request's wvmNetwork). A change starts from the saved definition
  read anew (VIR_NETWORK_XML_INACTIVE), not the running one: two QoS
  changes on a running network no longer undo the first. The XML
  editor shows and changes the saved definition, and defines this
  network only (its name, and its UUID if given), read for that with
  no entity expanded and handed to libvirt as written; an XML declaring
  its encoding is taken. The actions go back to the network's page by
  its own URL.
- Fixed addresses are found by the address they had (a hidden field),
  not by the editable box: changing it and pressing Delete deleted
  another entry or none. A change deletes the entry and adds it anew
  from a copy, keeping what the page does not show (a client id, a
  lease), and puts it back if the add fails: libvirt's own change
  finds an entry by any of its MAC, address or name, so it could
  replace another entry, and never by an IPv6 DUID. The address must
  be of the subnet, not the host's, and neither it, the MAC or DUID
  nor the name another entry's; an entry gone meanwhile is refused,
  not added anew; an unchanged one writes no audit row. They can be
  added while the network is stopped; a running network saved with
  other addresses than it runs with is not changed live, as
  parentIndex would name another <ip> of it.
- An address without a netmask or prefix takes libvirt's (IPv4 its
  class's, IPv6 /64), for its checks and the overlap check.
- The DHCP range must be in the subnet, in order and not take in the
  host's address.
- The create form takes a known mode only ("bogus" made an isolated
  network, a missing one a server error); NAT and routed networks need
  an IPv4 subnet, an isolated one may have none, a bridge or macvtap
  network needs its bridge or interface and gets no addresses; IPv6
  only with its box (whose value was "false", so never); no name or
  subnet of another network of the host. "Fixed Addresses" at create
  goes: it made a random-MAC entry for every address of the range,
  for no real VM.
- Refusals of a fixed address, the DHCP range, the XML and a QoS
  removal are messages, not server errors.
- The IPv6 forwarding of a bridge or macvtap network is the outside
  network's, not ROUTE.
- get_networks_info reads each network's XML once and gives its
  autostart and addresses too. Unused can_pxe, DHCP lease helpers,
  get_uuid and the per-family range and host getters go.
2026-10-29 10:09:14 +03:00

103 lines
4.6 KiB
Python

import ipaddress
import re
from django import forms
from django.utils.translation import gettext_lazy as _
def checked_subnet(subnet, version):
"""subnet, if it is empty or an IPv<version> network that has room for a
gateway, a DHCP range and (IPv4) a broadcast address; else a field error."""
if not subnet:
return subnet
try:
network = ipaddress.ip_network(subnet, strict=False)
except ValueError:
network = None
if network is None or network.version != version:
raise forms.ValidationError(_("%(subnet)s is not an IPv%(version)s subnet") % {"subnet": subnet, "version": version})
if version == 4 and network.prefixlen > 30:
raise forms.ValidationError(_("The IPv4 network prefix must be /30 or shorter"))
if version == 6 and network.prefixlen != 64:
raise forms.ValidationError(_("For libvirt, the IPv6 network prefix must be /64"))
return subnet
class AddNetPool(forms.Form):
"""A new network of the host. networks: the host's networks
(get_networks_info), whose names it may not take nor overlap their
subnets. NAT and routed networks need an IPv4 subnet; an isolated one
may have none; a bridge or macvtap network takes its addresses from the
outside network, and needs the host's bridge or interface."""
MODES = ("nat", "route", "none", "bridge", "macvtap")
name = forms.CharField(
error_messages={"required": _("No pool name has been entered")},
max_length=20
)
subnet = forms.CharField(label=_("IPv4 subnet"), max_length=20, required=False)
subnet6 = forms.CharField(label=_("IPv6 subnet"), max_length=42, required=False)
forward = forms.ChoiceField(choices=[(mode, mode) for mode in MODES])
dhcp4 = forms.BooleanField(required=False)
enable_ipv6 = forms.BooleanField(required=False)
dhcp6 = forms.BooleanField(required=False)
bridge_name = forms.CharField(label=_("Bridge or interface"), max_length=20, required=False)
openvswitch = forms.BooleanField(required=False)
def __init__(self, *args, networks=(), **kwargs):
super().__init__(*args, **kwargs)
self.networks = networks
def clean_name(self):
name = self.cleaned_data["name"]
if not re.fullmatch(r"[a-zA-Z0-9._-]+", name):
raise forms.ValidationError(
_("The pool name must not contain any special characters")
)
if any(net["name"] == name for net in self.networks):
raise forms.ValidationError(_("This host has a network of that name"), code="taken")
return name
def clean_subnet(self):
return checked_subnet(self.cleaned_data["subnet"], 4)
def clean_subnet6(self):
return checked_subnet(self.cleaned_data["subnet6"], 6)
def clean_bridge_name(self):
bridge_name = self.cleaned_data["bridge_name"]
if bridge_name and not re.fullmatch(r"[a-zA-Z0-9._:-]+", bridge_name):
raise forms.ValidationError(
_("The pool bridge name must not contain any special characters")
)
return bridge_name
def clean(self):
data = super().clean()
mode = data.get("forward")
if mode in ("bridge", "macvtap"):
# the outside network gives the addresses: none of libvirt's
data.update(subnet="", subnet6="", dhcp4=False, dhcp6=False)
if not data.get("bridge_name") and "bridge_name" not in self.errors:
self.add_error("bridge_name", _("This field is required."))
else:
data["bridge_name"] = ""
if mode in ("nat", "route") and not data.get("subnet") and "subnet" not in self.errors:
self.add_error("subnet", _("This field is required."))
if not data.get("enable_ipv6"):
data["subnet6"] = ""
elif not data.get("subnet6") and "subnet6" not in self.errors:
self.add_error("subnet6", _("This field is required."))
if mode != "bridge":
data["openvswitch"] = False
for field in ("subnet", "subnet6"):
if data.get(field) and field not in self.errors:
subnet = ipaddress.ip_network(data[field], strict=False)
for net in self.networks:
taken = next((ip["subnet"] for ip in net["ips"]
if ip["subnet"] and ip["subnet"].version == subnet.version and ip["subnet"].overlaps(subnet)), None)
if taken:
self.add_error(field, _("Network %(net)s has %(subnet)s") % {"net": net["name"], "subnet": taken})
break
return data