docs: build de 9477dc91d2
This commit is contained in:
parent
080c3e1f0e
commit
0626b4b97d
9 changed files with 117 additions and 14 deletions
|
|
@ -360,6 +360,7 @@
|
|||
de sérialisation structurée.</p>
|
||||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>vpc/<name>/state → creating | running | error | deleting | deleted
|
||||
vpc/<name>/cidr → <cidr>
|
||||
vpc/<name>/l3vni → <id> (optionnel : VPC routé par L3VNI)
|
||||
|
||||
subnet/<name>/state → creating | running | error | deleting | deleted
|
||||
subnet/<name>/vpc → <vpc-name>
|
||||
|
|
|
|||
|
|
@ -844,6 +844,11 @@ 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>
|
||||
</section>
|
||||
<section id="bridge">
|
||||
<h2>bridge<a class="headerlink" href="#bridge" title="Lien vers cette rubrique">#</a></h2>
|
||||
|
|
|
|||
|
|
@ -778,7 +778,10 @@ window.runMermaid = runMermaid;</script>
|
|||
</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="#vpc">VPC</a></li>
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#vpc">VPC</a><ul class="nav section-nav flex-column">
|
||||
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#routage-entre-hyperviseurs-l3vni">Routage entre hyperviseurs : <code class="docutils literal notranslate"><span class="pre">l3vni</span></code></a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#subnet">Subnet</a></li>
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#vm">VM</a></li>
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#ce-qui-est-stocke-et-ou">Ce qui est stocké, et où</a></li>
|
||||
|
|
@ -809,6 +812,30 @@ window.runMermaid = runMermaid;</script>
|
|||
<p>Un VPC est un <strong>network namespace</strong> portant un espace d’adressage (<code class="docutils literal notranslate"><span class="pre">cidr</span></code>). C’est l’unité
|
||||
d’isolation : deux VPC ne se voient pas, et peuvent réutiliser les mêmes plages d’adresses.</p>
|
||||
<p>Un VPC ne peut être supprimé que si tous ses subnets le sont déjà — sinon 409.</p>
|
||||
<section id="routage-entre-hyperviseurs-l3vni">
|
||||
<h3>Routage entre hyperviseurs : <code class="docutils literal notranslate"><span class="pre">l3vni</span></code><a class="headerlink" href="#routage-entre-hyperviseurs-l3vni" title="Lien vers cette rubrique">#</a></h3>
|
||||
<p>Un VPC créé avec <code class="docutils literal notranslate"><span class="pre">l3vni</span></code> route ses subnets entre hyperviseurs par un <strong>VNI de transit</strong> propre
|
||||
au VPC (IRB symétrique, <a class="reference external" href="https://git.g3e.fr/syonad/two/issues/41">#41</a>) : un hyperviseur n’a
|
||||
plus besoin de porter un subnet pour joindre ses VM. Sans <code class="docutils literal notranslate"><span class="pre">l3vni</span></code>, le VPC se comporte comme
|
||||
avant. Le champ exige la section <code class="docutils literal notranslate"><span class="pre">bgp</span></code> de l’agent (<a class="reference internal" href="../exploitation/configuration.html"><span class="doc">Configuration</span></a>) et ne
|
||||
se change pas après création.</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
|
||||
├── 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
|
||||
</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
|
||||
<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
|
||||
configurée fait planter <code class="docutils literal notranslate"><span class="pre">bgpd</span></code> (FRR 10.7.1).</p>
|
||||
</section>
|
||||
</section>
|
||||
<section id="subnet">
|
||||
<h2>Subnet<a class="headerlink" href="#subnet" title="Lien vers cette rubrique">#</a></h2>
|
||||
|
|
@ -820,6 +847,10 @@ bridge physique par la configuration de l’agent. Une clé absente ou inconnue
|
|||
<code class="docutils literal notranslate"><span class="pre">default_interface</span></code>. Ce niveau d’indirection permet au même appel d’API de fonctionner sur des
|
||||
hosts dont le nommage réseau diffère.</p>
|
||||
<p>Le comportement réseau dépend du <a class="reference internal" href="modes-reseau.html"><span class="doc">mode</span></a>.</p>
|
||||
<p>Un subnet ne peut être supprimé que si aucune VM non supprimée n’a d’interface dessus — sinon
|
||||
409, avec la liste des VM. Dans un VPC routé par <code class="docutils literal notranslate"><span class="pre">l3vni</span></code>, un subnet <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> annonce son
|
||||
préfixe dans la VRF du VPC à la création et le retire en premier à la suppression : c’est le
|
||||
filet qui couvre une VM tant que son <code class="docutils literal notranslate"><span class="pre">/32</span></code> n’est pas annoncé.</p>
|
||||
</section>
|
||||
<section id="vm">
|
||||
<h2>VM<a class="headerlink" href="#vm" title="Lien vers cette rubrique">#</a></h2>
|
||||
|
|
@ -828,6 +859,11 @@ hosts dont le nommage réseau diffère.</p>
|
|||
le nom de l’interface dans le guest. Exactement une interface doit être <code class="docutils literal notranslate"><span class="pre">primary</span></code> : elle porte
|
||||
la route par défaut et le serveur de metadata. Tous les subnets d’une VM doivent appartenir au
|
||||
<strong>même VPC</strong>.</p>
|
||||
<p><strong>Routes.</strong> Dans un VPC routé par <code class="docutils literal notranslate"><span class="pre">l3vni</span></code>, chaque interface sur un subnet <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> est annoncée
|
||||
en <code class="docutils literal notranslate"><span class="pre">/32</span></code> dans la VRF du VPC une fois QEMU démarré, juste avant le passage en <code class="docutils literal notranslate"><span class="pre">running</span></code>. À la
|
||||
suppression, ces <code class="docutils literal notranslate"><span class="pre">/32</span></code> sont retirés <strong>avant</strong> l’arrêt de QEMU. Comme un subnet ne peut être
|
||||
supprimé tant qu’une VM l’utilise, le <code class="docutils literal notranslate"><span class="pre">/32</span></code> d’une VM est toujours retiré avant le <code class="docutils literal notranslate"><span class="pre">/24</span></code> de son
|
||||
subnet — l’ordre qui évite le trou noir de <a class="reference external" href="https://git.g3e.fr/syonad/two/issues/41">#41</a>.</p>
|
||||
<p><strong>Stockage.</strong> Un seul disque <code class="docutils literal notranslate"><span class="pre">vdX</span></code> (virtio-blk) par VM ; les disques supplémentaires passent
|
||||
par le contrôleur SCSI (<code class="docutils literal notranslate"><span class="pre">sdX</span></code>). Cette contrainte vient de la carte PCI figée — voir
|
||||
<a class="reference internal" href="../architecture/contraintes.html"><span class="doc">Invariants et pièges</span></a>.</p>
|
||||
|
|
@ -894,7 +930,10 @@ convention <code class="docutils literal notranslate"><span class="pre">vp-</spa
|
|||
</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="#vpc">VPC</a></li>
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#vpc">VPC</a><ul class="nav section-nav flex-column">
|
||||
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#routage-entre-hyperviseurs-l3vni">Routage entre hyperviseurs : <code class="docutils literal notranslate"><span class="pre">l3vni</span></code></a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#subnet">Subnet</a></li>
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#vm">VM</a></li>
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#ce-qui-est-stocke-et-ou">Ce qui est stocké, et où</a></li>
|
||||
|
|
|
|||
|
|
@ -383,8 +383,16 @@ l’agent désactive l’apprentissage et ne configure aucun voisin — cf.
|
|||
<a class="reference internal" href="architecture-cluster.html"><span class="doc">Architecture du cluster</span></a>.</p>
|
||||
<section id="configuration-de-frr">
|
||||
<h3>Configuration de FRR<a class="headerlink" href="#configuration-de-frr" title="Lien vers cette rubrique">#</a></h3>
|
||||
<p>Seul <code class="docutils literal notranslate"><span class="pre">bgpd</span></code> est activé dans <code class="docutils literal notranslate"><span class="pre">/etc/frr/daemons</span></code>. D’un hyperviseur à l’autre ne changent que
|
||||
<code class="docutils literal notranslate"><span class="pre">hostname</span></code> et <code class="docutils literal notranslate"><span class="pre">router-id</span></code>, l’adresse de l’hyperviseur sur son segment.</p>
|
||||
<p>Seul <code class="docutils literal notranslate"><span class="pre">bgpd</span></code> est activé dans <code class="docutils literal notranslate"><span class="pre">/etc/frr/daemons</span></code>. Le reste est posé par l’agent, à chaque
|
||||
démarrage, à partir de la 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> (<a class="reference internal" href="../exploitation/configuration.html"><span class="doc">Configuration</span></a>) :</p>
|
||||
<div class="highlight-yaml notranslate"><div class="highlight"><pre><span></span><span class="nt">bgp</span><span class="p">:</span>
|
||||
<span class="w"> </span><span class="nt">asn</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">64600</span>
|
||||
<span class="w"> </span><span class="nt">route_reflectors</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">10.255.255.1</span><span class="p p-Indicator">]</span>
|
||||
</pre></div>
|
||||
</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
|
||||
|
|
|
|||
|
|
@ -866,7 +866,8 @@ accepté.</p></li>
|
|||
</tr>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">409</span></code></p></td>
|
||||
<td><p>conflit d’existence ou d’état : ressource déjà créée, ou suppression depuis un état qui
|
||||
ne l’autorise pas ; pour un VPC, subnets encore présents</p></td>
|
||||
ne l’autorise pas ; pour un VPC, subnets encore présents ; pour un subnet, VM non
|
||||
supprimées qui l’utilisent encore</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">422</span></code></p></td>
|
||||
<td><p>dépendance absente ou pas prête : VPC parent d’un subnet, subnet d’une VM</p></td>
|
||||
|
|
|
|||
|
|
@ -369,7 +369,8 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
|
|||
<span class="w"> </span><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"state"</span><span class="p">:</span><span class="w"> </span><span class="s2">"creating"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"cidr"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="w"> </span><span class="nt">"cidr"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"l3vni"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span>
|
||||
<span class="w"> </span><span class="p">}</span>
|
||||
<span class="p">]</span>
|
||||
</pre></div>
|
||||
|
|
@ -402,7 +403,8 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
|
|||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"cidr"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="w"> </span><span class="nt">"cidr"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"l3vni"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
|
|
@ -417,12 +419,13 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
|
|||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"state"</span><span class="p">:</span><span class="w"> </span><span class="s2">"creating"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"cidr"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="w"> </span><span class="nt">"cidr"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"l3vni"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span>
|
||||
<span class="p">}</span>
|
||||
</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 or invalid request body</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, invalid request body, or l3vni out of range</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>
|
||||
|
|
@ -433,7 +436,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/409">409 Conflict</a></span> – <p>VPC already exists</p>
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/409">409 Conflict</a></span> – <p>VPC already exists, l3vni already used by another VPC, or l3vni requested on an agent without a bgp section</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">409</span> <span class="ne">Conflict</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
|
@ -487,7 +490,8 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
|
|||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"state"</span><span class="p">:</span><span class="w"> </span><span class="s2">"creating"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"cidr"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="w"> </span><span class="nt">"cidr"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"l3vni"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
|
|
@ -539,7 +543,8 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
|
|||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"state"</span><span class="p">:</span><span class="w"> </span><span class="s2">"creating"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"cidr"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="w"> </span><span class="nt">"cidr"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"l3vni"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
|
|
@ -1164,7 +1169,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/409">409 Conflict</a></span> – <p>Subnet not deletable — only running or error states can be deleted</p>
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/409">409 Conflict</a></span> – <p>Subnet not deletable — only running or error states can be deleted, and no VM that is not deleted may still have an interface on it</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">409</span> <span class="ne">Conflict</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
|
|
|||
|
|
@ -346,6 +346,7 @@
|
|||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#serveurs">Serveurs</a></li>
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#execution-des-commandes">Exécution des commandes</a></li>
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#correspondance-des-interfaces">Correspondance des interfaces</a></li>
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#plan-de-controle-bgp">Plan de contrôle BGP</a></li>
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#metadata-et-qemu">Metadata et QEMU</a></li>
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#backend-dhcp">Backend DHCP</a><ul class="nav section-nav flex-column">
|
||||
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#bascule-d-un-backend-a-l-autre">Bascule d’un backend à l’autre</a></li>
|
||||
|
|
@ -457,6 +458,35 @@ d’images), une valeur confortable évite un système de fichiers invité incoh
|
|||
inconnue ou omise retombe silencieusement sur <code class="docutils literal notranslate"><span class="pre">default_interface</span></code> — ce n’est pas une erreur,
|
||||
mais c’est une source de subnets branchés au mauvais endroit sans le dire.</p>
|
||||
</section>
|
||||
<section id="plan-de-controle-bgp">
|
||||
<h2>Plan de contrôle BGP<a class="headerlink" href="#plan-de-controle-bgp" title="Lien vers cette rubrique">#</a></h2>
|
||||
<div class="highlight-yaml notranslate"><div class="highlight"><pre><span></span><span class="nt">bgp</span><span class="p">:</span>
|
||||
<span class="w"> </span><span class="nt">asn</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">64600</span>
|
||||
<span class="w"> </span><span class="nt">route_reflectors</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">10.255.255.1</span><span class="p p-Indicator">]</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>Section <strong>facultative</strong>. Absente, l’agent ne touche pas à FRR : sa configuration reste à poser
|
||||
à la main, comme avant. Présente, l’agent <strong>pilote la configuration BGP de l’hyperviseur</strong> :
|
||||
à chaque démarrage, avant d’ouvrir son API, il applique par <code class="docutils literal notranslate"><span class="pre">vtysh</span></code> la base décrite dans
|
||||
<a class="reference internal" href="../deploiement/premier-hyperviseur.html"><span class="doc">Premier hyperviseur</span></a>, puis l’enregistre par <code class="docutils literal notranslate"><span class="pre">write</span> <span class="pre">memory</span></code>.</p>
|
||||
<ul class="simple">
|
||||
<li><p><code class="docutils literal notranslate"><span class="pre">asn</span></code> — l’AS de l’hyperviseur, commun à tous les hyperviseurs du cluster (iBGP vers le
|
||||
route reflector). Obligatoire dès que la section existe.</p></li>
|
||||
<li><p><code class="docutils literal notranslate"><span class="pre">route_reflectors</span></code> — au moins une adresse IPv4, sans doublon. Un route reflector retiré de
|
||||
la liste est retiré de FRR au démarrage suivant.</p></li>
|
||||
</ul>
|
||||
<p>Le <code class="docutils literal notranslate"><span class="pre">router-id</span></code> n’est pas configurable : c’est l’adresse IPv4 primaire de
|
||||
<code class="docutils literal notranslate"><span class="pre">default_interface</span></code>, celle qui sert de VTEP.</p>
|
||||
<p>Le démarrage <strong>échoue</strong> si la section est incomplète, si <code class="docutils literal notranslate"><span class="pre">default_interface</span></code> n’a pas
|
||||
d’adresse IPv4 primaire, si <code class="docutils literal notranslate"><span class="pre">vtysh</span></code> refuse une commande, ou si FRR tourne déjà sous un autre
|
||||
AS : changer d”<code class="docutils literal notranslate"><span class="pre">asn</span></code> suppose de retirer l’ancienne instance à la main.</p>
|
||||
<div class="admonition warning">
|
||||
<p class="admonition-title">Avertissement</p>
|
||||
<p><code class="docutils literal notranslate"><span class="pre">/etc/frr/frr.conf</span></code> devient un fichier <strong>généré</strong> : <code class="docutils literal notranslate"><span class="pre">write</span> <span class="pre">memory</span></code> le réécrit à partir de
|
||||
la configuration en mémoire de FRR. Une modification faite dans le fichier sans être
|
||||
rechargée est perdue au prochain démarrage de l’agent.</p>
|
||||
</div>
|
||||
</section>
|
||||
<section id="metadata-et-qemu">
|
||||
<h2>Metadata et QEMU<a class="headerlink" href="#metadata-et-qemu" title="Lien vers cette rubrique">#</a></h2>
|
||||
<div class="highlight-yaml notranslate"><div class="highlight"><pre><span></span><span class="nt">metadata</span><span class="p">:</span>
|
||||
|
|
@ -613,6 +643,7 @@ l’autre.</p>
|
|||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#serveurs">Serveurs</a></li>
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#execution-des-commandes">Exécution des commandes</a></li>
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#correspondance-des-interfaces">Correspondance des interfaces</a></li>
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#plan-de-controle-bgp">Plan de contrôle BGP</a></li>
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#metadata-et-qemu">Metadata et QEMU</a></li>
|
||||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#backend-dhcp">Backend DHCP</a><ul class="nav section-nav flex-column">
|
||||
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#bascule-d-un-backend-a-l-autre">Bascule d’un backend à l’autre</a></li>
|
||||
|
|
|
|||
|
|
@ -400,6 +400,19 @@ toujours sur le système, et <strong>notifie les écarts sans jamais réparer</s
|
|||
</div>
|
||||
<p>Il contrôle notamment l’existence des network namespaces, des liens réseau des subnets, des taps
|
||||
de VM et la réponse des units systemd associées.</p>
|
||||
<p>Avec une section <code class="docutils literal notranslate"><span class="pre">bgp</span></code> dans la configuration, il contrôle aussi le plan de contrôle :</p>
|
||||
<ul class="simple">
|
||||
<li><p><strong>Sessions BGP</strong> : une notification par route reflector dont la session n’est pas
|
||||
<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>
|
||||
<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> —
|
||||
est signalée comme un <strong>trou noir</strong> : l’annonce attire du trafic que plus rien ne reçoit.</p></li>
|
||||
</ul>
|
||||
<p>Un VPC routé alors que la section <code class="docutils literal notranslate"><span class="pre">bgp</span></code> a disparu de la configuration est signalé lui aussi.</p>
|
||||
<div class="admonition note">
|
||||
<p class="admonition-title">Note</p>
|
||||
<p>Un écart persistant est signalé <strong>à chaque tick</strong>, sans déduplication. Le volume de
|
||||
|
|
|
|||
File diff suppressed because one or more lines are too long
Loading…
Add table
Add a link
Reference in a new issue