This commit is contained in:
forgejo-actions 2026-10-24 14:45:23 +00:00
commit b20e16ee62
28 changed files with 289 additions and 180 deletions

View file

@ -393,11 +393,13 @@ depuis la release, et les vérifie contre le manifeste <code class="docutils lit
<tbody>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">-t</span> <span class="pre">&lt;tag&gt;</span></code></p></td>
<td><p>déployer une release donnée</p></td>
<td><p>dernière</p></td>
<td><p>dernière publiée, <strong>préversions comprises</strong></p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">-b</span> <span class="pre">&lt;branche&gt;</span></code></p></td>
<td><p>branche utilisée pour l’auto-mise à jour du script</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">main</span></code></p></td>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">-b</span> <span class="pre">&lt;branche&gt;/</span></code></p></td>
<td><p>branche d’où viennent l’auto-mise à jour du script et les scripts de <code class="docutils literal notranslate"><span class="pre">-i</span></code> ; les
binaires viennent toujours d’une release. Le <code class="docutils literal notranslate"><span class="pre">/</span></code> final est <strong>obligatoire</strong> : l’URL est
concaténée sans séparateur (<code class="docutils literal notranslate"><span class="pre">-b</span> <span class="pre">dev</span></code> donne <code class="docutils literal notranslate"><span class="pre">…/branch/devscripts/…</span></code>)</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">main/</span></code></p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">-p</span> <span class="pre">&lt;profil&gt;</span></code></p></td>
<td><p>profil d’host ; seul <code class="docutils literal notranslate"><span class="pre">kvm</span></code> installe les units de l’agent</p></td>
@ -416,7 +418,8 @@ depuis la release, et les vérifie contre le manifeste <code class="docutils lit
<td><p><code class="docutils literal notranslate"><span class="pre">br-000000</span></code></p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">-P</span> <span class="pre">&lt;bridge&gt;</span></code></p></td>
<td><p>bridge supplémentaire, créé vide et réservé</p></td>
<td><p>bridge supplémentaire, créé vide et réservé ; garder <code class="docutils literal notranslate"><span class="pre">br-public</span></code>, nom attendu par
l’agent (voir ci-dessous)</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">br-public</span></code></p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">-R</span> <span class="pre">&lt;secondes&gt;</span></code></p></td>
@ -457,6 +460,9 @@ le serveur de metadata : sans elle, iptables ne voit pas le trafic bridgé des V
ne se provisionne pas. Contrepartie assumée : tout le trafic inter-VM traverse les tables NAT.</p>
<p><strong>Réseau</strong> — création du bridge réservé, puis rattachement de l’uplink au bridge principal,
l’adresse et la route par défaut étant déplacées de l’interface physique vers le bridge.</p>
<p>Le nom <code class="docutils literal notranslate"><span class="pre">br-public</span></code> est <strong>en dur dans l’agent</strong> : chaque VPC <code class="docutils literal notranslate"><span class="pre">vp-&lt;id&gt;</span></code> y raccorde un veth
<code class="docutils literal notranslate"><span class="pre">vp-&lt;id&gt;-e</span></code> côté host, dont l’autre extrémité <code class="docutils literal notranslate"><span class="pre">vp-&lt;id&gt;-i</span></code> rejoint un <code class="docutils literal notranslate"><span class="pre">br-public</span></code> créé dans
le netns du VPC. Avec un autre nom passé à <code class="docutils literal notranslate"><span class="pre">-P</span></code>, toute création de VPC échoue.</p>
<div class="admonition danger">
<p class="admonition-title">Danger</p>
<p>La migration réseau <strong>coupe le réseau de l’host si elle échoue à mi-parcours</strong>, sans console
@ -498,7 +504,8 @@ mécanisme normal, pas une réparation.</p>
<td><p><code class="docutils literal notranslate"><span class="pre">-conf</span></code></p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">db</span></code></p></td>
<td><p>inspection de la base clé-valeur en ligne de commande</p></td>
<td><p>inspection de la base clé-valeur en ligne de commande ; <strong>ni publié ni déployé</strong> par
<code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code>, à compiler depuis les sources (<a class="reference internal" href="../exploitation/observabilite.html"><span class="doc">Observabilité</span></a>)</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">-conf</span></code></p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">dhcp</span></code></p></td>
@ -509,7 +516,7 @@ avec <code class="docutils literal notranslate"><span class="pre">dhcp.backend:<
</tbody>
</table>
</div>
<p>Les quatre partagent le même fichier, <code class="docutils literal notranslate"><span class="pre">/etc/two/agent.yml</span></code> — voir
<p>Les quatre lisent le même fichier, <code class="docutils literal notranslate"><span class="pre">/etc/two/agent.yml</span></code> — voir
<a class="reference internal" href="../exploitation/configuration.html"><span class="doc">Configuration</span></a>. <code class="docutils literal notranslate"><span class="pre">dhcp</span></code> reçoit en plus son bridge et ses deux chemins de
fichiers en paramètres, posés par son script d’enrobage.</p>
</section>

View file

@ -806,15 +806,18 @@ plan de contrôle du cluster en place, cf. <a class="reference internal" href=".
<pre class="mermaid">
graph LR
subgraph netns vp-admin
BR[&quot;br-sn000001&lt;br/&gt;10.1.1.254&quot;]
BR[&quot;br-000001&lt;br/&gt;10.1.1.253&quot;]
GW[&quot;gw-000001&lt;br/&gt;gateway 10.1.1.254&quot;]
MD[&quot;metadata&#64;i-web&lt;br/&gt;169.254.169.254&quot;]
end
VM[&quot;VM i-web&lt;br/&gt;10.1.1.2&quot;] --- BR
BR --- MD
BR --- VXLAN[&quot;VXLAN vni 1&lt;br/&gt;br-000000&quot;]
</pre><p>Le VPC est un network namespace ; le subnet y pose un bridge porteur de la gateway ; la VM s’y
raccroche par un tap, reçoit son adresse en DHCP et son cloud-init depuis le serveur de metadata
du netns.</p>
BR --- GW
GW --- MD
BR --- VXLAN[&quot;VXLAN vni 65537&lt;br/&gt;br-000000&quot;]
</pre><p>Le VPC est un network namespace ; le subnet y pose un bridge <code class="docutils literal notranslate"><span class="pre">br-000001</span></code> — <code class="docutils literal notranslate"><span class="pre">br-</span></code> suivi de ce
qui suit le premier tiret du nom du subnet — porteur de l’adresse d’émission, et un macvlan
<code class="docutils literal notranslate"><span class="pre">gw-000001</span></code> porteur de la gateway ; la VM se raccroche au bridge par un tap, reçoit son
adresse en DHCP et son cloud-init depuis le serveur de metadata du netns.</p>
</section>
<section id="le-vpc">
<h2>1. Le VPC<a class="headerlink" href="#le-vpc" title="Lien vers cette rubrique">#</a></h2>
@ -829,8 +832,10 @@ route interne, quel que soit le mode du subnet.</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>curl<span class="w"> </span>-s<span class="w"> </span>http://127.0.0.1:8080/vpcs/vp-admin
</pre></div>
</div>
<p>Attendez <code class="docutils literal notranslate"><span class="pre">&quot;state&quot;:</span> <span class="pre">&quot;running&quot;</span></code> avant l’étape suivante — un subnet dont le VPC parent n’est pas
prêt est refusé en <strong>422</strong>. Le modèle d’attente est décrit dans <a class="reference internal" href="../exploitation/api-agent/asynchronisme.html"><span class="doc">Modèle asynchrone et codes de retour</span></a>.</p>
<p>Un subnet peut être demandé dès maintenant : il est accepté tant que le VPC est en <code class="docutils literal notranslate"><span class="pre">creating</span></code>
ou <code class="docutils literal notranslate"><span class="pre">running</span></code>, et sa création attend que le VPC soit <code class="docutils literal notranslate"><span class="pre">running</span></code>, dans la limite de
<code class="docutils literal notranslate"><span class="pre">dispatcher.timeout_seconds</span></code>. Il n’est refusé en <strong>422</strong> que si le VPC est absent, en <code class="docutils literal notranslate"><span class="pre">error</span></code>
ou en <code class="docutils literal notranslate"><span class="pre">deleting</span></code>. Le modèle d’attente est décrit dans <a class="reference internal" href="../exploitation/api-agent/asynchronisme.html"><span class="doc">Modèle asynchrone et codes de retour</span></a>.</p>
</section>
<section id="le-subnet">
<h2>2. Le subnet<a class="headerlink" href="#le-subnet" title="Lien vers cette rubrique">#</a></h2>
@ -839,7 +844,7 @@ prêt est refusé en <strong>422</strong>. Le modèle d’attente est décrit da
<span class="w"> </span>-d<span class="w"> </span><span class="s1">'{"name": "sn-000001",</span>
<span class="s1"> "vpc": "vp-admin",</span>
<span class="s1"> "mode": "vxlan",</span>
<span class="s1"> "vxlan_id": 1,</span>
<span class="s1"> "vxlan_id": 65537,</span>
<span class="s1"> "iface_type": "vms",</span>
<span class="s1"> "cidr": "10.1.0.0/23"}'</span>
</pre></div>
@ -910,14 +915,14 @@ cloud-init, lui, se déroule dans le guest ; on l’observe par la console séri
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>socat<span class="w"> </span>-,raw,echo<span class="o">=</span><span class="m">0</span><span class="w"> </span>UNIX-CONNECT:/run/two/vms/serial/i-web.sock
</pre></div>
</div>
<p>Puis, depuis l’host :</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>ssh<span class="w"> </span>syonad@10.1.1.2
<p>Puis, depuis l’host, en passant par le netns du VPC :</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>ip<span class="w"> </span>netns<span class="w"> </span><span class="nb">exec</span><span class="w"> </span>vp-admin<span class="w"> </span>ssh<span class="w"> </span>syonad@10.1.1.2
</pre></div>
</div>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>En mode <code class="docutils literal notranslate"><span class="pre">vxlan</span></code>, la VM vit dans le netns du VPC : elle n’est pas joignable depuis l’host
sans route explicite. En mode <code class="docutils literal notranslate"><span class="pre">bridge</span></code>, elle l’est directement.</p>
sans route explicite, d’où le <code class="docutils literal notranslate"><span class="pre">ip</span> <span class="pre">netns</span> <span class="pre">exec</span></code>. En mode <code class="docutils literal notranslate"><span class="pre">bridge</span></code>, elle l’est directement.</p>
</div>
</section>
<section id="supprimer">