From 0f31b2faf49451c6ab1f2be438631de00462e17a Mon Sep 17 00:00:00 2001 From: GnomeZworc Date: Tue, 6 Oct 2026 00:50:06 +0200 Subject: [PATCH] =?UTF-8?q?f-41:=20subnet:=20MAC=20de=20gateway=20anycast?= =?UTF-8?q?=20d=C3=A9riv=C3=A9e=20de=20la=20VNI=20#41?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: GnomeZworc --- docs/concepts/modes-reseau.rst | 6 ++++ internal/netif/upDown.go | 10 ++++++ internal/subnet/create.go | 9 +++++ internal/subnet/gateway.go | 19 +++++++++++ internal/subnet/gateway_test.go | 58 +++++++++++++++++++++++++++++++++ 5 files changed, 102 insertions(+) create mode 100644 internal/subnet/gateway.go create mode 100644 internal/subnet/gateway_test.go diff --git a/docs/concepts/modes-reseau.rst b/docs/concepts/modes-reseau.rst index 270cb17..74031e9 100644 --- a/docs/concepts/modes-reseau.rst +++ b/docs/concepts/modes-reseau.rst @@ -42,6 +42,12 @@ vxlan Le subnet vit dans le netns du VPC. La VM n'est donc **pas joignable depuis l'host** sans route explicite — point à connaître avant de câbler un outil externe dessus. +Le bridge du subnet, qui porte ``interface_ip``, a une **MAC de gateway anycast** calculée depuis +le ``vxlan_id`` : ``02:01:00`` suivi des 24 bits de la VNI (``vxlan_id`` 2811 → +``02:01:00:00:0a:fb``). Elle est identique sur tous les hôtes qui portent le subnet : une VM qui +change d'hôte garde une entrée ARP valide pour sa gateway. Elle n'est posée qu'à la création du +subnet — un subnet créé avant garde la MAC choisie par le noyau jusqu'à sa recréation. + bridge ------ diff --git a/internal/netif/upDown.go b/internal/netif/upDown.go index 6d27cc2..4e9cc61 100644 --- a/internal/netif/upDown.go +++ b/internal/netif/upDown.go @@ -1,6 +1,8 @@ package netif import ( + "net" + "github.com/vishvananda/netlink" ) @@ -19,3 +21,11 @@ func LinkSetDown(name string) error { } return netlink.LinkSetDown(link) } + +func LinkSetHardwareAddr(name string, mac net.HardwareAddr) error { + link, err := netlink.LinkByName(name) + if err != nil { + return err + } + return netlink.LinkSetHardwareAddr(link, mac) +} diff --git a/internal/subnet/create.go b/internal/subnet/create.go index 1164219..568b64e 100644 --- a/internal/subnet/create.go +++ b/internal/subnet/create.go @@ -70,6 +70,15 @@ func createSubnet(db *badger.DB, subnetName string, d subnetData, backend dhcpba if err := netif.CreateBridge(d.bridge, 1500); err != nil { return fmt.Errorf("create bridge: %w", err) } + if d.mode == ModeVxlan { + mac, err := anycastGatewayMAC(d.vxlanID) + if err != nil { + return err + } + if err := netif.LinkSetHardwareAddr(d.bridge, mac); err != nil { + return fmt.Errorf("set anycast gateway mac %s: %w", mac, err) + } + } return netif.BridgeSetMaster(vethI, d.bridge) }); err != nil { return fmt.Errorf("setup bridge in netns: %w", err) diff --git a/internal/subnet/gateway.go b/internal/subnet/gateway.go new file mode 100644 index 0000000..a61eb11 --- /dev/null +++ b/internal/subnet/gateway.go @@ -0,0 +1,19 @@ +package subnet + +import ( + "fmt" + "net" +) + +const ( + maxVNI = 1<<24 - 1 + roleAnycastGateway = 0x01 + locallyAdministered = 0x02 +) + +func anycastGatewayMAC(vni int) (net.HardwareAddr, error) { + if vni < 0 || vni > maxVNI { + return nil, fmt.Errorf("vxlan_id %d does not fit in 24 bits", vni) + } + return net.HardwareAddr{locallyAdministered, roleAnycastGateway, 0x00, byte(vni >> 16), byte(vni >> 8), byte(vni)}, nil +} diff --git a/internal/subnet/gateway_test.go b/internal/subnet/gateway_test.go new file mode 100644 index 0000000..2352996 --- /dev/null +++ b/internal/subnet/gateway_test.go @@ -0,0 +1,58 @@ +package subnet + +import "testing" + +func TestAnycastGatewayMAC(t *testing.T) { + cases := []struct { + vni int + want string + }{ + {2811, "02:01:00:00:0a:fb"}, + {0, "02:01:00:00:00:00"}, + {1, "02:01:00:00:00:01"}, + {0x123456, "02:01:00:12:34:56"}, + {maxVNI, "02:01:00:ff:ff:ff"}, + } + for _, c := range cases { + got, err := anycastGatewayMAC(c.vni) + if err != nil { + t.Fatalf("VNI %d : erreur inattendue %v", c.vni, err) + } + if got.String() != c.want { + t.Errorf("VNI %d : %s, %s attendu", c.vni, got, c.want) + } + } +} + +func TestAnycastGatewayMACIsLocalUnicast(t *testing.T) { + got, err := anycastGatewayMAC(2811) + if err != nil { + t.Fatal(err) + } + if got[0]&0x02 == 0 { + t.Errorf("%s : bit « administrée localement » absent", got) + } + if got[0]&0x01 != 0 { + t.Errorf("%s : MAC de groupe (multicast)", got) + } +} + +func TestAnycastGatewayMACIsIdenticalForTheSameVNIAndDistinctOtherwise(t *testing.T) { + a, _ := anycastGatewayMAC(2811) + b, _ := anycastGatewayMAC(2811) + c, _ := anycastGatewayMAC(2812) + if a.String() != b.String() { + t.Errorf("même VNI, MAC différentes : %s et %s", a, b) + } + if a.String() == c.String() { + t.Errorf("VNI différentes, même MAC : %s", a) + } +} + +func TestAnycastGatewayMACRejectsVNIOutside24Bits(t *testing.T) { + for _, vni := range []int{-1, maxVNI + 1} { + if mac, err := anycastGatewayMAC(vni); err == nil { + t.Errorf("VNI %d accepté : %s", vni, mac) + } + } +}