720 lines
No EOL
52 KiB
HTML
720 lines
No EOL
52 KiB
HTML
|
||
<!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 — 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@<netns>_<bridge></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/<netns>_<bridge>.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/<netns>_<bridge>.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"><VTEP>:<l3vni></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:<IPv4</span> <span class="pre">du</span> <span class="pre">VTEP></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"><VTEP>:<l3vni></span></code>, RT <code class="docutils literal notranslate"><span class="pre"><asn>:<l3vni></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-<subnet></span></code> à <strong>MAC anycast</strong> <code class="docutils literal notranslate"><span class="pre">02:01:00:<VNI</span> <span class="pre">sur</span> <span class="pre">24</span> <span class="pre">bits></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:<IPv4</span> <span class="pre">du</span> <span class="pre">VTEP></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-<subnet></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/<name>/dhcp/<ip></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"><dev></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/<name>/disk/sdX</span></code> deviennent <code class="docutils literal notranslate"><span class="pre">vm/<name>/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">"served":</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/<netns>_<bridge>.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> |