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 à 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 <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> 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 <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
pour les subnets créés après la bascule, et le paquet est nécessaire tant qu’un hyperviseur peut 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
revenir en arrière. Voir <a class="reference internal" href="../exploitation/configuration.html"><span class="doc">Configuration</span></a>.</p> 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 <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 <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 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"> <section id="backend-dhcp">
<h2>Backend DHCP<a class="headerlink" href="#backend-dhcp" title="Lien vers cette rubrique">#</a></h2> <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> <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> </pre></div>
</div> </div>
<p>Choisit qui sert le DHCP des subnets <strong>créés par cet agent</strong> :</p> <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> </tbody>
</table> </table>
</div> </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 <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
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> 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> : <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> 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 <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> <p><strong>Coexistence avec dnsmasq</strong></p>
<ul class="simple"> <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 <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 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>
comporte exactement comme avant</p></li>
<li><p>La bascule est une <strong>opération manuelle</strong> sur un hyperviseur vide — l’option ne migre rien, un <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> 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> <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 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> </pre></div>
</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, à <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
cinq exceptions près ; les quatre premières touchent les appelants de l’API :</p> près ; les quatre premières touchent les appelants de l’API :</p>
<ul class="simple"> <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 <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 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 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 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> 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> </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 <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 bridge) jusqu’à leur recréation. Les subnets <code class="docutils literal notranslate"><span class="pre">bridge</span></code> existants restent sans le confinement de