two/main/versions/0.2.0.html
2026-10-26 22:29:20 +00:00

720 lines
No EOL
52 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html lang="fr" data-content_root="../" >
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Bael &#8212; Documentation two 0.2.0</title>
<script data-cfasync="false">
document.documentElement.dataset.mode = localStorage.getItem("mode") || "";
document.documentElement.dataset.theme = localStorage.getItem("theme") || "";
</script>
<!--
this give us a css class that will be invisible only if js is disabled
-->
<noscript>
<style>
.pst-js-only { display: none !important; }
</style>
</noscript>
<!-- Loaded before other Sphinx assets -->
<link href="../_static/styles/theme.css?digest=8878045cc6db502f8baf" rel="stylesheet" />
<link href="../_static/styles/pydata-sphinx-theme.css?digest=8878045cc6db502f8baf" rel="stylesheet" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=8f2a1f02" />
<link rel="stylesheet" type="text/css" href="../_static/styles/sphinx-book-theme.css?v=3c74b3bc" />
<!-- So that users can add custom icons -->
<script src="../_static/scripts/fontawesome.js?digest=8878045cc6db502f8baf"></script>
<!-- Pre-loaded scripts that we'll load fully later -->
<link rel="preload" as="script" href="../_static/scripts/bootstrap.js?digest=8878045cc6db502f8baf" />
<link rel="preload" as="script" href="../_static/scripts/pydata-sphinx-theme.js?digest=8878045cc6db502f8baf" />
<script src="../_static/documentation_options.js?v=7788c55d"></script>
<script src="../_static/doctools.js?v=fd6eb6e6"></script>
<script src="../_static/sphinx_highlight.js?v=6ffebe34"></script>
<script src="../_static/scripts/sphinx-book-theme.js?v=fab101a9"></script>
<script src="../_static/translations.js?v=e6b791cb"></script>
<script>DOCUMENTATION_OPTIONS.pagename = 'versions/0.2.0';</script>
<script>
DOCUMENTATION_OPTIONS.theme_version = '0.16.1';
DOCUMENTATION_OPTIONS.theme_switcher_json_url = '../switcher.json';
DOCUMENTATION_OPTIONS.theme_switcher_version_match = 'main';
DOCUMENTATION_OPTIONS.show_version_warning_banner =
false;
</script>
<script src="../_static/version-switcher.js?v=bb617709"></script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Recherche" href="../search.html" />
<link rel="next" title="Michael" href="0.1.0.html" />
<link rel="prev" title="Versions" href="index.html" />
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<meta name="docsearch:language" content="fr"/>
<meta name="docsearch:version" content="0.2" />
</head>
<body data-bs-spy="scroll" data-bs-target=".bd-toc-nav" data-offset="180" data-bs-root-margin="0px 0px -60%" data-default-mode="">
<div id="pst-skip-link" class="skip-link d-print-none"><a href="#main-content">Passer au contenu principal</a></div>
<div id="pst-scroll-pixel-helper"></div>
<button type="button" class="btn rounded-pill" id="pst-back-to-top">
<i class="fa-solid fa-arrow-up"></i>Haut de page</button>
<dialog id="pst-search-dialog">
<form class="bd-search d-flex align-items-center"
action="../search.html"
method="get">
<i class="fa-solid fa-magnifying-glass"></i>
<input type="search"
class="form-control"
name="q"
placeholder="Search..."
aria-label="Search..."
autocomplete="off"
autocorrect="off"
autocapitalize="off"
spellcheck="false"/>
<span class="search-button__kbd-shortcut"><kbd class="kbd-shortcut__modifier">Ctrl</kbd>+<kbd>K</kbd></span>
</form>
</dialog>
<div class="pst-async-banner-revealer d-none">
<aside id="bd-header-version-warning" class="d-none d-print-none" aria-label="Alerte de version"></aside>
</div>
<header class="bd-header navbar navbar-expand-lg bd-navbar d-print-none">
</header>
<div class="bd-container">
<div class="bd-container__inner bd-page-width">
<dialog id="pst-primary-sidebar-modal"></dialog>
<div id="pst-primary-sidebar" class="bd-sidebar-primary bd-sidebar">
<div class="sidebar-header-items sidebar-primary__section">
</div>
<div class="sidebar-primary-items__start sidebar-primary__section">
<div class="sidebar-primary-item">
<a class="navbar-brand logo" href="../index.html">
<p class="title logo__title">Documentation two 0.2.0</p>
</a></div>
<div class="sidebar-primary-item"><ul class="navbar-icon-links"
aria-label="Icon Links">
<li class="nav-item">
<a href="https://git.g3e.fr/syonad/two" title="Dépôt" class="nav-link pst-navbar-icon" rel="noopener" target="_blank" data-bs-toggle="tooltip" data-bs-placement="bottom"><i class="fa-solid fa-code-branch fa-lg" aria-hidden="true"></i>
<span class="sr-only">Dépôt</span></a>
</li>
</ul></div>
<div class="sidebar-primary-item">
<div class="version-switcher__container dropdown pst-js-only">
<button id="pst-version-switcher-button-2"
type="button"
class="version-switcher__button btn btn-sm dropdown-toggle"
data-bs-toggle="dropdown"
aria-haspopup="listbox"
aria-controls="pst-version-switcher-list-2"
aria-label="Version switcher list"
>
Choose version <!-- this text may get changed later by javascript -->
<span class="caret"></span>
</button>
<div id="pst-version-switcher-list-2"
class="version-switcher__menu dropdown-menu list-group-flush py-0"
role="listbox" aria-labelledby="pst-version-switcher-button-2">
<!-- dropdown will be populated by javascript on page load -->
</div>
</div></div>
<div class="sidebar-primary-item">
<button class="btn search-button-field search-button__button pst-js-only" title="Recherche" aria-label="Recherche" data-bs-placement="bottom" data-bs-toggle="tooltip">
<i class="fa-solid fa-magnifying-glass"></i>
<span class="search-button__default-text">Recherche</span>
<span class="search-button__kbd-shortcut"><kbd class="kbd-shortcut__modifier">Ctrl</kbd>+<kbd class="kbd-shortcut__modifier">K</kbd></span>
</button></div>
<div class="sidebar-primary-item"><nav class="bd-links bd-docs-nav" aria-label="Main">
<div class="bd-toc-item navbar-nav active">
<ul class="nav bd-sidenav bd-sidenav__home-link">
<li class="toctree-l1">
<a class="reference internal" href="../index.html">
two
</a>
</li>
</ul>
<p aria-level="2" class="caption" role="heading"><span class="caption-text">Mise en œuvre</span></p>
<ul class="nav bd-sidenav">
<li class="toctree-l1 has-children"><a class="reference internal" href="../demarrage/index.html">Démarrage</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../demarrage/installation.html">Installation d’un hyperviseur</a></li>
<li class="toctree-l2"><a class="reference internal" href="../demarrage/premier-vpc.html">Premier VPC, premier subnet, première VM</a></li>
</ul>
</details></li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../deploiement/index.html">Déploiement d’un cluster</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../deploiement/architecture-cluster.html">Architecture du cluster</a></li>
<li class="toctree-l2"><a class="reference internal" href="../deploiement/image-qcow2.html">Construction de l’image qcow2</a></li>
<li class="toctree-l2"><a class="reference internal" href="../deploiement/routeurs.html">Routeurs</a></li>
<li class="toctree-l2"><a class="reference internal" href="../deploiement/premier-hyperviseur.html">Premier hyperviseur</a></li>
<li class="toctree-l2"><a class="reference internal" href="../deploiement/route-reflector.html">VM route reflector</a></li>
</ul>
</details></li>
</ul>
<p aria-level="2" class="caption" role="heading"><span class="caption-text">Exploitation</span></p>
<ul class="nav bd-sidenav">
<li class="toctree-l1 has-children"><a class="reference internal" href="../exploitation/index.html">Exploitation</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../exploitation/configuration.html">Configuration</a></li>
<li class="toctree-l2"><a class="reference internal" href="../exploitation/services.html">Services systemd</a></li>
<li class="toctree-l2 has-children"><a class="reference internal" href="../exploitation/api-agent/index.html">API de l’agent</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l3"><a class="reference internal" href="../exploitation/api-agent/asynchronisme.html">Modèle asynchrone et codes de retour</a></li>
<li class="toctree-l3"><a class="reference internal" href="../exploitation/api-agent/reference.html">Référence</a></li>
</ul>
</details></li>
<li class="toctree-l2"><a class="reference internal" href="../exploitation/observabilite.html">Observabilité</a></li>
<li class="toctree-l2"><a class="reference internal" href="../exploitation/diagnostic.html">Diagnostic</a></li>
</ul>
</details></li>
</ul>
<p aria-level="2" class="caption" role="heading"><span class="caption-text">Développement</span></p>
<ul class="nav bd-sidenav">
<li class="toctree-l1 has-children"><a class="reference internal" href="../developpement/index.html">Développement</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../developpement/lab.html">Lab de test multi-nœud</a></li>
</ul>
</details></li>
</ul>
<p aria-level="2" class="caption" role="heading"><span class="caption-text">Interne</span></p>
<ul class="current nav bd-sidenav">
<li class="toctree-l1 has-children"><a class="reference internal" href="../concepts/index.html">Concepts</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../concepts/vpc-subnet-vm.html">VPC, subnet et VM</a></li>
<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>
<li class="toctree-l2"><a class="reference internal" href="../architecture/vue-densemble.html">Vue d’ensemble</a></li>
<li class="toctree-l2"><a class="reference internal" href="../architecture/stockage.html">Schéma des clés</a></li>
<li class="toctree-l2"><a class="reference internal" href="../architecture/contraintes.html">Invariants et pièges</a></li>
</ul>
</details></li>
<li class="toctree-l1 current active has-children"><a class="reference internal" href="index.html">Versions</a><details open="open"><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul class="current">
<li class="toctree-l2 current active"><a class="current reference internal" href="#">0.2.0 — Bael</a></li>
<li class="toctree-l2"><a class="reference internal" href="0.1.0.html">0.1.0 — Michael</a></li>
</ul>
</details></li>
</ul>
</div>
</nav></div>
</div>
<div class="sidebar-primary-items__end sidebar-primary__section">
<div class="sidebar-primary-item">
<div id="ethical-ad-placement"
class="flat"
data-ea-publisher="readthedocs"
data-ea-type="readthedocs-sidebar"
data-ea-manual="true">
</div></div>
</div>
</div>
<main id="main-content" class="bd-main" role="main">
<div class="sbt-scroll-pixel-helper"></div>
<div class="bd-content">
<div class="bd-article-container">
<div class="bd-header-article d-print-none">
<div class="header-article-items header-article__inner">
<div class="header-article-items__start">
<div class="header-article-item"><button class="sidebar-toggle primary-toggle btn btn-sm" title="Toggle primary sidebar" data-bs-placement="bottom" data-bs-toggle="tooltip">
<span class="fa-solid fa-bars"></span>
</button></div>
</div>
<div class="header-article-items__end">
<div class="header-article-item">
<div class="article-header-buttons">
<button onclick="toggleFullScreen()"
class="btn btn-sm btn-fullscreen-button pst-navbar-icon"
title="Mode plein écran"
data-bs-placement="bottom" data-bs-toggle="tooltip"
>
<span class="btn__icon-container">
<i class="fas fa-expand"></i>
</span>
</button>
<button class="btn btn-sm nav-link pst-navbar-icon theme-switch-button pst-js-only" aria-label="Thème" data-bs-title="Thème" data-bs-placement="bottom" data-bs-toggle="tooltip">
<i class="theme-switch fa-solid fa-sun fa-lg" data-mode="light" title="Clair"></i>
<i class="theme-switch fa-solid fa-moon fa-lg" data-mode="dark" title="Sombre"></i>
<i class="theme-switch fa-solid fa-circle-half-stroke fa-lg" data-mode="auto" title="Paramètres système"></i>
</button>
<button class="btn btn-sm pst-navbar-icon search-button search-button__button pst-js-only" title="Recherche" aria-label="Recherche" data-bs-placement="bottom" data-bs-toggle="tooltip">
<i class="fa-solid fa-magnifying-glass fa-lg"></i>
</button>
<button class="sidebar-toggle secondary-toggle btn btn-sm pst-navbar-icon" title="Toggle secondary sidebar" data-bs-placement="bottom" data-bs-toggle="tooltip">
<span class="fa-solid fa-list"></span>
</button>
</div></div>
</div>
</div>
</div>
<div id="jb-print-docs-body" class="onlyprint">
<h1>Bael</h1>
<!-- Table of contents -->
<div id="print-main-content">
<div id="jb-print-toc">
<div>
<h2> Contenu </h2>
</div>
<nav aria-label="Page">
<ul class="visible nav section-nav flex-column">
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#fonctionnalites">Fonctionnalités</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#correctifs">Correctifs</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#changements-internes">Changements internes</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#perimetre-et-limites-connues">Périmètre et limites connues</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#mise-a-jour-depuis-la-0-1-0">Mise à jour depuis la 0.1.0</a></li>
</ul>
</nav>
</div>
</div>
</div>
<div id="searchbox"></div>
<article class="bd-article">
<section id="bael">
<h1>Bael<a class="headerlink" href="#bael" title="Lien vers cette rubrique">#</a></h1>
<p>Serveur DHCP intégré, en coexistence avec dnsmasq ; routage inter-subnet entre hyperviseurs par
L3VNI, avec une configuration BGP pilotée par l’agent ; documentation du projet.</p>
<section id="fonctionnalites">
<h2>Fonctionnalités<a class="headerlink" href="#fonctionnalites" title="Lien vers cette rubrique">#</a></h2>
<p><strong>Serveur DHCP intégré</strong></p>
<ul class="simple">
<li><p>Nouveau binaire <code class="docutils literal notranslate"><span class="pre">dhcp</span></code>, une instance par subnet lancée dans le netns du VPC par l’unit
<code class="docutils literal notranslate"><span class="pre">dhcp&#64;&lt;netns&gt;_&lt;bridge&gt;</span></code>. Il reçoit son bridge et ses deux chemins de fichiers en paramètres :
il ne compose aucun chemin et ignore le netns dans lequel il tourne</p></li>
<li><p>Piloté par l’agent sur une <strong>socket Unix</strong> <code class="docutils literal notranslate"><span class="pre">/run/two/dhcp/&lt;netns&gt;_&lt;bridge&gt;.sock</span></code>, en JSON par
ligne. Ordres idempotents en remplacement intégral : configuration du subnet à sa création,
une réservation par interface à chaque création ou suppression de VM</p></li>
<li><p><strong>Réservations statiques uniquement</strong>, pas de baux : une MAC inconnue n’obtient rien, et le
serveur reste silencieux plutôt que de répondre par un refus. Aucun <code class="docutils literal notranslate"><span class="pre">DHCPNAK</span></code> n’est émis</p></li>
<li><p>État auto-persisté dans <code class="docutils literal notranslate"><span class="pre">/run/two/dhcp/&lt;netns&gt;_&lt;bridge&gt;.state</span></code>, en écriture atomique et lisible
par le seul <code class="docutils literal notranslate"><span class="pre">root</span></code>. Le fichier appartient au processus, qui le relit à son démarrage ; l’agent
ne l’écrit jamais et se borne à le supprimer — à la création du subnet pour écarter un résidu,
à sa suppression après avoir arrêté l’unit</p></li>
<li><p>La route par défaut est décidée <strong>par interface</strong> et non plus par subnet, ce qui permet de ne
l’annoncer que sur une interface d’une VM multi-réseaux</p></li>
<li><p>L’encodage RFC 3442 de l’option 121 est délégué à <code class="docutils literal notranslate"><span class="pre">github.com/insomniacslk/dhcp</span></code></p></li>
</ul>
<p><strong>Coexistence avec dnsmasq</strong></p>
<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
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>
<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>
<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>
</ul>
<p><strong>Routage inter-subnet entre hyperviseurs : L3VNI (#41)</strong></p>
<ul class="simple">
<li><p>Nouveau champ facultatif <code class="docutils literal notranslate"><span class="pre">l3vni</span></code> sur <code class="docutils literal notranslate"><span class="pre">POST</span> <span class="pre">/vpcs</span></code> (1 à 65535, sauf 253-255 : c’est aussi
l’identifiant de la table de routage, et le numéro du RD <code class="docutils literal notranslate"><span class="pre">&lt;VTEP&gt;:&lt;l3vni&gt;</span></code>, sur 16 bits).
Absent, le VPC se comporte comme avant. Une L3VNI déjà portée par un VPC de l’agent est refusée
(409), comme un <code class="docutils literal notranslate"><span class="pre">l3vni</span></code> demandé sans section <code class="docutils literal notranslate"><span class="pre">bgp</span></code></p></li>
<li><p>Pour un VPC routé, l’agent pose sur l’hyperviseur une VRF (table = L3VNI), un bridge à la MAC de
routeur <code class="docutils literal notranslate"><span class="pre">02:02:&lt;IPv4</span> <span class="pre">du</span> <span class="pre">VTEP&gt;</span></code>, le VXLAN de la L3VNI, un lien de transit <code class="docutils literal notranslate"><span class="pre">169.254.0.1/30</span></code> ↔
<code class="docutils literal notranslate"><span class="pre">169.254.0.2/30</span></code> vers le netns et la route du <code class="docutils literal notranslate"><span class="pre">cidr</span></code> du VPC dans le netns ; FRR reçoit la VRF,
sa <code class="docutils literal notranslate"><span class="pre">vni</span></code>, une instance <code class="docutils literal notranslate"><span class="pre">router</span> <span class="pre">bgp</span> <span class="pre">…</span> <span class="pre">vrf</span></code> (RD <code class="docutils literal notranslate"><span class="pre">&lt;VTEP&gt;:&lt;l3vni&gt;</span></code>, RT <code class="docutils literal notranslate"><span class="pre">&lt;asn&gt;:&lt;l3vni&gt;</span></code>) et l’export
des routes du <code class="docutils literal notranslate"><span class="pre">cidr</span></code>. Un hyperviseur n’a plus besoin de porter un subnet pour joindre ses VM</p></li>
<li><p>Routes annoncées : le <code class="docutils literal notranslate"><span class="pre">/24</span></code> de chaque subnet <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> à sa création, le <code class="docutils literal notranslate"><span class="pre">/32</span></code> de chaque interface
de VM juste avant son passage en <code class="docutils literal notranslate"><span class="pre">running</span></code> ; retirés en premier à la suppression</p></li>
<li><p>La suppression d’un VPC routé retire la configuration de routage de FRR, puis les interfaces,
puis la VRF de FRR — dans cet ordre, faute de quoi <code class="docutils literal notranslate"><span class="pre">bgpd</span></code> plante (FRR 10.7.1)</p></li>
</ul>
<p><strong>Configuration BGP pilotée par l’agent</strong></p>
<ul class="simple">
<li><p>Nouvelle section facultative <code class="docutils literal notranslate"><span class="pre">bgp</span></code> (<code class="docutils literal notranslate"><span class="pre">asn</span></code>, <code class="docutils literal notranslate"><span class="pre">route_reflectors</span></code>). Présente, l’agent applique à
chaque démarrage, par <code class="docutils literal notranslate"><span class="pre">vtysh</span></code>, la base BGP de l’hyperviseur (router-id = VTEP, peer-group
<code class="docutils literal notranslate"><span class="pre">fabric</span></code> vers les route reflectors, EVPN, <code class="docutils literal notranslate"><span class="pre">advertise-all-vni</span></code>) et l’enregistre :
<code class="docutils literal notranslate"><span class="pre">/etc/frr/frr.conf</span></code> devient un fichier généré. Un route reflector retiré de la liste est retiré
de FRR. Absente, l’agent ne touche pas à FRR</p></li>
<li><p>Le démarrage échoue si la section est incomplète, si FRR tourne déjà sous un autre AS ou si
<code class="docutils literal notranslate"><span class="pre">vtysh</span></code> ne répond pas</p></li>
</ul>
<p><strong>Gateway anycast des subnets <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> (#57)</strong></p>
<ul class="simple">
<li><p>La gateway et l’adresse d’émission sont <strong>calculées</strong> par l’agent : avant-dernière adresse du
<code class="docutils literal notranslate"><span class="pre">cidr</span></code> (<code class="docutils literal notranslate"><span class="pre">.254</span></code> en <code class="docutils literal notranslate"><span class="pre">/24</span></code>) pour la gateway, exposée comme <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code>, et celle d’avant
(<code class="docutils literal notranslate"><span class="pre">.253</span></code>) pour l’adresse d’émission, exposée comme nouveau champ <code class="docutils literal notranslate"><span class="pre">relay_ip</span></code>. Le <code class="docutils literal notranslate"><span class="pre">cidr</span></code> doit
être sans bits d’hôte et faire au plus <code class="docutils literal notranslate"><span class="pre">/29</span></code></p></li>
<li><p>La gateway est portée par un macvlan <code class="docutils literal notranslate"><span class="pre">gw-&lt;subnet&gt;</span></code> à <strong>MAC anycast</strong> <code class="docutils literal notranslate"><span class="pre">02:01:00:&lt;VNI</span> <span class="pre">sur</span> <span class="pre">24</span> <span class="pre">bits&gt;</span></code>,
identique sur tous les hôtes qui portent le subnet : une VM résout toujours sa gateway vers son
hôte. Le bridge garde une MAC propre à l’hôte, <code class="docutils literal notranslate"><span class="pre">02:03:&lt;IPv4</span> <span class="pre">du</span> <span class="pre">VTEP&gt;</span></code>, et porte l’adresse
d’émission, d’où partent les requêtes ARP du netns</p></li>
<li><p>Une VM qui reçoit la requête ARP d’un autre hôte ne change plus de gateway : jusqu’ici, elle
envoyait pendant quelques secondes son trafic à cet hôte, coupant métadonnées, renouvellement
DHCP et sessions depuis le netns. Mesuré en lab : aucune perte pendant cette fenêtre</p></li>
<li><p>La MAC anycast est confinée au netns — règles ebtables sur le veth du subnet et entrée FDB
locale dans le bridge — et n’apparaît jamais en EVPN. Le DHCP écoute sur <code class="docutils literal notranslate"><span class="pre">gw-&lt;subnet&gt;</span></code> ; la
route du subnet a la gateway pour source</p></li>
<li><p>Une VM ne peut prendre ni la gateway, ni l’adresse d’émission, ni la <code class="docutils literal notranslate"><span class="pre">gateway</span></code> explicite, ni
l’adresse de réseau ou de broadcast du subnet, ni une adresse hors de son <code class="docutils literal notranslate"><span class="pre">cidr</span></code> (422)</p></li>
<li><p>Le watchdog contrôle le macvlan, sa MAC, les deux adresses et l’entrée FDB</p></li>
</ul>
<p><strong>MAC des VM fournie à la création (#62)</strong></p>
<ul class="simple">
<li><p>Champ <code class="docutils literal notranslate"><span class="pre">mac</span></code> obligatoire par interface dans <code class="docutils literal notranslate"><span class="pre">POST</span> <span class="pre">/vms</span></code>, rendu par <code class="docutils literal notranslate"><span class="pre">GET</span> <span class="pre">/vms/{name}</span></code>. Il est
passé tel quel à QEMU et à la réservation DHCP ; son format et son unicité relèvent de l’appelant</p></li>
<li><p>Fin de la table <code class="docutils literal notranslate"><span class="pre">subnet/&lt;name&gt;/dhcp/&lt;ip&gt;</span></code>, qui préchargeait une MAC par adresse du <code class="docutils literal notranslate"><span class="pre">cidr</span></code> : la
MAC dérivée du rang de l’IP donnait la même MAC à deux interfaces d’une VM de même rang dans
leurs subnets (VM injoignable), et n’était pas tenable en IPv6</p></li>
<li><p>Migration au démarrage : les VM existantes gardent leur MAC, recopiée sur chaque interface</p></li>
</ul>
<p><strong>Disques : <code class="docutils literal notranslate"><span class="pre">vda</span></code> pour la racine, <code class="docutils literal notranslate"><span class="pre">xvdX</span></code> pour les autres (#74)</strong></p>
<ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">dev</span></code> accepte désormais <code class="docutils literal notranslate"><span class="pre">vda</span></code>, le disque racine virtio, et <code class="docutils literal notranslate"><span class="pre">xvda</span></code> à <code class="docutils literal notranslate"><span class="pre">xvdz</span></code> pour les disques
additionnels, sur la cible SCSI de même rang (<code class="docutils literal notranslate"><span class="pre">xvda</span></code> → 0). Toute autre valeur est refusée (400),
<code class="docutils literal notranslate"><span class="pre">sdX</span></code> compris</p></li>
<li><p>Chaque disque reçoit le numéro de série <code class="docutils literal notranslate"><span class="pre">&lt;dev&gt;</span></code>. Le noyau de l’invité nomme les disques SCSI
<code class="docutils literal notranslate"><span class="pre">/dev/sdY</span></code> dans l’ordre de détection, qui change d’un démarrage à l’autre (mesuré en lab : <code class="docutils literal notranslate"><span class="pre">sda</span></code>
et <code class="docutils literal notranslate"><span class="pre">sdb</span></code> inversés 4 démarrages sur 6). Le nom stable est <code class="docutils literal notranslate"><span class="pre">/dev/xvdX</span></code>, créé par une règle udev
de l’image (exigence décrite dans la documentation de construction d’image), et toujours
<code class="docutils literal notranslate"><span class="pre">/dev/disk/by-id/scsi-0QEMU_QEMU_HARDDISK_xvdX</span></code></p></li>
<li><p>Migration au démarrage : les clés <code class="docutils literal notranslate"><span class="pre">vm/&lt;name&gt;/disk/sdX</span></code> deviennent <code class="docutils literal notranslate"><span class="pre">vm/&lt;name&gt;/disk/xvdX</span></code></p></li>
</ul>
<p><strong>MTU unique du cluster (#56)</strong></p>
<ul class="simple">
<li><p>Nouvelle section <code class="docutils literal notranslate"><span class="pre">network</span></code> de la configuration de l’agent. <code class="docutils literal notranslate"><span class="pre">mtu_vm</span></code> (1500 par défaut, 1500 au
plus) fixe le MTU de toutes les VM et de tous les bridges, veth, taps et interfaces VXLAN que
l’agent crée, jusque-là figé à 1500. Il doit être identique sur tous les hyperviseurs. Sous
1500, il faut <code class="docutils literal notranslate"><span class="pre">allow_mtu_vm_below_1500</span></code>, et jamais sous 1280 ; une valeur hors bornes fait
échouer le démarrage</p></li>
<li><p>Le MTU est annoncé aux VM par l’option DHCP 26 (serveur intégré et dnsmasq) et par <code class="docutils literal notranslate"><span class="pre">host_mtu</span></code>
sur leur interface virtio. <code class="docutils literal notranslate"><span class="pre">probe</span></code> l’affiche</p></li>
<li><p>L’underlay est attendu à exactement 9000 : un subnet <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> dont l’interface n’y est pas est
refusé (422), comme un VPC avec <code class="docutils literal notranslate"><span class="pre">l3vni</span></code> si <code class="docutils literal notranslate"><span class="pre">default_interface</span></code> n’y est pas (409), sauf avec
<code class="docutils literal notranslate"><span class="pre">allow_mtu_underlay_below_9000</span></code>. Dans tous les cas l’underlay doit porter <code class="docutils literal notranslate"><span class="pre">mtu_vm</span></code> + 50 octets
d’en-tête VXLAN. Un subnet <code class="docutils literal notranslate"><span class="pre">bridge</span></code> est refusé si son bridge est sous <code class="docutils literal notranslate"><span class="pre">mtu_vm</span></code></p></li>
</ul>
<p><strong>Exploitation</strong></p>
<ul class="simple">
<li><p>Le watchdog contrôle aussi, avec une section <code class="docutils literal notranslate"><span class="pre">bgp</span></code> : les sessions vers les route reflectors ;
pour chaque VPC routé, les interfaces de la VRF et l’état de la L3VNI dans FRR (type, état, MAC
de routeur) ; la cohérence entre routes exportées et ressources <code class="docutils literal notranslate"><span class="pre">running</span></code> — une route exportée
sans propriétaire est signalée comme <strong>trou noir</strong>, une route attendue absente comme manquante</p></li>
<li><p>Le watchdog interroge le serveur DHCP intégré et compare les réservations servies à celles que
la base implique. Il nomme ce qui diverge — ordre perdu à la création, ordre perdu à la
suppression, adresse ou route par défaut divergente — et reste en lecture seule. Une VM en
<code class="docutils literal notranslate"><span class="pre">creating</span></code>, <code class="docutils literal notranslate"><span class="pre">deleting</span></code> ou <code class="docutils literal notranslate"><span class="pre">error</span></code> n’est pas comparée : sa réservation peut être présente ou
absente sans alerte, le temps que la création ou la suppression aboutisse (#78)</p></li>
<li><p>La socket de contrôle répond à <code class="docutils literal notranslate"><span class="pre">get-state</span></code> et à <code class="docutils literal notranslate"><span class="pre">probe</span></code>, ce dernier montrant sans effet de bord
ce qui serait envoyé à une MAC donnée : adresse, masque, routeur, DNS et routes</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">bootstrap_kvm.sh</span></code> installe les paquets KVM sans les paquets recommandés et demande <code class="docutils literal notranslate"><span class="pre">qemu-utils</span></code>
explicitement : l’installation, rejouée à chaque démarrage, passe d’environ 270 à 65 Mo (#64)</p></li>
<li><p>Documentation Sphinx du projet : concepts, architecture, déploiement et exploitation</p></li>
</ul>
</section>
<section id="correctifs">
<h2>Correctifs<a class="headerlink" href="#correctifs" title="Lien vers cette rubrique">#</a></h2>
<ul class="simple">
<li><p><strong>Suppression d’un subnet refusée tant qu’une VM non supprimée l’utilise</strong> (409, avec la liste
des VM), pour tous les subnets : garantit qu’une route <code class="docutils literal notranslate"><span class="pre">/32</span></code> est retirée avant le <code class="docutils literal notranslate"><span class="pre">/24</span></code> de son
subnet, ce qui évite un trou noir partiel mesuré en lab</p></li>
<li><p><strong>Un fichier de configuration présent mais invalide fait désormais échouer le démarrage.</strong>
Jusqu’en 0.1.0 l’erreur de lecture était ignorée : l’agent tournait alors entièrement sur ses
valeurs par défaut sans le dire, ce qui rendait indétectable une simple tabulation d’indentation</p></li>
<li><p><strong>Réponses de l’API des subnets alignées sur la spécification</strong> : <code class="docutils literal notranslate"><span class="pre">gateway</span></code> est rendu aussi par
<code class="docutils literal notranslate"><span class="pre">GET</span> <span class="pre">/subnets</span></code> et par la réponse 202 de <code class="docutils literal notranslate"><span class="pre">POST</span> <span class="pre">/subnets</span></code>, plus seulement par
<code class="docutils literal notranslate"><span class="pre">GET</span> <span class="pre">/subnets/{name}</span></code> ; <code class="docutils literal notranslate"><span class="pre">vxlan_id</span></code> est omis hors mode <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> au lieu de valoir 0 (#80)</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">probe</span></code> annonce explicitement <code class="docutils literal notranslate"><span class="pre">&quot;served&quot;:</span> <span class="pre">false</span></code> pour une MAC non réservée, au lieu d’omettre le
champ et de le rendre indistinguable d’une réponse tronquée</p></li>
<li><p><strong>Le serveur DHCP intégré s’arrête proprement</strong> sur <code class="docutils literal notranslate"><span class="pre">SIGTERM</span></code> et <code class="docutils literal notranslate"><span class="pre">SIGINT</span></code> : il ferme sa socket de
contrôle et sa socket UDP avant de sortir. Il mourait jusque-là sans nettoyer, et laissait
<code class="docutils literal notranslate"><span class="pre">/run/two/dhcp/&lt;netns&gt;_&lt;bridge&gt;.sock</span></code> après la suppression du subnet. L’agent supprime aussi
cette socket avec le fichier d’état, ce qui couvre une mort brutale du processus (#77)</p></li>
<li><p><strong>Les VXLAN portent l’adresse VTEP locale (#51).</strong> Créés sans adresse source, ils laissaient FRR
sans VTEP local : aucune route EVPN annoncée, et les VM d’un même subnet <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> ne se
joignaient pas d’un hyperviseur à l’autre</p></li>
<li><p><strong>VM multi-NIC : les interfaces secondaires obtiennent leur bail (#73).</strong> Le <code class="docutils literal notranslate"><span class="pre">network-config</span></code>
servi par le serveur de metadata ne déclarait que <code class="docutils literal notranslate"><span class="pre">eth0</span></code> ; il déclare désormais une entrée par
interface, reconnue par sa MAC. L’image doit en outre lancer DHCP sur toutes ses interfaces
<code class="docutils literal notranslate"><span class="pre">en*</span></code> : voir la documentation de l’image</p></li>
<li><p><strong>Mode <code class="docutils literal notranslate"><span class="pre">bridge</span></code> sur plusieurs hôtes : <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> confinée à son hôte (#75).</strong> Chaque hôte
portant la même <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code>, une VM obtenait parfois l’ARP, les métadonnées ou le DHCP d’un
autre hôte : en lab, une VM ne recevait ses propres métadonnées que 3 à 4 fois sur 5. L’agent
bloque désormais vers le segment les requêtes ARP vers <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code>, l’ARP émis depuis elle
et le DHCP émis depuis elle, y compris par le serveur local (chaîne <code class="docutils literal notranslate"><span class="pre">OUTPUT</span></code>, que la règle
précédente ne couvrait pas). Le watchdog signale une règle manquante ; la suppression d’un
subnet ne retire que les règles présentes</p></li>
</ul>
</section>
<section id="changements-internes">
<h2>Changements internes<a class="headerlink" href="#changements-internes" title="Lien vers cette rubrique">#</a></h2>
<ul class="simple">
<li><p>Nouveaux paquets <code class="docutils literal notranslate"><span class="pre">internal/frr</span></code> (seul point d’appel à <code class="docutils literal notranslate"><span class="pre">vtysh</span></code> : génération des commandes,
démontage ordonné, relecture de la configuration après démontage) et <code class="docutils literal notranslate"><span class="pre">internal/sysctl</span></code> ; une
remarque de <code class="docutils literal notranslate"><span class="pre">vtysh</span></code> (« Configuration applied with notes ») n’est pas une erreur, et la
suppression d’une instance BGP de VRF est réessayée tant que <code class="docutils literal notranslate"><span class="pre">bgpd</span></code> n’a pas libéré la L3VNI</p></li>
<li><p>Les tests du dispatcher arrêtent les workers avant de fermer la base (#47), ceux du watchdog
attendent la fin de <code class="docutils literal notranslate"><span class="pre">Run</span></code> avant de la fermer (#83)</p></li>
<li><p><strong>Lab de test</strong> : labctl, qui monte un lab virtuel (hyperviseurs en KVM imbriqué, route
reflectors, switchs L3), vit dans son propre dépôt (#50, #55) ; la suite <code class="docutils literal notranslate"><span class="pre">test/e2e</span></code> reste dans
two, refondue par fonctionnalité dans un ordre fixe (#70), sur un plan de contrôle redondant —
deux route reflectors, deux switchs (#54). L’image Rocky 10 des VM de test se construit de
façon reproductible dans <code class="docutils literal notranslate"><span class="pre">syonad/two-images</span></code> (#53)</p></li>
<li><p>Le module passe à <strong>Go 1.25</strong>, exigé par la bibliothèque DHCP retenue. La version de Go du
workflow de build, restée à 1.21 alors que le module en demandait davantage, est alignée</p></li>
<li><p>Nouveau paquet <code class="docutils literal notranslate"><span class="pre">pkg/db/statefile</span></code> : persistance générique d’un état de composant dans un
fichier, en écriture atomique. Badger a été écarté pour cet usage — une instance par subnet
coûterait une memtable de 64 Mio et quatre goroutines de compaction pour environ un kilo-octet
d’état, dans un <code class="docutils literal notranslate"><span class="pre">tmpfs</span></code>, et laisserait un verrou résiduel après un arrêt brutal</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">internal/subnet</span></code> et <code class="docutils literal notranslate"><span class="pre">internal/vm</span></code> ne parlent plus à dnsmasq en direct mais à une interface
<code class="docutils literal notranslate"><span class="pre">Backend</span></code> à deux implémentations</p></li>
</ul>
</section>
<section id="perimetre-et-limites-connues">
<h2>Périmètre et limites connues<a class="headerlink" href="#perimetre-et-limites-connues" title="Lien vers cette rubrique">#</a></h2>
<p>Celles de la 0.1.0 restent valables, sauf mention contraire ci-dessus. S’y ajoutent :</p>
<ul class="simple">
<li><p><strong>L3VNI</strong> : pas de migration à chaud ; la gateway anycast (#57) la prépare côté réseau. Le transit <code class="docutils literal notranslate"><span class="pre">169.254.0.0/30</span></code> étant identique sur tous les hôtes, les ICMP des sauts distants sont
rejetés comme « martiens » (traceroute partiel)</p></li>
<li><p>Avec une section <code class="docutils literal notranslate"><span class="pre">bgp</span></code>, l’agent ne démarre pas sans FRR et <code class="docutils literal notranslate"><span class="pre">agent.service</span></code> ne le relance pas :
au démarrage, l’ordre est migration réseau, puis FRR, puis l’agent (#52)</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">bootstrap_kvm.sh</span></code> active <code class="docutils literal notranslate"><span class="pre">net.ipv4.ip_forward</span></code> en global ; le forwarding que l’agent active
sur les seules interfaces de la VRF n’en restreint donc pas la portée</p></li>
<li><p><strong>dnsmasq n’est pas retiré</strong> et reste un paquet requis : il sert les hyperviseurs qui déclarent
<code class="docutils literal notranslate"><span class="pre">dhcp.backend:</span> <span class="pre">dnsmasq</span></code>, dont ceux mis à jour avec des subnets existants, et le retour arrière
suppose dnsmasq installé. Son retrait est prévu en 0.4.0 (#49)</p></li>
<li><p>Pas de DNS, pas de pool dynamique, pas de PXE, pas de DHCPv6 dans le serveur intégré</p></li>
<li><p>La comparaison faite par le watchdog porte sur les <strong>réservations</strong> et non sur la configuration
du subnet : celle-ci dépend de la route par défaut de l’host, dont la lecture au moment du
contrôle produirait de faux écarts. Un serveur dépourvu de configuration est en revanche signalé</p></li>
<li><p>L’option 249 (routes classless de Microsoft) n’est pas émise, comme dnsmasq ne l’émet pas</p></li>
<li><p>Le serveur intégré écoute UDP/67 sans authentification, comme tout serveur DHCP : l’isolation
entre locataires d’un même subnet repose sur les règles ebtables anti-usurpation, inchangées</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">internal/dhcpbackend</span></code> n’est testé sous Linux que pour ses appels systemd ; le reste, y compris
le dialogue avec le serveur intégré, est couvert sur toute plateforme</p></li>
</ul>
</section>
<section id="mise-a-jour-depuis-la-0-1-0">
<h2>Mise à jour depuis la 0.1.0<a class="headerlink" href="#mise-a-jour-depuis-la-0-1-0" title="Lien vers cette rubrique">#</a></h2>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>curl<span class="w"> </span>-O<span class="w"> </span>https://git.g3e.fr/syonad/two/raw/branch/main/scripts/deploy.sh
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>
</div>
<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
près ; les quatre premières touchent les appelants de l’API :</p>
<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
calcule. Le retirer des appels de création, et ne plus placer de VM sur les deux dernières
adresses utilisables du subnet. Il reste obligatoire en <code class="docutils literal notranslate"><span class="pre">bridge</span></code> et <code class="docutils literal notranslate"><span class="pre">public_ip</span></code></p></li>
<li><p><strong>un subnet encore utilisé par une VM ne se supprime plus</strong> : supprimer les VM d’abord</p></li>
<li><p><strong>chaque interface d’une VM doit porter sa <code class="docutils literal notranslate"><span class="pre">mac</span></code></strong> (400 sinon) : l’appelant la choisit et en
garantit l’unicité. Les VM existantes gardent la leur, recopiée au premier démarrage de l’agent</p></li>
<li><p><strong>les disques additionnels s’appellent <code class="docutils literal notranslate"><span class="pre">xvdX</span></code></strong> : <code class="docutils literal notranslate"><span class="pre">sdX</span></code> est refusé (400). Les VM existantes sont
migrées ; leurs disques prennent le numéro de série <code class="docutils literal notranslate"><span class="pre">xvdX</span></code> au prochain lancement, et une image
qui les montait par <code class="docutils literal notranslate"><span class="pre">/dev/sdY</span></code> doit passer à <code class="docutils literal notranslate"><span class="pre">/dev/xvdX</span></code></p></li>
<li><p><strong>l’underlay doit être à 9000</strong> : sur un hyperviseur dont <code class="docutils literal notranslate"><span class="pre">default_interface</span></code> (ou l’interface
d’un <code class="docutils literal notranslate"><span class="pre">iface_type</span></code>) est à un autre MTU, la création d’un subnet <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> est refusée. Passer
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
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>
<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
<code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> (#75) jusqu’à leur recréation ; le watchdog les signale.</p>
<p>Pour router entre hyperviseurs : ajouter la section <code class="docutils literal notranslate"><span class="pre">bgp</span></code>, réduire <code class="docutils literal notranslate"><span class="pre">frr.conf</span></code> à <code class="docutils literal notranslate"><span class="pre">hostname</span></code> et
<code class="docutils literal notranslate"><span class="pre">log</span></code> (l’agent pose le reste), puis créer les VPC avec <code class="docutils literal notranslate"><span class="pre">l3vni</span></code>. Pour passer au serveur intégré, suivre la procédure de bascule dans la
documentation d’exploitation — elle suppose un hyperviseur vidé.</p>
</section>
</section>
</article>
<footer class="prev-next-footer d-print-none">
<div class="prev-next-area">
<a class="left-prev"
href="index.html"
title="page précédente">
<i class="fa-solid fa-angle-left"></i>
<div class="prev-next-info">
<p class="prev-next-subtitle">précédent</p>
<p class="prev-next-title">Versions</p>
</div>
</a>
<a class="right-next"
href="0.1.0.html"
title="page suivante">
<div class="prev-next-info">
<p class="prev-next-subtitle">suivant</p>
<p class="prev-next-title">Michael</p>
</div>
<i class="fa-solid fa-angle-right"></i>
</a>
</div>
</footer>
</div>
<dialog id="pst-secondary-sidebar-modal"></dialog>
<div id="pst-secondary-sidebar" class="bd-sidebar-secondary bd-toc"><div class="sidebar-secondary-items sidebar-secondary__inner">
<div class="sidebar-secondary-item"><div
id="pst-page-navigation-heading-2"
class="page-toc tocsection onthispage">
<i class="fa-solid fa-list"></i> Contenu
</div>
<nav id="pst-page-toc-nav" class="page-toc" aria-labelledby="pst-page-navigation-heading-2">
<ul class="visible nav section-nav flex-column">
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#fonctionnalites">Fonctionnalités</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#correctifs">Correctifs</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#changements-internes">Changements internes</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#perimetre-et-limites-connues">Périmètre et limites connues</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#mise-a-jour-depuis-la-0-1-0">Mise à jour depuis la 0.1.0</a></li>
</ul>
</nav></div>
</div></div>
</div>
<footer class="bd-footer-content">
<div class="bd-footer-content__inner container">
<div class="footer-item">
<p class="component-author">
Par Nicolas Boufidjeline
</p>
</div>
<div class="footer-item">
<p class="copyright">
© Copyright 2026, Nicolas Boufidjeline.
<br/>
</p>
</div>
<div class="footer-item">
</div>
<div class="footer-item">
</div>
</div>
</footer>
</main>
</div>
</div>
<!-- Scripts loaded after <body> so the DOM is not blocked -->
<script defer src="../_static/scripts/bootstrap.js?digest=8878045cc6db502f8baf"></script>
<script defer src="../_static/scripts/pydata-sphinx-theme.js?digest=8878045cc6db502f8baf"></script>
<footer class="bd-footer">
</footer>
</body>
</html>