This commit is contained in:
forgejo-actions 2026-10-17 22:48:45 +00:00
commit 9d3395bae1
8 changed files with 1045 additions and 427 deletions

View file

@ -1,155 +1,170 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1000 736" width="1000" height="736" role="img" aria-label="Architecture du cluster : routeurs, route reflector, hyperviseurs, plans de données et de contrôle">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 900" width="1200" height="900" role="img" aria-label="Architecture du cluster : routeurs, route reflectors, hyperviseurs, plans de données et de contrôle">
<style>
.lbl { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 14px; fill: #e6edf3; }
.sub { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; fill: #9198a1; }
.grp { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 12px; font-weight: 600; fill: #9198a1; letter-spacing: .04em; }
.ctrlt { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; fill: #c297ff; }
.datat { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; font-weight: 600; fill: #4493f8; }
.orcht { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; font-weight: 600; fill: #3fb950; }
.nett { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; font-weight: 600; fill: #f0883e; }
.box { fill: #22272e; stroke: #6e7781; stroke-width: 1.5; }
.future { fill: #22272e; stroke: #6e7781; stroke-width: 1.5; stroke-dasharray: 6 4; }
.group { fill: #1c2128; stroke: #444c56; stroke-width: 1.5; }
.pill { fill: #22272e; stroke: #9198a1; stroke-width: 1.5; }
.bus { stroke: #9198a1; stroke-width: 4; fill: none; stroke-linecap: round; }
.link { stroke: #9198a1; stroke-width: 1.8; fill: none; }
.ctrl { stroke: #c297ff; stroke-width: 1.6; fill: none; stroke-dasharray: 5 4; }
.data { stroke: #4493f8; stroke-width: 3; fill: none; }
.made { stroke: #6e7781; stroke-width: 1.5; fill: none; stroke-dasharray: 2 3; }
.orch { stroke: #3fb950; stroke-width: 2; fill: none; stroke-dasharray: 8 4; }
.net { stroke: #f0883e; stroke-width: 2.4; fill: none; }
.head-ctrl { fill: #c297ff; }
.head-data { fill: #4493f8; }
.head-orch { fill: #3fb950; }
.head-net { fill: #f0883e; }
.made { stroke: #6e7781; stroke-width: 1.5; fill: none; stroke-dasharray: 2 3; }
.head-made { fill: #6e7781; }
</style>
<defs>
<marker id="a-ctrl" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path class="head-ctrl" d="M0 0 L10 5 L0 10 z"/></marker>
<marker id="a-data" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="5" markerHeight="5" orient="auto-start-reverse"><path class="head-data" d="M0 0 L10 5 L0 10 z"/></marker>
<marker id="a-orch" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse"><path class="head-orch" d="M0 0 L10 5 L0 10 z"/></marker>
<marker id="a-net" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse"><path class="head-net" d="M0 0 L10 5 L0 10 z"/></marker>
<marker id="a-made" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path class="head-made" d="M0 0 L10 5 L0 10 z"/></marker>
</defs>
<rect class="group" x="40" y="20" width="400" height="144" rx="8"/>
<text class="grp" x="60" y="44">ROUTEURS DE CLUSTER · AS 65100</text>
<rect class="box" x="60" y="66" width="170" height="60" rx="6"/>
<text class="lbl" x="145" y="92" text-anchor="middle">routeur 1</text>
<text class="sub" x="145" y="111" text-anchor="middle">169.254.0.1/28</text>
<rect class="box" x="250" y="66" width="170" height="60" rx="6"/>
<text class="lbl" x="335" y="92" text-anchor="middle">routeur 2</text>
<text class="sub" x="335" y="111" text-anchor="middle">169.254.0.2/28</text>
<text class="sub" x="240" y="150" text-anchor="middle">passerelle 192.168.14.1/24</text>
<rect class="group" x="560" y="20" width="400" height="144" rx="8"/>
<text class="grp" x="580" y="44">VM ROUTE REFLECTOR · AS 65000</text>
<text class="lbl" x="580" y="70">lo1 · 10.255.255.1/32</text>
<text class="sub" x="580" y="87">router-id, cluster-id, source des sessions EVPN</text>
<text class="lbl" x="580" y="111">192.168.14.4/24 · 169.254.0.3/28</text>
<text class="sub" x="580" y="128">principale, et secondaire pour le lien avec les routeurs</text>
<text class="sub" x="580" y="150">hébergée par le cluster lui-même</text>
<path class="ctrl" d="M440 92 L560 92"/>
<text class="ctrlt" x="500" y="84" text-anchor="middle">eBGP · BFD (×2)</text>
<text class="ctrlt" x="500" y="108" text-anchor="middle">annonce lo1 seule</text>
<text class="ctrlt" x="500" y="122" text-anchor="middle">n'accepte rien</text>
<path class="link" d="M145 126 L145 196"/>
<path class="link" d="M335 126 L335 196"/>
<path class="link" d="M760 164 L760 196"/>
<path class="bus" d="M40 196 L960 196"/>
<rect class="pill" x="376" y="177" width="216" height="38" rx="19"/>
<text class="lbl" x="484" y="194" text-anchor="middle">segment underlay · L2</text>
<text class="sub" x="484" y="209" text-anchor="middle">192.168.14.0/24 · 169.254.0.0/28</text>
<rect class="group" x="40" y="262" width="430" height="306" rx="8"/>
<text class="grp" x="60" y="284">HYPERVISEUR 1</text>
<rect class="box" x="274" y="298" width="180" height="46" rx="6"/>
<text class="lbl" x="364" y="317" text-anchor="middle">br-000000</text>
<text class="sub" x="364" y="334" text-anchor="middle">uplink · 192.168.14.11</text>
<rect class="box" x="274" y="366" width="180" height="46" rx="6"/>
<text class="lbl" x="364" y="385" text-anchor="middle">vxlan-&lt;vni&gt;</text>
<text class="sub" x="364" y="402" text-anchor="middle">dans br-&lt;subnet&gt;, sans learning</text>
<rect class="box" x="274" y="434" width="180" height="46" rx="6"/>
<text class="lbl" x="364" y="453" text-anchor="middle">netns du VPC</text>
<text class="sub" x="364" y="470" text-anchor="middle">passerelle, DHCP</text>
<rect class="box" x="274" y="502" width="180" height="46" rx="6"/>
<text class="lbl" x="364" y="521" text-anchor="middle">VM</text>
<text class="sub" x="364" y="538" text-anchor="middle">QEMU / KVM</text>
<path class="link" d="M364 344 L364 366"/>
<text class="sub" x="372" y="359">VTEP</text>
<path class="link" d="M364 412 L364 434"/>
<text class="sub" x="372" y="427">veth</text>
<path class="link" d="M364 480 L364 502"/>
<text class="sub" x="372" y="495">tap</text>
<rect class="box" x="56" y="298" width="180" height="70" rx="6"/>
<text class="lbl" x="146" y="321" text-anchor="middle">FRR</text>
<text class="sub" x="146" y="340" text-anchor="middle">bgpd · AS 64600</text>
<text class="sub" x="146" y="356" text-anchor="middle">advertise-all-vni</text>
<rect class="box" x="56" y="434" width="180" height="46" rx="6"/>
<text class="lbl" x="146" y="453" text-anchor="middle">agent</text>
<text class="sub" x="146" y="470" text-anchor="middle">API REST · Badger</text>
<path class="ctrl" d="M236 352 L255 352 L255 389 L272 389" marker-end="url(#a-ctrl)"/>
<text class="ctrlt" x="255" y="345" text-anchor="middle">FDB</text>
<path class="made" d="M236 457 L272 457" marker-end="url(#a-made)"/>
<text class="sub" x="255" y="450" text-anchor="middle">crée</text>
<rect class="group" x="530" y="262" width="430" height="306" rx="8"/>
<text class="grp" x="656" y="284">HYPERVISEUR 2</text>
<rect class="box" x="546" y="298" width="180" height="46" rx="6"/>
<text class="lbl" x="636" y="317" text-anchor="middle">br-000000</text>
<text class="sub" x="636" y="334" text-anchor="middle">uplink · 192.168.14.12</text>
<rect class="box" x="546" y="366" width="180" height="46" rx="6"/>
<text class="lbl" x="636" y="385" text-anchor="middle">vxlan-&lt;vni&gt;</text>
<text class="sub" x="636" y="402" text-anchor="middle">dans br-&lt;subnet&gt;, sans learning</text>
<rect class="box" x="546" y="434" width="180" height="46" rx="6"/>
<text class="lbl" x="636" y="453" text-anchor="middle">netns du VPC</text>
<text class="sub" x="636" y="470" text-anchor="middle">passerelle, DHCP</text>
<rect class="box" x="546" y="502" width="180" height="46" rx="6"/>
<text class="lbl" x="636" y="521" text-anchor="middle">VM</text>
<text class="sub" x="636" y="538" text-anchor="middle">QEMU / KVM</text>
<path class="link" d="M636 344 L636 366"/>
<text class="sub" x="628" y="359" text-anchor="end">VTEP</text>
<path class="link" d="M636 412 L636 434"/>
<text class="sub" x="628" y="427" text-anchor="end">veth</text>
<path class="link" d="M636 480 L636 502"/>
<text class="sub" x="628" y="495" text-anchor="end">tap</text>
<rect class="box" x="764" y="298" width="180" height="70" rx="6"/>
<text class="lbl" x="854" y="321" text-anchor="middle">FRR</text>
<text class="sub" x="854" y="340" text-anchor="middle">bgpd · AS 64600</text>
<text class="sub" x="854" y="356" text-anchor="middle">advertise-all-vni</text>
<rect class="box" x="764" y="434" width="180" height="46" rx="6"/>
<text class="lbl" x="854" y="453" text-anchor="middle">agent</text>
<text class="sub" x="854" y="470" text-anchor="middle">API REST · Badger</text>
<path class="ctrl" d="M764 352 L745 352 L745 389 L728 389" marker-end="url(#a-ctrl)"/>
<text class="ctrlt" x="745" y="345" text-anchor="middle">FDB</text>
<path class="made" d="M764 457 L728 457" marker-end="url(#a-made)"/>
<text class="sub" x="745" y="450" text-anchor="middle">crée</text>
<path class="link" d="M364 298 L364 196"/>
<path class="link" d="M636 298 L636 196"/>
<path class="ctrl" d="M210 298 L210 246 L357 246"/>
<path class="ctrl" d="M371 246 L612 246 L612 164"/>
<path class="ctrl" d="M854 298 L854 164"/>
<text class="ctrlt" x="384" y="240">iBGP l2vpn evpn · AS 64600</text>
<text class="ctrlt" x="862" y="240">iBGP</text>
<path class="data" d="M458 389 L542 389" marker-start="url(#a-data)" marker-end="url(#a-data)"/>
<text class="datat" x="500" y="378" text-anchor="middle">VXLAN</text>
<text class="datat" x="500" y="406" text-anchor="middle">UDP 4789</text>
<path class="link" d="M40 604 L76 604"/>
<text class="sub" x="84" y="608">lien L2 / interface</text>
<path class="data" d="M220 604 L256 604"/>
<text class="sub" x="264" y="608">plan de données : tunnels VXLAN</text>
<path class="ctrl" d="M470 604 L506 604"/>
<text class="sub" x="514" y="608">plan de contrôle : sessions BGP</text>
<path class="made" d="M716 604 L752 604"/>
<text class="sub" x="760" y="608">créé par l'agent</text>
<text class="sub" x="40" y="640">Les hyperviseurs joignent 10.255.255.1 par leur passerelle 192.168.14.1 : les routeurs l'ont apprise du route reflector en eBGP, sans rien lui renvoyer.</text>
<text class="sub" x="40" y="658">Le route reflector accepte toute session venant de 192.168.14.0/24 (bgp listen range) et réfléchit les routes EVPN entre hyperviseurs.</text>
<text class="sub" x="40" y="676">Chaque FRR en peuple la FDB des VXLAN locaux — intégration de FRR avec les interfaces créées par two : à qualifier (#50, E5).</text>
<text class="sub" x="40" y="694">MTU du segment : 1550 au moins (VXLAN figé à 1500 par l'agent, + 50 octets d'encapsulation) ; 9000 dans le lab.</text>
<text class="sub" x="40" y="712">ASN, loopback et plages : valeurs de production (#50). Adresses en 192.168.14.0/24 : celles du lab. Placement de la VM route reflector : à rédiger.</text>
<rect class="group" x="40" y="20" width="440" height="140" rx="8"/>
<text class="grp" x="60" y="44">ROUTEURS DU CLUSTER · AS 65100</text>
<rect class="box" x="60" y="52" width="190" height="56" rx="6"/>
<text class="lbl" x="155.0" y="77.0" text-anchor="middle">routeur 1</text>
<text class="sub" x="155.0" y="94.0" text-anchor="middle">169.254.0.1/28</text>
<rect class="box" x="270" y="52" width="190" height="56" rx="6"/>
<text class="lbl" x="365.0" y="77.0" text-anchor="middle">routeur 2</text>
<text class="sub" x="365.0" y="94.0" text-anchor="middle">169.254.0.2/28</text>
<text class="sub" x="260" y="132" text-anchor="middle">passerelle de l'underlay en VRRP</text>
<text class="sub" x="260" y="148" text-anchor="middle">annoncent les loopbacks des RR, ne leur renvoient rien</text>
<rect class="group" x="620" y="20" width="540" height="140" rx="8"/>
<text class="grp" x="640" y="44">ROUTE REFLECTORS · AS 65000</text>
<rect class="box" x="640" y="52" width="240" height="56" rx="6"/>
<text class="lbl" x="760.0" y="77.0" text-anchor="middle">route reflector 1</text>
<text class="sub" x="760.0" y="94.0" text-anchor="middle">lo 10.255.255.1/32 · 169.254.0.3/28</text>
<rect class="box" x="900" y="52" width="240" height="56" rx="6"/>
<text class="lbl" x="1020.0" y="77.0" text-anchor="middle">route reflector 2</text>
<text class="sub" x="1020.0" y="94.0" text-anchor="middle">lo 10.255.255.2/32 · 169.254.0.4/28</text>
<text class="sub" x="890" y="132" text-anchor="middle">router-id, cluster-id et source des sessions EVPN : la loopback</text>
<text class="sub" x="890" y="148" text-anchor="middle">un par cluster (vue d'ensemble) ; le lab les réunit dans un seul</text>
<path class="ctrl" d="M480 80 H640" marker-start="url(#a-ctrl)" marker-end="url(#a-ctrl)"/>
<text class="ctrlt" x="560" y="72" text-anchor="middle">eBGP · BFD</text>
<text class="ctrlt" x="560" y="98" text-anchor="middle">loopbacks seules</text>
<line class="bus" x1="40" y1="200" x2="1160" y2="200"/>
<text class="sub" x="600" y="192" text-anchor="middle">segment underlay · L2 · lien routeurs ↔ RR en 169.254.0.0/28</text>
<path class="link" d="M260 160 V200"/>
<path class="link" d="M890 160 V200"/>
<path class="data" d="M200 236 H780"/>
<text class="datat" x="490" y="230" text-anchor="middle">VXLAN · UDP 4789 · de VTEP à VTEP</text>
<path class="data" d="M200 236 V280"/>
<path class="data" d="M780 236 V280"/>
<rect class="group" x="40" y="250" width="540" height="450" rx="8"/>
<text class="grp" x="60" y="274">HYPERVISEUR 1</text>
<rect class="box" x="60" y="280" width="180" height="52" rx="6"/>
<text class="lbl" x="150.0" y="303.0" text-anchor="middle">br-000000</text>
<text class="sub" x="150.0" y="320.0" text-anchor="middle">IP de l'hyperviseur = VTEP</text>
<rect class="box" x="60" y="350" width="180" height="62" rx="6"/>
<text class="lbl" x="150.0" y="370.0" text-anchor="middle">FRR</text>
<text class="sub" x="150.0" y="387.0" text-anchor="middle">bgpd · AS 64600</text>
<text class="sub" x="150.0" y="402.0" text-anchor="middle">advertise-all-vni</text>
<rect class="box" x="60" y="430" width="180" height="52" rx="6"/>
<text class="lbl" x="150.0" y="453.0" text-anchor="middle">agent</text>
<text class="sub" x="150.0" y="470.0" text-anchor="middle">API REST · Badger</text>
<rect class="box" x="60" y="510" width="180" height="56" rx="6"/>
<text class="lbl" x="150.0" y="535.0" text-anchor="middle">vxlan-&lt;vni&gt;</text>
<text class="sub" x="150.0" y="552.0" text-anchor="middle">dans br-&lt;subnet&gt;, sans learning</text>
<rect class="group" x="270" y="280" width="290" height="300" rx="8"/>
<text class="grp" x="290" y="304">NETNS DE LA VPC</text>
<rect class="box" x="285" y="312" width="125" height="66" rx="6"/>
<text class="lbl" x="347.5" y="334.0" text-anchor="middle">gw-&lt;subnet&gt;</text>
<text class="sub" x="347.5" y="351.0" text-anchor="middle">gateway .254</text>
<text class="sub" x="347.5" y="366.0" text-anchor="middle">MAC anycast</text>
<rect class="box" x="420" y="312" width="125" height="66" rx="6"/>
<text class="lbl" x="482.5" y="334.0" text-anchor="middle">DHCP</text>
<text class="sub" x="482.5" y="351.0" text-anchor="middle">métadonnées</text>
<text class="sub" x="482.5" y="366.0" text-anchor="middle">écoutent sur gw-</text>
<rect class="box" x="285" y="400" width="260" height="52" rx="6"/>
<text class="lbl" x="415.0" y="423.0" text-anchor="middle">br-&lt;subnet&gt;</text>
<text class="sub" x="415.0" y="440.0" text-anchor="middle">adresse d'émission .253</text>
<rect class="box" x="285" y="478" width="260" height="52" rx="6"/>
<text class="lbl" x="415.0" y="501.0" text-anchor="middle">VM</text>
<text class="sub" x="415.0" y="518.0" text-anchor="middle">QEMU / KVM · tap dans le netns</text>
<text class="sub" x="415" y="552" text-anchor="middle">macvlan gw- posé sur br-, confiné à l'hôte (#57)</text>
<rect class="box" x="270" y="610" width="290" height="62" rx="6"/>
<text class="lbl" x="415.0" y="630.0" text-anchor="middle">vrf-&lt;vpc&gt; · L3VNI</text>
<text class="sub" x="415.0" y="647.0" text-anchor="middle">brl3 · vxl3 · veth de transit</text>
<text class="sub" x="415.0" y="662.0" text-anchor="middle">routage entre hyperviseurs (#41)</text>
<path class="link" d="M347 378 V400"/>
<path class="link" d="M240 538 H255 V430 H285"/>
<path class="link" d="M415 452 V478"/>
<text class="sub" x="423" y="469" text-anchor="start">tap</text>
<path class="link" d="M415 580 V610"/>
<text class="sub" x="423" y="600" text-anchor="start">transit</text>
<path class="made" d="M60 538 H50 V306 H60" marker-end="url(#a-made)"/>
<path class="made" d="M240 456 H270" marker-end="url(#a-made)"/>
<path class="link" d="M225 280 V200"/>
<path class="ctrl" d="M240 365 H248 V200"/>
<rect class="group" x="620" y="250" width="540" height="450" rx="8"/>
<text class="grp" x="640" y="274">HYPERVISEUR 2</text>
<rect class="box" x="640" y="280" width="180" height="52" rx="6"/>
<text class="lbl" x="730.0" y="303.0" text-anchor="middle">br-000000</text>
<text class="sub" x="730.0" y="320.0" text-anchor="middle">IP de l'hyperviseur = VTEP</text>
<rect class="box" x="640" y="350" width="180" height="62" rx="6"/>
<text class="lbl" x="730.0" y="370.0" text-anchor="middle">FRR</text>
<text class="sub" x="730.0" y="387.0" text-anchor="middle">bgpd · AS 64600</text>
<text class="sub" x="730.0" y="402.0" text-anchor="middle">advertise-all-vni</text>
<rect class="box" x="640" y="430" width="180" height="52" rx="6"/>
<text class="lbl" x="730.0" y="453.0" text-anchor="middle">agent</text>
<text class="sub" x="730.0" y="470.0" text-anchor="middle">API REST · Badger</text>
<rect class="box" x="640" y="510" width="180" height="56" rx="6"/>
<text class="lbl" x="730.0" y="535.0" text-anchor="middle">vxlan-&lt;vni&gt;</text>
<text class="sub" x="730.0" y="552.0" text-anchor="middle">dans br-&lt;subnet&gt;, sans learning</text>
<rect class="group" x="850" y="280" width="290" height="300" rx="8"/>
<text class="grp" x="870" y="304">NETNS DE LA VPC</text>
<rect class="box" x="865" y="312" width="125" height="66" rx="6"/>
<text class="lbl" x="927.5" y="334.0" text-anchor="middle">gw-&lt;subnet&gt;</text>
<text class="sub" x="927.5" y="351.0" text-anchor="middle">gateway .254</text>
<text class="sub" x="927.5" y="366.0" text-anchor="middle">MAC anycast</text>
<rect class="box" x="1000" y="312" width="125" height="66" rx="6"/>
<text class="lbl" x="1062.5" y="334.0" text-anchor="middle">DHCP</text>
<text class="sub" x="1062.5" y="351.0" text-anchor="middle">métadonnées</text>
<text class="sub" x="1062.5" y="366.0" text-anchor="middle">écoutent sur gw-</text>
<rect class="box" x="865" y="400" width="260" height="52" rx="6"/>
<text class="lbl" x="995.0" y="423.0" text-anchor="middle">br-&lt;subnet&gt;</text>
<text class="sub" x="995.0" y="440.0" text-anchor="middle">adresse d'émission .253</text>
<rect class="box" x="865" y="478" width="260" height="52" rx="6"/>
<text class="lbl" x="995.0" y="501.0" text-anchor="middle">VM</text>
<text class="sub" x="995.0" y="518.0" text-anchor="middle">QEMU / KVM · tap dans le netns</text>
<text class="sub" x="995" y="552" text-anchor="middle">macvlan gw- posé sur br-, confiné à l'hôte (#57)</text>
<rect class="box" x="850" y="610" width="290" height="62" rx="6"/>
<text class="lbl" x="995.0" y="630.0" text-anchor="middle">vrf-&lt;vpc&gt; · L3VNI</text>
<text class="sub" x="995.0" y="647.0" text-anchor="middle">brl3 · vxl3 · veth de transit</text>
<text class="sub" x="995.0" y="662.0" text-anchor="middle">routage entre hyperviseurs (#41)</text>
<path class="link" d="M927 378 V400"/>
<path class="link" d="M820 538 H835 V430 H865"/>
<path class="link" d="M995 452 V478"/>
<text class="sub" x="1003" y="469" text-anchor="start">tap</text>
<path class="link" d="M995 580 V610"/>
<text class="sub" x="1003" y="600" text-anchor="start">transit</text>
<path class="made" d="M640 538 H630 V306 H640" marker-end="url(#a-made)"/>
<path class="made" d="M820 456 H850" marker-end="url(#a-made)"/>
<path class="link" d="M805 280 V200"/>
<path class="ctrl" d="M820 365 H828 V200"/>
<text class="ctrlt" x="1150" y="230" text-anchor="end">iBGP l2vpn evpn · AS 64600 (FRR → RR)</text>
<line class="link" x1="60" y1="736" x2="110" y2="736"/>
<text class="sub" x="118" y="740" text-anchor="start">lien L2 / interface</text>
<path class="data" d="M260 736 H310"/>
<text class="sub" x="318" y="740" text-anchor="start">plan de données : tunnels VXLAN</text>
<path class="ctrl" d="M520 736 H570"/>
<text class="sub" x="578" y="740" text-anchor="start">plan de contrôle : sessions BGP</text>
<path class="made" d="M790 736 H840" marker-end="url(#a-made)"/>
<text class="sub" x="848" y="740" text-anchor="start">créé par l'agent</text>
<text class="sub" x="60" y="780" text-anchor="start">Les hyperviseurs joignent les loopbacks des route reflectors par leur passerelle : les routeurs les ont apprises en eBGP, sans rien leur renvoyer.</text>
<text class="sub" x="60" y="798" text-anchor="start">Les route reflectors acceptent toute session venant de l'underlay (bgp listen range) et réfléchissent les routes EVPN entre hyperviseurs ; chaque FRR en peuple la FDB des VXLAN locaux.</text>
<text class="sub" x="60" y="816" text-anchor="start">La gateway d'un subnet a la même IP et la même MAC sur tous les hôtes ; chaque netns émet depuis son adresse d'émission. Les subnets d'une VPC se joignent par son L3VNI.</text>
<text class="sub" x="60" y="834" text-anchor="start">ASN et loopbacks : valeurs de production (#50). Vue d'ensemble (bordures, Internet, orchestration, plusieurs clusters) : schéma précédent.</text>
</svg>

Before

Width:  |  Height:  |  Size: 10 KiB

After

Width:  |  Height:  |  Size: 14 KiB

Before After
Before After

View file

@ -1,155 +1,170 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1000 736" width="1000" height="736" role="img" aria-label="Architecture du cluster : routeurs, route reflector, hyperviseurs, plans de données et de contrôle">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 900" width="1200" height="900" role="img" aria-label="Architecture du cluster : routeurs, route reflectors, hyperviseurs, plans de données et de contrôle">
<style>
.lbl { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 14px; fill: #1f2328; }
.sub { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; fill: #57606a; }
.grp { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 12px; font-weight: 600; fill: #57606a; letter-spacing: .04em; }
.ctrlt { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; fill: #8250df; }
.datat { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; font-weight: 600; fill: #0969da; }
.orcht { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; font-weight: 600; fill: #1a7f37; }
.nett { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; font-weight: 600; fill: #bc4c00; }
.box { fill: #ffffff; stroke: #8c959f; stroke-width: 1.5; }
.future { fill: #ffffff; stroke: #8c959f; stroke-width: 1.5; stroke-dasharray: 6 4; }
.group { fill: #f6f8fa; stroke: #d0d7de; stroke-width: 1.5; }
.pill { fill: #ffffff; stroke: #57606a; stroke-width: 1.5; }
.bus { stroke: #57606a; stroke-width: 4; fill: none; stroke-linecap: round; }
.link { stroke: #57606a; stroke-width: 1.8; fill: none; }
.ctrl { stroke: #8250df; stroke-width: 1.6; fill: none; stroke-dasharray: 5 4; }
.data { stroke: #0969da; stroke-width: 3; fill: none; }
.made { stroke: #8c959f; stroke-width: 1.5; fill: none; stroke-dasharray: 2 3; }
.orch { stroke: #1a7f37; stroke-width: 2; fill: none; stroke-dasharray: 8 4; }
.net { stroke: #bc4c00; stroke-width: 2.4; fill: none; }
.head-ctrl { fill: #8250df; }
.head-data { fill: #0969da; }
.head-orch { fill: #1a7f37; }
.head-net { fill: #bc4c00; }
.made { stroke: #8c959f; stroke-width: 1.5; fill: none; stroke-dasharray: 2 3; }
.head-made { fill: #8c959f; }
</style>
<defs>
<marker id="a-ctrl" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path class="head-ctrl" d="M0 0 L10 5 L0 10 z"/></marker>
<marker id="a-data" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="5" markerHeight="5" orient="auto-start-reverse"><path class="head-data" d="M0 0 L10 5 L0 10 z"/></marker>
<marker id="a-orch" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse"><path class="head-orch" d="M0 0 L10 5 L0 10 z"/></marker>
<marker id="a-net" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse"><path class="head-net" d="M0 0 L10 5 L0 10 z"/></marker>
<marker id="a-made" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path class="head-made" d="M0 0 L10 5 L0 10 z"/></marker>
</defs>
<rect class="group" x="40" y="20" width="400" height="144" rx="8"/>
<text class="grp" x="60" y="44">ROUTEURS DE CLUSTER · AS 65100</text>
<rect class="box" x="60" y="66" width="170" height="60" rx="6"/>
<text class="lbl" x="145" y="92" text-anchor="middle">routeur 1</text>
<text class="sub" x="145" y="111" text-anchor="middle">169.254.0.1/28</text>
<rect class="box" x="250" y="66" width="170" height="60" rx="6"/>
<text class="lbl" x="335" y="92" text-anchor="middle">routeur 2</text>
<text class="sub" x="335" y="111" text-anchor="middle">169.254.0.2/28</text>
<text class="sub" x="240" y="150" text-anchor="middle">passerelle 192.168.14.1/24</text>
<rect class="group" x="560" y="20" width="400" height="144" rx="8"/>
<text class="grp" x="580" y="44">VM ROUTE REFLECTOR · AS 65000</text>
<text class="lbl" x="580" y="70">lo1 · 10.255.255.1/32</text>
<text class="sub" x="580" y="87">router-id, cluster-id, source des sessions EVPN</text>
<text class="lbl" x="580" y="111">192.168.14.4/24 · 169.254.0.3/28</text>
<text class="sub" x="580" y="128">principale, et secondaire pour le lien avec les routeurs</text>
<text class="sub" x="580" y="150">hébergée par le cluster lui-même</text>
<path class="ctrl" d="M440 92 L560 92"/>
<text class="ctrlt" x="500" y="84" text-anchor="middle">eBGP · BFD (×2)</text>
<text class="ctrlt" x="500" y="108" text-anchor="middle">annonce lo1 seule</text>
<text class="ctrlt" x="500" y="122" text-anchor="middle">n'accepte rien</text>
<path class="link" d="M145 126 L145 196"/>
<path class="link" d="M335 126 L335 196"/>
<path class="link" d="M760 164 L760 196"/>
<path class="bus" d="M40 196 L960 196"/>
<rect class="pill" x="376" y="177" width="216" height="38" rx="19"/>
<text class="lbl" x="484" y="194" text-anchor="middle">segment underlay · L2</text>
<text class="sub" x="484" y="209" text-anchor="middle">192.168.14.0/24 · 169.254.0.0/28</text>
<rect class="group" x="40" y="262" width="430" height="306" rx="8"/>
<text class="grp" x="60" y="284">HYPERVISEUR 1</text>
<rect class="box" x="274" y="298" width="180" height="46" rx="6"/>
<text class="lbl" x="364" y="317" text-anchor="middle">br-000000</text>
<text class="sub" x="364" y="334" text-anchor="middle">uplink · 192.168.14.11</text>
<rect class="box" x="274" y="366" width="180" height="46" rx="6"/>
<text class="lbl" x="364" y="385" text-anchor="middle">vxlan-&lt;vni&gt;</text>
<text class="sub" x="364" y="402" text-anchor="middle">dans br-&lt;subnet&gt;, sans learning</text>
<rect class="box" x="274" y="434" width="180" height="46" rx="6"/>
<text class="lbl" x="364" y="453" text-anchor="middle">netns du VPC</text>
<text class="sub" x="364" y="470" text-anchor="middle">passerelle, DHCP</text>
<rect class="box" x="274" y="502" width="180" height="46" rx="6"/>
<text class="lbl" x="364" y="521" text-anchor="middle">VM</text>
<text class="sub" x="364" y="538" text-anchor="middle">QEMU / KVM</text>
<path class="link" d="M364 344 L364 366"/>
<text class="sub" x="372" y="359">VTEP</text>
<path class="link" d="M364 412 L364 434"/>
<text class="sub" x="372" y="427">veth</text>
<path class="link" d="M364 480 L364 502"/>
<text class="sub" x="372" y="495">tap</text>
<rect class="box" x="56" y="298" width="180" height="70" rx="6"/>
<text class="lbl" x="146" y="321" text-anchor="middle">FRR</text>
<text class="sub" x="146" y="340" text-anchor="middle">bgpd · AS 64600</text>
<text class="sub" x="146" y="356" text-anchor="middle">advertise-all-vni</text>
<rect class="box" x="56" y="434" width="180" height="46" rx="6"/>
<text class="lbl" x="146" y="453" text-anchor="middle">agent</text>
<text class="sub" x="146" y="470" text-anchor="middle">API REST · Badger</text>
<path class="ctrl" d="M236 352 L255 352 L255 389 L272 389" marker-end="url(#a-ctrl)"/>
<text class="ctrlt" x="255" y="345" text-anchor="middle">FDB</text>
<path class="made" d="M236 457 L272 457" marker-end="url(#a-made)"/>
<text class="sub" x="255" y="450" text-anchor="middle">crée</text>
<rect class="group" x="530" y="262" width="430" height="306" rx="8"/>
<text class="grp" x="656" y="284">HYPERVISEUR 2</text>
<rect class="box" x="546" y="298" width="180" height="46" rx="6"/>
<text class="lbl" x="636" y="317" text-anchor="middle">br-000000</text>
<text class="sub" x="636" y="334" text-anchor="middle">uplink · 192.168.14.12</text>
<rect class="box" x="546" y="366" width="180" height="46" rx="6"/>
<text class="lbl" x="636" y="385" text-anchor="middle">vxlan-&lt;vni&gt;</text>
<text class="sub" x="636" y="402" text-anchor="middle">dans br-&lt;subnet&gt;, sans learning</text>
<rect class="box" x="546" y="434" width="180" height="46" rx="6"/>
<text class="lbl" x="636" y="453" text-anchor="middle">netns du VPC</text>
<text class="sub" x="636" y="470" text-anchor="middle">passerelle, DHCP</text>
<rect class="box" x="546" y="502" width="180" height="46" rx="6"/>
<text class="lbl" x="636" y="521" text-anchor="middle">VM</text>
<text class="sub" x="636" y="538" text-anchor="middle">QEMU / KVM</text>
<path class="link" d="M636 344 L636 366"/>
<text class="sub" x="628" y="359" text-anchor="end">VTEP</text>
<path class="link" d="M636 412 L636 434"/>
<text class="sub" x="628" y="427" text-anchor="end">veth</text>
<path class="link" d="M636 480 L636 502"/>
<text class="sub" x="628" y="495" text-anchor="end">tap</text>
<rect class="box" x="764" y="298" width="180" height="70" rx="6"/>
<text class="lbl" x="854" y="321" text-anchor="middle">FRR</text>
<text class="sub" x="854" y="340" text-anchor="middle">bgpd · AS 64600</text>
<text class="sub" x="854" y="356" text-anchor="middle">advertise-all-vni</text>
<rect class="box" x="764" y="434" width="180" height="46" rx="6"/>
<text class="lbl" x="854" y="453" text-anchor="middle">agent</text>
<text class="sub" x="854" y="470" text-anchor="middle">API REST · Badger</text>
<path class="ctrl" d="M764 352 L745 352 L745 389 L728 389" marker-end="url(#a-ctrl)"/>
<text class="ctrlt" x="745" y="345" text-anchor="middle">FDB</text>
<path class="made" d="M764 457 L728 457" marker-end="url(#a-made)"/>
<text class="sub" x="745" y="450" text-anchor="middle">crée</text>
<path class="link" d="M364 298 L364 196"/>
<path class="link" d="M636 298 L636 196"/>
<path class="ctrl" d="M210 298 L210 246 L357 246"/>
<path class="ctrl" d="M371 246 L612 246 L612 164"/>
<path class="ctrl" d="M854 298 L854 164"/>
<text class="ctrlt" x="384" y="240">iBGP l2vpn evpn · AS 64600</text>
<text class="ctrlt" x="862" y="240">iBGP</text>
<path class="data" d="M458 389 L542 389" marker-start="url(#a-data)" marker-end="url(#a-data)"/>
<text class="datat" x="500" y="378" text-anchor="middle">VXLAN</text>
<text class="datat" x="500" y="406" text-anchor="middle">UDP 4789</text>
<path class="link" d="M40 604 L76 604"/>
<text class="sub" x="84" y="608">lien L2 / interface</text>
<path class="data" d="M220 604 L256 604"/>
<text class="sub" x="264" y="608">plan de données : tunnels VXLAN</text>
<path class="ctrl" d="M470 604 L506 604"/>
<text class="sub" x="514" y="608">plan de contrôle : sessions BGP</text>
<path class="made" d="M716 604 L752 604"/>
<text class="sub" x="760" y="608">créé par l'agent</text>
<text class="sub" x="40" y="640">Les hyperviseurs joignent 10.255.255.1 par leur passerelle 192.168.14.1 : les routeurs l'ont apprise du route reflector en eBGP, sans rien lui renvoyer.</text>
<text class="sub" x="40" y="658">Le route reflector accepte toute session venant de 192.168.14.0/24 (bgp listen range) et réfléchit les routes EVPN entre hyperviseurs.</text>
<text class="sub" x="40" y="676">Chaque FRR en peuple la FDB des VXLAN locaux — intégration de FRR avec les interfaces créées par two : à qualifier (#50, E5).</text>
<text class="sub" x="40" y="694">MTU du segment : 1550 au moins (VXLAN figé à 1500 par l'agent, + 50 octets d'encapsulation) ; 9000 dans le lab.</text>
<text class="sub" x="40" y="712">ASN, loopback et plages : valeurs de production (#50). Adresses en 192.168.14.0/24 : celles du lab. Placement de la VM route reflector : à rédiger.</text>
<rect class="group" x="40" y="20" width="440" height="140" rx="8"/>
<text class="grp" x="60" y="44">ROUTEURS DU CLUSTER · AS 65100</text>
<rect class="box" x="60" y="52" width="190" height="56" rx="6"/>
<text class="lbl" x="155.0" y="77.0" text-anchor="middle">routeur 1</text>
<text class="sub" x="155.0" y="94.0" text-anchor="middle">169.254.0.1/28</text>
<rect class="box" x="270" y="52" width="190" height="56" rx="6"/>
<text class="lbl" x="365.0" y="77.0" text-anchor="middle">routeur 2</text>
<text class="sub" x="365.0" y="94.0" text-anchor="middle">169.254.0.2/28</text>
<text class="sub" x="260" y="132" text-anchor="middle">passerelle de l'underlay en VRRP</text>
<text class="sub" x="260" y="148" text-anchor="middle">annoncent les loopbacks des RR, ne leur renvoient rien</text>
<rect class="group" x="620" y="20" width="540" height="140" rx="8"/>
<text class="grp" x="640" y="44">ROUTE REFLECTORS · AS 65000</text>
<rect class="box" x="640" y="52" width="240" height="56" rx="6"/>
<text class="lbl" x="760.0" y="77.0" text-anchor="middle">route reflector 1</text>
<text class="sub" x="760.0" y="94.0" text-anchor="middle">lo 10.255.255.1/32 · 169.254.0.3/28</text>
<rect class="box" x="900" y="52" width="240" height="56" rx="6"/>
<text class="lbl" x="1020.0" y="77.0" text-anchor="middle">route reflector 2</text>
<text class="sub" x="1020.0" y="94.0" text-anchor="middle">lo 10.255.255.2/32 · 169.254.0.4/28</text>
<text class="sub" x="890" y="132" text-anchor="middle">router-id, cluster-id et source des sessions EVPN : la loopback</text>
<text class="sub" x="890" y="148" text-anchor="middle">un par cluster (vue d'ensemble) ; le lab les réunit dans un seul</text>
<path class="ctrl" d="M480 80 H640" marker-start="url(#a-ctrl)" marker-end="url(#a-ctrl)"/>
<text class="ctrlt" x="560" y="72" text-anchor="middle">eBGP · BFD</text>
<text class="ctrlt" x="560" y="98" text-anchor="middle">loopbacks seules</text>
<line class="bus" x1="40" y1="200" x2="1160" y2="200"/>
<text class="sub" x="600" y="192" text-anchor="middle">segment underlay · L2 · lien routeurs ↔ RR en 169.254.0.0/28</text>
<path class="link" d="M260 160 V200"/>
<path class="link" d="M890 160 V200"/>
<path class="data" d="M200 236 H780"/>
<text class="datat" x="490" y="230" text-anchor="middle">VXLAN · UDP 4789 · de VTEP à VTEP</text>
<path class="data" d="M200 236 V280"/>
<path class="data" d="M780 236 V280"/>
<rect class="group" x="40" y="250" width="540" height="450" rx="8"/>
<text class="grp" x="60" y="274">HYPERVISEUR 1</text>
<rect class="box" x="60" y="280" width="180" height="52" rx="6"/>
<text class="lbl" x="150.0" y="303.0" text-anchor="middle">br-000000</text>
<text class="sub" x="150.0" y="320.0" text-anchor="middle">IP de l'hyperviseur = VTEP</text>
<rect class="box" x="60" y="350" width="180" height="62" rx="6"/>
<text class="lbl" x="150.0" y="370.0" text-anchor="middle">FRR</text>
<text class="sub" x="150.0" y="387.0" text-anchor="middle">bgpd · AS 64600</text>
<text class="sub" x="150.0" y="402.0" text-anchor="middle">advertise-all-vni</text>
<rect class="box" x="60" y="430" width="180" height="52" rx="6"/>
<text class="lbl" x="150.0" y="453.0" text-anchor="middle">agent</text>
<text class="sub" x="150.0" y="470.0" text-anchor="middle">API REST · Badger</text>
<rect class="box" x="60" y="510" width="180" height="56" rx="6"/>
<text class="lbl" x="150.0" y="535.0" text-anchor="middle">vxlan-&lt;vni&gt;</text>
<text class="sub" x="150.0" y="552.0" text-anchor="middle">dans br-&lt;subnet&gt;, sans learning</text>
<rect class="group" x="270" y="280" width="290" height="300" rx="8"/>
<text class="grp" x="290" y="304">NETNS DE LA VPC</text>
<rect class="box" x="285" y="312" width="125" height="66" rx="6"/>
<text class="lbl" x="347.5" y="334.0" text-anchor="middle">gw-&lt;subnet&gt;</text>
<text class="sub" x="347.5" y="351.0" text-anchor="middle">gateway .254</text>
<text class="sub" x="347.5" y="366.0" text-anchor="middle">MAC anycast</text>
<rect class="box" x="420" y="312" width="125" height="66" rx="6"/>
<text class="lbl" x="482.5" y="334.0" text-anchor="middle">DHCP</text>
<text class="sub" x="482.5" y="351.0" text-anchor="middle">métadonnées</text>
<text class="sub" x="482.5" y="366.0" text-anchor="middle">écoutent sur gw-</text>
<rect class="box" x="285" y="400" width="260" height="52" rx="6"/>
<text class="lbl" x="415.0" y="423.0" text-anchor="middle">br-&lt;subnet&gt;</text>
<text class="sub" x="415.0" y="440.0" text-anchor="middle">adresse d'émission .253</text>
<rect class="box" x="285" y="478" width="260" height="52" rx="6"/>
<text class="lbl" x="415.0" y="501.0" text-anchor="middle">VM</text>
<text class="sub" x="415.0" y="518.0" text-anchor="middle">QEMU / KVM · tap dans le netns</text>
<text class="sub" x="415" y="552" text-anchor="middle">macvlan gw- posé sur br-, confiné à l'hôte (#57)</text>
<rect class="box" x="270" y="610" width="290" height="62" rx="6"/>
<text class="lbl" x="415.0" y="630.0" text-anchor="middle">vrf-&lt;vpc&gt; · L3VNI</text>
<text class="sub" x="415.0" y="647.0" text-anchor="middle">brl3 · vxl3 · veth de transit</text>
<text class="sub" x="415.0" y="662.0" text-anchor="middle">routage entre hyperviseurs (#41)</text>
<path class="link" d="M347 378 V400"/>
<path class="link" d="M240 538 H255 V430 H285"/>
<path class="link" d="M415 452 V478"/>
<text class="sub" x="423" y="469" text-anchor="start">tap</text>
<path class="link" d="M415 580 V610"/>
<text class="sub" x="423" y="600" text-anchor="start">transit</text>
<path class="made" d="M60 538 H50 V306 H60" marker-end="url(#a-made)"/>
<path class="made" d="M240 456 H270" marker-end="url(#a-made)"/>
<path class="link" d="M225 280 V200"/>
<path class="ctrl" d="M240 365 H248 V200"/>
<rect class="group" x="620" y="250" width="540" height="450" rx="8"/>
<text class="grp" x="640" y="274">HYPERVISEUR 2</text>
<rect class="box" x="640" y="280" width="180" height="52" rx="6"/>
<text class="lbl" x="730.0" y="303.0" text-anchor="middle">br-000000</text>
<text class="sub" x="730.0" y="320.0" text-anchor="middle">IP de l'hyperviseur = VTEP</text>
<rect class="box" x="640" y="350" width="180" height="62" rx="6"/>
<text class="lbl" x="730.0" y="370.0" text-anchor="middle">FRR</text>
<text class="sub" x="730.0" y="387.0" text-anchor="middle">bgpd · AS 64600</text>
<text class="sub" x="730.0" y="402.0" text-anchor="middle">advertise-all-vni</text>
<rect class="box" x="640" y="430" width="180" height="52" rx="6"/>
<text class="lbl" x="730.0" y="453.0" text-anchor="middle">agent</text>
<text class="sub" x="730.0" y="470.0" text-anchor="middle">API REST · Badger</text>
<rect class="box" x="640" y="510" width="180" height="56" rx="6"/>
<text class="lbl" x="730.0" y="535.0" text-anchor="middle">vxlan-&lt;vni&gt;</text>
<text class="sub" x="730.0" y="552.0" text-anchor="middle">dans br-&lt;subnet&gt;, sans learning</text>
<rect class="group" x="850" y="280" width="290" height="300" rx="8"/>
<text class="grp" x="870" y="304">NETNS DE LA VPC</text>
<rect class="box" x="865" y="312" width="125" height="66" rx="6"/>
<text class="lbl" x="927.5" y="334.0" text-anchor="middle">gw-&lt;subnet&gt;</text>
<text class="sub" x="927.5" y="351.0" text-anchor="middle">gateway .254</text>
<text class="sub" x="927.5" y="366.0" text-anchor="middle">MAC anycast</text>
<rect class="box" x="1000" y="312" width="125" height="66" rx="6"/>
<text class="lbl" x="1062.5" y="334.0" text-anchor="middle">DHCP</text>
<text class="sub" x="1062.5" y="351.0" text-anchor="middle">métadonnées</text>
<text class="sub" x="1062.5" y="366.0" text-anchor="middle">écoutent sur gw-</text>
<rect class="box" x="865" y="400" width="260" height="52" rx="6"/>
<text class="lbl" x="995.0" y="423.0" text-anchor="middle">br-&lt;subnet&gt;</text>
<text class="sub" x="995.0" y="440.0" text-anchor="middle">adresse d'émission .253</text>
<rect class="box" x="865" y="478" width="260" height="52" rx="6"/>
<text class="lbl" x="995.0" y="501.0" text-anchor="middle">VM</text>
<text class="sub" x="995.0" y="518.0" text-anchor="middle">QEMU / KVM · tap dans le netns</text>
<text class="sub" x="995" y="552" text-anchor="middle">macvlan gw- posé sur br-, confiné à l'hôte (#57)</text>
<rect class="box" x="850" y="610" width="290" height="62" rx="6"/>
<text class="lbl" x="995.0" y="630.0" text-anchor="middle">vrf-&lt;vpc&gt; · L3VNI</text>
<text class="sub" x="995.0" y="647.0" text-anchor="middle">brl3 · vxl3 · veth de transit</text>
<text class="sub" x="995.0" y="662.0" text-anchor="middle">routage entre hyperviseurs (#41)</text>
<path class="link" d="M927 378 V400"/>
<path class="link" d="M820 538 H835 V430 H865"/>
<path class="link" d="M995 452 V478"/>
<text class="sub" x="1003" y="469" text-anchor="start">tap</text>
<path class="link" d="M995 580 V610"/>
<text class="sub" x="1003" y="600" text-anchor="start">transit</text>
<path class="made" d="M640 538 H630 V306 H640" marker-end="url(#a-made)"/>
<path class="made" d="M820 456 H850" marker-end="url(#a-made)"/>
<path class="link" d="M805 280 V200"/>
<path class="ctrl" d="M820 365 H828 V200"/>
<text class="ctrlt" x="1150" y="230" text-anchor="end">iBGP l2vpn evpn · AS 64600 (FRR → RR)</text>
<line class="link" x1="60" y1="736" x2="110" y2="736"/>
<text class="sub" x="118" y="740" text-anchor="start">lien L2 / interface</text>
<path class="data" d="M260 736 H310"/>
<text class="sub" x="318" y="740" text-anchor="start">plan de données : tunnels VXLAN</text>
<path class="ctrl" d="M520 736 H570"/>
<text class="sub" x="578" y="740" text-anchor="start">plan de contrôle : sessions BGP</text>
<path class="made" d="M790 736 H840" marker-end="url(#a-made)"/>
<text class="sub" x="848" y="740" text-anchor="start">créé par l'agent</text>
<text class="sub" x="60" y="780" text-anchor="start">Les hyperviseurs joignent les loopbacks des route reflectors par leur passerelle : les routeurs les ont apprises en eBGP, sans rien leur renvoyer.</text>
<text class="sub" x="60" y="798" text-anchor="start">Les route reflectors acceptent toute session venant de l'underlay (bgp listen range) et réfléchissent les routes EVPN entre hyperviseurs ; chaque FRR en peuple la FDB des VXLAN locaux.</text>
<text class="sub" x="60" y="816" text-anchor="start">La gateway d'un subnet a la même IP et la même MAC sur tous les hôtes ; chaque netns émet depuis son adresse d'émission. Les subnets d'une VPC se joignent par son L3VNI.</text>
<text class="sub" x="60" y="834" text-anchor="start">ASN et loopbacks : valeurs de production (#50). Vue d'ensemble (bordures, Internet, orchestration, plusieurs clusters) : schéma précédent.</text>
</svg>

Before

Width:  |  Height:  |  Size: 10 KiB

After

Width:  |  Height:  |  Size: 14 KiB

Before After
Before After

View file

@ -0,0 +1,185 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1500 1210" width="1500" height="1210" role="img" aria-label="Vue d'ensemble : Internet, bordures, routeurs du cluster, services, orchestration et hyperviseurs">
<style>
.lbl { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 14px; fill: #e6edf3; }
.sub { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; fill: #9198a1; }
.grp { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 12px; font-weight: 600; fill: #9198a1; letter-spacing: .04em; }
.ctrlt { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; fill: #c297ff; }
.datat { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; font-weight: 600; fill: #4493f8; }
.orcht { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; font-weight: 600; fill: #3fb950; }
.nett { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; font-weight: 600; fill: #f0883e; }
.box { fill: #22272e; stroke: #6e7781; stroke-width: 1.5; }
.future { fill: #22272e; stroke: #6e7781; stroke-width: 1.5; stroke-dasharray: 6 4; }
.group { fill: #1c2128; stroke: #444c56; stroke-width: 1.5; }
.pill { fill: #22272e; stroke: #9198a1; stroke-width: 1.5; }
.bus { stroke: #9198a1; stroke-width: 4; fill: none; stroke-linecap: round; }
.link { stroke: #9198a1; stroke-width: 1.8; fill: none; }
.ctrl { stroke: #c297ff; stroke-width: 1.6; fill: none; stroke-dasharray: 5 4; }
.data { stroke: #4493f8; stroke-width: 3; fill: none; }
.orch { stroke: #3fb950; stroke-width: 2; fill: none; stroke-dasharray: 8 4; }
.net { stroke: #f0883e; stroke-width: 2.4; fill: none; }
.head-ctrl { fill: #c297ff; }
.head-data { fill: #4493f8; }
.head-orch { fill: #3fb950; }
.head-net { fill: #f0883e; }
</style>
<defs>
<marker id="a-ctrl" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path class="head-ctrl" d="M0 0 L10 5 L0 10 z"/></marker>
<marker id="a-data" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="5" markerHeight="5" orient="auto-start-reverse"><path class="head-data" d="M0 0 L10 5 L0 10 z"/></marker>
<marker id="a-orch" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse"><path class="head-orch" d="M0 0 L10 5 L0 10 z"/></marker>
<marker id="a-net" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse"><path class="head-net" d="M0 0 L10 5 L0 10 z"/></marker>
</defs>
<rect class="pill" x="600" y="20" width="300" height="56" rx="28"/>
<text class="lbl" x="750" y="54" text-anchor="middle">Internet</text>
<path class="net" d="M750 76 V110" marker-start="url(#a-net)" marker-end="url(#a-net)"/>
<text class="nett" x="758" y="98" text-anchor="start">agrégats publics</text>
<rect class="group" x="560" y="110" width="380" height="130" rx="8"/>
<text class="grp" x="580" y="134">BORDURES · AS PUBLIC · #31</text>
<rect class="future" x="580" y="140" width="160" height="52" rx="6"/>
<text class="lbl" x="660.0" y="163.0" text-anchor="middle">bordure 1</text>
<text class="sub" x="660.0" y="180.0" text-anchor="middle">gateway anycast</text>
<rect class="future" x="760" y="140" width="160" height="52" rx="6"/>
<text class="lbl" x="840.0" y="163.0" text-anchor="middle">bordure 2</text>
<text class="sub" x="840.0" y="180.0" text-anchor="middle">gateway anycast</text>
<text class="sub" x="750" y="214" text-anchor="middle">même IP et même MAC de gateway · sans état</text>
<text class="sub" x="750" y="230" text-anchor="middle">VTEP · VNI 66001 (public)</text>
<rect class="group" x="40" y="280" width="480" height="130" rx="8"/>
<text class="grp" x="60" y="304">CLUSTER A</text>
<rect class="box" x="60" y="312" width="210" height="56" rx="6"/>
<text class="lbl" x="165.0" y="337.0" text-anchor="middle">routeur 1</text>
<text class="sub" x="165.0" y="354.0" text-anchor="middle">169.254.0.1/28</text>
<rect class="box" x="290" y="312" width="210" height="56" rx="6"/>
<text class="lbl" x="395.0" y="337.0" text-anchor="middle">routeur 2</text>
<text class="sub" x="395.0" y="354.0" text-anchor="middle">169.254.0.2/28</text>
<text class="sub" x="280" y="392" text-anchor="middle">VRRP · VTEP · VNI 66000 · NAT vers le VNI 66000 · #72</text>
<rect class="group" x="1200" y="280" width="260" height="130" rx="8"/>
<text class="grp" x="1220" y="304">CLUSTER B</text>
<rect class="box" x="1215" y="312" width="110" height="56" rx="6"/>
<text class="lbl" x="1270.0" y="337.0" text-anchor="middle">routeur 1</text>
<text class="sub" x="1270.0" y="354.0" text-anchor="middle">169.254.0.1/28</text>
<rect class="box" x="1335" y="312" width="110" height="56" rx="6"/>
<text class="lbl" x="1390.0" y="337.0" text-anchor="middle">routeur 2</text>
<text class="sub" x="1390.0" y="354.0" text-anchor="middle">169.254.0.2/28</text>
<text class="sub" x="1330" y="388" text-anchor="middle">VRRP · VTEP · VNI 66000</text>
<text class="sub" x="1330" y="403" text-anchor="middle">NAT vers le VNI 66000 · #72</text>
<line class="bus" x1="1200" y1="460" x2="1460" y2="460"/>
<text class="sub" x="1205" y="478" text-anchor="start">underlay B · VXLAN UDP 4789 · BGP</text>
<path class="link" d="M1230 368 V460"/>
<path class="link" d="M1430 368 V460"/>
<rect class="box" x="1215" y="505" width="220" height="52" rx="6"/>
<text class="lbl" x="1325.0" y="528.0" text-anchor="middle">route reflector 2</text>
<text class="sub" x="1325.0" y="545.0" text-anchor="middle">lo 10.255.255.2/32 · 169.254.0.4/28</text>
<path class="link" d="M1440 460 V505"/>
<text class="ctrlt" x="1434" y="498" text-anchor="end">iBGP EVPN</text>
<rect class="group" x="1200" y="600" width="260" height="410" rx="8"/>
<text class="grp" x="1220" y="624">HYPERVISEURS B (×N)</text>
<rect class="box" x="1220" y="645" width="220" height="64" rx="6"/>
<text class="lbl" x="1330.0" y="666.0" text-anchor="middle">hyperviseur B1</text>
<text class="sub" x="1330.0" y="683.0" text-anchor="middle">agent · FRR · VPC</text>
<text class="sub" x="1330.0" y="698.0" text-anchor="middle">VTEP : son IP sur l'underlay B</text>
<rect class="box" x="1220" y="729" width="220" height="64" rx="6"/>
<text class="lbl" x="1330.0" y="750.0" text-anchor="middle">hyperviseur B2</text>
<text class="sub" x="1330.0" y="767.0" text-anchor="middle">agent · FRR · VPC</text>
<text class="sub" x="1330.0" y="782.0" text-anchor="middle">VTEP : son IP sur l'underlay B</text>
<rect class="box" x="1220" y="813" width="220" height="64" rx="6"/>
<text class="lbl" x="1330.0" y="834.0" text-anchor="middle">hyperviseur B3</text>
<text class="sub" x="1330.0" y="851.0" text-anchor="middle">agent · FRR · VPC</text>
<text class="sub" x="1330.0" y="866.0" text-anchor="middle">VTEP : son IP sur l'underlay B</text>
<text class="lbl" x="1330" y="925" text-anchor="middle">…</text>
<text class="sub" x="1330" y="955" text-anchor="middle">même modèle que</text>
<text class="sub" x="1330" y="970" text-anchor="middle">l'hyperviseur détaillé</text>
<path class="link" d="M1452 460 V600"/>
<path class="link" d="M500 340 H1215"/>
<text class="sub" x="860" y="332" text-anchor="middle">eBGP · routeur 2 de A → routeur 1 de B</text>
<path class="link" d="M660 240 V258 H210 V312"/>
<path class="link" d="M840 240 V258 H1315 V312"/>
<text class="sub" x="420" y="252" text-anchor="middle">eBGP</text>
<text class="sub" x="1060" y="252" text-anchor="middle">eBGP</text>
<line class="bus" x1="40" y1="460" x2="680" y2="460"/>
<text class="sub" x="690" y="465" text-anchor="start">underlay A · VXLAN UDP 4789 · BGP</text>
<path class="link" d="M75 368 V460"/>
<path class="link" d="M485 368 V460"/>
<rect class="box" x="60" y="490" width="230" height="52" rx="6"/>
<text class="lbl" x="175.0" y="513.0" text-anchor="middle">route reflector 1</text>
<text class="sub" x="175.0" y="530.0" text-anchor="middle">lo 10.255.255.1/32 · 169.254.0.3/28</text>
<path class="link" d="M175 460 V490"/>
<text class="ctrlt" x="183" y="482" text-anchor="start">iBGP EVPN</text>
<rect class="group" x="740" y="490" width="440" height="92" rx="8"/>
<text class="grp" x="760" y="514">SERVICES · VNI 66000 PARTAGÉ ENTRE CLUSTERS · #72</text>
<rect class="future" x="760" y="520" width="190" height="52" rx="6"/>
<text class="lbl" x="855.0" y="543.0" text-anchor="middle">broker</text>
<text class="sub" x="855.0" y="560.0" text-anchor="middle">MQTT · VNI 66000</text>
<rect class="future" x="970" y="520" width="190" height="52" rx="6"/>
<text class="lbl" x="1065.0" y="543.0" text-anchor="middle">orchestrateur</text>
<text class="sub" x="1065.0" y="560.0" text-anchor="middle">VNI 66000 et VNI 66001</text>
<path class="orch" d="M950 546 H970"/>
<path class="orch" d="M510 410 V546 H760" marker-end="url(#a-orch)"/>
<path class="orch" d="M1200 400 H1192 V560 H1180" marker-end="url(#a-orch)"/>
<rect class="group" x="40" y="600" width="1120" height="410" rx="8"/>
<text class="grp" x="60" y="624">HYPERVISEUR A (détaillé)</text>
<rect class="box" x="60" y="635" width="260" height="52" rx="6"/>
<text class="lbl" x="190.0" y="658.0" text-anchor="middle">br-000000</text>
<text class="sub" x="190.0" y="675.0" text-anchor="middle">IP de l'hyperviseur = VTEP</text>
<rect class="box" x="60" y="701" width="260" height="52" rx="6"/>
<text class="lbl" x="190.0" y="724.0" text-anchor="middle">FRR · bgpd</text>
<text class="sub" x="190.0" y="741.0" text-anchor="middle">sessions EVPN vers les RR</text>
<rect class="box" x="60" y="767" width="260" height="66" rx="6"/>
<text class="lbl" x="190.0" y="789.0" text-anchor="middle">agent</text>
<text class="sub" x="190.0" y="806.0" text-anchor="middle">API locale 127.0.0.1:8080</text>
<text class="sub" x="190.0" y="821.0" text-anchor="middle">client du broker, en sortie</text>
<rect class="future" x="60" y="849" width="260" height="56" rx="6"/>
<text class="lbl" x="190.0" y="874.0" text-anchor="middle">IP flottante · NAT 1:1</text>
<text class="sub" x="190.0" y="891.0" text-anchor="middle">hôte de la VM, sans état · #31</text>
<rect class="future" x="60" y="921" width="260" height="56" rx="6"/>
<text class="lbl" x="190.0" y="946.0" text-anchor="middle">subnet public de l'hôte</text>
<text class="sub" x="190.0" y="963.0" text-anchor="middle">VNI 66001 · hors VPC · #31</text>
<rect class="group" x="360" y="635" width="780" height="355" rx="8"/>
<text class="grp" x="380" y="659">VPC · netns + VRF</text>
<rect class="box" x="380" y="675" width="240" height="60" rx="6"/>
<text class="lbl" x="500.0" y="702.0" text-anchor="middle">netns de la VPC</text>
<text class="sub" x="500.0" y="719.0" text-anchor="middle">gateway .254 · DHCP · métadonnées</text>
<rect class="box" x="380" y="770" width="240" height="60" rx="6"/>
<text class="lbl" x="500.0" y="797.0" text-anchor="middle">VRF · L3VNI</text>
<text class="sub" x="500.0" y="814.0" text-anchor="middle">routage entre subnets et hyperviseurs</text>
<rect class="future" x="660" y="770" width="200" height="60" rx="6"/>
<text class="lbl" x="760.0" y="797.0" text-anchor="middle">passerelle NAT de la VPC</text>
<text class="sub" x="760.0" y="814.0" text-anchor="middle">sur un des hyperviseurs · #42</text>
<rect class="future" x="380" y="895" width="240" height="60" rx="6"/>
<text class="lbl" x="500.0" y="922.0" text-anchor="middle">subnet public de la VPC</text>
<text class="sub" x="500.0" y="939.0" text-anchor="middle">relié au subnet public de l'hôte</text>
<rect class="box" x="880" y="675" width="240" height="60" rx="6"/>
<text class="lbl" x="1000.0" y="702.0" text-anchor="middle">VM privée</text>
<text class="sub" x="1000.0" y="719.0" text-anchor="middle">adresse de la VPC</text>
<rect class="future" x="880" y="895" width="240" height="60" rx="6"/>
<text class="lbl" x="1000.0" y="922.0" text-anchor="middle">VM publique</text>
<text class="sub" x="1000.0" y="939.0" text-anchor="middle">+ NIC sur le subnet public</text>
<path class="link" d="M880 705 H620"/>
<path class="link" d="M500 735 V770"/>
<path class="net" d="M880 925 H620"/>
<path class="net" d="M380 953 H320" marker-end="url(#a-net)"/>
<path class="net" d="M380 810 H340 V877 H320" marker-end="url(#a-net)"/>
<path class="net" d="M620 800 H660" marker-end="url(#a-net)"/>
<path class="net" d="M760 830 V863 H350 V929 H320" marker-end="url(#a-net)"/>
<text class="nett" x="640" y="763" text-anchor="middle">défaut type 5</text>
<path class="net" d="M190 905 V921" marker-end="url(#a-net)"/>
<path class="data" d="M60 949 H50 V661 H60"/>
<text class="datat" x="30" y="805" text-anchor="middle" transform="rotate(-90 30 805)">VNI 66001</text>
<path class="link" d="M300 635 V460"/>
<path class="orch" d="M320 785 H332 V410" marker-end="url(#a-orch)"/>
<text class="orcht" x="340" y="596" text-anchor="start">register · ordres · événements (mTLS, sortant)</text>
<path class="data" d="M60 1045 H110"/>
<text class="sub" x="118" y="1049" text-anchor="start">plan de données : VXLAN</text>
<path class="ctrl" d="M290 1045 H340"/>
<text class="sub" x="348" y="1049" text-anchor="start">plan de contrôle : BGP</text>
<path class="orch" d="M510 1045 H560" marker-end="url(#a-orch)"/>
<text class="sub" x="568" y="1049" text-anchor="start">orchestration</text>
<path class="net" d="M690 1045 H740" marker-end="url(#a-net)"/>
<text class="sub" x="748" y="1049" text-anchor="start">trafic Internet</text>
<rect class="future" x="880" y="1035" width="34" height="20" rx="4"/>
<text class="sub" x="922" y="1049" text-anchor="start">à venir (ticket indiqué)</text>
<text class="sub" x="60" y="1089" text-anchor="start">Les agents ne sont jamais joints par l'orchestrateur : ils se connectent au broker en sortie, via leur passerelle ; les routeurs de leur cluster les NAT vers le VNI 66000.</text>
<text class="sub" x="60" y="1107" text-anchor="start">L'orchestrateur a une patte dans le VNI 66001 : son API est joignable depuis Internet, par les bordures.</text>
<text class="sub" x="60" y="1125" text-anchor="start">VM publique : un subnet public dans sa VPC, relié au subnet public de l'hôte (VNI 66001), dont la gateway anycast est portée par toutes les bordures.</text>
<text class="sub" x="60" y="1143" text-anchor="start">VM privée : route par défaut de type 5 vers la passerelle NAT de sa VPC (IP de sortie de la VPC) si la VPC autorise Internet, ou IP flottante 1:1 sur son hôte.</text>
<text class="sub" x="60" y="1161" text-anchor="start">Les bordures restent sans état : tout NAT vit sur un hyperviseur. Broker et orchestrateur sont des VM du VNI 66000, partagé : elles tournent sur les hyperviseurs de n'importe quel cluster.</text>
<text class="sub" x="60" y="1179" text-anchor="start">Un route reflector par cluster : un événement d'un cluster ne coupe pas les deux sessions. Chaque lien routeurs ↔ RR est en 169.254.0.0/28, propre à son cluster.</text>
</svg>

After

Width:  |  Height:  |  Size: 15 KiB

View file

@ -0,0 +1,185 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1500 1210" width="1500" height="1210" role="img" aria-label="Vue d'ensemble : Internet, bordures, routeurs du cluster, services, orchestration et hyperviseurs">
<style>
.lbl { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 14px; fill: #1f2328; }
.sub { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; fill: #57606a; }
.grp { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 12px; font-weight: 600; fill: #57606a; letter-spacing: .04em; }
.ctrlt { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; fill: #8250df; }
.datat { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; font-weight: 600; fill: #0969da; }
.orcht { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; font-weight: 600; fill: #1a7f37; }
.nett { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; font-weight: 600; fill: #bc4c00; }
.box { fill: #ffffff; stroke: #8c959f; stroke-width: 1.5; }
.future { fill: #ffffff; stroke: #8c959f; stroke-width: 1.5; stroke-dasharray: 6 4; }
.group { fill: #f6f8fa; stroke: #d0d7de; stroke-width: 1.5; }
.pill { fill: #ffffff; stroke: #57606a; stroke-width: 1.5; }
.bus { stroke: #57606a; stroke-width: 4; fill: none; stroke-linecap: round; }
.link { stroke: #57606a; stroke-width: 1.8; fill: none; }
.ctrl { stroke: #8250df; stroke-width: 1.6; fill: none; stroke-dasharray: 5 4; }
.data { stroke: #0969da; stroke-width: 3; fill: none; }
.orch { stroke: #1a7f37; stroke-width: 2; fill: none; stroke-dasharray: 8 4; }
.net { stroke: #bc4c00; stroke-width: 2.4; fill: none; }
.head-ctrl { fill: #8250df; }
.head-data { fill: #0969da; }
.head-orch { fill: #1a7f37; }
.head-net { fill: #bc4c00; }
</style>
<defs>
<marker id="a-ctrl" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path class="head-ctrl" d="M0 0 L10 5 L0 10 z"/></marker>
<marker id="a-data" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="5" markerHeight="5" orient="auto-start-reverse"><path class="head-data" d="M0 0 L10 5 L0 10 z"/></marker>
<marker id="a-orch" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse"><path class="head-orch" d="M0 0 L10 5 L0 10 z"/></marker>
<marker id="a-net" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse"><path class="head-net" d="M0 0 L10 5 L0 10 z"/></marker>
</defs>
<rect class="pill" x="600" y="20" width="300" height="56" rx="28"/>
<text class="lbl" x="750" y="54" text-anchor="middle">Internet</text>
<path class="net" d="M750 76 V110" marker-start="url(#a-net)" marker-end="url(#a-net)"/>
<text class="nett" x="758" y="98" text-anchor="start">agrégats publics</text>
<rect class="group" x="560" y="110" width="380" height="130" rx="8"/>
<text class="grp" x="580" y="134">BORDURES · AS PUBLIC · #31</text>
<rect class="future" x="580" y="140" width="160" height="52" rx="6"/>
<text class="lbl" x="660.0" y="163.0" text-anchor="middle">bordure 1</text>
<text class="sub" x="660.0" y="180.0" text-anchor="middle">gateway anycast</text>
<rect class="future" x="760" y="140" width="160" height="52" rx="6"/>
<text class="lbl" x="840.0" y="163.0" text-anchor="middle">bordure 2</text>
<text class="sub" x="840.0" y="180.0" text-anchor="middle">gateway anycast</text>
<text class="sub" x="750" y="214" text-anchor="middle">même IP et même MAC de gateway · sans état</text>
<text class="sub" x="750" y="230" text-anchor="middle">VTEP · VNI 66001 (public)</text>
<rect class="group" x="40" y="280" width="480" height="130" rx="8"/>
<text class="grp" x="60" y="304">CLUSTER A</text>
<rect class="box" x="60" y="312" width="210" height="56" rx="6"/>
<text class="lbl" x="165.0" y="337.0" text-anchor="middle">routeur 1</text>
<text class="sub" x="165.0" y="354.0" text-anchor="middle">169.254.0.1/28</text>
<rect class="box" x="290" y="312" width="210" height="56" rx="6"/>
<text class="lbl" x="395.0" y="337.0" text-anchor="middle">routeur 2</text>
<text class="sub" x="395.0" y="354.0" text-anchor="middle">169.254.0.2/28</text>
<text class="sub" x="280" y="392" text-anchor="middle">VRRP · VTEP · VNI 66000 · NAT vers le VNI 66000 · #72</text>
<rect class="group" x="1200" y="280" width="260" height="130" rx="8"/>
<text class="grp" x="1220" y="304">CLUSTER B</text>
<rect class="box" x="1215" y="312" width="110" height="56" rx="6"/>
<text class="lbl" x="1270.0" y="337.0" text-anchor="middle">routeur 1</text>
<text class="sub" x="1270.0" y="354.0" text-anchor="middle">169.254.0.1/28</text>
<rect class="box" x="1335" y="312" width="110" height="56" rx="6"/>
<text class="lbl" x="1390.0" y="337.0" text-anchor="middle">routeur 2</text>
<text class="sub" x="1390.0" y="354.0" text-anchor="middle">169.254.0.2/28</text>
<text class="sub" x="1330" y="388" text-anchor="middle">VRRP · VTEP · VNI 66000</text>
<text class="sub" x="1330" y="403" text-anchor="middle">NAT vers le VNI 66000 · #72</text>
<line class="bus" x1="1200" y1="460" x2="1460" y2="460"/>
<text class="sub" x="1205" y="478" text-anchor="start">underlay B · VXLAN UDP 4789 · BGP</text>
<path class="link" d="M1230 368 V460"/>
<path class="link" d="M1430 368 V460"/>
<rect class="box" x="1215" y="505" width="220" height="52" rx="6"/>
<text class="lbl" x="1325.0" y="528.0" text-anchor="middle">route reflector 2</text>
<text class="sub" x="1325.0" y="545.0" text-anchor="middle">lo 10.255.255.2/32 · 169.254.0.4/28</text>
<path class="link" d="M1440 460 V505"/>
<text class="ctrlt" x="1434" y="498" text-anchor="end">iBGP EVPN</text>
<rect class="group" x="1200" y="600" width="260" height="410" rx="8"/>
<text class="grp" x="1220" y="624">HYPERVISEURS B (×N)</text>
<rect class="box" x="1220" y="645" width="220" height="64" rx="6"/>
<text class="lbl" x="1330.0" y="666.0" text-anchor="middle">hyperviseur B1</text>
<text class="sub" x="1330.0" y="683.0" text-anchor="middle">agent · FRR · VPC</text>
<text class="sub" x="1330.0" y="698.0" text-anchor="middle">VTEP : son IP sur l'underlay B</text>
<rect class="box" x="1220" y="729" width="220" height="64" rx="6"/>
<text class="lbl" x="1330.0" y="750.0" text-anchor="middle">hyperviseur B2</text>
<text class="sub" x="1330.0" y="767.0" text-anchor="middle">agent · FRR · VPC</text>
<text class="sub" x="1330.0" y="782.0" text-anchor="middle">VTEP : son IP sur l'underlay B</text>
<rect class="box" x="1220" y="813" width="220" height="64" rx="6"/>
<text class="lbl" x="1330.0" y="834.0" text-anchor="middle">hyperviseur B3</text>
<text class="sub" x="1330.0" y="851.0" text-anchor="middle">agent · FRR · VPC</text>
<text class="sub" x="1330.0" y="866.0" text-anchor="middle">VTEP : son IP sur l'underlay B</text>
<text class="lbl" x="1330" y="925" text-anchor="middle">…</text>
<text class="sub" x="1330" y="955" text-anchor="middle">même modèle que</text>
<text class="sub" x="1330" y="970" text-anchor="middle">l'hyperviseur détaillé</text>
<path class="link" d="M1452 460 V600"/>
<path class="link" d="M500 340 H1215"/>
<text class="sub" x="860" y="332" text-anchor="middle">eBGP · routeur 2 de A → routeur 1 de B</text>
<path class="link" d="M660 240 V258 H210 V312"/>
<path class="link" d="M840 240 V258 H1315 V312"/>
<text class="sub" x="420" y="252" text-anchor="middle">eBGP</text>
<text class="sub" x="1060" y="252" text-anchor="middle">eBGP</text>
<line class="bus" x1="40" y1="460" x2="680" y2="460"/>
<text class="sub" x="690" y="465" text-anchor="start">underlay A · VXLAN UDP 4789 · BGP</text>
<path class="link" d="M75 368 V460"/>
<path class="link" d="M485 368 V460"/>
<rect class="box" x="60" y="490" width="230" height="52" rx="6"/>
<text class="lbl" x="175.0" y="513.0" text-anchor="middle">route reflector 1</text>
<text class="sub" x="175.0" y="530.0" text-anchor="middle">lo 10.255.255.1/32 · 169.254.0.3/28</text>
<path class="link" d="M175 460 V490"/>
<text class="ctrlt" x="183" y="482" text-anchor="start">iBGP EVPN</text>
<rect class="group" x="740" y="490" width="440" height="92" rx="8"/>
<text class="grp" x="760" y="514">SERVICES · VNI 66000 PARTAGÉ ENTRE CLUSTERS · #72</text>
<rect class="future" x="760" y="520" width="190" height="52" rx="6"/>
<text class="lbl" x="855.0" y="543.0" text-anchor="middle">broker</text>
<text class="sub" x="855.0" y="560.0" text-anchor="middle">MQTT · VNI 66000</text>
<rect class="future" x="970" y="520" width="190" height="52" rx="6"/>
<text class="lbl" x="1065.0" y="543.0" text-anchor="middle">orchestrateur</text>
<text class="sub" x="1065.0" y="560.0" text-anchor="middle">VNI 66000 et VNI 66001</text>
<path class="orch" d="M950 546 H970"/>
<path class="orch" d="M510 410 V546 H760" marker-end="url(#a-orch)"/>
<path class="orch" d="M1200 400 H1192 V560 H1180" marker-end="url(#a-orch)"/>
<rect class="group" x="40" y="600" width="1120" height="410" rx="8"/>
<text class="grp" x="60" y="624">HYPERVISEUR A (détaillé)</text>
<rect class="box" x="60" y="635" width="260" height="52" rx="6"/>
<text class="lbl" x="190.0" y="658.0" text-anchor="middle">br-000000</text>
<text class="sub" x="190.0" y="675.0" text-anchor="middle">IP de l'hyperviseur = VTEP</text>
<rect class="box" x="60" y="701" width="260" height="52" rx="6"/>
<text class="lbl" x="190.0" y="724.0" text-anchor="middle">FRR · bgpd</text>
<text class="sub" x="190.0" y="741.0" text-anchor="middle">sessions EVPN vers les RR</text>
<rect class="box" x="60" y="767" width="260" height="66" rx="6"/>
<text class="lbl" x="190.0" y="789.0" text-anchor="middle">agent</text>
<text class="sub" x="190.0" y="806.0" text-anchor="middle">API locale 127.0.0.1:8080</text>
<text class="sub" x="190.0" y="821.0" text-anchor="middle">client du broker, en sortie</text>
<rect class="future" x="60" y="849" width="260" height="56" rx="6"/>
<text class="lbl" x="190.0" y="874.0" text-anchor="middle">IP flottante · NAT 1:1</text>
<text class="sub" x="190.0" y="891.0" text-anchor="middle">hôte de la VM, sans état · #31</text>
<rect class="future" x="60" y="921" width="260" height="56" rx="6"/>
<text class="lbl" x="190.0" y="946.0" text-anchor="middle">subnet public de l'hôte</text>
<text class="sub" x="190.0" y="963.0" text-anchor="middle">VNI 66001 · hors VPC · #31</text>
<rect class="group" x="360" y="635" width="780" height="355" rx="8"/>
<text class="grp" x="380" y="659">VPC · netns + VRF</text>
<rect class="box" x="380" y="675" width="240" height="60" rx="6"/>
<text class="lbl" x="500.0" y="702.0" text-anchor="middle">netns de la VPC</text>
<text class="sub" x="500.0" y="719.0" text-anchor="middle">gateway .254 · DHCP · métadonnées</text>
<rect class="box" x="380" y="770" width="240" height="60" rx="6"/>
<text class="lbl" x="500.0" y="797.0" text-anchor="middle">VRF · L3VNI</text>
<text class="sub" x="500.0" y="814.0" text-anchor="middle">routage entre subnets et hyperviseurs</text>
<rect class="future" x="660" y="770" width="200" height="60" rx="6"/>
<text class="lbl" x="760.0" y="797.0" text-anchor="middle">passerelle NAT de la VPC</text>
<text class="sub" x="760.0" y="814.0" text-anchor="middle">sur un des hyperviseurs · #42</text>
<rect class="future" x="380" y="895" width="240" height="60" rx="6"/>
<text class="lbl" x="500.0" y="922.0" text-anchor="middle">subnet public de la VPC</text>
<text class="sub" x="500.0" y="939.0" text-anchor="middle">relié au subnet public de l'hôte</text>
<rect class="box" x="880" y="675" width="240" height="60" rx="6"/>
<text class="lbl" x="1000.0" y="702.0" text-anchor="middle">VM privée</text>
<text class="sub" x="1000.0" y="719.0" text-anchor="middle">adresse de la VPC</text>
<rect class="future" x="880" y="895" width="240" height="60" rx="6"/>
<text class="lbl" x="1000.0" y="922.0" text-anchor="middle">VM publique</text>
<text class="sub" x="1000.0" y="939.0" text-anchor="middle">+ NIC sur le subnet public</text>
<path class="link" d="M880 705 H620"/>
<path class="link" d="M500 735 V770"/>
<path class="net" d="M880 925 H620"/>
<path class="net" d="M380 953 H320" marker-end="url(#a-net)"/>
<path class="net" d="M380 810 H340 V877 H320" marker-end="url(#a-net)"/>
<path class="net" d="M620 800 H660" marker-end="url(#a-net)"/>
<path class="net" d="M760 830 V863 H350 V929 H320" marker-end="url(#a-net)"/>
<text class="nett" x="640" y="763" text-anchor="middle">défaut type 5</text>
<path class="net" d="M190 905 V921" marker-end="url(#a-net)"/>
<path class="data" d="M60 949 H50 V661 H60"/>
<text class="datat" x="30" y="805" text-anchor="middle" transform="rotate(-90 30 805)">VNI 66001</text>
<path class="link" d="M300 635 V460"/>
<path class="orch" d="M320 785 H332 V410" marker-end="url(#a-orch)"/>
<text class="orcht" x="340" y="596" text-anchor="start">register · ordres · événements (mTLS, sortant)</text>
<path class="data" d="M60 1045 H110"/>
<text class="sub" x="118" y="1049" text-anchor="start">plan de données : VXLAN</text>
<path class="ctrl" d="M290 1045 H340"/>
<text class="sub" x="348" y="1049" text-anchor="start">plan de contrôle : BGP</text>
<path class="orch" d="M510 1045 H560" marker-end="url(#a-orch)"/>
<text class="sub" x="568" y="1049" text-anchor="start">orchestration</text>
<path class="net" d="M690 1045 H740" marker-end="url(#a-net)"/>
<text class="sub" x="748" y="1049" text-anchor="start">trafic Internet</text>
<rect class="future" x="880" y="1035" width="34" height="20" rx="4"/>
<text class="sub" x="922" y="1049" text-anchor="start">à venir (ticket indiqué)</text>
<text class="sub" x="60" y="1089" text-anchor="start">Les agents ne sont jamais joints par l'orchestrateur : ils se connectent au broker en sortie, via leur passerelle ; les routeurs de leur cluster les NAT vers le VNI 66000.</text>
<text class="sub" x="60" y="1107" text-anchor="start">L'orchestrateur a une patte dans le VNI 66001 : son API est joignable depuis Internet, par les bordures.</text>
<text class="sub" x="60" y="1125" text-anchor="start">VM publique : un subnet public dans sa VPC, relié au subnet public de l'hôte (VNI 66001), dont la gateway anycast est portée par toutes les bordures.</text>
<text class="sub" x="60" y="1143" text-anchor="start">VM privée : route par défaut de type 5 vers la passerelle NAT de sa VPC (IP de sortie de la VPC) si la VPC autorise Internet, ou IP flottante 1:1 sur son hôte.</text>
<text class="sub" x="60" y="1161" text-anchor="start">Les bordures restent sans état : tout NAT vit sur un hyperviseur. Broker et orchestrateur sont des VM du VNI 66000, partagé : elles tournent sur les hyperviseurs de n'importe quel cluster.</text>
<text class="sub" x="60" y="1179" text-anchor="start">Un route reflector par cluster : un événement d'un cluster ne coupe pas les deux sessions. Chaque lien routeurs ↔ RR est en 169.254.0.0/28, propre à son cluster.</text>
</svg>

After

Width:  |  Height:  |  Size: 15 KiB

View file

@ -885,7 +885,7 @@ un renouvellement unicast reste servi par l’hôte de la VM.</p></li>
</ul>
<p>L’adresse d’émission est la même sur tous les hôtes : une VM qui reçoit la requête ARP d’un autre
hôte associe <code class="docutils literal notranslate"><span class="pre">.253</span></code> à la MAC de celui-ci. C’est sans effet — la VM ne parle jamais d’elle-même à
<code class="docutils literal notranslate"><span class="pre">.253</span></code> et le netns lui parle depuis la gateway. Mesuré en lab (<code class="docutils literal notranslate"><span class="pre">s11-fenetre-arp</span></code>) : pendant
<code class="docutils literal notranslate"><span class="pre">.253</span></code> et le netns lui parle depuis la gateway. Mesuré en lab (<code class="docutils literal notranslate"><span class="pre">44-fenetre-arp</span></code>) : pendant
cette fenêtre, métadonnées, renouvellement DHCP et connexions depuis le netns passent sans perte.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>

View file

@ -342,6 +342,7 @@
</div>
<nav aria-label="Page">
<ul class="visible nav section-nav flex-column">
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#vue-d-ensemble">Vue d’ensemble</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#topologie">Topologie</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#ce-que-l-agent-suppose-deja-en-place">Ce que l’agent suppose déjà en place</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#pourquoi-un-plan-de-controle-est-necessaire">Pourquoi un plan de contrôle est nécessaire</a></li>
@ -361,22 +362,69 @@
<section id="architecture-du-cluster">
<h1>Architecture du cluster<a class="headerlink" href="#architecture-du-cluster" title="Lien vers cette rubrique">#</a></h1>
<section id="topologie">
<h2>Topologie<a class="headerlink" href="#topologie" title="Lien vers cette rubrique">#</a></h2>
<figure class="align-center" id="id1">
<a class="only-light reference internal image-reference" href="../_images/architecture-cluster.svg"><img alt="Architecture du cluster : routeurs, route reflector, hyperviseurs, plans de données et de contrôle" class="only-light" src="../_images/architecture-cluster.svg" style="width: 100%;" />
<section id="vue-d-ensemble">
<h2>Vue d’ensemble<a class="headerlink" href="#vue-d-ensemble" title="Lien vers cette rubrique">#</a></h2>
<figure class="align-center" id="id4">
<a class="only-light reference internal image-reference" href="../_images/architecture-ensemble.svg"><img alt="Vue d'ensemble : Internet, bordures, deux clusters, route reflectors, services partagés et hyperviseurs" class="only-light" src="../_images/architecture-ensemble.svg" style="width: 100%;" />
</a>
<figcaption>
<p><span class="caption-text">Architecture cible. Trait bleu : plan de données (VXLAN). Tirets violets : plan de contrôle
(sessions BGP). Pointillé gris : interfaces créées par l’agent.</span><a class="headerlink" href="#id1" title="Lien vers cette image">#</a></p>
(BGP). Tirets verts : orchestration. Trait orange : trafic Internet. Cadre en pointillés :
élément à venir, avec son ticket.</span><a class="headerlink" href="#id4" title="Lien vers cette image">#</a></p>
</figcaption>
</figure>
<figure class="align-center" id="id2">
<a class="only-dark reference internal image-reference" href="../_images/architecture-cluster-dark.svg"><img alt="Architecture du cluster : routeurs, route reflector, hyperviseurs, plans de données et de contrôle" class="only-dark" src="../_images/architecture-cluster-dark.svg" style="width: 100%;" />
<figure class="align-center" id="id5">
<a class="only-dark reference internal image-reference" href="../_images/architecture-ensemble-dark.svg"><img alt="Vue d'ensemble : Internet, bordures, deux clusters, route reflectors, services partagés et hyperviseurs" class="only-dark" src="../_images/architecture-ensemble-dark.svg" style="width: 100%;" />
</a>
<figcaption>
<p><span class="caption-text">Architecture cible. Trait bleu : plan de données (VXLAN). Tirets violets : plan de contrôle
(sessions BGP). Pointillé gris : interfaces créées par l’agent.</span><a class="headerlink" href="#id2" title="Lien vers cette image">#</a></p>
(BGP). Tirets verts : orchestration. Trait orange : trafic Internet. Cadre en pointillés :
élément à venir, avec son ticket.</span><a class="headerlink" href="#id5" title="Lien vers cette image">#</a></p>
</figcaption>
</figure>
<p>Plusieurs clusters, chacun avec son underlay, ses deux routeurs et un route reflector, sont reliés
en eBGP entre eux et aux <strong>routeurs de bordure</strong>. Ce qui n’existe pas encore est décrit sur son
ticket :</p>
<ul class="simple">
<li><p><strong>Internet</strong> (<a class="reference external" href="https://git.g3e.fr/syonad/two/issues/31">#31</a>,
<a class="reference external" href="https://git.g3e.fr/syonad/two/issues/42">#42</a>). Les bordures partagent avec les hyperviseurs
un VXLAN public (VNI 66001) et portent toutes la même IP et la même MAC de gateway. Elles restent
sans état : tout NAT vit sur un hyperviseur. Trois façons de sortir :</p>
<ul>
<li><p>une VM qui porte une IP publique a une NIC sur un subnet public de sa VPC, relié au subnet
public de l’hôte ;</p></li>
<li><p>une <strong>IP flottante</strong> est traduite 1:1, sans état, par l’hyperviseur de la VM ;</p></li>
<li><p>les autres VM sortent par la <strong>passerelle NAT de leur VPC</strong>, que la VRF atteint par une route
par défaut de type 5, si la VPC autorise Internet.</p></li>
</ul>
</li>
<li><p><strong>Orchestration</strong> (<a class="reference external" href="https://git.g3e.fr/syonad/two/issues/72">#72</a>). Le broker et
l’orchestrateur sont des VM du VNI 66000, partagé entre clusters. Les agents s’y connectent
<strong>en sortie</strong>, par leur passerelle ; les routeurs de chaque cluster les NAT vers le VNI 66000.
L’orchestrateur a aussi une patte dans le VNI 66001 : son API est joignable depuis Internet.</p></li>
<li><p><strong>Route reflectors.</strong> Un par cluster, pour qu’un incident sur un cluster ne coupe pas les deux
sessions EVPN. Chaque lien entre routeurs et route reflector est en <code class="docutils literal notranslate"><span class="pre">169.254.0.0/28</span></code>, propre
à son cluster.</p></li>
</ul>
<p>Le lab (<a class="reference internal" href="../developpement/lab.html"><span class="doc">Lab de test multi-nœud</span></a>) simplifie : un seul cluster, qui porte les deux route
reflectors.</p>
</section>
<section id="topologie">
<h2>Topologie<a class="headerlink" href="#topologie" title="Lien vers cette rubrique">#</a></h2>
<figure class="align-center" id="id6">
<a class="only-light reference internal image-reference" href="../_images/architecture-cluster.svg"><img alt="Détail d'un cluster : routeurs, route reflectors, hyperviseurs, netns et VRF des VPC, plans de données et de contrôle" class="only-light" src="../_images/architecture-cluster.svg" style="width: 100%;" />
</a>
<figcaption>
<p><span class="caption-text">Détail d’un cluster et de deux hyperviseurs. Trait bleu : plan de données (VXLAN). Tirets
violets : plan de contrôle (sessions BGP). Pointillé gris : créé par l’agent.</span><a class="headerlink" href="#id6" title="Lien vers cette image">#</a></p>
</figcaption>
</figure>
<figure class="align-center" id="id7">
<a class="only-dark reference internal image-reference" href="../_images/architecture-cluster-dark.svg"><img alt="Détail d'un cluster : routeurs, route reflectors, hyperviseurs, netns et VRF des VPC, plans de données et de contrôle" class="only-dark" src="../_images/architecture-cluster-dark.svg" style="width: 100%;" />
</a>
<figcaption>
<p><span class="caption-text">Détail d’un cluster et de deux hyperviseurs. Trait bleu : plan de données (VXLAN). Tirets
violets : plan de contrôle (sessions BGP). Pointillé gris : créé par l’agent.</span><a class="headerlink" href="#id7" title="Lien vers cette image">#</a></p>
</figcaption>
</figure>
<p>Deux plans distincts, à ne pas confondre au moment du diagnostic :</p>
@ -500,6 +548,7 @@ l’agent ne valide pas <code class="docutils literal notranslate"><span class="
</div>
<nav id="pst-page-toc-nav" class="page-toc" aria-labelledby="pst-page-navigation-heading-2">
<ul class="visible nav section-nav flex-column">
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#vue-d-ensemble">Vue d’ensemble</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#topologie">Topologie</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#ce-que-l-agent-suppose-deja-en-place">Ce que l’agent suppose déjà en place</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#pourquoi-un-plan-de-controle-est-necessaire">Pourquoi un plan de contrôle est nécessaire</a></li>

View file

@ -347,8 +347,11 @@
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#roles">Rôles</a></li>
</ul>
</li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#scenarios">Scénarios</a><ul class="nav section-nav flex-column">
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#ecrire-un-scenario">Écrire un scénario</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#suite-de-tests">Suite de tests</a><ul class="nav section-nav flex-column">
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#matrice-de-couverture">Matrice de couverture</a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#campagne-du-2026-10-17">Campagne du 2026-10-17</a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#ecrire-un-test">Écrire un test</a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#campagnes-precedentes">Campagnes précédentes</a></li>
</ul>
</li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#securite">Sécurité</a></li>
@ -422,7 +425,7 @@ entamée comme une heure pleine. En cas de doute (session interrompue, poste mis
<section id="topologies">
<h2>Topologies<a class="headerlink" href="#topologies" title="Lien vers cette rubrique">#</a></h2>
<p>Les topologies de two vivent dans <code class="docutils literal notranslate"><span class="pre">test/e2e/topologies/</span></code> : <code class="docutils literal notranslate"><span class="pre">evpn-2hv.yml</span></code> (deux hyperviseurs)
et <code class="docutils literal notranslate"><span class="pre">evpn-3hv.yml</span></code> (trois, pour <code class="docutils literal notranslate"><span class="pre">s8</span></code> et <code class="docutils literal notranslate"><span class="pre">s9</span></code>). Le format est celui de <code class="docutils literal notranslate"><span class="pre">labctl</span></code> :</p>
et <code class="docutils literal notranslate"><span class="pre">evpn-3hv.yml</span></code> (trois, celle de la suite). Le format est celui de <code class="docutils literal notranslate"><span class="pre">labctl</span></code> :</p>
<div class="highlight-yaml notranslate"><div class="highlight"><pre><span></span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">evpn-2hv</span>
<span class="nt">images</span><span class="p">:</span>
@ -435,6 +438,9 @@ et <code class="docutils literal notranslate"><span class="pre">evpn-3hv.yml</sp
<span class="w"> </span><span class="nt">routers</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">sw1</span><span class="p p-Indicator">,</span><span class="w"> </span><span class="nv">sw2</span><span class="p p-Indicator">]</span>
<span class="w"> </span><span class="nt">cidr</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">192.168.14.0/24</span>
<span class="w"> </span><span class="nt">mtu</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">9000</span>
<span class="w"> </span><span class="nt">lan</span><span class="p">:</span>
<span class="w"> </span><span class="nt">cidr</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10.33.0.0/24</span>
<span class="w"> </span><span class="nt">mtu</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1500</span>
<span class="nt">nodes</span><span class="p">:</span>
<span class="w"> </span><span class="nt">sw1</span><span class="p">:</span>
@ -454,14 +460,16 @@ et <code class="docutils literal notranslate"><span class="pre">evpn-3hv.yml</sp
<span class="nt"> addresses</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> underlay</span><span class="p">:</span><span class="w"> </span><span class="nv">192.168.14.5</span><span class="w"> </span><span class="p p-Indicator">},</span><span class="nt"> secondary</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> underlay</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">169.254.0.4/28</span><span class="p p-Indicator">]</span><span class="w"> </span><span class="p p-Indicator">},</span>
<span class="nt"> loopback</span><span class="p">:</span><span class="w"> </span><span class="nv">10.255.255.2/32</span><span class="p p-Indicator">,</span><span class="nt"> frr</span><span class="p">:</span><span class="w"> </span><span class="nv">frr/rr2.conf</span><span class="w"> </span><span class="p p-Indicator">}</span>
<span class="w"> </span><span class="nt">hv1</span><span class="p">:</span>
<span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> role</span><span class="p">:</span><span class="w"> </span><span class="nv">host</span><span class="p p-Indicator">,</span><span class="nt"> image</span><span class="p">:</span><span class="w"> </span><span class="nv">debian12</span><span class="p p-Indicator">,</span><span class="nt"> cpus</span><span class="p">:</span><span class="w"> </span><span class="nv">4</span><span class="p p-Indicator">,</span><span class="nt"> memory</span><span class="p">:</span><span class="w"> </span><span class="nv">16384</span><span class="p p-Indicator">,</span><span class="nt"> segments</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">underlay</span><span class="p p-Indicator">],</span>
<span class="nt"> addresses</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> underlay</span><span class="p">:</span><span class="w"> </span><span class="nv">192.168.14.11</span><span class="w"> </span><span class="p p-Indicator">},</span><span class="nt"> frr</span><span class="p">:</span><span class="w"> </span><span class="nv">frr/hv1.conf</span><span class="p p-Indicator">,</span><span class="nt"> provision</span><span class="p">:</span><span class="w"> </span><span class="nv">provision/hypervisor.sh</span><span class="p p-Indicator">,</span>
<span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> role</span><span class="p">:</span><span class="w"> </span><span class="nv">host</span><span class="p p-Indicator">,</span><span class="nt"> image</span><span class="p">:</span><span class="w"> </span><span class="nv">debian12</span><span class="p p-Indicator">,</span><span class="nt"> cpus</span><span class="p">:</span><span class="w"> </span><span class="nv">4</span><span class="p p-Indicator">,</span><span class="nt"> memory</span><span class="p">:</span><span class="w"> </span><span class="nv">16384</span><span class="p p-Indicator">,</span>
<span class="nt"> segments</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">underlay</span><span class="p p-Indicator">,</span><span class="w"> </span><span class="nv">lan</span><span class="p p-Indicator">],</span><span class="nt"> addresses</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> underlay</span><span class="p">:</span><span class="w"> </span><span class="nv">192.168.14.11</span><span class="p p-Indicator">,</span><span class="nt"> lan</span><span class="p">:</span><span class="w"> </span><span class="nv">10.33.0.11</span><span class="w"> </span><span class="p p-Indicator">},</span>
<span class="nt"> frr</span><span class="p">:</span><span class="w"> </span><span class="nv">frr/hv1.conf</span><span class="p p-Indicator">,</span><span class="nt"> provision</span><span class="p">:</span><span class="w"> </span><span class="nv">provision/hypervisor.sh</span><span class="p p-Indicator">,</span>
<span class="nt"> post_provision</span><span class="p">:</span><span class="w"> </span><span class="nv">provision/hypervisor-post.sh</span><span class="p p-Indicator">,</span><span class="nt"> files</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> agent.yml</span><span class="p">:</span><span class="w"> </span><span class="nv">agent/two.yml</span><span class="p p-Indicator">,</span><span class="nt"> bin</span><span class="p">:</span><span class="w"> </span><span class="nv">bin</span><span class="w"> </span><span class="p p-Indicator">},</span>
<span class="nt"> services</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">agent.service</span><span class="p p-Indicator">]</span><span class="w"> </span><span class="p p-Indicator">}</span>
<span class="w"> </span><span class="nt">hv2</span><span class="p">:</span>
<span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> role</span><span class="p">:</span><span class="w"> </span><span class="nv">host</span><span class="p p-Indicator">,</span><span class="nt"> image</span><span class="p">:</span><span class="w"> </span><span class="nv">debian12</span><span class="p p-Indicator">,</span><span class="nt"> cpus</span><span class="p">:</span><span class="w"> </span><span class="nv">4</span><span class="p p-Indicator">,</span><span class="nt"> memory</span><span class="p">:</span><span class="w"> </span><span class="nv">16384</span><span class="p p-Indicator">,</span><span class="nt"> segments</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">underlay</span><span class="p p-Indicator">],</span>
<span class="nt"> addresses</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> underlay</span><span class="p">:</span><span class="w"> </span><span class="nv">192.168.14.12</span><span class="w"> </span><span class="p p-Indicator">},</span><span class="nt"> frr</span><span class="p">:</span><span class="w"> </span><span class="nv">frr/hv2.conf</span><span class="p p-Indicator">,</span><span class="nt"> provision</span><span class="p">:</span><span class="w"> </span><span class="nv">provision/hypervisor.sh</span><span class="p p-Indicator">,</span>
<span class="nt"> post_provision</span><span class="p">:</span><span class="w"> </span><span class="nv">provision/hypervisor-post.sh</span><span class="p p-Indicator">,</span><span class="nt"> files</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> agent.yml</span><span class="p">:</span><span class="w"> </span><span class="nv">agent/bgp.yml</span><span class="p p-Indicator">,</span><span class="nt"> bin</span><span class="p">:</span><span class="w"> </span><span class="nv">bin</span><span class="w"> </span><span class="p p-Indicator">},</span>
<span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> role</span><span class="p">:</span><span class="w"> </span><span class="nv">host</span><span class="p p-Indicator">,</span><span class="nt"> image</span><span class="p">:</span><span class="w"> </span><span class="nv">debian12</span><span class="p p-Indicator">,</span><span class="nt"> cpus</span><span class="p">:</span><span class="w"> </span><span class="nv">4</span><span class="p p-Indicator">,</span><span class="nt"> memory</span><span class="p">:</span><span class="w"> </span><span class="nv">16384</span><span class="p p-Indicator">,</span>
<span class="nt"> segments</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">underlay</span><span class="p p-Indicator">,</span><span class="w"> </span><span class="nv">lan</span><span class="p p-Indicator">],</span><span class="nt"> addresses</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> underlay</span><span class="p">:</span><span class="w"> </span><span class="nv">192.168.14.12</span><span class="p p-Indicator">,</span><span class="nt"> lan</span><span class="p">:</span><span class="w"> </span><span class="nv">10.33.0.12</span><span class="w"> </span><span class="p p-Indicator">},</span>
<span class="nt"> frr</span><span class="p">:</span><span class="w"> </span><span class="nv">frr/hv2.conf</span><span class="p p-Indicator">,</span><span class="nt"> provision</span><span class="p">:</span><span class="w"> </span><span class="nv">provision/hypervisor.sh</span><span class="p p-Indicator">,</span>
<span class="nt"> post_provision</span><span class="p">:</span><span class="w"> </span><span class="nv">provision/hypervisor-post.sh</span><span class="p p-Indicator">,</span><span class="nt"> files</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> agent.yml</span><span class="p">:</span><span class="w"> </span><span class="nv">agent/dnsmasq.yml</span><span class="p p-Indicator">,</span><span class="nt"> bin</span><span class="p">:</span><span class="w"> </span><span class="nv">bin</span><span class="w"> </span><span class="p p-Indicator">},</span>
<span class="nt"> services</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">agent.service</span><span class="p p-Indicator">]</span><span class="w"> </span><span class="p p-Indicator">}</span>
</pre></div>
</div>
@ -545,7 +553,16 @@ télécharge la release sur <code class="docutils literal notranslate"><span cla
réponde, à travers le switch. Les deux fichiers <code class="docutils literal notranslate"><span class="pre">agent/</span></code> donnent à l’agent la section <code class="docutils literal notranslate"><span class="pre">bgp</span></code>
(AS 64600, route reflectors <code class="docutils literal notranslate"><span class="pre">10.255.255.1</span></code> et <code class="docutils literal notranslate"><span class="pre">10.255.255.2</span></code>) et un watchdog toutes les 10 s ;
<code class="docutils literal notranslate"><span class="pre">agent/two.yml</span></code> met en plus hv1 sur le serveur DHCP intégré (<code class="docutils literal notranslate"><span class="pre">dhcp.backend:</span> <span class="pre">two</span></code>),
<code class="docutils literal notranslate"><span class="pre">agent/bgp.yml</span></code> laisse les autres sur dnsmasq.</p>
<code class="docutils literal notranslate"><span class="pre">agent/dnsmasq.yml</span></code> met explicitement les autres sur dnsmasq (<code class="docutils literal notranslate"><span class="pre">dhcp.backend:</span> <span class="pre">dnsmasq</span></code>).</p>
<p><strong>Segment ``lan`` (mode ``bridge``).</strong> hv1 et hv2 sont aussi reliés à un second segment,
<code class="docutils literal notranslate"><span class="pre">lan</span></code> (<code class="docutils literal notranslate"><span class="pre">10.33.0.0/24</span></code>, MTU 1500, <strong>sans routeur</strong> : L2 pur, sans passerelle ni NAT),
déclaré après <code class="docutils literal notranslate"><span class="pre">underlay</span></code> pour ne changer ni ses adresses ni ses taps. Avant <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code>,
<code class="docutils literal notranslate"><span class="pre">hypervisor.sh</span></code> crée le bridge <code class="docutils literal notranslate"><span class="pre">br-lan</span></code> (STP coupé, MTU de l’interface), y rattache
l’interface <code class="docutils literal notranslate"><span class="pre">lan</span></code> et y déplace l’adresse que labctl lui a donnée (<code class="docutils literal notranslate"><span class="pre">10.33.0.11</span></code> sur hv1,
<code class="docutils literal notranslate"><span class="pre">10.33.0.12</span></code> sur hv2). Les deux fichiers <code class="docutils literal notranslate"><span class="pre">agent/</span></code> déclarent <code class="docutils literal notranslate"><span class="pre">interfaces:</span> <span class="pre">{lan:</span> <span class="pre">br-lan}</span></code> :
un subnet créé avec <code class="docutils literal notranslate"><span class="pre">mode:</span> <span class="pre">bridge</span></code> et <code class="docutils literal notranslate"><span class="pre">iface_type:</span> <span class="pre">lan</span></code> rattache son veth à <code class="docutils literal notranslate"><span class="pre">br-lan</span></code>. Les
subnets <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> (<code class="docutils literal notranslate"><span class="pre">iface_type:</span> <span class="pre">vms</span></code>, clé absente) restent sur <code class="docutils literal notranslate"><span class="pre">default_interface</span></code> : le VTEP
ne change pas. Le bridge n’est créé qu’au premier démarrage, comme le reste du provisionnement.</p>
<p><strong>Tester l’arbre courant plutôt que la release.</strong> <code class="docutils literal notranslate"><span class="pre">test/e2e/build.sh</span></code> compile <code class="docutils literal notranslate"><span class="pre">agent</span></code>,
<code class="docutils literal notranslate"><span class="pre">dhcp</span></code> et <code class="docutils literal notranslate"><span class="pre">metadata</span></code> pour linux/amd64 dans <code class="docutils literal notranslate"><span class="pre">test/e2e/topologies/bin/</span></code> (ignoré par git),
que les hyperviseurs reçoivent par <code class="docutils literal notranslate"><span class="pre">files:</span> <span class="pre">{bin:</span> <span class="pre">bin}</span></code>. Après <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code>,
@ -634,127 +651,319 @@ que de BGP et d’EVPN, et sa configuration propre au constructeur n’a pas sa
</div>
</section>
</section>
<section id="scenarios">
<h2>Scénarios<a class="headerlink" href="#scenarios" title="Lien vers cette rubrique">#</a></h2>
<p>Les scénarios se lancent <strong>depuis le Mac</strong>, sur un lab démarré (<code class="docutils literal notranslate"><span class="pre">up</span></code>, <code class="docutils literal notranslate"><span class="pre">push</span></code>, <code class="docutils literal notranslate"><span class="pre">./labctl</span> <span class="pre">up</span></code>) :</p>
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>test/e2e/run.sh s1 # un scénario
test/e2e/run.sh s1 s3 # plusieurs
test/e2e/run.sh all # tous, dans l'ordre
</pre></div>
</div>
<p>Chacun affiche une ligne <code class="docutils literal notranslate"><span class="pre">RÉUSSI</span></code> ou <code class="docutils literal notranslate"><span class="pre">ÉCHOUÉ</span></code> par vérification — un échec porte la dernière
ligne de la commande en cause —, des lignes <code class="docutils literal notranslate"><span class="pre">INFO</span></code> pour les mesures, puis son bilan. Le code de
sortie vaut 1 si une vérification échoue <strong>ou si aucune n’a été faite</strong>.</p>
<section id="suite-de-tests">
<h2>Suite de tests<a class="headerlink" href="#suite-de-tests" title="Lien vers cette rubrique">#</a></h2>
<p>La suite (<a class="reference external" href="https://git.g3e.fr/syonad/two/issues/70">#70</a>) vit dans <code class="docutils literal notranslate"><span class="pre">test/e2e/suite/</span></code> : <strong>un
fichier par fonctionnalité</strong>, rangés en couches de bas en haut. Chaque couche ne s’appuie que sur
les précédentes, et les tests de panne passent en dernier. Elle remplace les scénarios <code class="docutils literal notranslate"><span class="pre">s1</span></code> à
<code class="docutils literal notranslate"><span class="pre">s11</span></code>, écrits au fil des tickets : chacune de leurs 251 vérifications est reprise (tableau de
correspondance sur #70).</p>
<div class="pst-scrollable-table-container"><table class="table">
<colgroup>
<col style="width: 22.0%" />
<col style="width: 58.0%" />
<col style="width: 20.0%" />
<col style="width: 18.0%" />
<col style="width: 82.0%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head"><p>Scénario</p></th>
<th class="head"><p>Ce qui doit être vrai</p></th>
<th class="head"><p>Hyperviseurs</p></th>
<tr class="row-odd"><th class="head"><p>Couche</p></th>
<th class="head"><p>Contenu</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">s1-dhcp-two</span></code></p></td>
<td><p>backend DHCP <code class="docutils literal notranslate"><span class="pre">two</span></code>, une VPC et deux subnets : chaque VM reçoit l’adresse de <strong>son</strong>
subnet, démarrée seule ou en même temps qu’une autre ; le bail est tenu par
systemd-networkd ; route par défaut, route vers la VPC et <code class="docutils literal notranslate"><span class="pre">/32</span></code> vers les métadonnées
via la gateway calculée (<code class="docutils literal notranslate"><span class="pre">.254</span></code>) ; l’état de chaque serveur DHCP ne connaît que les MAC de
son subnet (#46)</p></td>
<td><p>hv1</p></td>
<tr class="row-even"><td><p>00 socle</p></td>
<td><p>lab, prérequis d’environnement, image des VM</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">s2-gateway</span></code></p></td>
<td><p>gateway (<code class="docutils literal notranslate"><span class="pre">.254</span></code>) et adresse d’émission (<code class="docutils literal notranslate"><span class="pre">.253</span></code>) calculées par l’agent, refusées pour
une VM ; <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> refusé sur un subnet <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> (#57) ; route par défaut via la
gateway, ou via <code class="docutils literal notranslate"><span class="pre">gateway</span></code> avec <code class="docutils literal notranslate"><span class="pre">default_route</span></code> ; route vers la VPC toujours via la
gateway du subnet ; macvlan retiré à la suppression, même résultat après recréation (#31)</p></td>
<td><p>hv1</p></td>
<tr class="row-odd"><td><p>10 API</p></td>
<td><p>refus de l’API, machine d’états</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">s3-isolation-local</span></code></p></td>
<td><p>deux VPC sur le même hyperviseur ne se joignent pas, en ICMP comme en TCP ; chaque VM
joint sa passerelle (témoin)</p></td>
<td><p>hv1</p></td>
<tr class="row-even"><td><p>20 VM</p></td>
<td><p>DHCP (backend <code class="docutils literal notranslate"><span class="pre">two</span></code> et dnsmasq), métadonnées, UEFI, multi-NIC, multi-disque, redémarrage</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">s4-evpn</span></code></p></td>
<td><p>adresse VTEP locale sur les VXLAN (#51), VTEP distant appris par EVPN, ping VM ↔ VM
entre hyperviseurs, trame de 1472 octets en <code class="docutils literal notranslate"><span class="pre">-M</span> <span class="pre">do</span></code>, 1473 refusés</p></td>
<td><p>hv1, hv2</p></td>
<tr class="row-odd"><td><p>30 réseau local</p></td>
<td><p>gateway anycast, VXLAN sur un hôte, mode <code class="docutils literal notranslate"><span class="pre">bridge</span></code>, isolation, filtrage au port</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">s5-isolation-evpn</span></code></p></td>
<td><p>deux VPC de même plage, VNI différentes, sur deux hyperviseurs : la VM joint celle de sa
VPC sur l’autre hyperviseur (témoin) et pas celle de l’autre VPC — aucune résolution ARP</p></td>
<td><p>hv1, hv2</p></td>
<tr class="row-even"><td><p>40 EVPN L2</p></td>
<td><p>subnet étendu entre hôtes, isolation, subnets partagés, fenêtre ARP</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">s6-rr-loss</span></code></p></td>
<td><p>FRR arrêté sur rr1, puis sur rr2, ping continu entre les VM
de <code class="docutils literal notranslate"><span class="pre">s4</span></code> : la session vers le route reflector arrêté tombe, celle vers l’autre reste
établie, le VTEP distant reste connu et <strong>le trafic continue</strong> (au moins 45 réponses sur 50
à 30 s) ; session rétablie au redémarrage, délai mesuré ; au plus 1 % de pertes sur tout le
scénario (#54)</p></td>
<td><p>hv1, hv2, rr1, rr2</p></td>
<tr class="row-odd"><td><p>50 L3VNI</p></td>
<td><p>routage entre subnets, migration, watchdog L3</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">s7-l3vni</span></code></p></td>
<td><p>qualification de <a class="reference external" href="https://git.g3e.fr/syonad/two/issues/41">#41</a> <strong>par l’API</strong> : VPC créées
avec une <code class="docutils literal notranslate"><span class="pre">l3vni</span></code>, l’agent pose VRF, L3VNI, transit, FRR et les routes de type 5 (<code class="docutils literal notranslate"><span class="pre">/24</span></code>
des subnets, <code class="docutils literal notranslate"><span class="pre">/32</span></code> des VM). Deux subnets d’une même VPC, chacun sur un seul hyperviseur,
se joignent par le L3VNI à travers le route reflector inchangé ; 1472 octets en <code class="docutils literal notranslate"><span class="pre">-M</span> <span class="pre">do</span></code> ;
une seconde VPC de même plage sur un autre L3VNI n’est ni importée ni jointe ; L3VNI déjà
prise refusée ; forwarding de l’hôte limité aux interfaces de la VRF ; suppression d’un
subnet refusée tant qu’une VM l’utilise ; démontage complet d’une VPC sans redémarrage de
bgpd</p></td>
<td><p>hv1, hv2, rr1</p></td>
<tr class="row-even"><td><p>60 cycle de vie</p></td>
<td><p>redémarrage de l’agent, nettoyage global</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">s8-l3vni-migration</span></code></p></td>
<td><p>suite de <code class="docutils literal notranslate"><span class="pre">s7</span></code>, topologie <code class="docutils literal notranslate"><span class="pre">evpn-3hv.yml</span></code> : migration d’une VM de hv1 vers hv2 par l’API,
observée depuis hv3 qui n’a pas le subnet : migration simple (VM supprimée puis recréée,
<code class="docutils literal notranslate"><span class="pre">/24</span></code> comme filet), séquence orchestrée (deux VM de même IP, deux <code class="docutils literal notranslate"><span class="pre">/32</span></code> en ECMP, 40
sources sur 40) ; l’ancien « pire cas » devient un refus (409) ; MAC anycast de la gateway
absente d’EVPN (aucune route de type 2 sur rr1, absente de la table de hv1), sans doublon
(#57) ; watchdog : <code class="docutils literal notranslate"><span class="pre">/32</span></code> orphelin signalé comme trou noir, <code class="docutils literal notranslate"><span class="pre">/32</span></code> manquant
signalé</p></td>
<td><p>hv1, hv2, hv3, rr1</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">s9-subnets-partages</span></code></p></td>
<td><p>deux VPC, avec et sans <code class="docutils literal notranslate"><span class="pre">l3vni</span></code>, chacune avec deux subnets présents sur <strong>les deux</strong>
hyperviseurs et une VM par subnet et par hôte : ping entre toutes les paires (même subnet ou
non, même hôte ou non) ; chaque VM voit la MAC anycast de sa gateway ; aucune MAC en
double et aucune MAC anycast dans EVPN sur les quatre VNI (#57)</p></td>
<td><p>hv2, hv3, rr1</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">s10-switch-loss</span></code></p></td>
<td><p>un seul switch maître VRRP de la passerelle (lu par <code class="docutils literal notranslate"><span class="pre">show</span> <span class="pre">vrrp</span></code>, pas supposé) ; interface
<code class="docutils literal notranslate"><span class="pre">underlay</span></code> du maître coupée pendant un ping continu de hv1 vers la loopback de rr1 :
l’autre switch devient maître, les sessions EVPN de hv1 <strong>ne tombent pas</strong> (compteur
<code class="docutils literal notranslate"><span class="pre">dropped</span></code> inchangé), le trafic reprend (au moins 45 réponses sur 50 à 20 s), plus long
silence sous 5 s ; interface rétablie : ses sessions eBGP reviennent et il <strong>reste en
attente</strong>, sans reprendre la passerelle (#54)</p></td>
<td><p>hv1, sw1, sw2</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">s11-fenetre-arp</span></code></p></td>
<td><p>fenêtre ARP de #57 : sur hv1, entrées ARP du netns retirées, puis une VM de hv1 joint une VM
de hv2 dans l’autre subnet (relais L2 depuis l’adresse d’émission de hv1). La VM de hv2
associe alors <code class="docutils literal notranslate"><span class="pre">.253</span></code> à la MAC de hv1 (fenêtre ouverte, vérifiée), mais sa gateway reste
la MAC anycast ; pendant la fenêtre, métadonnées servies, bail DHCP renouvelé auprès de
<code class="docutils literal notranslate"><span class="pre">.254</span></code>, et <strong>aucune</strong> des 80 connexions TCP du netns de hv2 vers sa VM n’est perdue ; MAC
anycast inscrite dans la FDB du bridge du netns</p></td>
<td><p>hv1, hv2</p></td>
<tr class="row-odd"><td><p>70 résilience</p></td>
<td><p>perte d’un route reflector, perte d’un switch</p></td>
</tr>
</tbody>
</table>
</div>
<p><code class="docutils literal notranslate"><span class="pre">s6</span></code> réutilise les VM de <code class="docutils literal notranslate"><span class="pre">s4</span></code> : le lancer après.</p>
<p><strong>Comment c’est fait.</strong> <code class="docutils literal notranslate"><span class="pre">test/e2e/run.sh</span></code> exécute chaque scénario sur le Mac ; un
scénario envoie des blocs de shell aux nœuds par <code class="docutils literal notranslate"><span class="pre">on</span> <span class="pre">&lt;nœud&gt;</span> <span class="pre">[VAR=valeur…]</span> <span class="pre">&lt;&lt;'NODE'</span></code>, précédés de
<code class="docutils literal notranslate"><span class="pre">test/e2e/lib/node.sh</span></code> — appels à l’API de l’agent, attente des états, image Debian compatible two
(préparée une fois par hyperviseur, <code class="docutils literal notranslate"><span class="pre">seedfrom</span></code> avec barre oblique finale), clé SSH des VM,
<code class="docutils literal notranslate"><span class="pre">check</span></code> et <code class="docutils literal notranslate"><span class="pre">vm_fails</span></code> ; pour #41, <code class="docutils literal notranslate"><span class="pre">vpc_create</span></code> avec une <code class="docutils literal notranslate"><span class="pre">l3vni</span></code>, <code class="docutils literal notranslate"><span class="pre">api_code</span></code> (code HTTP
d’un refus attendu), l’observation des VRF et de BGP (<code class="docutils literal notranslate"><span class="pre">vrf_nexthops</span></code>, <code class="docutils literal notranslate"><span class="pre">bgp_paths</span></code>,
<code class="docutils literal notranslate"><span class="pre">wait_l3vni</span></code>…) et <code class="docutils literal notranslate"><span class="pre">wait_watchdog</span></code> (alerte du watchdog dans le journal de l’agent). Une vérification négative (« ne joint pas ») passe par <code class="docutils literal notranslate"><span class="pre">vm_fails</span></code> :
elle n’est réussie que si le SSH vers la VM a fonctionné <strong>et</strong> que la commande y a échoué — un
SSH en panne ne passe jamais pour une isolation.</p>
<p>Les tests se lancent <strong>depuis le Mac</strong>, sur un lab démarré (<code class="docutils literal notranslate"><span class="pre">up</span></code>, <code class="docutils literal notranslate"><span class="pre">push</span></code>, <code class="docutils literal notranslate"><span class="pre">./labctl</span> <span class="pre">up</span></code>) :</p>
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>test/e2e/run.sh all # toute la suite, dans l'ordre
test/e2e/run.sh 40 # une couche
test/e2e/run.sh 41 43 # des tests, par numéro ou par nom
test/e2e/run.sh --from 30 # à partir d'un numéro
test/e2e/run.sh --continue all # sans s'arrêter sur une couche en échec
test/e2e/run.sh --connus all # les échecs connus comptent comme des échecs
test/e2e/run.sh --matrice # matrice de couverture, tirée des en-têtes
</pre></div>
</div>
<p>Chaque test affiche une ligne <code class="docutils literal notranslate"><span class="pre">RÉUSSI</span></code> ou <code class="docutils literal notranslate"><span class="pre">ÉCHOUÉ</span></code> par vérification (un échec porte la
dernière ligne de la commande en cause), des lignes <code class="docutils literal notranslate"><span class="pre">INFO</span></code> pour les mesures, puis son bilan. Le
code de sortie vaut 1 si une vérification échoue <strong>ou si aucune n’a été faite</strong>. Avec <code class="docutils literal notranslate"><span class="pre">all</span></code> ou
<code class="docutils literal notranslate"><span class="pre">--from</span></code>, une couche en échec arrête la suite à la fin de la couche.</p>
<p><strong>Tests autonomes.</strong> Avant chaque test, le runner supprime les ressources <code class="docutils literal notranslate"><span class="pre">tNN</span></code> laissées par un
passage précédent, puis relève l’état de chaque hôte de l’en-tête <code class="docutils literal notranslate"><span class="pre">#</span> <span class="pre">hôtes:</span></code>. Après le test, il
supprime ses VM, ses subnets puis ses VPC, et vérifie que l’hôte est revenu à l’état relevé
(<code class="docutils literal notranslate"><span class="pre">assert_clean</span></code> : netns, liens, adresses, routes, règles ebtables et iptables, configuration FRR et
<code class="docutils literal notranslate"><span class="pre">frr.conf</span></code>, fichiers de <code class="docutils literal notranslate"><span class="pre">/run/two</span></code>, <code class="docutils literal notranslate"><span class="pre">dnsmasq.d</span></code> et des volumes, unités <code class="docutils literal notranslate"><span class="pre">two-vm-*</span></code>,
processus dnsmasq et QEMU). Aucun test ne dépend d’un autre : n’importe lequel se lance seul.</p>
<p><strong>Plages.</strong> Le test <code class="docutils literal notranslate"><span class="pre">NN</span></code> nomme ses ressources <code class="docutils literal notranslate"><span class="pre">vp-tNN*</span></code>, <code class="docutils literal notranslate"><span class="pre">sn-tNN*</span></code> et <code class="docutils literal notranslate"><span class="pre">tNN-*</span></code>, et utilise
<code class="docutils literal notranslate"><span class="pre">10.NN.0.0/16</span></code> et les VNI <code class="docutils literal notranslate"><span class="pre">NN00</span></code> à <code class="docutils literal notranslate"><span class="pre">NN99</span></code> : aucune collision entre tests.</p>
<p><strong>Échecs connus.</strong> Un contrôle dont l’échec est connu et rattaché à un ticket s’écrit <code class="docutils literal notranslate"><span class="pre">known</span>
<span class="pre">&quot;#NN&quot;</span> <span class="pre">&quot;description&quot;</span> <span class="pre">commande…</span></code> au lieu de <code class="docutils literal notranslate"><span class="pre">check</span></code>. En échec, il sort en <code class="docutils literal notranslate"><span class="pre">CONNU</span></code> sans faire
échouer le test (bilan : <code class="docutils literal notranslate"><span class="pre">N</span> <span class="pre">connu(s)</span></code>). Dès qu’il passe, il sort en <code class="docutils literal notranslate"><span class="pre">INATTENDU</span></code> et fait
échouer le test : le marqueur est à retirer. Pour un échec <strong>intermittent</strong>, <code class="docutils literal notranslate"><span class="pre">known_flaky</span></code> sort
en <code class="docutils literal notranslate"><span class="pre">RÉUSSI</span></code> (annoté) quand l’échec ne se reproduit pas, sans rappel automatique : le retrait se
fait en fermant le ticket. Chaque ticket concerné liste ses marqueurs en commentaire.</p>
<section id="matrice-de-couverture">
<h3>Matrice de couverture<a class="headerlink" href="#matrice-de-couverture" title="Lien vers cette rubrique">#</a></h3>
<p>Générée par <code class="docutils literal notranslate"><span class="pre">test/e2e/run.sh</span> <span class="pre">--matrice</span></code> à partir des en-têtes ; à régénérer quand un test change.</p>
<div class="pst-scrollable-table-container"><table class="table">
<thead>
<tr class="row-odd"><th class="head"><p>Test</p></th>
<th class="head"><p>Fonctionnalité</p></th>
<th class="head"><p>Hôtes</p></th>
<th class="head"><p>Tickets</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">01-lab</span></code></p></td>
<td><p>socle du lab — underlay, passerelle VRRP, sessions EVPN, base BGP posée par l’agent, backend DHCP, watchdog silencieux</p></td>
<td><p>hv1 hv2 hv3</p></td>
<td><p>#50, #51, #54, #41</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">02-prerequis</span></code></p></td>
<td><p>hypothèses d’environnement de la suite — firmware UEFI, unités modèles de l’agent, journalctl, format de ebtables -L, br-lan, priorités VRRP lues dans FRR</p></td>
<td><p>hv1 hv2 hv3</p></td>
<td><p>#70</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">03-image</span></code></p></td>
<td><p>hypothèses sur l’image de VM — outils (curl, python3), nom d’interface, effet réel de network-config, forme du compte verrouillé</p></td>
<td><p>hv1</p></td>
<td><p>#70</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">11-validation</span></code></p></td>
<td><p>validation de l’API — refus synchrones (400, 409, 422) des VPC, subnets et VM, sans trace en base</p></td>
<td><p>hv1</p></td>
<td><p>#41, #57, #33</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">12-etats</span></code></p></td>
<td><p>machine d’états — 409 pendant creating, suppression depuis error, dépendances VM → subnet → VPC, recréation sous le même nom</p></td>
<td><p>hv1</p></td>
<td><p>#41</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">21-dhcp-two</span></code></p></td>
<td><p>DHCP par le serveur intégré (backend two) — bail, server-id, renouvellement, option 121, un serveur par subnet, démarrages simultanés</p></td>
<td><p>hv1</p></td>
<td><p>#46, #57</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">22-dhcp-dnsmasq</span></code></p></td>
<td><p>DHCP par dnsmasq (backend dnsmasq) — bail, server-id, renouvellement, option 121, une instance par subnet écoutant sur la gateway anycast</p></td>
<td><p>hv2</p></td>
<td><p>#46, #57</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">23-metadonnees</span></code></p></td>
<td><p>serveur de métadonnées et cloud-init — sshkey, password (hash), user_data servi tel quel, documents absents (templates), VM sans compte</p></td>
<td><p>hv1</p></td>
<td><p>#43, #46</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">24-uefi</span></code></p></td>
<td><p>démarrage UEFI (OVMF) — firmware et variables par VM, VM démarrée en UEFI, témoin BIOS</p></td>
<td><p>hv1</p></td>
<td><p>UEFI (sans ticket)</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">25-multi-nic</span></code></p></td>
<td><p>VM à plusieurs interfaces — une NIC par subnet, adresses posées, route par défaut sur la primaire seule</p></td>
<td><p>hv1</p></td>
<td><p>#33, #62</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">26-multi-disque</span></code></p></td>
<td><p>VM à plusieurs disques — virtio (vdX) et SCSI (sdX), tailles et bus vus par la VM, démarrage sur vda</p></td>
<td><p>hv1</p></td>
<td><p>#32</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">27-reboot</span></code></p></td>
<td><p>redémarrage d’une VM depuis l’invité — même processus QEMU, même adresse, nouveau bail, user_data non rejoué</p></td>
<td><p>hv1</p></td>
<td><p>#46</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">31-gateway</span></code></p></td>
<td><p>gateway d’un subnet vxlan — gateway anycast et adresse d’émission calculées, default_route et gateway explicite, routes DHCP, macvlan gw-, FDB locale, sysctls ARP, règles de confinement, suppression et recréation</p></td>
<td><p>hv1</p></td>
<td><p>#57, #43</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">32-vxlan-local</span></code></p></td>
<td><p>routage entre deux subnets vxlan d’une même VPC sur un même hôte, sans et avec l3vni — ICMP, TCP, saut unique par la gateway</p></td>
<td><p>hv1</p></td>
<td><p>#57, #41</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">33-bridge</span></code></p></td>
<td><p>subnet en mode bridge rattaché au bridge br-lan de l’hôte — un hôte, puis le même subnet sur deux hôtes (une seule réponse ARP pour interface_ip, métadonnées servies par l’hôte de la VM)</p></td>
<td><p>hv1 hv2</p></td>
<td><p>#70</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">34-isolation-locale</span></code></p></td>
<td><p>isolation entre deux VPC sur un même hôte — ni ICMP ni TCP d’une VPC à l’autre</p></td>
<td><p>hv1</p></td>
<td><p>#50</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">35-filtrage-port</span></code></p></td>
<td><p>filtrage au port — en sortie vers le fabric (v-&lt;id&gt;-i) : ARP vers la gateway et l’adresse d’émission, DHCP émis depuis ces adresses, MAC anycast confinée dans les deux sens ; entre VM d’un même hôte : faux serveur DHCP et usurpation ARP de la gateway (comportement attendu, non filtré à ce jour)</p></td>
<td><p>hv1</p></td>
<td><p>#57</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">41-evpn-l2</span></code></p></td>
<td><p>subnet vxlan étendu entre deux hôtes par EVPN — VTEP local, VTEP distant et inondation appris, MAC des VM en type 2, trafic ICMP et TCP, MTU 1500 de bout en bout</p></td>
<td><p>hv1 hv2</p></td>
<td><p>#50, #51</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">42-isolation-evpn</span></code></p></td>
<td><p>isolation entre VPC à travers EVPN — deux VPC sur la même plage, la VM d’une VPC ne joint pas celle de l’autre sur un hôte distant</p></td>
<td><p>hv1 hv2</p></td>
<td><p>#50, #51</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">43-subnets-partages</span></code></p></td>
<td><p>subnets vxlan partagés par deux hôtes, deux VM par hôte, dans une VPC avec et une VPC sans l3vni — toutes les paires, gateway anycast vue par chaque VM et absente d’EVPN, aucune MAC en double</p></td>
<td><p>hv2 hv3</p></td>
<td><p>#57, #41</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">44-fenetre-arp</span></code></p></td>
<td><p>fenêtre ARP de la gateway anycast entre deux hôtes — relais L2 depuis l’adresse d’émission d’un hôte, gateway de la VM inchangée, métadonnées, renouvellement DHCP et TCP local sans perte pendant la fenêtre</p></td>
<td><p>hv1 hv2</p></td>
<td><p>#57</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">51-l3vni</span></code></p></td>
<td><p>routage inter-subnet entre hôtes par L3VNI (IRB symétrique) — VRF, RMAC, exports /24 et /32, RT-5 réfléchies, TTL, isolation par RT, démontage d’une VPC routée</p></td>
<td><p>hv1 hv2</p></td>
<td><p>#41</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">52-migration</span></code></p></td>
<td><p>migration d’une adresse de VM entre hôtes d’une VPC routée — /32 retiré en premier, /24 en filet puis en ECMP, séquence orchestrée, 40 sources, suppression du subnet refusée tant qu’une VM l’utilise, MAC anycast hors EVPN</p></td>
<td><p>hv1 hv2 hv3</p></td>
<td><p>#41, #57</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">53-watchdog-l3</span></code></p></td>
<td><p>watchdog d’une VPC routée — /32 orphelin signalé comme trou noir, /32 manquant signalé, aucune fausse alerte BGP ni L3VNI, trafic intact après les essais</p></td>
<td><p>hv1 hv3</p></td>
<td><p>#41</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">61-redemarrage-agent</span></code></p></td>
<td><p>redémarrage de l’agent avec des VM en marche — rien ne disparaît ni n’est recréé, trafic routé sans perte, DHCP et métadonnées servis, base BGP réappliquée à l’identique, ressources toujours gérées</p></td>
<td><p>hv1 hv2</p></td>
<td><p>#41, #46</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">62-nettoyage-global</span></code></p></td>
<td><p>nettoyage global en fin de suite — aucun hôte ne garde de ressource : API vide, ni netns, tap, VRF, unité, instance DHCP ou de métadonnées, processus QEMU, règle de port, volume ; FRR réduit à la base BGP</p></td>
<td></td>
<td><p>#70</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">71-perte-rr</span></code></p></td>
<td><p>perte d’un route reflector — l’autre garde la session EVPN, le VTEP distant reste connu, le trafic L2 entre hôtes passe sans perte mesurable, retour du RR arrêté</p></td>
<td><p>hv1 hv2</p></td>
<td><p>#54</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">72-perte-switch</span></code></p></td>
<td><p>perte d’un switch de la passerelle VRRP — bascule vers l’autre en moins de 5 s, sessions EVPN jamais coupées ; au retour, le plus prioritaire redevient maître, seconde bascule mesurée</p></td>
<td></td>
<td><p>#54, #69</p></td>
</tr>
</tbody>
</table>
</div>
</section>
<section id="campagne-du-2026-10-17">
<h3>Campagne du 2026-10-17<a class="headerlink" href="#campagne-du-2026-10-17" title="Lien vers cette rubrique">#</a></h3>
<p>Première campagne de la suite, <code class="docutils literal notranslate"><span class="pre">evpn-3hv.yml</span></code>, labctl <code class="docutils literal notranslate"><span class="pre">0.2.0</span></code>, binaires de l’arbre courant
(code de l’agent identique à <code class="docutils literal notranslate"><span class="pre">main</span></code>). <code class="docutils literal notranslate"><span class="pre">run.sh</span> <span class="pre">--continue</span> <span class="pre">all</span></code> en 76 min, dont environ 15 min
d’arrêts de VM à 300 s et 15 min d’attentes sur des tests en échec. Les hypothèses fausses des
tests ont été corrigées sur le serveur et les tests concernés rejoués. Il reste :</p>
<ul class="simple">
<li><p>tout vert, sauf les échecs réels, marqués <code class="docutils literal notranslate"><span class="pre">known</span></code> et rattachés à leur ticket : multi-NIC
(#73, #62), noms des disques SCSI (#74), mode <code class="docutils literal notranslate"><span class="pre">bridge</span></code> sur plusieurs hôtes (#75), filtrage au
port (#76), socket DHCP (#77), fausse alerte du watchdog (#78) ;</p></li>
<li><p>#69 vérifié : au retour de <code class="docutils literal notranslate"><span class="pre">sw1</span></code> (priorité 200), il redevient maître, seconde bascule en
1,2 s, sessions EVPN jamais coupées ;</p></li>
<li><p>une suppression de VM peut durer 300 s quand l’invité ignore l’arrêt ACPI (#79) : <code class="docutils literal notranslate"><span class="pre">wait_state</span></code>
attend jusqu’à 360 s.</p></li>
</ul>
<p>Hypothèses vérifiées en lab, à garder en tête en écrivant un test :</p>
<ul class="simple">
<li><p>systemd-networkd <strong>ne réécrit pas</strong> un bail renouvelé à l’identique : un renouvellement se
vérifie par le DHCPACK dans le journal du serveur (<code class="docutils literal notranslate"><span class="pre">lease_renewed</span></code>), pas par le fichier de bail ;</p></li>
<li><p>l’agent n’accepte <strong>qu’un seul disque virtio</strong> (le disque système) ; les autres sont des <code class="docutils literal notranslate"><span class="pre">sdX</span></code> ;</p></li>
<li><p>sur Debian 12, <code class="docutils literal notranslate"><span class="pre">ebtables</span> <span class="pre">-L</span></code> (nft) garde les zéros de tête des MAC ;</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> est posée en <code class="docutils literal notranslate"><span class="pre">/32</span></code> sur le bridge du netns en mode <code class="docutils literal notranslate"><span class="pre">bridge</span></code> ;</p></li>
<li><p>depuis le netns d’un hôte, une VM d’un autre hôte ne répond pas : la réponse repart vers la
gateway de son propre hôte. Une vérification entre hôtes passe par une VM.</p></li>
</ul>
<p>Les VM sont accessibles depuis le netns de leur VPC, sur l’hyperviseur, avec l’utilisateur
<code class="docutils literal notranslate"><span class="pre">syonad</span></code> créé par les métadonnées de two :</p>
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>test/e2e/labctl.sh ssh "./labctl ssh hv1 'sudo ip netns exec vp-t41 ssh -i /root/.ssh/lab-vm syonad@10.41.1.10'"
</pre></div>
</div>
</section>
<section id="ecrire-un-test">
<h3>Écrire un test<a class="headerlink" href="#ecrire-un-test" title="Lien vers cette rubrique">#</a></h3>
<p>Un test est un fichier <code class="docutils literal notranslate"><span class="pre">test/e2e/suite/NN-nom.sh</span></code>, exécuté par <code class="docutils literal notranslate"><span class="pre">run.sh</span></code> sur le Mac. Il
commence par un en-tête, puis envoie des blocs aux nœuds par <code class="docutils literal notranslate"><span class="pre">on</span> <span class="pre">&lt;nœud&gt;</span> <span class="pre">[VAR=valeur…]</span> <span class="pre">&lt;&lt;'NODE'</span></code>.
Chaque bloc est précédé des bibliothèques de <code class="docutils literal notranslate"><span class="pre">test/e2e/lib/</span></code> :</p>
<ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">core.sh</span></code> : <code class="docutils literal notranslate"><span class="pre">check</span></code>, <code class="docutils literal notranslate"><span class="pre">known</span></code>, <code class="docutils literal notranslate"><span class="pre">info</span></code>, appels à l’API, attente des états ;</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">vm.sh</span></code> : image Debian compatible two, clé SSH, <code class="docutils literal notranslate"><span class="pre">vm_launch</span></code> (plusieurs NIC et disques, UEFI,
<code class="docutils literal notranslate"><span class="pre">user_data</span></code>, mot de passe), SSH, bail, métadonnées ;</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">net.sh</span></code> : VPC, subnets, MAC anycast, trames brutes, règles ebtables, VRRP ;</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">evpn.sh</span></code> : VRF, BGP, L3VNI, watchdog ;</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">fixture.sh</span></code> : nettoyage et <code class="docutils literal notranslate"><span class="pre">assert_clean</span></code>, appelés par le runner.</p></li>
</ul>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="c1"># fonctionnalité: trafic entre deux VM d'un même subnet sur un hôte</span>
<span class="c1"># hôtes: hv1</span>
<span class="c1"># tickets: #NN</span>
on<span class="w"> </span>hv1<span class="w"> </span><span class="s">&lt;&lt;'NODE'</span>
<span class="s">KEY=$(vm_key)</span>
<span class="s">check "VPC vp-t99" vpc_create vp-t99 10.99.0.0/16</span>
<span class="s">check "subnet sn-t99" subnet_create sn-t99 vp-t99 9901 10.99.1.0/24</span>
<span class="s">check "VM t99-a" vm_launch t99-a --nic sn-t99=10.99.1.10 --sshkey "${KEY}"</span>
<span class="s">check "VM t99-b" vm_launch t99-b --nic sn-t99=10.99.1.11 --sshkey "${KEY}"</span>
<span class="s">check "t99-a joignable" vm_wait vp-t99 10.99.1.10</span>
<span class="s">check "t99-a joint t99-b" vm_ssh vp-t99 10.99.1.10 'ping -c 2 -W 2 10.99.1.11'</span>
<span class="s">check "t99-a ne joint pas 10.98.1.10" vm_fails vp-t99 10.99.1.10 'ping -c 2 -W 2 10.98.1.10'</span>
<span class="s">NODE</span>
</pre></div>
</div>
<p>Les règles :</p>
<ul class="simple">
<li><p><strong>une vérification par ligne</strong>, avec <code class="docutils literal notranslate"><span class="pre">check</span></code> : jamais un <code class="docutils literal notranslate"><span class="pre">echo</span> <span class="pre">RÉUSSI</span></code> écrit à la main ;</p></li>
<li><p><strong>toute vérification négative a son témoin</strong> : avant « ne joint pas », une ligne qui prouve que
la cible est vivante et que le chemin du test fonctionne ;</p></li>
<li><p><strong>``vm_fails`` pour le négatif</strong>, jamais <code class="docutils literal notranslate"><span class="pre">!</span></code> devant un <code class="docutils literal notranslate"><span class="pre">vm_ssh</span></code> : un SSH en panne doit
échouer, pas passer pour une isolation ;</p></li>
<li><p><strong>une donnée qui distingue réellement les cas</strong> : two dérive la MAC du rang de l’IP, donc deux
subnets ont les mêmes MAC ; comparer des couples MAC/IP, pas des MAC ;</p></li>
<li><p><strong>les mesures en ``INFO``</strong>, les attentes en <code class="docutils literal notranslate"><span class="pre">check</span></code> : un temps de reconvergence se mesure,
il ne se décrète pas ;</p></li>
<li><p><strong>l’en-tête ``# hôtes:`` liste exactement les hôtes où le test crée des ressources</strong> : ce sont
ceux que le runner nettoie et compare ;</p></li>
<li><p><strong>un échec connu se marque</strong> <code class="docutils literal notranslate"><span class="pre">known</span></code> (ou <code class="docutils literal notranslate"><span class="pre">known_flaky</span></code>) avec son ticket, et le ticket liste
le marqueur : jamais un contrôle retiré ou affaibli pour faire passer la suite ;</p></li>
<li><p>variables vers un nœud : <code class="docutils literal notranslate"><span class="pre">on</span> <span class="pre">hv1</span> <span class="pre">NOM=valeur</span> <span class="pre">&lt;&lt;'NODE'</span></code> (valeurs échappées par <code class="docutils literal notranslate"><span class="pre">run.sh</span></code>) ;</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">bash</span> <span class="pre">test/e2e/run_test.sh</span></code> vérifie le runner, les bibliothèques et la syntaxe de chaque bloc
réellement envoyé : à lancer avant toute session.</p></li>
</ul>
</section>
<section id="campagnes-precedentes">
<h3>Campagnes précédentes<a class="headerlink" href="#campagnes-precedentes" title="Lien vers cette rubrique">#</a></h3>
<p>Résultats obtenus avec les anciens scénarios <code class="docutils literal notranslate"><span class="pre">s1</span></code> à <code class="docutils literal notranslate"><span class="pre">s11</span></code>, conservés pour leurs constats.
Leurs vérifications sont reprises dans la suite.</p>
<p>Résultats du 2026-10-04 sur le serveur de lab, release <code class="docutils literal notranslate"><span class="pre">0.2.0rc003</span></code>, hv1 sur le DHCP intégré et
hv2 sur dnsmasq — toute la série en 8 minutes :</p>
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>$ test/e2e/run.sh all | grep -E '^(=== s[0-9].* : |INFO)'
@ -852,49 +1061,6 @@ requête perdue sur 510 pendant l’arrêt de rr1 puis de rr2, session rétablie
redémarrage de FRR. <code class="docutils literal notranslate"><span class="pre">s10</span></code> : <code class="docutils literal notranslate"><span class="pre">sw2</span></code> coupé, <code class="docutils literal notranslate"><span class="pre">sw1</span></code> maître, 14 requêtes perdues, plus long
silence 2,8 s, sessions EVPN de hv1 jamais coupées ; <code class="docutils literal notranslate"><span class="pre">sw2</span></code> rétabli reste en attente.
<code class="docutils literal notranslate"><span class="pre">s9</span></code> sans <code class="docutils literal notranslate"><span class="pre">Broken</span> <span class="pre">pipe</span></code> cette fois : #57 n’est pas corrigé pour autant.</p>
<p>Les VM sont accessibles depuis le netns de leur VPC, sur l’hyperviseur, avec l’utilisateur
<code class="docutils literal notranslate"><span class="pre">syonad</span></code> créé par les métadonnées de two :</p>
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>test/e2e/labctl.sh ssh "./labctl ssh hv1 'sudo ip netns exec vp-s4 ssh -i /root/.ssh/lab-vm syonad@10.240.1.10'"
</pre></div>
</div>
<section id="ecrire-un-scenario">
<h3>Écrire un scénario<a class="headerlink" href="#ecrire-un-scenario" title="Lien vers cette rubrique">#</a></h3>
<p>Le lab sert à qualifier des comportements qui ne se voient qu’à plusieurs hyperviseurs — la
campagne L3VNI de <a class="reference external" href="https://git.g3e.fr/syonad/two/issues/41">#41</a> en est le prochain exemple. Un
scénario est un fichier <code class="docutils literal notranslate"><span class="pre">test/e2e/scenarios/&lt;n&gt;-&lt;nom&gt;.sh</span></code>, exécuté par <code class="docutils literal notranslate"><span class="pre">run.sh</span></code> sur le
Mac ; il envoie des blocs aux nœuds :</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>on<span class="w"> </span>hv1<span class="w"> </span><span class="s">&lt;&lt;'NODE'</span>
<span class="s">two_image || { echo "ÉCHOUÉ: image compatible two"; exit 0; }</span>
<span class="s">KEY=$(vm_key)</span>
<span class="s">check "VPC vp-x" vpc_create vp-x 10.250.0.0/16</span>
<span class="s">check "subnet sn-x" subnet_create sn-x vp-x 2601 10.250.1.1 10.250.1.0/24</span>
<span class="s">check "VM x1" vm_create x1 sn-x 10.250.1.10 "${KEY}"</span>
<span class="s">check "x1 joignable" vm_wait vp-x 10.250.1.10</span>
<span class="s">check "x1 joint sa passerelle" vm_ssh vp-x 10.250.1.10 'ping -c 2 -W 2 10.250.1.1'</span>
<span class="s">check "x1 ne joint pas 10.251.1.10" vm_fails vp-x 10.250.1.10 'ping -c 2 -W 2 10.251.1.10'</span>
<span class="s">info "mesure : $(vtysh -c 'show evpn vni 2601' | grep -c 'flood')"</span>
<span class="s">NODE</span>
</pre></div>
</div>
<p>Les règles qui ont fait leurs preuves en E5 :</p>
<ul class="simple">
<li><p><strong>une vérification par ligne</strong>, avec <code class="docutils literal notranslate"><span class="pre">check</span></code> — jamais un <code class="docutils literal notranslate"><span class="pre">echo</span> <span class="pre">RÉUSSI</span></code> écrit à la main ;</p></li>
<li><p><strong>toute vérification négative a son témoin</strong> : avant « ne joint pas », une ligne qui prouve que
la cible est vivante et que le chemin du test fonctionne ;</p></li>
<li><p><strong>``vm_fails`` pour le négatif</strong>, jamais <code class="docutils literal notranslate"><span class="pre">!</span></code> devant un <code class="docutils literal notranslate"><span class="pre">vm_ssh</span></code> : un SSH en panne doit
échouer, pas passer pour une isolation ;</p></li>
<li><p><strong>une donnée qui distingue réellement les cas</strong> : two dérivant la MAC du rang de l’IP, deux
subnets ont les mêmes MAC — comparer des couples MAC/IP, pas des MAC ;</p></li>
<li><p><strong>les mesures en ``INFO``</strong>, les attentes en <code class="docutils literal notranslate"><span class="pre">check</span></code> : un temps de reconvergence se mesure,
il ne se décrète pas ;</p></li>
<li><p>chaque scénario crée ses propres VPC, plages et VNI, distinctes de celles des autres, pour que
<code class="docutils literal notranslate"><span class="pre">all</span></code> les enchaîne sur le même lab ; un scénario qui dépend d’un autre le vérifie en tête
(<code class="docutils literal notranslate"><span class="pre">check</span> <span class="pre">&quot;prérequis</span> <span class="pre">:</span> <span class="pre">…&quot;</span></code>) ;</p></li>
<li><p>variables vers un nœud : <code class="docutils literal notranslate"><span class="pre">on</span> <span class="pre">hv1</span> <span class="pre">NOM=valeur</span> <span class="pre">&lt;&lt;'NODE'</span></code> (valeurs échappées par
<code class="docutils literal notranslate"><span class="pre">run.sh</span></code>) ;</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">bash</span> <span class="pre">test/e2e/run_test.sh</span></code> vérifie la syntaxe de chaque bloc réellement envoyé — à
lancer avant toute session.</p></li>
</ul>
</section>
</section>
<section id="securite">
@ -916,8 +1082,8 @@ sont, eux, vérifiés contre <code class="docutils literal notranslate"><span cl
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>bash<span class="w"> </span>test/e2e/run_test.sh
</pre></div>
</div>
<p>Sans réseau : vérifie la syntaxe de chaque bloc réellement envoyé aux nœuds par les scénarios et
les fonctions de <code class="docutils literal notranslate"><span class="pre">test/e2e/lib/node.sh</span></code>. Les tests de l’outil sont dans le dépôt <code class="docutils literal notranslate"><span class="pre">labctl</span></code>.</p>
<p>Sans réseau : vérifie le runner, les fonctions de <code class="docutils literal notranslate"><span class="pre">test/e2e/lib/</span></code> et la syntaxe de chaque bloc
réellement envoyé aux nœuds par la suite. Les tests de l’outil sont dans le dépôt <code class="docutils literal notranslate"><span class="pre">labctl</span></code>.</p>
</section>
</section>
@ -973,8 +1139,11 @@ les fonctions de <code class="docutils literal notranslate"><span class="pre">te
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#roles">Rôles</a></li>
</ul>
</li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#scenarios">Scénarios</a><ul class="nav section-nav flex-column">
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#ecrire-un-scenario">Écrire un scénario</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#suite-de-tests">Suite de tests</a><ul class="nav section-nav flex-column">
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#matrice-de-couverture">Matrice de couverture</a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#campagne-du-2026-10-17">Campagne du 2026-10-17</a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#ecrire-un-test">Écrire un test</a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#campagnes-precedentes">Campagnes précédentes</a></li>
</ul>
</li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#securite">Sécurité</a></li>

File diff suppressed because one or more lines are too long