This commit is contained in:
forgejo-actions 2026-10-26 22:29:20 +00:00
commit 567a7d6dc9
38 changed files with 1165 additions and 34 deletions

View file

@ -233,6 +233,7 @@
<li class="toctree-l2"><a class="reference internal" href="../concepts/modes-reseau.html">Modes réseau</a></li>
<li class="toctree-l2"><a class="reference internal" href="../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
<li class="toctree-l2"><a class="reference internal" href="../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
<li class="toctree-l2"><a class="reference internal" href="../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
</ul>
</details></li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../architecture/index.html">Architecture</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
@ -345,6 +346,7 @@
<ul class="visible nav section-nav flex-column">
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#dnsmasq">dnsmasq</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#serveur-dhcp-integre">Serveur DHCP intégré</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#relais-dns-et-ntp">Relais DNS et NTP</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#qemu-n-est-pas-une-unit">QEMU n’est pas une unit</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#sockets-par-vm">Sockets par VM</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#arret-de-l-agent">Arrêt de l’agent</a></li>
@ -362,7 +364,7 @@
<section id="services-systemd">
<h1>Services systemd<a class="headerlink" href="#services-systemd" title="Lien vers cette rubrique">#</a></h1>
<p>Quatre units, installées dans <code class="docutils literal notranslate"><span class="pre">/etc/systemd/system</span></code> par <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code> ; les binaires et scripts
<p>Cinq units, installées dans <code class="docutils literal notranslate"><span class="pre">/etc/systemd/system</span></code> par <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code> ; les binaires et scripts
qu’elles lancent sont sous <code class="docutils literal notranslate"><span class="pre">/opt/two/bin</span></code>. Les deux units DHCP
s’excluent : celle qui tourne dépend de <code class="docutils literal notranslate"><span class="pre">dhcp.backend</span></code> (voir <a class="reference internal" href="configuration.html"><span class="doc">Configuration</span></a>).</p>
<div class="pst-scrollable-table-container"><table class="table">
@ -394,6 +396,11 @@ s’excluent : celle qui tourne dépend de <code class="docutils literal notrans
<td><p><code class="docutils literal notranslate"><span class="pre">&lt;nom</span> <span class="pre">de</span> <span class="pre">la</span> <span class="pre">VM&gt;</span></code></p></td>
<td><p>serveur de metadata cloud-init, un par VM</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">two-hostsvc.service</span></code></p></td>
<td><p>—</p></td>
<td><p>relais DNS et NTP des VM, un par hyperviseur, démarré avant l’agent (voir
<a class="reference internal" href="../concepts/dns-ntp.html"><span class="doc">DNS et NTP des VM</span></a>)</p></td>
</tr>
</tbody>
</table>
</div>
@ -403,6 +410,7 @@ n’y a pas à les démarrer à la main en fonctionnement normal.</p>
systemctl<span class="w"> </span>status<span class="w"> </span><span class="s1">'dnsmasq@vp-admin_br-000001'</span><span class="w"> </span><span class="c1"># backend dnsmasq</span>
systemctl<span class="w"> </span>status<span class="w"> </span><span class="s1">'dhcp@vp-admin_br-000001'</span><span class="w"> </span><span class="c1"># backend two</span>
systemctl<span class="w"> </span>status<span class="w"> </span><span class="s1">'metadata@i-web'</span>
systemctl<span class="w"> </span>status<span class="w"> </span>two-hostsvc
</pre></div>
</div>
<section id="dnsmasq">
@ -475,6 +483,33 @@ socket UDP. À la suppression du subnet, l’agent retire aussi la socket, pour
processus serait mort sans nettoyer (<code class="docutils literal notranslate"><span class="pre">SIGKILL</span></code>, plantage).</p>
<p>Diagnostic : voir <a class="reference internal" href="diagnostic.html"><span class="doc">Diagnostic</span></a>, qui montre comment interroger la socket.</p>
</section>
<section id="relais-dns-et-ntp">
<h2>Relais DNS et NTP<a class="headerlink" href="#relais-dns-et-ntp" title="Lien vers cette rubrique">#</a></h2>
<p><code class="docutils literal notranslate"><span class="pre">two-hostsvc.service</span></code> lance <code class="docutils literal notranslate"><span class="pre">/opt/two/bin/two-hostsvc</span></code>, un seul processus par hyperviseur,
qui sert DNS et NTP aux VM de tous les VPC (voir <a class="reference internal" href="../concepts/dns-ntp.html"><span class="doc">DNS et NTP des VM</span></a>). Il lit la section
<code class="docutils literal notranslate"><span class="pre">hostsvc</span></code> de <code class="docutils literal notranslate"><span class="pre">/etc/two/agent.yml</span></code> (voir <a class="reference internal" href="configuration.html"><span class="doc">Configuration</span></a>).</p>
<div class="pst-scrollable-table-container"><table class="table">
<colgroup>
<col style="width: 40.0%" />
<col style="width: 60.0%" />
</colgroup>
<tbody>
<tr class="row-odd"><td><p>Socket de contrôle</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">/run/two/hostsvc/hostsvc.sock</span></code></p></td>
</tr>
<tr class="row-even"><td><p>État</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">/run/two/hostsvc/hostsvc.state</span></code> (VPC servis)</p></td>
</tr>
<tr class="row-odd"><td><p>Journal</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">journalctl</span> <span class="pre">-u</span> <span class="pre">two-hostsvc</span></code></p></td>
</tr>
</tbody>
</table>
</div>
<p>L’unit démarre avant <code class="docutils literal notranslate"><span class="pre">agent.service</span></code> et se relance en cas d’échec. Son répertoire
<code class="docutils literal notranslate"><span class="pre">/run/two/hostsvc</span></code> survit à un redémarrage du service : le processus y relit la liste des VPC
servis et rouvre leurs sockets. Un VPC ne peut pas être créé tant que le service ne répond pas.</p>
</section>
<section id="qemu-n-est-pas-une-unit">
<h2>QEMU n’est pas une unit<a class="headerlink" href="#qemu-n-est-pas-une-unit" title="Lien vers cette rubrique">#</a></h2>
<p>Les processus QEMU sont lancés par <code class="docutils literal notranslate"><span class="pre">systemd-run</span> <span class="pre">--scope</span></code>, <strong>jamais</strong> en unit transitoire. Un
@ -563,6 +598,7 @@ les services à la main avant de lancer le script fait perdre cette liste.</p>
<ul class="visible nav section-nav flex-column">
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#dnsmasq">dnsmasq</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#serveur-dhcp-integre">Serveur DHCP intégré</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#relais-dns-et-ntp">Relais DNS et NTP</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#qemu-n-est-pas-une-unit">QEMU n’est pas une unit</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#sockets-par-vm">Sockets par VM</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#arret-de-l-agent">Arrêt de l’agent</a></li>