This commit is contained in:
forgejo-actions 2026-10-24 15:41:59 +00:00
commit 1fd9d8bae7
4 changed files with 17 additions and 11 deletions

View file

@ -451,9 +451,9 @@ démarrage, la racine étant en tmpfs. <code class="docutils literal notranslate
à la construction de l’image (<a class="reference internal" href="../deploiement/image-qcow2.html"><span class="doc">Construction de l’image qcow2</span></a>). Le service <code class="docutils literal notranslate"><span class="pre">dnsmasq</span></code> du système est ensuite désactivé et
<strong>masqué</strong> : il prendrait le port 53 en concurrence des instances <code class="docutils literal notranslate"><span class="pre">dnsmasq&#64;</span></code> que l’agent lance
dans les netns.</p>
<p><code class="docutils literal notranslate"><span class="pre">dnsmasq</span></code> reste installé même avec <code class="docutils literal notranslate"><span class="pre">dhcp.backend:</span> <span class="pre">two</span></code> : le backend intégré ne le remplace que
pour les subnets créés après la bascule, et le paquet est nécessaire tant qu’un hyperviseur peut
revenir en arrière. Voir <a class="reference internal" href="../exploitation/configuration.html"><span class="doc">Configuration</span></a>.</p>
<p><code class="docutils literal notranslate"><span class="pre">dnsmasq</span></code> reste installé bien que <code class="docutils literal notranslate"><span class="pre">dhcp.backend</span></code> vaille <code class="docutils literal notranslate"><span class="pre">two</span></code> par défaut : le paquet sert
aux hyperviseurs qui déclarent <code class="docutils literal notranslate"><span class="pre">dhcp.backend:</span> <span class="pre">dnsmasq</span></code>, et tant qu’un hyperviseur peut revenir
en arrière. Voir <a class="reference internal" href="../exploitation/configuration.html"><span class="doc">Configuration</span></a>.</p>
<p><strong>Noyau</strong> — chargement de <code class="docutils literal notranslate"><span class="pre">br_netfilter</span></code>, puis <code class="docutils literal notranslate"><span class="pre">net.ipv4.ip_forward</span> <span class="pre">=</span> <span class="pre">1</span></code> et
<code class="docutils literal notranslate"><span class="pre">net.bridge.bridge-nf-call-iptables</span> <span class="pre">=</span> <span class="pre">1</span></code>. Cette dernière clé est <strong>requise</strong> par la DNAT vers
le serveur de metadata : sans elle, iptables ne voit pas le trafic bridgé des VM et cloud-init

View file

@ -534,7 +534,7 @@ créée au démarrage et supprimée à l’arrêt.</p>
<section id="backend-dhcp">
<h2>Backend DHCP<a class="headerlink" href="#backend-dhcp" title="Lien vers cette rubrique">#</a></h2>
<div class="highlight-yaml notranslate"><div class="highlight"><pre><span></span><span class="nt">dhcp</span><span class="p">:</span>
<span class="w"> </span><span class="nt">backend</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">dnsmasq</span><span class="w"> </span><span class="c1"># ou two</span>
<span class="w"> </span><span class="nt">backend</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">two</span><span class="w"> </span><span class="c1"># ou dnsmasq</span>
</pre></div>
</div>
<p>Choisit qui sert le DHCP des subnets <strong>créés par cet agent</strong> :</p>
@ -562,8 +562,10 @@ créée au démarrage et supprimée à l’arrêt.</p>
</tbody>
</table>
</div>
<p>Le défaut est <code class="docutils literal notranslate"><span class="pre">dnsmasq</span></code> : un fichier de configuration de la 0.1.0, non modifié, se comporte
exactement comme avant. Toute autre valeur 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.</p>
<p>Le défaut est <code class="docutils literal notranslate"><span class="pre">two</span></code>. Un hyperviseur mis à jour depuis la 0.1.0 avec des subnets existants doit
déclarer <code class="docutils literal notranslate"><span class="pre">backend:</span> <span class="pre">dnsmasq</span></code> avant la mise à jour, ou être vidé puis basculé (voir plus bas) : ses
subnets restent servis par dnsmasq. Toute autre valeur 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.</p>
<p>Le répertoire d’exécution du backend <code class="docutils literal notranslate"><span class="pre">two</span></code> — <code class="docutils literal notranslate"><span class="pre">/run/two/dhcp</span></code> — <strong>n’est pas configurable</strong> :
le script d’enrobage le code en dur, une clé que lui ignorerait serait un mensonge.</p>
<p>Ce que le backend <code class="docutils literal notranslate"><span class="pre">two</span></code> apporte : la configuration DHCP devient modifiable par VM et non plus

File diff suppressed because one or more lines are too long

View file

@ -385,8 +385,7 @@ l’annoncer que sur une interface d’une VM multi-réseaux</p></li>
<p><strong>Coexistence avec dnsmasq</strong></p>
<ul class="simple">
<li><p>Nouvelle clé <code class="docutils literal notranslate"><span class="pre">dhcp.backend</span></code>, <code class="docutils literal notranslate"><span class="pre">dnsmasq</span></code> ou <code class="docutils literal notranslate"><span class="pre">two</span></code>, qui choisit le serveur des subnets <strong>créés par
cet agent</strong>. Le défaut est <code class="docutils literal notranslate"><span class="pre">dnsmasq</span></code> : un fichier de configuration de la 0.1.0, non modifié, se
comporte exactement comme avant</p></li>
cet agent</strong>. Le défaut est <code class="docutils literal notranslate"><span class="pre">two</span></code> (#85) ; <code class="docutils literal notranslate"><span class="pre">dnsmasq</span></code> reste disponible jusqu’à son retrait (#49)</p></li>
<li><p>La bascule est une <strong>opération manuelle</strong> sur un hyperviseur vide — l’option ne migre rien, un
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>
@ -562,8 +561,8 @@ 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>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, à
cinq exceptions près ; les quatre premières touchent les appelants de l’API :</p>
<p>Sans <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, à six exceptions
près ; les quatre premières touchent les appelants de l’API :</p>
<ul class="simple">
<li><p><strong><code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> ne se fournit plus pour un subnet <code class="docutils literal notranslate"><span class="pre">vxlan</span></code></strong> : il est refusé (400), l’agent le
calcule. Le retirer des appels de création, et ne plus placer de VM sur les deux dernières
@ -579,6 +578,11 @@ d’un <code class="docutils literal notranslate"><span class="pre">iface_type</
l’underlay à 9000, ou poser <code class="docutils literal notranslate"><span class="pre">network.allow_mtu_underlay_below_9000:</span> <span class="pre">true</span></code> — sous 1550, il faut
aussi abaisser <code class="docutils literal notranslate"><span class="pre">network.mtu_vm</span></code> avec <code class="docutils literal notranslate"><span class="pre">allow_mtu_vm_below_1500</span></code>. Les subnets existants gardent
leurs interfaces à 1500 jusqu’à leur recréation</p></li>
<li><p><strong>le DHCP passe par défaut au serveur intégré</strong> (<code class="docutils literal notranslate"><span class="pre">dhcp.backend:</span> <span class="pre">two</span></code>) : sur un hyperviseur qui a
déjà des subnets, ajouter <code class="docutils literal notranslate"><span class="pre">dhcp.backend:</span> <span class="pre">dnsmasq</span></code> à <code class="docutils literal notranslate"><span class="pre">/etc/two/agent.yml</span></code> <strong>avant</strong>
<code class="docutils literal notranslate"><span class="pre">deploy.sh</span> <span class="pre">-t</span> <span class="pre">0.2.0</span></code>. Sinon ses subnets restent servis par dnsmasq pendant que l’agent s’adresse
au serveur intégré : les VM existantes continuent, les nouvelles n’obtiennent pas d’adresse.
Un hyperviseur vide n’a rien à faire</p></li>
</ul>
<p>Les subnets <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> existants gardent leur adressage et le modèle précédent (gateway sur le
bridge) jusqu’à leur recréation. Les subnets <code class="docutils literal notranslate"><span class="pre">bridge</span></code> existants restent sans le confinement de