docs: build de 7672445fe7
This commit is contained in:
parent
ac2e7cc8fc
commit
a86d47e622
7 changed files with 33 additions and 12 deletions
|
|
@ -389,6 +389,13 @@ autre symptôme.</p></li>
|
|||
<li><p><strong>La route du subnet garde la gateway pour source</strong> (<code class="docutils literal notranslate"><span class="pre">src</span></code>) : le netns parle à ses VM depuis
|
||||
la gateway, leurs réponses reviennent à l’hôte local. Depuis l’adresse d’émission, partagée par
|
||||
tous les hôtes, une réponse peut partir vers un autre hôte.</p></li>
|
||||
<li><p><strong>Chaque VRF de VPC porte une route ``unreachable default`` de métrique maximale.</strong> Sans elle,
|
||||
une recherche manquée dans la VRF retombe dans la table <code class="docutils literal notranslate"><span class="pre">main</span></code> de l’hôte et le paquet du
|
||||
locataire sort par l’underlay. Elle survit à la suppression de la VRF (aucune interface) : la
|
||||
retirer explicitement au démontage.</p></li>
|
||||
<li><p><strong>``default_route: true`` sans ``gateway`` est réservé au mode ``bridge``</strong> : en <code class="docutils literal notranslate"><span class="pre">vxlan</span></code>, la
|
||||
gateway de l’hôte n’est pas sur le subnet, la route par défaut serait inutilisable, et jointe
|
||||
elle contournerait le netns et la VRF.</p></li>
|
||||
<li><p><code class="docutils literal notranslate"><span class="pre">169.254.169.254</span></code> est centralisé dans <code class="docutils literal notranslate"><span class="pre">metadata.ServiceIP</span></code> — ne pas le réécrire en dur.</p></li>
|
||||
</ul>
|
||||
</section>
|
||||
|
|
|
|||
|
|
@ -972,7 +972,9 @@ seule. Le champ <code class="docutils literal notranslate"><span class="pre">def
|
|||
<dt><code class="docutils literal notranslate"><span class="pre">default_route:</span> <span class="pre">false</span></code> (défaut)</dt><dd><p>next-hop = <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> du subnet, la gateway calculée en <code class="docutils literal notranslate"><span class="pre">vxlan</span></code>.</p>
|
||||
</dd>
|
||||
<dt><code class="docutils literal notranslate"><span class="pre">default_route:</span> <span class="pre">true</span></code></dt><dd><p>next-hop = le champ <code class="docutils literal notranslate"><span class="pre">gateway</span></code> s’il est fourni, sinon la gateway lue dans la table de routage
|
||||
de l’host.</p>
|
||||
de l’host, à la création du subnet. Ce dernier cas est <strong>réservé au mode</strong> <code class="docutils literal notranslate"><span class="pre">bridge</span></code>, où la VM
|
||||
partage le L2 de cette gateway : sans <code class="docutils literal notranslate"><span class="pre">gateway</span></code>, <code class="docutils literal notranslate"><span class="pre">default_route:</span> <span class="pre">true</span></code> est refusé (400) en
|
||||
<code class="docutils literal notranslate"><span class="pre">vxlan</span></code> et en <code class="docutils literal notranslate"><span class="pre">public_ip</span></code>.</p>
|
||||
</dd>
|
||||
</dl>
|
||||
<p><code class="docutils literal notranslate"><span class="pre">gateway</span></code> n’est <strong>pas validé</strong> par l’agent : sa joignabilité et sa cohérence avec le CIDR du
|
||||
|
|
|
|||
|
|
@ -830,7 +830,7 @@ se change pas après création.</p>
|
|||
subnets. L’agent n’impose que la première borne (le RD <code class="docutils literal notranslate"><span class="pre"><VTEP>:<l3vni></span></code> porte un numéro sur
|
||||
16 bits) ; le respect du plan revient à l’appelant, qui alloue les deux.</p>
|
||||
<p>À la création, l’agent pose sur l’hyperviseur, pour un VPC <code class="docutils literal notranslate"><span class="pre">vp-<id></span></code> :</p>
|
||||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>vrf-<id> VRF, table de routage = l3vni
|
||||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>vrf-<id> VRF, table de routage = l3vni, unreachable default metric 4278198272
|
||||
├── brl3-<id> bridge sans adresse, MAC de routeur 02:02:<IPv4 du VTEP>
|
||||
│ └── vxl3-<id> VXLAN du l3vni, VTEP = IPv4 primaire de default_interface
|
||||
└── l3-<id>-o 169.254.0.1/30 ── l3-<id>-i 169.254.0.2/30, dans le netns du VPC
|
||||
|
|
@ -842,8 +842,17 @@ et sur l’hôte sur <code class="docutils literal notranslate"><span class="pre
|
|||
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
|
||||
VRF de FRR. Cet ordre est imposé : supprimer la VRF du noyau sous une instance BGP encore
|
||||
<p>La table de la VRF reçoit, juste après sa création, une route <code class="docutils literal notranslate"><span class="pre">unreachable</span> <span class="pre">default</span></code> de métrique
|
||||
maximale (<code class="docutils literal notranslate"><span class="pre">4278198272</span></code>, valeur recommandée par la documentation VRF du noyau). Sans elle, une
|
||||
recherche qui échoue dans la VRF continue dans les règles suivantes, donc dans la table <code class="docutils literal notranslate"><span class="pre">main</span></code>
|
||||
de l’hôte : un paquet d’un locataire vers une adresse inconnue de la VRF sortirait par l’underlay,
|
||||
avec <code class="docutils literal notranslate"><span class="pre">169.254.0.2</span></code> pour source (mesuré, <a class="reference external" href="https://git.g3e.fr/syonad/two/issues/81">#81</a>). La
|
||||
métrique maximale laisse passer avant elle toute route réelle de la VRF. Cette route n’est pas
|
||||
annoncée en EVPN : le route-map de la VRF n’exporte que le <code class="docutils literal notranslate"><span class="pre">cidr</span></code> du VPC. Elle n’est liée à
|
||||
aucune interface et ne disparaît pas avec la VRF : la suppression la retire explicitement. IPv4
|
||||
seulement.</p>
|
||||
<p>La suppression retire d’abord la configuration de routage de FRR, puis les interfaces, la route
|
||||
<code class="docutils literal notranslate"><span class="pre">unreachable</span> <span class="pre">default</span></code>, puis la VRF de FRR. Cet ordre est imposé : supprimer la VRF du noyau sous une instance BGP encore
|
||||
configurée fait planter <code class="docutils literal notranslate"><span class="pre">bgpd</span></code> (FRR 10.7.1).</p>
|
||||
</section>
|
||||
</section>
|
||||
|
|
|
|||
|
|
@ -757,7 +757,7 @@ fait en fermant le ticket. Chaque ticket concerné liste ses marqueurs en commen
|
|||
<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, #62, #74</p></td>
|
||||
<td><p>#41, #57, #33, #62, #74, #81</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>
|
||||
|
|
@ -850,9 +850,9 @@ fait en fermant le ticket. Chaque ticket concerné liste ses marqueurs en commen
|
|||
<td><p>#57</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><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’un VPC routé</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, unreachable default dans la VRF, démontage d’un VPC routé</p></td>
|
||||
<td><p>hv1 hv2</p></td>
|
||||
<td><p>#41</p></td>
|
||||
<td><p>#41, #81</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><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’un VPC routé — /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>
|
||||
|
|
@ -860,9 +860,9 @@ fait en fermant le ticket. Chaque ticket concerné liste ses marqueurs en commen
|
|||
<td><p>#41, #57</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">53-watchdog-l3</span></code></p></td>
|
||||
<td><p>watchdog d’un VPC routé — /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>watchdog d’un VPC routé — /32 orphelin signalé comme trou noir, /32 manquant signalé, unreachable default absente signalée, 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>
|
||||
<td><p>#41, #81</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><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>
|
||||
|
|
|
|||
|
|
@ -1019,7 +1019,7 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
|
|||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/400">400 Bad Request</a></span> – <p>Missing required field; interface_ip missing on a bridge or public_ip subnet, or supplied on a vxlan subnet (it is computed)</p>
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/400">400 Bad Request</a></span> – <p>Missing required field; interface_ip missing on a bridge or public_ip subnet, or supplied on a vxlan subnet (it is computed); default_route true without gateway on a vxlan or public_ip subnet</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">400</span> <span class="ne">Bad Request</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
|
|
|||
|
|
@ -408,7 +408,10 @@ de VM et la réponse des units systemd associées.</p>
|
|||
<code class="docutils literal notranslate"><span class="pre">Established</span></code> (<code class="docutils literal notranslate"><span class="pre">show</span> <span class="pre">bgp</span> <span class="pre">neighbors</span> <span class="pre"><ip></span></code>).</p></li>
|
||||
<li><p><strong>VPC routés</strong> (<code class="docutils literal notranslate"><span class="pre">l3vni</span></code>, état <code class="docutils literal notranslate"><span class="pre">running</span></code>) : présence et état des interfaces <code class="docutils literal notranslate"><span class="pre">vrf-<id></span></code>,
|
||||
<code class="docutils literal notranslate"><span class="pre">brl3-<id></span></code>, <code class="docutils literal notranslate"><span class="pre">vxl3-<id></span></code>, <code class="docutils literal notranslate"><span class="pre">l3-<id>-o</span></code> et, dans le netns, <code class="docutils literal notranslate"><span class="pre">l3-<id>-i</span></code> ; L3VNI de type
|
||||
<code class="docutils literal notranslate"><span class="pre">L3</span></code>, <code class="docutils literal notranslate"><span class="pre">Up</span></code>, avec la MAC de routeur attendue (<code class="docutils literal notranslate"><span class="pre">show</span> <span class="pre">evpn</span> <span class="pre">vni</span> <span class="pre"><l3vni></span></code>).</p></li>
|
||||
<code class="docutils literal notranslate"><span class="pre">L3</span></code>, <code class="docutils literal notranslate"><span class="pre">Up</span></code>, avec la MAC de routeur attendue (<code class="docutils literal notranslate"><span class="pre">show</span> <span class="pre">evpn</span> <span class="pre">vni</span> <span class="pre"><l3vni></span></code>) ; route
|
||||
<code class="docutils literal notranslate"><span class="pre">unreachable</span> <span class="pre">default</span></code> de métrique <code class="docutils literal notranslate"><span class="pre">4278198272</span></code> dans la table de la VRF. Un VPC routé créé
|
||||
par une version antérieure à la 0.3.0 ne l’a pas : il est signalé à chaque tick jusqu’à sa
|
||||
recréation, l’agent ne la pose pas au démarrage.</p></li>
|
||||
<li><p><strong>Réconciliation des routes exportées</strong> dans la VRF : chaque <code class="docutils literal notranslate"><span class="pre">/24</span></code> de subnet <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> et chaque
|
||||
<code class="docutils literal notranslate"><span class="pre">/32</span></code> d’interface de VM <code class="docutils literal notranslate"><span class="pre">running</span></code> doit être exporté ; à l’inverse, une route exportée dont
|
||||
le propriétaire n’existe plus — ni <code class="docutils literal notranslate"><span class="pre">running</span></code>, ni en <code class="docutils literal notranslate"><span class="pre">creating</span></code>, <code class="docutils literal notranslate"><span class="pre">deleting</span></code> ou <code class="docutils literal notranslate"><span class="pre">error</span></code> —
|
||||
|
|
|
|||
File diff suppressed because one or more lines are too long
Loading…
Add table
Add a link
Reference in a new issue