docs: build de c628e7072a
This commit is contained in:
parent
8bfeb602ce
commit
b20e16ee62
28 changed files with 289 additions and 180 deletions
|
|
@ -801,7 +801,6 @@ window.runMermaid = runMermaid;</script>
|
|||
creating --> running
|
||||
creating --> error
|
||||
running --> deleting
|
||||
running --> error
|
||||
deleting --> deleted
|
||||
deleting --> error
|
||||
error --> deleting
|
||||
|
|
@ -824,7 +823,9 @@ window.runMermaid = runMermaid;</script>
|
|||
<td><p>la ressource existe sur le système</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">error</span></code></p></td>
|
||||
<td><p><code class="docutils literal notranslate"><span class="pre">Execute</span></code> a échoué ; état <strong>terminal</strong>, il n’y a pas de reprise automatique</p></td>
|
||||
<td><p><code class="docutils literal notranslate"><span class="pre">Execute</span></code> a échoué, ou la migration du démarrage a trouvé la ressource en <code class="docutils literal notranslate"><span class="pre">creating</span></code> ou
|
||||
<code class="docutils literal notranslate"><span class="pre">deleting</span></code> ; état <strong>terminal</strong>, il n’y a pas de reprise automatique. Une ressource
|
||||
<code class="docutils literal notranslate"><span class="pre">running</span></code> ne passe jamais en <code class="docutils literal notranslate"><span class="pre">error</span></code></p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">deleting</span></code></p></td>
|
||||
<td><p>suppression en cours</p></td>
|
||||
|
|
|
|||
|
|
@ -811,14 +811,14 @@ deux processus ne doivent pas partager une même instance.</p>
|
|||
</section>
|
||||
<section id="documents-servis">
|
||||
<h2>Documents servis<a class="headerlink" href="#documents-servis" title="Lien vers cette rubrique">#</a></h2>
|
||||
<p>Chaque document suit la même règle :</p>
|
||||
<p>Quatre documents sont servis : <code class="docutils literal notranslate"><span class="pre">meta-data</span></code>, <code class="docutils literal notranslate"><span class="pre">user-data</span></code>, <code class="docutils literal notranslate"><span class="pre">network-config</span></code> et
|
||||
<code class="docutils literal notranslate"><span class="pre">vendor-data</span></code>. Seul <code class="docutils literal notranslate"><span class="pre">user-data</span></code> vient de l’appelant :</p>
|
||||
<ul class="simple">
|
||||
<li><p>fourni par l’appelant → servi <strong>verbatim</strong>, l’agent n’interprète rien ;</p></li>
|
||||
<li><p>absent → le template par défaut est rendu ;</p></li>
|
||||
<li><p>fourni <strong>vide</strong> → servi vide.</p></li>
|
||||
<li><p><code class="docutils literal notranslate"><span class="pre">user_data</span></code> fourni → servi <strong>verbatim</strong>, après décodage base64 ; l’agent n’interprète rien ;</p></li>
|
||||
<li><p><code class="docutils literal notranslate"><span class="pre">user_data</span></code> absent ou <strong>vide</strong> → <code class="docutils literal notranslate"><span class="pre">user-data</span></code> servi vide : les deux cas sont équivalents.</p></li>
|
||||
</ul>
|
||||
<p>Les deux derniers cas sont distincts, et c’est délibéré : fournir une chaîne vide est une façon
|
||||
explicite de neutraliser un document.</p>
|
||||
<p><code class="docutils literal notranslate"><span class="pre">meta-data</span></code>, <code class="docutils literal notranslate"><span class="pre">network-config</span></code> et <code class="docutils literal notranslate"><span class="pre">vendor-data</span></code> sont <strong>toujours</strong> rendus depuis les templates
|
||||
de l’agent ; <code class="docutils literal notranslate"><span class="pre">vendor-data</span></code> crée le compte <code class="docutils literal notranslate"><span class="pre">syonad</span></code> à partir de <code class="docutils literal notranslate"><span class="pre">password</span></code> et <code class="docutils literal notranslate"><span class="pre">sshkey</span></code>.</p>
|
||||
</section>
|
||||
<section id="champs-de-metadata">
|
||||
<h2>Champs de <code class="docutils literal notranslate"><span class="pre">metadata</span></code><a class="headerlink" href="#champs-de-metadata" title="Lien vers cette rubrique">#</a></h2>
|
||||
|
|
@ -874,11 +874,15 @@ NoCloud en <code class="docutils literal notranslate"><span class="pre">seedfrom
|
|||
<li><p>cloud-init 22.4 (Debian 12) ne demande jamais <code class="docutils literal notranslate"><span class="pre">network-config</span></code> par <code class="docutils literal notranslate"><span class="pre">seedfrom</span></code> et
|
||||
applique sa configuration de repli, limitée à la première interface ;</p></li>
|
||||
<li><p>cloud-init 25.1 (Debian 13) le lit et l’applique au premier démarrage, mais à chaque
|
||||
démarrage suivant l’étape locale réapplique le repli, et <code class="docutils literal notranslate"><span class="pre">network-config</span></code> n’est pas
|
||||
relu : les interfaces secondaires perdent leur configuration.</p></li>
|
||||
démarrage suivant l’étape locale réapplique le repli. L’étape réseau, qui trouve la
|
||||
source, émet alors l’événement <code class="docutils literal notranslate"><span class="pre">boot-legacy</span></code> : refusé par défaut, il est autorisé par
|
||||
<code class="docutils literal notranslate"><span class="pre">updates:</span> <span class="pre">network:</span> <span class="pre">when:</span> <span class="pre">[boot-new-instance,</span> <span class="pre">boot,</span> <span class="pre">boot-legacy]</span></code>, et <code class="docutils literal notranslate"><span class="pre">network-config</span></code>
|
||||
est alors réappliqué à chaque démarrage. Sans ce réglage, les interfaces secondaires
|
||||
perdent leur configuration.</p></li>
|
||||
</ul>
|
||||
<p>L’image doit donc faire du DHCP IPv4 sur <strong>toutes</strong> ses interfaces Ethernet, sans compter
|
||||
sur cloud-init. Voir <a class="reference internal" href="../deploiement/image-qcow2.html"><span class="doc">Construction de l’image qcow2</span></a>.</p>
|
||||
sur cloud-init, et autoriser <code class="docutils literal notranslate"><span class="pre">boot-legacy</span></code> pour que le <code class="docutils literal notranslate"><span class="pre">network-config</span></code> reste appliqué
|
||||
là où cloud-init le lit. Voir <a class="reference internal" href="../deploiement/image-qcow2.html"><span class="doc">Construction de l’image qcow2</span></a>.</p>
|
||||
</div>
|
||||
</section>
|
||||
<section id="securite">
|
||||
|
|
|
|||
|
|
@ -950,11 +950,12 @@ netns relève de #61.</p>
|
|||
<section id="routes-annoncees-aux-vm">
|
||||
<h2>Routes annoncées aux VM<a class="headerlink" href="#routes-annoncees-aux-vm" title="Lien vers cette rubrique">#</a></h2>
|
||||
<p>Les routes sont poussées par DHCP, dans l”<strong>option 121</strong> (routes statiques sans classe,
|
||||
RFC 3442). Trois entrées y figurent :</p>
|
||||
RFC 3442). Trois entrées au plus y figurent :</p>
|
||||
<ol class="arabic simple">
|
||||
<li><p>la route <code class="docutils literal notranslate"><span class="pre">/32</span></code> vers <code class="docutils literal notranslate"><span class="pre">169.254.169.254</span></code>, le serveur de metadata ;</p></li>
|
||||
<li><p>la route vers le CIDR du VPC ;</p></li>
|
||||
<li><p>la route par défaut <code class="docutils literal notranslate"><span class="pre">0.0.0.0/0</span></code>.</p></li>
|
||||
<li><p>la route vers le CIDR du VPC, <strong>sauf en mode</strong> <code class="docutils literal notranslate"><span class="pre">bridge</span></code> ;</p></li>
|
||||
<li><p>la route par défaut <code class="docutils literal notranslate"><span class="pre">0.0.0.0/0</span></code>, <strong>sur l’interface</strong> <code class="docutils literal notranslate"><span class="pre">primary</span></code> <strong>seulement</strong> : les autres
|
||||
interfaces d’une VM n’en reçoivent pas.</p></li>
|
||||
</ol>
|
||||
<div class="admonition important">
|
||||
<p class="admonition-title">Important</p>
|
||||
|
|
@ -964,8 +965,8 @@ dans l’option 121 ; l’option 3 ne sert que les clients qui n’implémentent
|
|||
</section>
|
||||
<section id="route-par-defaut-default-route-et-gateway">
|
||||
<h2>Route par défaut : <code class="docutils literal notranslate"><span class="pre">default_route</span></code> et <code class="docutils literal notranslate"><span class="pre">gateway</span></code><a class="headerlink" href="#route-par-defaut-default-route-et-gateway" title="Lien vers cette rubrique">#</a></h2>
|
||||
<p>Une route par défaut est <strong>toujours</strong> annoncée. Le champ <code class="docutils literal notranslate"><span class="pre">default_route</span></code> ne choisit que son
|
||||
next-hop :</p>
|
||||
<p>Une route par défaut est <strong>toujours</strong> annoncée à l’interface <code class="docutils literal notranslate"><span class="pre">primary</span></code> d’une VM, et à elle
|
||||
seule. Le champ <code class="docutils literal notranslate"><span class="pre">default_route</span></code> ne choisit que son next-hop :</p>
|
||||
<dl class="simple">
|
||||
<dt><code class="docutils literal notranslate"><span class="pre">default_route:</span> <span class="pre">false</span></code> (défaut)</dt><dd><p>next-hop = <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> du subnet, la gateway calculée en <code class="docutils literal notranslate"><span class="pre">vxlan</span></code>.</p>
|
||||
</dd>
|
||||
|
|
@ -977,7 +978,7 @@ de l’host.</p>
|
|||
subnet relèvent de l’appelant. Fourni avec <code class="docutils literal notranslate"><span class="pre">default_route:</span> <span class="pre">false</span></code>, il est ignoré.</p>
|
||||
<p>Dans tous les modes sauf <code class="docutils literal notranslate"><span class="pre">bridge</span></code>, la route vers le CIDR du VPC garde <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> comme
|
||||
next-hop : sur un subnet à IP publique, le trafic interne ne doit pas sortir par la gateway
|
||||
publique.</p>
|
||||
publique. En mode <code class="docutils literal notranslate"><span class="pre">bridge</span></code>, cette route n’est pas annoncée du tout.</p>
|
||||
</section>
|
||||
<section id="pourquoi-la-route-32-vers-le-serveur-de-metadata-est-indispensable">
|
||||
<h2>Pourquoi la route <code class="docutils literal notranslate"><span class="pre">/32</span></code> vers le serveur de metadata est indispensable<a class="headerlink" href="#pourquoi-la-route-32-vers-le-serveur-de-metadata-est-indispensable" title="Lien vers cette rubrique">#</a></h2>
|
||||
|
|
|
|||
|
|
@ -811,6 +811,11 @@ window.runMermaid = runMermaid;</script>
|
|||
<h2>VPC<a class="headerlink" href="#vpc" title="Lien vers cette rubrique">#</a></h2>
|
||||
<p>Un VPC est un <strong>network namespace</strong> portant un espace d’adressage (<code class="docutils literal notranslate"><span class="pre">cidr</span></code>). C’est l’unité
|
||||
d’isolation : deux VPC ne se voient pas, et peuvent réutiliser les mêmes plages d’adresses.</p>
|
||||
<p>À la création, l’agent relie le netns au bridge <code class="docutils literal notranslate"><span class="pre">br-public</span></code> de l’host par un veth
|
||||
<code class="docutils literal notranslate"><span class="pre">vp-<id>-e</span></code> (côté host) ↔ <code class="docutils literal notranslate"><span class="pre">vp-<id>-i</span></code> (côté netns, rattaché à un <code class="docutils literal notranslate"><span class="pre">br-public</span></code> propre au
|
||||
netns). Ce nom de bridge est <strong>en dur</strong> : l’host doit porter un bridge <code class="docutils literal notranslate"><span class="pre">br-public</span></code>, celui que
|
||||
crée <code class="docutils literal notranslate"><span class="pre">deploy.sh</span> <span class="pre">-i</span></code> avec la valeur par défaut de <code class="docutils literal notranslate"><span class="pre">-P</span></code> (<a class="reference internal" href="../demarrage/installation.html"><span class="doc">Installation d’un hyperviseur</span></a>) ;
|
||||
sans lui, toute création de VPC échoue.</p>
|
||||
<p>Un VPC ne peut être supprimé que si tous ses subnets le sont déjà — sinon 409.</p>
|
||||
<section id="routage-entre-hyperviseurs-l3vni">
|
||||
<h3>Routage entre hyperviseurs : <code class="docutils literal notranslate"><span class="pre">l3vni</span></code><a class="headerlink" href="#routage-entre-hyperviseurs-l3vni" title="Lien vers cette rubrique">#</a></h3>
|
||||
|
|
@ -888,9 +893,12 @@ depuis le subnet, leur source canonique. Le schéma complet des clés est dans
|
|||
</section>
|
||||
<section id="nommage">
|
||||
<h2>Nommage<a class="headerlink" href="#nommage" title="Lien vers cette rubrique">#</a></h2>
|
||||
<p>L’API est machine-to-machine : elle <strong>ne valide pas</strong> les conventions de nommage, à l’exception
|
||||
du motif documenté pour les VPC (<code class="docutils literal notranslate"><span class="pre">vp-…</span></code>). Les exemples de cette documentation suivent la
|
||||
convention <code class="docutils literal notranslate"><span class="pre">vp-</span></code> / <code class="docutils literal notranslate"><span class="pre">sn-</span></code> / <code class="docutils literal notranslate"><span class="pre">i-</span></code>, mais c’est à l’appelant de la faire respecter.</p>
|
||||
<p>L’API est machine-to-machine : elle <strong>ne valide aucun nommage</strong>, pas même le motif <code class="docutils literal notranslate"><span class="pre">vp-…</span></code>
|
||||
indiqué par la spécification pour les VPC. Une contrainte est pourtant réelle : le nom d’un VPC
|
||||
ou d’un subnet doit <strong>contenir un « - »</strong>, car l’identifiant système (<code class="docutils literal notranslate"><span class="pre">vp-<id>-e</span></code>, <code class="docutils literal notranslate"><span class="pre">br-<id></span></code>,
|
||||
<code class="docutils literal notranslate"><span class="pre">gw-<id></span></code>…) est ce qui suit le premier tiret. Un nom sans tiret fait paniquer l’agent. Les
|
||||
exemples de cette documentation suivent la convention <code class="docutils literal notranslate"><span class="pre">vp-</span></code> / <code class="docutils literal notranslate"><span class="pre">sn-</span></code> / <code class="docutils literal notranslate"><span class="pre">i-</span></code>, mais c’est à
|
||||
l’appelant de la faire respecter.</p>
|
||||
</section>
|
||||
</section>
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue