docs: build de 1828053e6d
This commit is contained in:
parent
0626b4b97d
commit
d081a75883
7 changed files with 209 additions and 42 deletions
|
|
@ -374,9 +374,10 @@ subnet/<name>/gateway → <ip> (optionnel)
|
|||
subnet/<name>/dhcp/<ip> → <mac>
|
||||
|
||||
vm/<name>/state → creating | running | error | deleting | deleted
|
||||
vm/<name>/subnet → <subnet-name>
|
||||
vm/<name>/tap_id → <int>
|
||||
vm/<name>/ip → <ip>
|
||||
vm/<name>/nic/<i>/subnet → <subnet-name> (une interface par index, ordre du tableau interfaces)
|
||||
vm/<name>/nic/<i>/ip → <ip>
|
||||
vm/<name>/nic/<i>/primary → "true" (exactement une interface ; absent sur les autres)
|
||||
vm/<name>/nic/<i>/tap_id → <int> (alloué au premier démarrage, puis conservé)
|
||||
vm/<name>/metadata_port → <port>
|
||||
vm/<name>/disk/<dev> → <path> (une clé par disque : sda, vda, …)
|
||||
vm/<name>/memory → <int> (Mo)
|
||||
|
|
@ -389,9 +390,13 @@ vm/<name>/metadata/<document> → <contenu brut> (optionnel :
|
|||
</div>
|
||||
<section id="regles">
|
||||
<h2>Règles<a class="headerlink" href="#regles" title="Lien vers cette rubrique">#</a></h2>
|
||||
<p><strong>Pas de duplication.</strong> Une ressource ne stocke que ce qui lui est propre. Une VM garde le lien
|
||||
<code class="docutils literal notranslate"><span class="pre">vm/<name>/subnet</span></code> ; le VPC, le bridge et l”<code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> sont lus depuis le subnet, leur
|
||||
source canonique.</p>
|
||||
<p><strong>Pas de duplication.</strong> Une ressource ne stocke que ce qui lui est propre. Une interface de VM
|
||||
garde le lien <code class="docutils literal notranslate"><span class="pre">vm/<name>/nic/<i>/subnet</span></code> ; le VPC, le mode, le bridge et l”<code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> sont
|
||||
lus depuis le subnet, leur source canonique. De même, la L3VNI d’un VPC n’est stockée que sous
|
||||
<code class="docutils literal notranslate"><span class="pre">vpc/<name>/l3vni</span></code> : RT, RD, MAC de routeur et table de routage en sont calculés.</p>
|
||||
<p><strong>Ancien schéma des VM.</strong> Avant le multi-interfaces, une VM portait directement <code class="docutils literal notranslate"><span class="pre">subnet</span></code>, <code class="docutils literal notranslate"><span class="pre">ip</span></code>
|
||||
et <code class="docutils literal notranslate"><span class="pre">tap_id</span></code>. L’agent les migre au démarrage vers <code class="docutils literal notranslate"><span class="pre">nic/0/…</span></code>, marquée <code class="docutils literal notranslate"><span class="pre">primary</span></code>, avant
|
||||
d’ouvrir son API ; une VM qui a déjà des clés <code class="docutils literal notranslate"><span class="pre">nic/</span></code> est laissée telle quelle.</p>
|
||||
<p><strong>Les états passent par ``state``.</strong> Toujours <code class="docutils literal notranslate"><span class="pre">state.Set</span></code> / <code class="docutils literal notranslate"><span class="pre">state.Get</span></code> : <code class="docutils literal notranslate"><span class="pre">Set</span></code> refuse une
|
||||
valeur hors énumération, <code class="docutils literal notranslate"><span class="pre">Get</span></code> refuse de retourner une valeur non reconnue. <code class="docutils literal notranslate"><span class="pre">error</span></code> n’est
|
||||
écrit que par <code class="docutils literal notranslate"><span class="pre">Dispatcher.Dispatch</span></code>, via <code class="docutils literal notranslate"><span class="pre">cmd.Key()</span></code>.</p>
|
||||
|
|
|
|||
|
|
@ -844,11 +844,15 @@ configuration réseau côté host n’existe pas encore : la création part en <
|
|||
BR --- VX["vxlan&lt;vni&gt;"] --- HBR["bridge host<br/>(iface_type)"] --- UP[uplink]
|
||||
</pre><p>Le subnet vit dans le netns du VPC. La VM n’est donc <strong>pas joignable depuis l’host</strong> sans route
|
||||
explicite — point à connaître avant de câbler un outil externe dessus.</p>
|
||||
<p>Le bridge du subnet, qui porte <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code>, a une <strong>MAC de gateway anycast</strong> calculée depuis
|
||||
le <code class="docutils literal notranslate"><span class="pre">vxlan_id</span></code> : <code class="docutils literal notranslate"><span class="pre">02:01:00</span></code> suivi des 24 bits de la VNI (<code class="docutils literal notranslate"><span class="pre">vxlan_id</span></code> 2811 →
|
||||
<code class="docutils literal notranslate"><span class="pre">02:01:00:00:0a:fb</span></code>). Elle est identique sur tous les hôtes qui portent le subnet : une VM qui
|
||||
change d’hôte garde une entrée ARP valide pour sa gateway. Elle n’est posée qu’à la création du
|
||||
subnet — un subnet créé avant garde la MAC choisie par le noyau jusqu’à sa recréation.</p>
|
||||
<p>Le bridge du subnet, qui porte <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code>, a une <strong>MAC de gateway propre à l’hôte</strong>, calculée
|
||||
depuis son VTEP — l’IPv4 primaire du <code class="docutils literal notranslate"><span class="pre">local_iface</span></code> : <code class="docutils literal notranslate"><span class="pre">02:03</span></code> suivi des quatre octets de
|
||||
l’adresse (VTEP <code class="docutils literal notranslate"><span class="pre">192.168.14.12</span></code> → <code class="docutils literal notranslate"><span class="pre">02:03:c0:a8:0e:0c</span></code>). Unique dans le fabric, elle est la
|
||||
même pour tous les subnets d’un hôte, chacun étant un domaine L2 distinct. Elle n’est posée qu’à la
|
||||
création du subnet — un subnet créé avant garde la MAC choisie par le noyau jusqu’à sa recréation.</p>
|
||||
<p>Une MAC de gateway <strong>identique sur tous les hôtes</strong> (anycast) a été essayée puis retirée : apprise
|
||||
sur le veth du subnet, elle était annoncée en EVPN par chaque hôte et détectée en double ; et une
|
||||
gateway ne pouvait plus joindre en L2 une VM d’un autre hôte, la réponse revenant à la gateway
|
||||
locale de la VM. Le cache ARP d’une VM migrée à chaud est un sujet de la migration, pas du subnet.</p>
|
||||
</section>
|
||||
<section id="bridge">
|
||||
<h2>bridge<a class="headerlink" href="#bridge" title="Lien vers cette rubrique">#</a></h2>
|
||||
|
|
|
|||
|
|
@ -827,9 +827,9 @@ se change pas après création.</p>
|
|||
</pre></div>
|
||||
</div>
|
||||
<p>Dans le netns, le <code class="docutils literal notranslate"><span class="pre">cidr</span></code> du VPC est routé vers <code class="docutils literal notranslate"><span class="pre">169.254.0.1</span></code> ; le transit <code class="docutils literal notranslate"><span class="pre">/30</span></code> est le même
|
||||
sur tous les hyperviseurs et pour tous les VPC. Le forwarding IPv4 est activé dans le netns, et
|
||||
sur l’hôte <strong>seulement</strong> sur <code class="docutils literal notranslate"><span class="pre">brl3-<id></span></code> et <code class="docutils literal notranslate"><span class="pre">l3-<id>-o</span></code> : l’hyperviseur ne devient pas un
|
||||
routeur entre ses autres interfaces. FRR reçoit la VRF, son <code class="docutils literal notranslate"><span class="pre">vni</span></code>, une instance
|
||||
sur tous les hyperviseurs et pour tous les VPC. L’agent active le forwarding IPv4 dans le netns,
|
||||
et sur l’hôte sur <code class="docutils literal notranslate"><span class="pre">brl3-<id></span></code> et <code class="docutils literal notranslate"><span class="pre">l3-<id>-o</span></code>, les deux interfaces d’entrée de la VRF ; il ne
|
||||
touche pas au réglage global, que <code class="docutils literal notranslate"><span class="pre">bootstrap_kvm.sh</span></code> met déjà à 1. FRR reçoit la VRF, son <code class="docutils literal notranslate"><span class="pre">vni</span></code>, une instance
|
||||
<code class="docutils literal notranslate"><span class="pre">router</span> <span class="pre">bgp</span> <span class="pre"><asn></span> <span class="pre">vrf</span> <span class="pre">vrf-<id></span></code> avec RD <code class="docutils literal notranslate"><span class="pre"><VTEP>:<l3vni></span></code> et RT <code class="docutils literal notranslate"><span class="pre"><asn>:<l3vni></span></code>, et
|
||||
l’export des routes du <code class="docutils literal notranslate"><span class="pre">cidr</span></code> présentes dans la VRF.</p>
|
||||
<p>La suppression retire d’abord la configuration de routage de FRR, puis les interfaces, puis la
|
||||
|
|
|
|||
|
|
@ -392,12 +392,8 @@ démarrage, à partir de la section <code class="docutils literal notranslate"><
|
|||
</div>
|
||||
<p>L’agent en déduit la configuration ci-dessous ; le <code class="docutils literal notranslate"><span class="pre">router-id</span></code> est l’adresse IPv4 primaire de
|
||||
<code class="docutils literal notranslate"><span class="pre">default_interface</span></code>, la seule valeur qui change d’un hyperviseur à l’autre. <code class="docutils literal notranslate"><span class="pre">hostname</span></code> et
|
||||
<code class="docutils literal notranslate"><span class="pre">log</span></code> ne sont pas gérés par l’agent.</p>
|
||||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>frr defaults traditional
|
||||
hostname hv1
|
||||
log syslog informational
|
||||
!
|
||||
router bgp 64600
|
||||
<code class="docutils literal notranslate"><span class="pre">log</span></code> ne sont pas gérés par l’agent : ce sont les seules lignes à déposer dans <code class="docutils literal notranslate"><span class="pre">frr.conf</span></code>.</p>
|
||||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>router bgp 64600
|
||||
bgp router-id 192.168.14.11
|
||||
no bgp default ipv4-unicast
|
||||
neighbor fabric peer-group
|
||||
|
|
@ -409,11 +405,16 @@ router bgp 64600
|
|||
neighbor fabric activate
|
||||
advertise-all-vni
|
||||
exit-address-family
|
||||
!
|
||||
exit
|
||||
!
|
||||
</pre></div>
|
||||
</div>
|
||||
<div class="admonition warning">
|
||||
<p class="admonition-title">Avertissement</p>
|
||||
<p>Avec une section <code class="docutils literal notranslate"><span class="pre">bgp</span></code>, l’agent <strong>refuse de démarrer</strong> si <code class="docutils literal notranslate"><span class="pre">vtysh</span></code> ne répond pas, et
|
||||
<code class="docutils literal notranslate"><span class="pre">agent.service</span></code> ne le relance pas. L’ordre au démarrage est donc : migration réseau vers
|
||||
<code class="docutils literal notranslate"><span class="pre">br-000000</span></code>, <strong>puis</strong> FRR, <strong>puis</strong> l’agent. FRR démarré avant la migration peut perdre la
|
||||
route par défaut quand elle change d’interface, et ne plus joindre le route reflector.</p>
|
||||
</div>
|
||||
<p>Ce qu’elle établit :</p>
|
||||
<ul class="simple">
|
||||
<li><p><strong>Une seule session</strong>, en iBGP dans l’AS 64600, vers la loopback du route reflector
|
||||
|
|
|
|||
|
|
@ -487,15 +487,16 @@ par <code class="docutils literal notranslate"><span class="pre">down</span></co
|
|||
et le prix ; ne crée rien
|
||||
up crée le serveur de lab, attend la fin de son installation et son SSH,
|
||||
puis le prépare (voir prepare)
|
||||
status liste les serveurs de lab du projet
|
||||
status liste les serveurs de lab du projet, dans toutes les zones candidates
|
||||
ssh [commande] se connecte au serveur de lab ; avec une commande, un terminal n'est demandé
|
||||
que si l'entrée standard en est un
|
||||
prepare installe sur le serveur ce dont lab a besoin (qemu, genisoimage), vérifie
|
||||
/dev/kvm et la virtualisation imbriquée ; lancé aussi par up
|
||||
/dev/kvm, la virtualisation imbriquée et un CPU x86-64-v3 ; lancé aussi par up
|
||||
push <topologie> compile cmd/lab pour linux/amd64 et dépose sur le serveur ~/lab et le
|
||||
répertoire de la topologie dans ~/topology/ (avec les fichiers qu'elle
|
||||
référence) ; ensuite : ssh './lab up topology/<topologie>'
|
||||
down supprime tous les serveurs de lab du projet et attend leur disparition
|
||||
down supprime tous les serveurs de lab du projet, dans toutes les zones candidates,
|
||||
et attend leur disparition
|
||||
session [cmd] up, puis la commande distante (ou un shell), puis down quoi qu'il arrive
|
||||
</pre></div>
|
||||
</div>
|
||||
|
|
@ -503,13 +504,25 @@ par <code class="docutils literal notranslate"><span class="pre">down</span></co
|
|||
<p>Toujours commencer par <code class="docutils literal notranslate"><span class="pre">plan</span></code>. Il valide la clé d’API, le quota d’offre, l’OS et les clés SSH,
|
||||
et montre exactement ce qui serait commandé :</p>
|
||||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>$ scripts/lab-host.sh plan
|
||||
== offre : EM-B212X-SSD (ddaf8ba6-b2b2-4279-8af3-51930fb602f8), facturation hourly, stock available
|
||||
== prix : 0.321 EUR HT par heure, frais de mise en service 0 EUR
|
||||
!! fr-par-1 : offre EM-B420E-NVME en rupture de stock en fr-par-1
|
||||
!! fr-par-2 : offre EM-B420E-NVME en rupture de stock en fr-par-2
|
||||
!! nl-ams-1 : offre horaire EM-B420E-NVME : 0 correspondance(s) en nl-ams-1, une seule attendue
|
||||
== zone : nl-ams-2
|
||||
== offre : EM-B420E-NVME (d14eef5e-3279-42db-bb57-bb2bbe6a5b28), AMD EPYC 7272, facturation hourly, stock available
|
||||
== prix : 0.444 EUR HT par heure, frais de mise en service 0 EUR
|
||||
== os : Debian 12 (Bookworm) (83640d93-a0b8-45ad-9c9f-30cae48380a4), utilisateur root
|
||||
== clés : 2 clé(s) SSH du projet
|
||||
== requête : POST /baremetal/v1/zones/fr-par-1/servers
|
||||
== requête : POST /baremetal/v1/zones/nl-ams-2/servers
|
||||
</pre></div>
|
||||
</div>
|
||||
<p><strong>Offre et zone.</strong> L’offre par défaut est <code class="docutils literal notranslate"><span class="pre">EM-B420E-NVME</span></code> (AMD EPYC 7272, 12 cœurs, 119 Gio) :
|
||||
son modèle de CPU est exact et atteint <strong>x86-64-v3</strong>, le minimum de RHEL 10 et Rocky 10. Les offres
|
||||
« Xeon … or equivalent » ne garantissent rien : <code class="docutils literal notranslate"><span class="pre">EM-B212X-SSD</span></code> (« E5-2620 v4 or equivalent ») a
|
||||
livré le 2026-10-11 un E5-2670 de 2012, x86-64-v2, sur lequel Rocky 10 ne démarre pas.
|
||||
<code class="docutils literal notranslate"><span class="pre">prepare</span></code> refuse donc un serveur sans x86-64-v3 — dans une <code class="docutils literal notranslate"><span class="pre">session</span></code>, il est aussitôt
|
||||
supprimé. La zone n’est pas imposée : <code class="docutils literal notranslate"><span class="pre">plan</span></code> et <code class="docutils literal notranslate"><span class="pre">up</span></code> prennent la première zone de
|
||||
<code class="docutils literal notranslate"><span class="pre">LAB_ZONES</span></code> (par défaut toutes les zones Elastic Metal) où l’offre est en stock, <code class="docutils literal notranslate"><span class="pre">SCW_DEFAULT_ZONE</span></code>
|
||||
passant en tête ; <code class="docutils literal notranslate"><span class="pre">status</span></code> et <code class="docutils literal notranslate"><span class="pre">down</span></code> couvrent toutes ces zones.</p>
|
||||
<p><code class="docutils literal notranslate"><span class="pre">session</span></code> est la forme normale d’usage : le serveur est supprimé à la fin, que la commande
|
||||
réussisse, échoue, ou que la session soit interrompue (Ctrl-C, <code class="docutils literal notranslate"><span class="pre">TERM</span></code>, fermeture du terminal).</p>
|
||||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>$ scripts/lab-host.sh session 'uname -a; lscpu | grep -E "Model name|^CPU\(s\)|Virtualization"; free -g | head -2; echo "nested=$(cat /sys/module/kvm_intel/parameters/nested)"; ls -l /dev/kvm'
|
||||
|
|
@ -584,11 +597,12 @@ portés par un switch). Exemple livré, <code class="docutils literal notranslat
|
|||
<span class="nt"> loopback</span><span class="p">:</span><span class="w"> </span><span class="nv">10.255.255.1/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/rr1.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">hypervisor</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"> release</span><span class="p">:</span><span class="w"> </span><span class="nv">0.2.0rc003</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"> release</span><span class="p">:</span><span class="w"> </span><span class="nv">0.2.0rc005</span><span class="p p-Indicator">,</span>
|
||||
<span class="nt"> agent</span><span class="p">:</span><span class="w"> </span><span class="nv">agent/two.yml</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">hypervisor</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"> release</span><span class="p">:</span><span class="w"> </span><span class="nv">0.2.0rc003</span><span class="w"> </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"> release</span><span class="p">:</span><span class="w"> </span><span class="nv">0.2.0rc005</span><span class="p p-Indicator">,</span>
|
||||
<span class="nt"> agent</span><span class="p">:</span><span class="w"> </span><span class="nv">agent/bgp.yml</span><span class="w"> </span><span class="p p-Indicator">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>Chaque nœud non-switch est relié au switch de chacun de ses segments par un câble virtuel QEMU ;
|
||||
|
|
@ -618,12 +632,14 @@ segment ;</p></li>
|
|||
<li><p><code class="docutils literal notranslate"><span class="pre">frr</span></code> — le chemin d’un <code class="docutils literal notranslate"><span class="pre">frr.conf</span></code>, relatif au fichier de topologie : FRR est installé
|
||||
au démarrage et la configuration déposée <strong>telle quelle</strong> (voir <a class="reference internal" href="#roles">Rôles</a>).</p></li>
|
||||
<li><p><code class="docutils literal notranslate"><span class="pre">release</span></code> — <strong>obligatoire pour un hyperviseur</strong>, refusé ailleurs : le tag de la release de
|
||||
two que <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code> installe (<code class="docutils literal notranslate"><span class="pre">release:</span> <span class="pre">0.2.0rc003</span></code>). Sans lui, <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code> prendrait la
|
||||
two que <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code> installe (<code class="docutils literal notranslate"><span class="pre">release:</span> <span class="pre">0.2.0rc005</span></code>). Sans lui, <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code> prendrait la
|
||||
dernière release, et le lab ne serait plus reproductible.</p></li>
|
||||
<li><p><code class="docutils literal notranslate"><span class="pre">agent</span></code> — pour un hyperviseur seulement : le chemin d’un <code class="docutils literal notranslate"><span class="pre">agent.yml</span></code>, relatif au fichier
|
||||
de topologie, déposé dans <code class="docutils literal notranslate"><span class="pre">/etc/two/agent.yml</span></code> avant <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code>. Sans lui, l’agent tourne
|
||||
avec sa configuration par défaut. L’exemple met hv1 sur le serveur DHCP intégré
|
||||
(<code class="docutils literal notranslate"><span class="pre">test/e2e/topologies/agent/two.yml</span></code> : <code class="docutils literal notranslate"><span class="pre">dhcp.backend:</span> <span class="pre">two</span></code>) et laisse hv2 sur dnsmasq.</p></li>
|
||||
avec sa configuration par défaut. Les deux fichiers fournis donnent à l’agent la section
|
||||
<code class="docutils literal notranslate"><span class="pre">bgp</span></code> (AS 64600, route reflector <code class="docutils literal notranslate"><span class="pre">10.255.255.1</span></code>) et un watchdog toutes les 10 s ;
|
||||
<code class="docutils literal notranslate"><span class="pre">test/e2e/topologies/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></li>
|
||||
</ul>
|
||||
<p><code class="docutils literal notranslate"><span class="pre">mgmt0</span></code> et <code class="docutils literal notranslate"><span class="pre">lo1</span></code> sont réservés : aucun segment ne peut porter ces noms.</p>
|
||||
</dd>
|
||||
|
|
@ -680,8 +696,8 @@ roles
|
|||
name loopback secondary frr release agent
|
||||
sw1 - underlay 169.254.0.1/28 sw1.conf - -
|
||||
rr1 lo1 10.255.255.1/32 underlay 169.254.0.3/28 rr1.conf - -
|
||||
hv1 - - hv1.conf 0.2.0rc003 two.yml
|
||||
hv2 - - hv2.conf 0.2.0rc003 -
|
||||
hv1 - - hv1.conf 0.2.0rc005 two.yml
|
||||
hv2 - - hv2.conf 0.2.0rc005 bgp.yml
|
||||
|
||||
segment underlay: 192.168.14.0/24, mtu 9000, switch sw1, bridge br-underlay, gateway 192.168.14.1
|
||||
node interface address mac udp switch port mac udp
|
||||
|
|
@ -710,7 +726,9 @@ n’en déclare pas : il porte toujours la passerelle, la première adresse du s
|
|||
<h3>Rôles<a class="headerlink" href="#roles" title="Lien vers cette rubrique">#</a></h3>
|
||||
<p>Les configurations FRR du lab vivent dans <code class="docutils literal notranslate"><span class="pre">test/e2e/topologies/frr/</span></code>, une par nœud, <strong>écrites à la main</strong> :
|
||||
ce sont les mêmes fichiers que la documentation de déploiement inclut, pour que le lab qualifie
|
||||
exactement ce qu’elle prescrit. Celle du route reflector :</p>
|
||||
exactement ce qu’elle prescrit. Celles des hyperviseurs se réduisent à <code class="docutils literal notranslate"><span class="pre">hostname</span></code> et <code class="docutils literal notranslate"><span class="pre">log</span></code> :
|
||||
la configuration BGP est posée par l’agent (section <code class="docutils literal notranslate"><span class="pre">bgp</span></code> de <code class="docutils literal notranslate"><span class="pre">agent.yml</span></code>). Celle du route
|
||||
reflector :</p>
|
||||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>frr defaults traditional
|
||||
hostname rr1
|
||||
log syslog informational
|
||||
|
|
@ -783,7 +801,12 @@ teste les scripts de sa branche. L’uplink <code class="docutils literal notran
|
|||
celle du premier segment de l’hyperviseur dans l’ordre de déclaration des segments — parce que
|
||||
<code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code> y lit l’adresse et la passerelle qu’il déplace sur <code class="docutils literal notranslate"><span class="pre">br-000000</span></code>. <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code>
|
||||
télécharge la release sur <code class="docutils literal notranslate"><span class="pre">git.g3e.fr</span></code> sans réessayer : le lancement attend d’abord que le serveur
|
||||
réponde, à travers le switch. FRR est installé <strong>après</strong> : il démarre sur le réseau final.</p>
|
||||
réponde, à travers le switch. FRR est installé <strong>après</strong> : il démarre sur le réseau final. Démarré
|
||||
avant la migration, zebra peut perdre la route par défaut quand elle passe de l’uplink à
|
||||
<code class="docutils literal notranslate"><span class="pre">br-000000</span></code> — constaté le 2026-10-11 sur un hyperviseur sur deux : route reflector
|
||||
<code class="docutils literal notranslate"><span class="pre">unresolved</span></code>, session BGP jamais établie. L’agent, configuré avec une section <code class="docutils literal notranslate"><span class="pre">bgp</span></code>, refuse de
|
||||
démarrer tant que FRR n’est pas là : son premier démarrage par <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code> échoue, et le
|
||||
provisionnement le <strong>redémarre</strong> une fois FRR installé.</p>
|
||||
<p><strong>Un seul script de provisionnement par nœud.</strong> cloud-init exécute <code class="docutils literal notranslate"><span class="pre">runcmd</span></code> comme un script
|
||||
<code class="docutils literal notranslate"><span class="pre">sh</span></code> sans <code class="docutils literal notranslate"><span class="pre">set</span> <span class="pre">-e</span></code> : seule la dernière commande compte, et un <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code> en échec suivi d’un
|
||||
FRR installé avec succès passerait pour un démarrage réussi. Chaque nœud reçoit donc
|
||||
|
|
@ -1174,6 +1197,26 @@ le trafic restant est <strong>mesuré</strong> (<code class="docutils literal no
|
|||
VTEP distant est réappris et le trafic repasse — délai mesuré</p></td>
|
||||
<td><p>hv1, hv2, rr1</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>
|
||||
<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 de gateway propre à
|
||||
chaque hôte, sans doublon EVPN ; 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>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
|
|
@ -1182,7 +1225,9 @@ VTEP distant est réappris et le trafic repasse — délai mesuré</p></td>
|
|||
scénario envoie des blocs de shell aux nœuds par <code class="docutils literal notranslate"><span class="pre">on</span> <span class="pre"><nœud></span> <span class="pre">[VAR=valeur…]</span> <span class="pre"><<'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>. Une vérification négative (« ne joint pas ») passe par <code class="docutils literal notranslate"><span class="pre">vm_fails</span></code> :
|
||||
<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>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
|
||||
|
|
@ -1205,6 +1250,61 @@ INFO: retour du VTEP distant et du trafic 31 s après le redémarrage de FRR
|
|||
dérive la MAC du rang de l’IP, et les VM <code class="docutils literal notranslate"><span class="pre">.10</span></code>/<code class="docutils literal notranslate"><span class="pre">.11</span></code> des deux subnets avaient les mêmes MAC.
|
||||
Vérifié à la main sur le lab, chaque serveur DHCP ne connaissait que les couples MAC/IP de son
|
||||
subnet ; le scénario compare désormais ces couples.</p>
|
||||
<p><code class="docutils literal notranslate"><span class="pre">s7-l3vni</span></code> le 2026-10-05, même lab, FRR 10.7.1 : <strong>46 réussi(s), 0 échoué(s)</strong> au dernier run.
|
||||
Quatre constats pour #41, au-delà du routage inter-subnet qui fonctionne avec le route reflector
|
||||
inchangé :</p>
|
||||
<ul class="simple">
|
||||
<li><p><strong>bgpd 10.7.1 plante</strong> (SIGSEGV dans <code class="docutils literal notranslate"><span class="pre">bgp_redistribute_add</span></code>) quand la VRF du noyau est
|
||||
supprimée puis recréée sous une instance <code class="docutils literal notranslate"><span class="pre">router</span> <span class="pre">bgp</span> <span class="pre">…</span> <span class="pre">vrf</span></code> encore configurée — FRR refuse de
|
||||
supprimer l’instance tant que <code class="docutils literal notranslate"><span class="pre">vni</span></code> est déclaré dans la VRF (« Please unconfigure l3vni »).
|
||||
Le plantage a touché les deux hyperviseurs à une seconde d’intervalle. Avec le démontage dans
|
||||
l’ordre — <code class="docutils literal notranslate"><span class="pre">no</span> <span class="pre">redistribute</span></code>, <code class="docutils literal notranslate"><span class="pre">no</span> <span class="pre">vni</span></code>, <code class="docutils literal notranslate"><span class="pre">no</span> <span class="pre">router</span> <span class="pre">bgp</span> <span class="pre">…</span> <span class="pre">vrf</span></code>, puis le noyau —, trois runs
|
||||
consécutifs passent sans plantage.</p></li>
|
||||
<li><p><strong>La configuration posée par vtysh est perdue</strong> au redémarrage de bgpd par watchfrr, qui
|
||||
relit <code class="docutils literal notranslate"><span class="pre">frr.conf</span></code> seul.</p></li>
|
||||
<li><p><strong>Le transit</strong> <code class="docutils literal notranslate"><span class="pre">169.254.0.0/30</span></code>, <strong>identique sur tous les hôtes</strong>, fait rejeter comme
|
||||
« martiens » les ICMP émis par les sauts distants (VRF et netns de l’hôte de sortie) : le
|
||||
noyau de l’hôte d’entrée possède la même adresse. Quatre routeurs sur le chemin, seuls les
|
||||
deux premiers répondent. Même effet attendu sur un ICMP « fragmentation nécessaire ».</p></li>
|
||||
<li><p><strong>La route du supernet n’existe pas dans le netns</strong> de la VPC avant la pose manuelle (premier
|
||||
run, lab neuf) : two ne pose que la route connectée du subnet.</p></li>
|
||||
</ul>
|
||||
<p><code class="docutils literal notranslate"><span class="pre">s8-l3vni-migration</span></code> le 2026-10-06, <code class="docutils literal notranslate"><span class="pre">evpn-3hv.yml</span></code> : <strong>61 réussi(s), 0 échoué(s)</strong>. Le filet du
|
||||
<code class="docutils literal notranslate"><span class="pre">/24</span></code> porte le trafic tant que la destination n’a pas annoncé son <code class="docutils literal notranslate"><span class="pre">/32</span></code> ; deux <code class="docutils literal notranslate"><span class="pre">/32</span></code>
|
||||
coexistent sans perte tant que la source garde le subnet (40 sources sur 40, relais en L2). Si la
|
||||
source supprime le subnet avant de retirer son <code class="docutils literal notranslate"><span class="pre">/32</span></code>, le trou noir est <strong>stable mais partiel</strong> :
|
||||
hv3 installe les deux chemins en ECMP, et seuls les flux hachés vers la source échouent (17 sources
|
||||
sur 40) — invisible avec un seul émetteur.</p>
|
||||
<p>Le 2026-10-11, les mêmes qualifications <strong>par l’API</strong>, l’agent posant toute la configuration
|
||||
(FRR 10.7.1) :</p>
|
||||
<ul class="simple">
|
||||
<li><p><code class="docutils literal notranslate"><span class="pre">s1</span></code> à <code class="docutils literal notranslate"><span class="pre">s6</span></code> sur <code class="docutils literal notranslate"><span class="pre">evpn-2hv.yml</span></code>, release <code class="docutils literal notranslate"><span class="pre">0.2.0rc004</span></code>, base BGP des hyperviseurs posée par
|
||||
l’agent : 37, 22, 12, 14, 13 et 8 réussis, aucun échec.</p></li>
|
||||
<li><p>Puis, release <code class="docutils literal notranslate"><span class="pre">0.2.0rc005</span></code> (correction du démontage FRR, ci-dessous), <code class="docutils literal notranslate"><span class="pre">evpn-3hv.yml</span></code> :</p></li>
|
||||
<li><p><code class="docutils literal notranslate"><span class="pre">s7-l3vni</span></code> : <strong>52 réussi(s), 1 échoué(s)</strong>. Routage inter-subnet par le
|
||||
L3VNI, MAC de routeur dérivée du VTEP, exports <code class="docutils literal notranslate"><span class="pre">/24</span></code> et <code class="docutils literal notranslate"><span class="pre">/32</span></code> automatiques, forwarding par
|
||||
interface, L3VNI en double et subnet utilisé refusés (409), démontage complet d’une VPC sans
|
||||
redémarrage de bgpd. L’échec — « TTL 1 », un seul paquet — ne s’est pas reproduit au run
|
||||
précédent : probablement le débit limité des ICMP du noyau ; la vérification envoie désormais
|
||||
trois paquets.</p></li>
|
||||
<li><p><code class="docutils literal notranslate"><span class="pre">s8-l3vni-migration</span></code> : <strong>48 réussi(s), 1 échoué(s)</strong>. Migration simple (<code class="docutils literal notranslate"><span class="pre">/32</span></code> de la
|
||||
destination installé sur hv3 sans délai mesurable, 50/50), séquence orchestrée (deux <code class="docutils literal notranslate"><span class="pre">/32</span></code> en
|
||||
ECMP, 40 sources sur 40), ex-pire cas refusé (409), 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é. L’échec est un constat : <strong>la MAC de gateway anycast est
|
||||
annoncée en EVPN</strong> (route de type 2 sur rr1) et FRR la déclare en double sur la VNI du subnet
|
||||
porté par deux hyperviseurs — apprise sur le veth du subnet, numéros de séquence croissants.</p></li>
|
||||
</ul>
|
||||
<p>Trois défauts trouvés et corrigés pendant la campagne :</p>
|
||||
<ul class="simple">
|
||||
<li><p><strong>FRR installé avant la migration réseau</strong> : zebra a perdu la route par défaut sur un
|
||||
hyperviseur sur deux (route reflector <code class="docutils literal notranslate"><span class="pre">unresolved</span></code>). Retour à l’ordre « FRR après
|
||||
<code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code> », puis redémarrage de l’agent (voir <a class="reference internal" href="#roles">Rôles</a>).</p></li>
|
||||
<li><p><strong>Remarques de vtysh prises pour des erreurs</strong> : <code class="docutils literal notranslate"><span class="pre">no</span> <span class="pre">vni</span></code> répond
|
||||
<code class="docutils literal notranslate"><span class="pre">%</span> <span class="pre">Configuration</span> <span class="pre">applied</span> <span class="pre">with</span> <span class="pre">notes:</span></code> avec un code de retour 0. Une vraie erreur (commande
|
||||
inconnue, refus) sort en 1.</p></li>
|
||||
<li><p><strong>L3VNI libérée de façon asynchrone</strong> : juste après <code class="docutils literal notranslate"><span class="pre">no</span> <span class="pre">vni</span></code>, <code class="docutils literal notranslate"><span class="pre">no</span> <span class="pre">router</span> <span class="pre">bgp</span> <span class="pre">…</span> <span class="pre">vrf</span></code> peut être
|
||||
refusé (« Please unconfigure l3vni ») puis accepté un instant plus tard ; l’agent réessaie.</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>scripts/lab-host.sh ssh "./lab ssh hv1 'sudo ip netns exec vp-s4 ssh -i /root/.ssh/lab-vm syonad@10.240.1.10'"
|
||||
|
|
|
|||
File diff suppressed because one or more lines are too long
|
|
@ -360,7 +360,8 @@
|
|||
|
||||
<section id="bael">
|
||||
<h1>Bael<a class="headerlink" href="#bael" title="Lien vers cette rubrique">#</a></h1>
|
||||
<p>Serveur DHCP intégré, en coexistence avec dnsmasq, et documentation du projet.</p>
|
||||
<p>Serveur DHCP intégré, en coexistence avec dnsmasq ; routage inter-subnet entre hyperviseurs par
|
||||
L3VNI, avec une configuration BGP pilotée par l’agent ; documentation du projet.</p>
|
||||
<section id="fonctionnalites">
|
||||
<h2>Fonctionnalités<a class="headerlink" href="#fonctionnalites" title="Lien vers cette rubrique">#</a></h2>
|
||||
<p><strong>Serveur DHCP intégré</strong></p>
|
||||
|
|
@ -390,8 +391,44 @@ comporte exactement comme avant</p></li>
|
|||
subnet déjà créé reste servi par le serveur qui l’a été. La procédure est documentée</p></li>
|
||||
<li><p>Toute valeur autre que <code class="docutils literal notranslate"><span class="pre">dnsmasq</span></code> ou <code class="docutils literal notranslate"><span class="pre">two</span></code> fait échouer le démarrage de l’agent</p></li>
|
||||
</ul>
|
||||
<p><strong>Routage inter-subnet entre hyperviseurs : L3VNI (#41)</strong></p>
|
||||
<ul class="simple">
|
||||
<li><p>Nouveau champ facultatif <code class="docutils literal notranslate"><span class="pre">l3vni</span></code> sur <code class="docutils literal notranslate"><span class="pre">POST</span> <span class="pre">/vpcs</span></code> (1 à 16777215, sauf 253-255 : c’est aussi
|
||||
l’identifiant de la table de routage). Absent, le VPC se comporte comme avant. Une L3VNI déjà
|
||||
portée par un VPC de l’agent est refusée (409), comme un <code class="docutils literal notranslate"><span class="pre">l3vni</span></code> demandé sans section <code class="docutils literal notranslate"><span class="pre">bgp</span></code></p></li>
|
||||
<li><p>Pour un VPC routé, l’agent pose sur l’hyperviseur une VRF (table = L3VNI), un bridge à la MAC de
|
||||
routeur <code class="docutils literal notranslate"><span class="pre">02:02:<IPv4</span> <span class="pre">du</span> <span class="pre">VTEP></span></code>, le VXLAN de la L3VNI, un lien de transit <code class="docutils literal notranslate"><span class="pre">169.254.0.1/30</span></code> ↔
|
||||
<code class="docutils literal notranslate"><span class="pre">169.254.0.2/30</span></code> vers le netns et la route du <code class="docutils literal notranslate"><span class="pre">cidr</span></code> du VPC dans le netns ; FRR reçoit la VRF,
|
||||
sa <code class="docutils literal notranslate"><span class="pre">vni</span></code>, une instance <code class="docutils literal notranslate"><span class="pre">router</span> <span class="pre">bgp</span> <span class="pre">…</span> <span class="pre">vrf</span></code> (RD <code class="docutils literal notranslate"><span class="pre"><VTEP>:<l3vni></span></code>, RT <code class="docutils literal notranslate"><span class="pre"><asn>:<l3vni></span></code>) et l’export
|
||||
des routes du <code class="docutils literal notranslate"><span class="pre">cidr</span></code>. Un hyperviseur n’a plus besoin de porter un subnet pour joindre ses VM</p></li>
|
||||
<li><p>Routes annoncées : le <code class="docutils literal notranslate"><span class="pre">/24</span></code> de chaque subnet <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> à sa création, le <code class="docutils literal notranslate"><span class="pre">/32</span></code> de chaque interface
|
||||
de VM juste avant son passage en <code class="docutils literal notranslate"><span class="pre">running</span></code> ; retirés en premier à la suppression</p></li>
|
||||
<li><p>La suppression d’un VPC routé retire la configuration de routage de FRR, puis les interfaces,
|
||||
puis la VRF de FRR — dans cet ordre, faute de quoi <code class="docutils literal notranslate"><span class="pre">bgpd</span></code> plante (FRR 10.7.1)</p></li>
|
||||
</ul>
|
||||
<p><strong>Configuration BGP pilotée par l’agent</strong></p>
|
||||
<ul class="simple">
|
||||
<li><p>Nouvelle section facultative <code class="docutils literal notranslate"><span class="pre">bgp</span></code> (<code class="docutils literal notranslate"><span class="pre">asn</span></code>, <code class="docutils literal notranslate"><span class="pre">route_reflectors</span></code>). Présente, l’agent applique à
|
||||
chaque démarrage, par <code class="docutils literal notranslate"><span class="pre">vtysh</span></code>, la base BGP de l’hyperviseur (router-id = VTEP, peer-group
|
||||
<code class="docutils literal notranslate"><span class="pre">fabric</span></code> vers les route reflectors, EVPN, <code class="docutils literal notranslate"><span class="pre">advertise-all-vni</span></code>) et l’enregistre :
|
||||
<code class="docutils literal notranslate"><span class="pre">/etc/frr/frr.conf</span></code> devient un fichier généré. Un route reflector retiré de la liste est retiré
|
||||
de FRR. Absente, l’agent ne touche pas à FRR</p></li>
|
||||
<li><p>Le démarrage échoue si la section est incomplète, si FRR tourne déjà sous un autre AS ou si
|
||||
<code class="docutils literal notranslate"><span class="pre">vtysh</span></code> ne répond pas</p></li>
|
||||
</ul>
|
||||
<p><strong>Gateway des subnets <code class="docutils literal notranslate"><span class="pre">vxlan</span></code></strong></p>
|
||||
<ul class="simple">
|
||||
<li><p>Le bridge du subnet porte une <strong>MAC propre à l’hôte</strong>, <code class="docutils literal notranslate"><span class="pre">02:03:<IPv4</span> <span class="pre">du</span> <span class="pre">VTEP></span></code>, posée à la
|
||||
création du subnet. Une MAC identique sur tous les hôtes (anycast) a été essayée puis retirée :
|
||||
annoncée en double en EVPN, elle empêchait aussi une gateway de joindre en L2 une VM d’un autre
|
||||
hôte (#57)</p></li>
|
||||
</ul>
|
||||
<p><strong>Exploitation</strong></p>
|
||||
<ul class="simple">
|
||||
<li><p>Le watchdog contrôle aussi, avec une section <code class="docutils literal notranslate"><span class="pre">bgp</span></code> : les sessions vers les route reflectors ;
|
||||
pour chaque VPC routé, les interfaces de la VRF et l’état de la L3VNI dans FRR (type, état, MAC
|
||||
de routeur) ; la cohérence entre routes exportées et ressources <code class="docutils literal notranslate"><span class="pre">running</span></code> — une route exportée
|
||||
sans propriétaire est signalée comme <strong>trou noir</strong>, une route attendue absente comme manquante</p></li>
|
||||
<li><p>Le watchdog interroge le serveur DHCP intégré et compare les réservations servies à celles que
|
||||
la base implique. Il nomme ce qui diverge — ordre perdu à la création, ordre perdu à la
|
||||
suppression, adresse ou route par défaut divergente — et reste en lecture seule</p></li>
|
||||
|
|
@ -403,6 +440,9 @@ ce qui serait envoyé à une MAC donnée : adresse, masque, routeur, DNS et rout
|
|||
<section id="correctifs">
|
||||
<h2>Correctifs<a class="headerlink" href="#correctifs" title="Lien vers cette rubrique">#</a></h2>
|
||||
<ul class="simple">
|
||||
<li><p><strong>Suppression d’un subnet refusée tant qu’une VM non supprimée l’utilise</strong> (409, avec la liste
|
||||
des VM), pour tous les subnets : garantit qu’une route <code class="docutils literal notranslate"><span class="pre">/32</span></code> est retirée avant le <code class="docutils literal notranslate"><span class="pre">/24</span></code> de son
|
||||
subnet, ce qui évite un trou noir partiel mesuré en lab</p></li>
|
||||
<li><p><strong>Un fichier de configuration présent mais invalide fait désormais échouer le démarrage.</strong>
|
||||
Jusqu’en 0.1.0 l’erreur de lecture était ignorée : l’agent tournait alors entièrement sur ses
|
||||
valeurs par défaut sans le dire, ce qui rendait indétectable une simple tabulation d’indentation</p></li>
|
||||
|
|
@ -413,6 +453,11 @@ champ et de le rendre indistinguable d’une réponse tronquée</p></li>
|
|||
<section id="changements-internes">
|
||||
<h2>Changements internes<a class="headerlink" href="#changements-internes" title="Lien vers cette rubrique">#</a></h2>
|
||||
<ul class="simple">
|
||||
<li><p>Nouveaux paquets <code class="docutils literal notranslate"><span class="pre">internal/frr</span></code> (seul point d’appel à <code class="docutils literal notranslate"><span class="pre">vtysh</span></code> : génération des commandes,
|
||||
démontage ordonné, relecture de la configuration après démontage) et <code class="docutils literal notranslate"><span class="pre">internal/sysctl</span></code> ; une
|
||||
remarque de <code class="docutils literal notranslate"><span class="pre">vtysh</span></code> (« Configuration applied with notes ») n’est pas une erreur, et la
|
||||
suppression d’une instance BGP de VRF est réessayée tant que <code class="docutils literal notranslate"><span class="pre">bgpd</span></code> n’a pas libéré la L3VNI</p></li>
|
||||
<li><p>Les tests du dispatcher arrêtent les workers avant de fermer la base (#47)</p></li>
|
||||
<li><p>Le module passe à <strong>Go 1.25</strong>, exigé par la bibliothèque DHCP retenue. La version de Go du
|
||||
workflow de build, restée à 1.21 alors que le module en demandait davantage, est alignée</p></li>
|
||||
<li><p>Nouveau paquet <code class="docutils literal notranslate"><span class="pre">pkg/db/statefile</span></code> : persistance générique d’un état de composant dans un
|
||||
|
|
@ -427,6 +472,14 @@ d’état, dans un <code class="docutils literal notranslate"><span class="pre">
|
|||
<h2>Périmètre et limites connues<a class="headerlink" href="#perimetre-et-limites-connues" title="Lien vers cette rubrique">#</a></h2>
|
||||
<p>Celles de la 0.1.0 restent valables, sauf mention contraire ci-dessus. S’y ajoutent :</p>
|
||||
<ul class="simple">
|
||||
<li><p><strong>L3VNI</strong> : pas de migration à chaud ; le cache ARP d’une VM qui changerait d’hôte reste à
|
||||
traiter (#57). MTU 1500 de bout en bout (#56). Un seul route reflector qualifié (#54). Le
|
||||
transit <code class="docutils literal notranslate"><span class="pre">169.254.0.0/30</span></code> étant identique sur tous les hôtes, les ICMP des sauts distants sont
|
||||
rejetés comme « martiens » (traceroute partiel)</p></li>
|
||||
<li><p>Avec une section <code class="docutils literal notranslate"><span class="pre">bgp</span></code>, l’agent ne démarre pas sans FRR et <code class="docutils literal notranslate"><span class="pre">agent.service</span></code> ne le relance pas :
|
||||
au démarrage, l’ordre est migration réseau, puis FRR, puis l’agent (#52)</p></li>
|
||||
<li><p><code class="docutils literal notranslate"><span class="pre">bootstrap_kvm.sh</span></code> active <code class="docutils literal notranslate"><span class="pre">net.ipv4.ip_forward</span></code> en global ; le forwarding que l’agent active
|
||||
sur les seules interfaces de la VRF n’en restreint donc pas la portée</p></li>
|
||||
<li><p><strong>dnsmasq n’est pas retiré</strong> et reste un paquet requis : le backend intégré ne sert que les
|
||||
subnets créés après la bascule, et le retour arrière suppose dnsmasq installé</p></li>
|
||||
<li><p>Pas de DNS, pas de pool dynamique, pas de PXE, pas de DHCPv6 dans le serveur intégré</p></li>
|
||||
|
|
@ -446,8 +499,12 @@ le dialogue avec le serveur intégré, est couvert sur toute plateforme</p></li>
|
|||
bash<span class="w"> </span>./deploy.sh<span class="w"> </span>-t<span class="w"> </span><span class="m">0</span>.2.0
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>Aucune action n’est requise : sans <code class="docutils literal notranslate"><span class="pre">dhcp.backend</span></code> dans <code class="docutils literal notranslate"><span class="pre">/etc/two/agent.yml</span></code>, le comportement est
|
||||
celui de la 0.1.0. Pour passer au serveur intégré, suivre la procédure de bascule dans la
|
||||
<p>Aucune action n’est requise : sans <code class="docutils literal notranslate"><span class="pre">dhcp.backend</span></code> ni <code class="docutils literal notranslate"><span class="pre">bgp</span></code> dans <code class="docutils literal notranslate"><span class="pre">/etc/two/agent.yml</span></code>, le
|
||||
comportement est celui de la 0.1.0, à une exception près — <strong>un subnet encore utilisé par une VM
|
||||
ne se supprime plus</strong> : supprimer les VM d’abord. Les subnets <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> existants gardent leur MAC
|
||||
de gateway jusqu’à leur recréation.</p>
|
||||
<p>Pour router entre hyperviseurs : ajouter la section <code class="docutils literal notranslate"><span class="pre">bgp</span></code>, réduire <code class="docutils literal notranslate"><span class="pre">frr.conf</span></code> à <code class="docutils literal notranslate"><span class="pre">hostname</span></code> et
|
||||
<code class="docutils literal notranslate"><span class="pre">log</span></code> (l’agent pose le reste), puis créer les VPC avec <code class="docutils literal notranslate"><span class="pre">l3vni</span></code>. Pour passer au serveur intégré, suivre la procédure de bascule dans la
|
||||
documentation d’exploitation — elle suppose un hyperviseur vidé.</p>
|
||||
</section>
|
||||
</section>
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue