docs: build de c628e7072a
This commit is contained in:
parent
8bfeb602ce
commit
b20e16ee62
28 changed files with 289 additions and 180 deletions
|
|
@ -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"><tag></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"><branche></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"><branche>/</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"><profil></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"><bridge></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"><secondes></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-<id></span></code> y raccorde un veth
|
||||
<code class="docutils literal notranslate"><span class="pre">vp-<id>-e</span></code> côté host, dont l’autre extrémité <code class="docutils literal notranslate"><span class="pre">vp-<id>-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>
|
||||
|
|
|
|||
|
|
@ -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["br-sn000001<br/>10.1.1.254"]
|
||||
BR["br-000001<br/>10.1.1.253"]
|
||||
GW["gw-000001<br/>gateway 10.1.1.254"]
|
||||
MD["metadata@i-web<br/>169.254.169.254"]
|
||||
end
|
||||
VM["VM i-web<br/>10.1.1.2"] --- BR
|
||||
BR --- MD
|
||||
BR --- VXLAN["VXLAN vni 1<br/>br-000000"]
|
||||
</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["VXLAN vni 65537<br/>br-000000"]
|
||||
</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">"state":</span> <span class="pre">"running"</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">
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue