993 lines
No EOL
76 KiB
HTML
993 lines
No EOL
76 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>Lab de test multi-nœud — Documentation two 0.1.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=57395fb6"></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 = 'developpement/lab';</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>
|
||
<link rel="index" title="Index" href="../genindex.html" />
|
||
<link rel="search" title="Recherche" href="../search.html" />
|
||
<link rel="next" title="Concepts" href="../concepts/index.html" />
|
||
<link rel="prev" title="Développement" 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.1" />
|
||
</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.1.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="current nav bd-sidenav">
|
||
<li class="toctree-l1 current active has-children"><a class="reference internal" href="index.html">Développement</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="#">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="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>
|
||
</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 has-children"><a class="reference internal" href="../versions/index.html">Versions</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="../versions/0.2.0.html">Bael</a></li>
|
||
<li class="toctree-l2"><a class="reference internal" href="../versions/0.1.0.html">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>Lab de test multi-nœud</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="#l-outil">L’outil</a></li>
|
||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#topologies">Topologies</a><ul class="nav section-nav flex-column">
|
||
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#roles">Rôles</a></li>
|
||
</ul>
|
||
</li>
|
||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#scenarios">Scénarios</a><ul class="nav section-nav flex-column">
|
||
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#ecrire-un-scenario">Écrire un scénario</a></li>
|
||
</ul>
|
||
</li>
|
||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#securite">Sécurité</a></li>
|
||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#tests">Tests</a></li>
|
||
</ul>
|
||
</nav>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
|
||
|
||
<div id="searchbox"></div>
|
||
<article class="bd-article">
|
||
|
||
<section id="lab-de-test-multi-noeud">
|
||
<h1>Lab de test multi-nœud<a class="headerlink" href="#lab-de-test-multi-noeud" title="Lien vers cette rubrique">#</a></h1>
|
||
<p>Ce qui fait l’intérêt de two ne se voit qu’à partir de <strong>deux hyperviseurs</strong> : sur un nœud isolé,
|
||
le trafic reste sur le bridge local et l’absence de plan de contrôle passe inaperçue (voir
|
||
<a class="reference internal" href="../deploiement/architecture-cluster.html"><span class="doc">Architecture du cluster</span></a>). Le lab reproduit la topologie du cluster —
|
||
hyperviseurs, route reflector, switch L3 — sous forme de VM, sur un serveur physique loué à
|
||
l’heure.</p>
|
||
<p>Le pourquoi des choix (serveur physique plutôt que VM cloud, câbles QEMU, MTU 9000, versions) est
|
||
consigné sur le ticket <a class="reference external" href="https://git.g3e.fr/syonad/two/issues/50">#50</a>. Cette page décrit
|
||
comment s’en servir.</p>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p>État actuel : le lab de #50 est livré et l’outil en est sorti (#55) : c’est
|
||
<a class="reference external" href="https://git.g3e.fr/syonad/labctl">labctl</a>, un dépôt à part, dont two épingle une release.
|
||
Ce dépôt garde ce qui est propre à two — ses topologies, l’installation de two sur les
|
||
hyperviseurs, les scénarios et leurs résultats. La redondance du plan de contrôle — deux route
|
||
reflectors, deux switchs — est l’objet de <a class="reference external" href="https://git.g3e.fr/syonad/two/issues/54">#54</a>.</p>
|
||
</div>
|
||
<section id="l-outil">
|
||
<h2>L’outil<a class="headerlink" href="#l-outil" title="Lien vers cette rubrique">#</a></h2>
|
||
<p><code class="docutils literal notranslate"><span class="pre">labctl</span></code> monte un lab de VM QEMU à partir d’une topologie YAML et s’exécute sur un hôte Linux
|
||
avec KVM ; son <code class="docutils literal notranslate"><span class="pre">lab-host.sh</span></code> loue cet hôte à l’heure chez Scaleway (Elastic Metal), le prépare,
|
||
y dépose <code class="docutils literal notranslate"><span class="pre">labctl</span></code> et la topologie, puis le supprime. Prérequis Scaleway, fichiers locaux
|
||
(<code class="docutils literal notranslate"><span class="pre">~/.config/labctl/</span></code>), commandes, format de topologie, rendu des VM, garanties de facturation et
|
||
diagnostic : voir le <a class="reference external" href="https://git.g3e.fr/syonad/labctl/src/branch/main/docs/guide.md">guide de labctl</a>.</p>
|
||
<p>two n’en garde aucune copie. <code class="docutils literal notranslate"><span class="pre">test/e2e/labctl.sh</span></code> épingle une release :</p>
|
||
<ul class="simple">
|
||
<li><p>au premier appel, il télécharge <code class="docutils literal notranslate"><span class="pre">labctl_linux_amd64</span></code> et <code class="docutils literal notranslate"><span class="pre">lab-host.sh</span></code> dans
|
||
<code class="docutils literal notranslate"><span class="pre">~/.cache/labctl/release/<version>/</span></code> et les vérifie contre des sommes SHA-256 <strong>écrites dans
|
||
le script</strong> — une release modifiée après coup est refusée ; un fichier altéré dans le cache est
|
||
retéléchargé ;</p></li>
|
||
<li><p>il lance ensuite <code class="docutils literal notranslate"><span class="pre">lab-host.sh</span></code> avec ses arguments et <code class="docutils literal notranslate"><span class="pre">LABCTL_BIN</span></code> pointé sur le binaire :
|
||
<code class="docutils literal notranslate"><span class="pre">push</span></code> dépose ce binaire au lieu de compiler.</p></li>
|
||
</ul>
|
||
<p>Changer de version : <code class="docutils literal notranslate"><span class="pre">LABCTL_VERSION</span></code> et les deux lignes de <code class="docutils literal notranslate"><span class="pre">LABCTL_SUMS</span></code> dans
|
||
<code class="docutils literal notranslate"><span class="pre">test/e2e/labctl.sh</span></code>, relevées dans le <code class="docutils literal notranslate"><span class="pre">SHA256SUMS</span></code> de la release <strong>et</strong> recalculées sur les
|
||
fichiers téléchargés.</p>
|
||
<p>Une campagne, depuis le Mac :</p>
|
||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>test/e2e/labctl.sh plan # gratuit : offre, zone, prix
|
||
test/e2e/labctl.sh up # crée le serveur, facturé à l'heure
|
||
test/e2e/labctl.sh push test/e2e/topologies/evpn-3hv.yml
|
||
test/e2e/labctl.sh ssh './labctl up -timeout 25m topology/evpn-3hv.yml'
|
||
test/e2e/run.sh all
|
||
test/e2e/labctl.sh ssh './labctl ssh hv1' # shell interactif sur hv1
|
||
test/e2e/labctl.sh down # supprime le serveur
|
||
</pre></div>
|
||
</div>
|
||
<div class="admonition warning">
|
||
<p class="admonition-title">Avertissement</p>
|
||
<p>Un serveur Elastic Metal est facturé <strong>de sa création à sa suppression</strong>, chaque heure
|
||
entamée comme une heure pleine. En cas de doute (session interrompue, poste mis en veille) :
|
||
<code class="docutils literal notranslate"><span class="pre">test/e2e/labctl.sh</span> <span class="pre">status</span></code> puis <code class="docutils literal notranslate"><span class="pre">down</span></code>. <strong>Ne jamais lancer</strong> <code class="docutils literal notranslate"><span class="pre">lab-host.sh</span></code> <strong>sous</strong>
|
||
<code class="docutils literal notranslate"><span class="pre">bash</span> <span class="pre">-x</span></code> : la trace afficherait la clé d’API.</p>
|
||
</div>
|
||
</section>
|
||
<section id="topologies">
|
||
<h2>Topologies<a class="headerlink" href="#topologies" title="Lien vers cette rubrique">#</a></h2>
|
||
<p>Les topologies de two vivent dans <code class="docutils literal notranslate"><span class="pre">test/e2e/topologies/</span></code> : <code class="docutils literal notranslate"><span class="pre">evpn-2hv.yml</span></code> (deux hyperviseurs)
|
||
et <code class="docutils literal notranslate"><span class="pre">evpn-3hv.yml</span></code> (trois, pour <code class="docutils literal notranslate"><span class="pre">s8</span></code> et <code class="docutils literal notranslate"><span class="pre">s9</span></code>). Le format est celui de <code class="docutils literal notranslate"><span class="pre">labctl</span></code> :</p>
|
||
<div class="highlight-yaml notranslate"><div class="highlight"><pre><span></span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">evpn-2hv</span>
|
||
|
||
<span class="nt">images</span><span class="p">:</span>
|
||
<span class="w"> </span><span class="nt">debian12</span><span class="p">:</span>
|
||
<span class="w"> </span><span class="nt">url</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">https://cloud.debian.org/images/cloud/bookworm/latest/debian-12-generic-amd64.qcow2</span>
|
||
<span class="w"> </span><span class="nt">sums</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">https://cloud.debian.org/images/cloud/bookworm/latest/SHA512SUMS</span>
|
||
|
||
<span class="nt">segments</span><span class="p">:</span>
|
||
<span class="w"> </span><span class="nt">underlay</span><span class="p">:</span>
|
||
<span class="w"> </span><span class="nt">switch</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">sw1</span>
|
||
<span class="w"> </span><span class="nt">cidr</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">192.168.14.0/24</span>
|
||
<span class="w"> </span><span class="nt">mtu</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">9000</span>
|
||
|
||
<span class="nt">nodes</span><span class="p">:</span>
|
||
<span class="w"> </span><span class="nt">sw1</span><span class="p">:</span>
|
||
<span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> role</span><span class="p">:</span><span class="w"> </span><span class="nv">switch</span><span class="p p-Indicator">,</span><span class="nt"> image</span><span class="p">:</span><span class="w"> </span><span class="nv">debian12</span><span class="p p-Indicator">,</span><span class="nt"> cpus</span><span class="p">:</span><span class="w"> </span><span class="nv">2</span><span class="p p-Indicator">,</span><span class="nt"> memory</span><span class="p">:</span><span class="w"> </span><span class="nv">1024</span><span class="p p-Indicator">,</span>
|
||
<span class="nt"> secondary</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> underlay</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">169.254.0.1/28</span><span class="p p-Indicator">]</span><span class="w"> </span><span class="p p-Indicator">},</span><span class="nt"> frr</span><span class="p">:</span><span class="w"> </span><span class="nv">frr/sw1.conf</span><span class="w"> </span><span class="p p-Indicator">}</span>
|
||
<span class="w"> </span><span class="nt">rr1</span><span class="p">:</span>
|
||
<span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> role</span><span class="p">:</span><span class="w"> </span><span class="nv">rr</span><span class="p p-Indicator">,</span><span class="nt"> image</span><span class="p">:</span><span class="w"> </span><span class="nv">debian12</span><span class="p p-Indicator">,</span><span class="nt"> cpus</span><span class="p">:</span><span class="w"> </span><span class="nv">1</span><span class="p p-Indicator">,</span><span class="nt"> memory</span><span class="p">:</span><span class="w"> </span><span class="nv">1024</span><span class="p p-Indicator">,</span><span class="nt"> segments</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">underlay</span><span class="p p-Indicator">],</span>
|
||
<span class="nt"> addresses</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> underlay</span><span class="p">:</span><span class="w"> </span><span class="nv">192.168.14.2</span><span class="w"> </span><span class="p p-Indicator">},</span><span class="nt"> secondary</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> underlay</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">169.254.0.3/28</span><span class="p p-Indicator">]</span><span class="w"> </span><span class="p p-Indicator">},</span>
|
||
<span class="nt"> loopback</span><span class="p">:</span><span class="w"> </span><span class="nv">10.255.255.1/32</span><span class="p p-Indicator">,</span><span class="nt"> frr</span><span class="p">:</span><span class="w"> </span><span class="nv">frr/rr1.conf</span><span class="w"> </span><span class="p p-Indicator">}</span>
|
||
<span class="w"> </span><span class="nt">hv1</span><span class="p">:</span>
|
||
<span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> role</span><span class="p">:</span><span class="w"> </span><span class="nv">host</span><span class="p p-Indicator">,</span><span class="nt"> image</span><span class="p">:</span><span class="w"> </span><span class="nv">debian12</span><span class="p p-Indicator">,</span><span class="nt"> cpus</span><span class="p">:</span><span class="w"> </span><span class="nv">4</span><span class="p p-Indicator">,</span><span class="nt"> memory</span><span class="p">:</span><span class="w"> </span><span class="nv">16384</span><span class="p p-Indicator">,</span><span class="nt"> segments</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">underlay</span><span class="p p-Indicator">],</span>
|
||
<span class="nt"> addresses</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> underlay</span><span class="p">:</span><span class="w"> </span><span class="nv">192.168.14.11</span><span class="w"> </span><span class="p p-Indicator">},</span><span class="nt"> frr</span><span class="p">:</span><span class="w"> </span><span class="nv">frr/hv1.conf</span><span class="p p-Indicator">,</span><span class="nt"> provision</span><span class="p">:</span><span class="w"> </span><span class="nv">provision/hypervisor.sh</span><span class="p p-Indicator">,</span>
|
||
<span class="nt"> post_provision</span><span class="p">:</span><span class="w"> </span><span class="nv">provision/hypervisor-post.sh</span><span class="p p-Indicator">,</span><span class="nt"> files</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> agent.yml</span><span class="p">:</span><span class="w"> </span><span class="nv">agent/two.yml</span><span class="p p-Indicator">,</span><span class="nt"> bin</span><span class="p">:</span><span class="w"> </span><span class="nv">bin</span><span class="w"> </span><span class="p p-Indicator">},</span>
|
||
<span class="nt"> services</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">agent.service</span><span class="p p-Indicator">]</span><span class="w"> </span><span class="p p-Indicator">}</span>
|
||
<span class="w"> </span><span class="nt">hv2</span><span class="p">:</span>
|
||
<span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> role</span><span class="p">:</span><span class="w"> </span><span class="nv">host</span><span class="p p-Indicator">,</span><span class="nt"> image</span><span class="p">:</span><span class="w"> </span><span class="nv">debian12</span><span class="p p-Indicator">,</span><span class="nt"> cpus</span><span class="p">:</span><span class="w"> </span><span class="nv">4</span><span class="p p-Indicator">,</span><span class="nt"> memory</span><span class="p">:</span><span class="w"> </span><span class="nv">16384</span><span class="p p-Indicator">,</span><span class="nt"> segments</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">underlay</span><span class="p p-Indicator">],</span>
|
||
<span class="nt"> addresses</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> underlay</span><span class="p">:</span><span class="w"> </span><span class="nv">192.168.14.12</span><span class="w"> </span><span class="p p-Indicator">},</span><span class="nt"> frr</span><span class="p">:</span><span class="w"> </span><span class="nv">frr/hv2.conf</span><span class="p p-Indicator">,</span><span class="nt"> provision</span><span class="p">:</span><span class="w"> </span><span class="nv">provision/hypervisor.sh</span><span class="p p-Indicator">,</span>
|
||
<span class="nt"> post_provision</span><span class="p">:</span><span class="w"> </span><span class="nv">provision/hypervisor-post.sh</span><span class="p p-Indicator">,</span><span class="nt"> files</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> agent.yml</span><span class="p">:</span><span class="w"> </span><span class="nv">agent/bgp.yml</span><span class="p p-Indicator">,</span><span class="nt"> bin</span><span class="p">:</span><span class="w"> </span><span class="nv">bin</span><span class="w"> </span><span class="p p-Indicator">},</span>
|
||
<span class="nt"> services</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">agent.service</span><span class="p p-Indicator">]</span><span class="w"> </span><span class="p p-Indicator">}</span>
|
||
</pre></div>
|
||
</div>
|
||
<p>Les ASN, la loopback du route reflector, le lien <code class="docutils literal notranslate"><span class="pre">169.254.0.0/28</span></code> et le subnet des hyperviseurs
|
||
de l’exemple sont <strong>ceux de la production</strong> (décision du 2026-10-04, #50) : les fichiers de
|
||
<code class="docutils literal notranslate"><span class="pre">test/e2e/topologies/</span></code> restent ainsi au plus près de ce qui tourne réellement. Toutes les adresses y sont
|
||
<strong>fixées</strong> par <code class="docutils literal notranslate"><span class="pre">addresses</span></code> — le route reflector en <code class="docutils literal notranslate"><span class="pre">.2</span></code>, les hyperviseurs à partir de <code class="docutils literal notranslate"><span class="pre">.11</span></code> —
|
||
pour que le modèle se lise sans le plan et ne dépende pas de l’ordre de déclaration : le
|
||
<code class="docutils literal notranslate"><span class="pre">frr.conf</span></code> d’un hyperviseur, écrit à la main, porte son adresse en <code class="docutils literal notranslate"><span class="pre">router-id</span></code>. Seul le switch
|
||
n’en déclare pas : il porte toujours la passerelle, la première adresse du segment.</p>
|
||
<section id="roles">
|
||
<h3>Rôles<a class="headerlink" href="#roles" title="Lien vers cette rubrique">#</a></h3>
|
||
<p>Les configurations FRR du lab vivent dans <code class="docutils literal notranslate"><span class="pre">test/e2e/topologies/frr/</span></code>, une par nœud, <strong>écrites à la main</strong> :
|
||
ce sont les mêmes fichiers que la documentation de déploiement inclut, pour que le lab qualifie
|
||
exactement ce qu’elle prescrit. Celles des hyperviseurs se réduisent à <code class="docutils literal notranslate"><span class="pre">hostname</span></code> et <code class="docutils literal notranslate"><span class="pre">log</span></code> :
|
||
la configuration BGP est posée par l’agent (section <code class="docutils literal notranslate"><span class="pre">bgp</span></code> de <code class="docutils literal notranslate"><span class="pre">agent.yml</span></code>). Celle du route
|
||
reflector :</p>
|
||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>frr defaults traditional
|
||
hostname rr1
|
||
log syslog informational
|
||
!
|
||
ip prefix-list RR-LOOPBACK-OUT seq 10 permit 10.255.255.1/32
|
||
!
|
||
route-map NO-IN deny 999
|
||
description deny
|
||
exit
|
||
!
|
||
router bgp 65000
|
||
no bgp default ipv4-unicast
|
||
bgp router-id 10.255.255.1
|
||
bgp cluster-id 10.255.255.1
|
||
neighbor CLUSTER peer-group
|
||
neighbor CLUSTER remote-as 65100
|
||
neighbor CLUSTER bfd
|
||
neighbor 169.254.0.1 peer-group CLUSTER
|
||
neighbor 169.254.0.1 description router-1
|
||
neighbor 169.254.0.2 peer-group CLUSTER
|
||
neighbor 169.254.0.2 description router-2
|
||
neighbor fabric peer-group
|
||
neighbor fabric remote-as 64600
|
||
neighbor fabric local-as 64600 no-prepend replace-as
|
||
neighbor fabric capability extended-nexthop
|
||
neighbor fabric update-source 10.255.255.1
|
||
bgp listen range 192.168.14.0/24 peer-group fabric
|
||
bgp listen limit 200
|
||
!
|
||
address-family ipv4 unicast
|
||
network 10.255.255.1/32
|
||
neighbor CLUSTER activate
|
||
neighbor CLUSTER prefix-list RR-LOOPBACK-OUT out
|
||
neighbor CLUSTER route-map NO-IN in
|
||
exit-address-family
|
||
!
|
||
address-family l2vpn evpn
|
||
neighbor fabric activate
|
||
neighbor fabric route-reflector-client
|
||
exit-address-family
|
||
!
|
||
exit
|
||
!
|
||
</pre></div>
|
||
</div>
|
||
<p>FRR est installé par <code class="docutils literal notranslate"><span class="pre">labctl</span></code> au premier démarrage (<code class="docutils literal notranslate"><span class="pre">frr-stable</span></code> de <code class="docutils literal notranslate"><span class="pre">deb.frrouting.org</span></code>,
|
||
clé du dépôt embarquée dans l’outil) : voir la section FRR du guide de <code class="docutils literal notranslate"><span class="pre">labctl</span></code>.</p>
|
||
<p><strong>Hyperviseurs.</strong> Ce sont des nœuds <code class="docutils literal notranslate"><span class="pre">host</span></code> dont la provision installe two comme en
|
||
production. <code class="docutils literal notranslate"><span class="pre">test/e2e/topologies/provision/hypervisor.sh</span></code> dépose <code class="docutils literal notranslate"><span class="pre">agent.yml</span></code> (fichier
|
||
<code class="docutils literal notranslate"><span class="pre">agent.yml</span></code> du nœud) dans <code class="docutils literal notranslate"><span class="pre">/etc/two/agent.yml</span></code>, télécharge <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code> et
|
||
<code class="docutils literal notranslate"><span class="pre">bootstrap_kvm.sh</span></code> <strong>au tag de la release testée</strong> dans <code class="docutils literal notranslate"><span class="pre">/opt/two/scripts/</span></code>, où <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code>
|
||
cherche d’abord <code class="docutils literal notranslate"><span class="pre">bootstrap_kvm.sh</span></code>, puis lance :</p>
|
||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>deploy.sh --noup_script -i -u "$LAB_UPLINK" -t <release>
|
||
</pre></div>
|
||
</div>
|
||
<p>La release est fixée dans le script (<code class="docutils literal notranslate"><span class="pre">RELEASE=</span></code>) : sans elle, <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code> prendrait la dernière,
|
||
et le lab ne serait plus reproductible. <code class="docutils literal notranslate"><span class="pre">--noup_script</span></code> empêche l’auto-mise à jour de remplacer le
|
||
script par celui de <code class="docutils literal notranslate"><span class="pre">main</span></code>. L’uplink <code class="docutils literal notranslate"><span class="pre">-u</span></code> est l’interface qui porte la route par défaut, parce
|
||
que <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code> y lit l’adresse et la passerelle qu’il déplace sur <code class="docutils literal notranslate"><span class="pre">br-000000</span></code>. <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code>
|
||
télécharge la release sur <code class="docutils literal notranslate"><span class="pre">git.g3e.fr</span></code> sans réessayer : le script attend d’abord que le serveur
|
||
réponde, à travers le switch. Les deux fichiers <code class="docutils literal notranslate"><span class="pre">agent/</span></code> donnent à l’agent la section <code class="docutils literal notranslate"><span class="pre">bgp</span></code>
|
||
(AS 64600, route reflector <code class="docutils literal notranslate"><span class="pre">10.255.255.1</span></code>) et un watchdog toutes les 10 s ;
|
||
<code class="docutils literal notranslate"><span class="pre">agent/two.yml</span></code> met en plus hv1 sur le serveur DHCP intégré (<code class="docutils literal notranslate"><span class="pre">dhcp.backend:</span> <span class="pre">two</span></code>),
|
||
<code class="docutils literal notranslate"><span class="pre">agent/bgp.yml</span></code> laisse les autres sur dnsmasq.</p>
|
||
<p><strong>Tester l’arbre courant plutôt que la release.</strong> <code class="docutils literal notranslate"><span class="pre">test/e2e/build.sh</span></code> compile <code class="docutils literal notranslate"><span class="pre">agent</span></code>,
|
||
<code class="docutils literal notranslate"><span class="pre">dhcp</span></code> et <code class="docutils literal notranslate"><span class="pre">metadata</span></code> pour linux/amd64 dans <code class="docutils literal notranslate"><span class="pre">test/e2e/topologies/bin/</span></code> (ignoré par git),
|
||
que les hyperviseurs reçoivent par <code class="docutils literal notranslate"><span class="pre">files:</span> <span class="pre">{bin:</span> <span class="pre">bin}</span></code>. Après <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code>,
|
||
<code class="docutils literal notranslate"><span class="pre">hypervisor.sh</span></code> installe chaque binaire présent dans <code class="docutils literal notranslate"><span class="pre">/opt/two/local/bin/</span></code> et y fait pointer
|
||
<code class="docutils literal notranslate"><span class="pre">/opt/two/bin/<nom></span></code> ; le reste (units, scripts) vient de la release. <code class="docutils literal notranslate"><span class="pre">build.sh</span> <span class="pre">--clean</span></code> vide
|
||
le répertoire : le lab suivant teste la release seule.</p>
|
||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>test/e2e/build.sh # binaires de l'arbre courant
|
||
test/e2e/labctl.sh push test/e2e/topologies/evpn-3hv.yml
|
||
test/e2e/labctl.sh ssh './labctl up topology/evpn-3hv.yml'
|
||
test/e2e/build.sh --clean # retour à la release seule
|
||
</pre></div>
|
||
</div>
|
||
<p>FRR est installé <strong>après</strong> la provision : il démarre sur le réseau final. Démarré
|
||
avant la migration, zebra peut perdre la route par défaut quand elle passe de l’uplink à
|
||
<code class="docutils literal notranslate"><span class="pre">br-000000</span></code> — constaté le 2026-10-11 sur un hyperviseur sur deux : route reflector
|
||
<code class="docutils literal notranslate"><span class="pre">unresolved</span></code>, session BGP jamais établie. L’agent, configuré avec une section <code class="docutils literal notranslate"><span class="pre">bgp</span></code>, refuse de
|
||
démarrer tant que FRR n’est pas là : son premier démarrage par <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code> échoue, et
|
||
<code class="docutils literal notranslate"><span class="pre">provision/hypervisor-post.sh</span></code> (<code class="docutils literal notranslate"><span class="pre">post_provision</span></code>) le <strong>redémarre</strong> une fois FRR installé.</p>
|
||
<div class="admonition warning">
|
||
<p class="admonition-title">Avertissement</p>
|
||
<p><strong>Un hyperviseur du lab ne survit pas à un redémarrage.</strong> En production, la racine est en
|
||
tmpfs et <code class="docutils literal notranslate"><span class="pre">deploy.sh</span> <span class="pre">--bootstrap</span></code> est rejoué à chaque démarrage ; dans le lab, <code class="docutils literal notranslate"><span class="pre">-i</span></code> n’est
|
||
exécuté qu’au premier, et la migration réseau, qui n’est pas persistée, est perdue. Recréer le
|
||
lab : <code class="docutils literal notranslate"><span class="pre">labctl</span> <span class="pre">down</span></code> puis <code class="docutils literal notranslate"><span class="pre">labctl</span> <span class="pre">up</span></code>.</p>
|
||
</div>
|
||
<p>Vérifié le 2026-10-04 sur le serveur de lab, topologie <code class="docutils literal notranslate"><span class="pre">evpn-2hv</span></code>, release <code class="docutils literal notranslate"><span class="pre">0.2.0rc002</span></code> :</p>
|
||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>$ test/e2e/labctl.sh ssh './labctl up -timeout 25m topology/evpn-2hv.yml'
|
||
sw1: started
|
||
rr1: started
|
||
hv1: started
|
||
hv2: started
|
||
sw1: ready
|
||
rr1: ready
|
||
hv1: ready
|
||
hv2: ready
|
||
</pre></div>
|
||
</div>
|
||
<div class="pst-scrollable-table-container"><table class="table">
|
||
<colgroup>
|
||
<col style="width: 55.0%" />
|
||
<col style="width: 45.0%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr class="row-odd"><th class="head"><p>Vérification</p></th>
|
||
<th class="head"><p>Résultat</p></th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">labctl</span> <span class="pre">up</span></code> complet : FRR, <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code> et vérification des services de chaque rôle</p></td>
|
||
<td><p>6 min 15</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>session switch ↔ route reflector, IPv4 unicast, BFD</p></td>
|
||
<td><p>Established, BFD up ; le switch reçoit la seule loopback du route reflector</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>sessions EVPN des deux hyperviseurs vers la loopback du route reflector</p></td>
|
||
<td><p>Established, voisins dynamiques, stables</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>réseau d’un hyperviseur après <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code></p></td>
|
||
<td><p>adresse sur <code class="docutils literal notranslate"><span class="pre">br-000000</span></code>, MTU 9000, API de l’agent qui répond</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>VPC, subnet <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> et VM Debian <code class="docutils literal notranslate"><span class="pre">genericcloud</span></code> créés par l’API de hv1</p></td>
|
||
<td><p><code class="docutils literal notranslate"><span class="pre">login:</span></code> en 20 s, en KVM imbriqué</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>DHCP et routes (option 121) servis par two à la VM</p></td>
|
||
<td><p>conformes, route <code class="docutils literal notranslate"><span class="pre">/32</span></code> vers <code class="docutils literal notranslate"><span class="pre">169.254.169.254</span></code> comprise</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>métadonnées, image configurée selon <a class="reference internal" href="../deploiement/image-qcow2.html"><span class="doc">Construction de l’image qcow2</span></a></p></td>
|
||
<td><p><code class="docutils literal notranslate"><span class="pre">DataSourceNoCloudNet</span></code>, nom d’hôte appliqué — avec la barre oblique finale de
|
||
<code class="docutils literal notranslate"><span class="pre">seedfrom</span></code> (voir cette page)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>VM ↔ VM entre les deux hyperviseurs, même subnet <code class="docutils literal notranslate"><span class="pre">vxlan</span></code></p></td>
|
||
<td><p><strong>échec</strong> : les VXLAN de two n’ont pas d’adresse VTEP locale, rien n’est annoncé en EVPN —
|
||
<a class="reference external" href="https://git.g3e.fr/syonad/two/issues/51">#51</a> ; avec l’adresse posée, ping et MTU 1500
|
||
passent</p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p><strong>Le switch du lab est un routeur Linux avec FRR, par choix.</strong> Il joue le rôle générique de
|
||
routeur de cluster : passerelle des hyperviseurs, session eBGP avec BFD vers le route reflector,
|
||
dont il n’accepte que la loopback (<code class="docutils literal notranslate"><span class="pre">test/e2e/topologies/frr/sw1.conf</span></code>). L’équipement réel dépend de qui
|
||
déploie l’infrastructure (MikroTik aujourd’hui ; Cisco, Juniper, Arista… demain) : il n’a besoin
|
||
que de BGP et d’EVPN, et sa configuration propre au constructeur n’a pas sa place dans le lab.</p>
|
||
</div>
|
||
</section>
|
||
</section>
|
||
<section id="scenarios">
|
||
<h2>Scénarios<a class="headerlink" href="#scenarios" title="Lien vers cette rubrique">#</a></h2>
|
||
<p>Les scénarios se lancent <strong>depuis le Mac</strong>, sur un lab démarré (<code class="docutils literal notranslate"><span class="pre">up</span></code>, <code class="docutils literal notranslate"><span class="pre">push</span></code>, <code class="docutils literal notranslate"><span class="pre">./labctl</span> <span class="pre">up</span></code>) :</p>
|
||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>test/e2e/run.sh s1 # un scénario
|
||
test/e2e/run.sh s1 s3 # plusieurs
|
||
test/e2e/run.sh all # tous, dans l'ordre
|
||
</pre></div>
|
||
</div>
|
||
<p>Chacun affiche une ligne <code class="docutils literal notranslate"><span class="pre">RÉUSSI</span></code> ou <code class="docutils literal notranslate"><span class="pre">ÉCHOUÉ</span></code> par vérification — un échec porte la dernière
|
||
ligne de la commande en cause —, des lignes <code class="docutils literal notranslate"><span class="pre">INFO</span></code> pour les mesures, puis son bilan. Le code de
|
||
sortie vaut 1 si une vérification échoue <strong>ou si aucune n’a été faite</strong>.</p>
|
||
<div class="pst-scrollable-table-container"><table class="table">
|
||
<colgroup>
|
||
<col style="width: 22.0%" />
|
||
<col style="width: 58.0%" />
|
||
<col style="width: 20.0%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr class="row-odd"><th class="head"><p>Scénario</p></th>
|
||
<th class="head"><p>Ce qui doit être vrai</p></th>
|
||
<th class="head"><p>Hyperviseurs</p></th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">s1-dhcp-two</span></code></p></td>
|
||
<td><p>backend DHCP <code class="docutils literal notranslate"><span class="pre">two</span></code>, une VPC et deux subnets : chaque VM reçoit l’adresse de <strong>son</strong>
|
||
subnet, démarrée seule ou en même temps qu’une autre ; le bail est tenu par
|
||
systemd-networkd ; route par défaut, route vers la VPC et <code class="docutils literal notranslate"><span class="pre">/32</span></code> vers les métadonnées
|
||
via <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> ; l’état de chaque serveur DHCP ne connaît que les MAC de son subnet
|
||
(#46)</p></td>
|
||
<td><p>hv1</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">s2-gateway</span></code></p></td>
|
||
<td><p>route par défaut via <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code>, ou via <code class="docutils literal notranslate"><span class="pre">gateway</span></code> avec <code class="docutils literal notranslate"><span class="pre">default_route</span></code> ; route
|
||
vers la VPC toujours via <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> ; même résultat après recréation du subnet (#31)</p></td>
|
||
<td><p>hv1</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">s3-isolation-local</span></code></p></td>
|
||
<td><p>deux VPC sur le même hyperviseur ne se joignent pas, en ICMP comme en TCP ; chaque VM
|
||
joint sa passerelle (témoin)</p></td>
|
||
<td><p>hv1</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">s4-evpn</span></code></p></td>
|
||
<td><p>adresse VTEP locale sur les VXLAN (#51), VTEP distant appris par EVPN, ping VM ↔ VM
|
||
entre hyperviseurs, trame de 1472 octets en <code class="docutils literal notranslate"><span class="pre">-M</span> <span class="pre">do</span></code>, 1473 refusés</p></td>
|
||
<td><p>hv1, hv2</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">s5-isolation-evpn</span></code></p></td>
|
||
<td><p>deux VPC de même plage, VNI différentes, sur deux hyperviseurs : la VM joint celle de sa
|
||
VPC sur l’autre hyperviseur (témoin) et pas celle de l’autre VPC — aucune résolution ARP</p></td>
|
||
<td><p>hv1, hv2</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">s6-rr-loss</span></code></p></td>
|
||
<td><p>FRR arrêté sur le route reflector, ping continu entre les VM de <code class="docutils literal notranslate"><span class="pre">s4</span></code> : la session tombe,
|
||
le trafic restant est <strong>mesuré</strong> (<code class="docutils literal notranslate"><span class="pre">INFO</span></code>) à 30 et 90 s ; au retour du route reflector, le
|
||
VTEP distant est réappris et le trafic repasse — délai mesuré</p></td>
|
||
<td><p>hv1, hv2, rr1</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">s7-l3vni</span></code></p></td>
|
||
<td><p>qualification de <a class="reference external" href="https://git.g3e.fr/syonad/two/issues/41">#41</a> <strong>par l’API</strong> : VPC créées
|
||
avec une <code class="docutils literal notranslate"><span class="pre">l3vni</span></code>, l’agent pose VRF, L3VNI, transit, FRR et les routes de type 5 (<code class="docutils literal notranslate"><span class="pre">/24</span></code>
|
||
des subnets, <code class="docutils literal notranslate"><span class="pre">/32</span></code> des VM). Deux subnets d’une même VPC, chacun sur un seul hyperviseur,
|
||
se joignent par le L3VNI à travers le route reflector inchangé ; 1472 octets en <code class="docutils literal notranslate"><span class="pre">-M</span> <span class="pre">do</span></code> ;
|
||
une seconde VPC de même plage sur un autre L3VNI n’est ni importée ni jointe ; L3VNI déjà
|
||
prise refusée ; forwarding de l’hôte limité aux interfaces de la VRF ; suppression d’un
|
||
subnet refusée tant qu’une VM l’utilise ; démontage complet d’une VPC sans redémarrage de
|
||
bgpd</p></td>
|
||
<td><p>hv1, hv2, rr1</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">s8-l3vni-migration</span></code></p></td>
|
||
<td><p>suite de <code class="docutils literal notranslate"><span class="pre">s7</span></code>, topologie <code class="docutils literal notranslate"><span class="pre">evpn-3hv.yml</span></code> : migration d’une VM de hv1 vers hv2 par l’API,
|
||
observée depuis hv3 qui n’a pas le subnet : migration simple (VM supprimée puis recréée,
|
||
<code class="docutils literal notranslate"><span class="pre">/24</span></code> comme filet), séquence orchestrée (deux VM de même IP, deux <code class="docutils literal notranslate"><span class="pre">/32</span></code> en ECMP, 40
|
||
sources sur 40) ; l’ancien « pire cas » devient un refus (409) ; MAC de gateway propre à
|
||
chaque hôte, sans doublon EVPN ; watchdog : <code class="docutils literal notranslate"><span class="pre">/32</span></code> orphelin signalé comme trou noir, <code class="docutils literal notranslate"><span class="pre">/32</span></code> manquant
|
||
signalé</p></td>
|
||
<td><p>hv1, hv2, hv3, rr1</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">s9-subnets-partages</span></code></p></td>
|
||
<td><p>deux VPC, avec et sans <code class="docutils literal notranslate"><span class="pre">l3vni</span></code>, chacune avec deux subnets présents sur <strong>les deux</strong>
|
||
hyperviseurs et une VM par subnet et par hôte : ping entre toutes les paires (même subnet ou
|
||
non, même hôte ou non) ; chaque VM voit la MAC de gateway de son propre hôte ; aucune MAC en
|
||
double sur les quatre VNI</p></td>
|
||
<td><p>hv2, hv3, rr1</p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
<p><code class="docutils literal notranslate"><span class="pre">s6</span></code> réutilise les VM de <code class="docutils literal notranslate"><span class="pre">s4</span></code> : le lancer après.</p>
|
||
<p><strong>Comment c’est fait.</strong> <code class="docutils literal notranslate"><span class="pre">test/e2e/run.sh</span></code> exécute chaque scénario sur le Mac ; un
|
||
scénario envoie des blocs de shell aux nœuds par <code class="docutils literal notranslate"><span class="pre">on</span> <span class="pre"><nœud></span> <span class="pre">[VAR=valeur…]</span> <span class="pre"><<'NODE'</span></code>, précédés de
|
||
<code class="docutils literal notranslate"><span class="pre">test/e2e/lib/node.sh</span></code> — appels à l’API de l’agent, attente des états, image Debian compatible two
|
||
(préparée une fois par hyperviseur, <code class="docutils literal notranslate"><span class="pre">seedfrom</span></code> avec barre oblique finale), clé SSH des VM,
|
||
<code class="docutils literal notranslate"><span class="pre">check</span></code> et <code class="docutils literal notranslate"><span class="pre">vm_fails</span></code> ; pour #41, <code class="docutils literal notranslate"><span class="pre">vpc_create</span></code> avec une <code class="docutils literal notranslate"><span class="pre">l3vni</span></code>, <code class="docutils literal notranslate"><span class="pre">api_code</span></code> (code HTTP
|
||
d’un refus attendu), l’observation des VRF et de BGP (<code class="docutils literal notranslate"><span class="pre">vrf_nexthops</span></code>, <code class="docutils literal notranslate"><span class="pre">bgp_paths</span></code>,
|
||
<code class="docutils literal notranslate"><span class="pre">wait_l3vni</span></code>…) et <code class="docutils literal notranslate"><span class="pre">wait_watchdog</span></code> (alerte du watchdog dans le journal de l’agent). Une vérification négative (« ne joint pas ») passe par <code class="docutils literal notranslate"><span class="pre">vm_fails</span></code> :
|
||
elle n’est réussie que si le SSH vers la VM a fonctionné <strong>et</strong> que la commande y a échoué — un
|
||
SSH en panne ne passe jamais pour une isolation.</p>
|
||
<p>Résultats du 2026-10-04 sur le serveur de lab, release <code class="docutils literal notranslate"><span class="pre">0.2.0rc003</span></code>, hv1 sur le DHCP intégré et
|
||
hv2 sur dnsmasq — toute la série en 8 minutes :</p>
|
||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>$ test/e2e/run.sh all | grep -E '^(=== s[0-9].* : |INFO)'
|
||
INFO: MAC de sn-s1a : 00:22:33:00:00:0a 00:22:33:00:00:0b ; de sn-s1b : 00:22:33:00:00:0a 00:22:33:00:00:0b
|
||
=== s1-dhcp-two : 37 réussi(s), 0 échoué(s)
|
||
=== s2-gateway : 22 réussi(s), 0 échoué(s)
|
||
=== s3-isolation-local : 12 réussi(s), 0 échoué(s)
|
||
=== s4-evpn : 14 réussi(s), 0 échoué(s)
|
||
=== s5-isolation-evpn : 13 réussi(s), 0 échoué(s)
|
||
INFO: 30 s après l'arrêt du route reflector : 0 réponses dans les 10 dernières secondes (50 si le trafic passe intégralement)
|
||
INFO: VTEP distant encore connu : 0 ; entrée d'inondation : 0
|
||
INFO: 90 s après l'arrêt : 0 réponses dans les 10 dernières secondes
|
||
INFO: retour du VTEP distant et du trafic 31 s après le redémarrage de FRR
|
||
=== s6-rr-loss : 8 réussi(s), 0 échoué(s)
|
||
</pre></div>
|
||
</div>
|
||
<p>Dans ce run, le contrôle « uniquement les MAC de son subnet » de <code class="docutils literal notranslate"><span class="pre">s1</span></code> ne prouvait rien : two
|
||
dérive la MAC du rang de l’IP, et les VM <code class="docutils literal notranslate"><span class="pre">.10</span></code>/<code class="docutils literal notranslate"><span class="pre">.11</span></code> des deux subnets avaient les mêmes MAC.
|
||
Vérifié à la main sur le lab, chaque serveur DHCP ne connaissait que les couples MAC/IP de son
|
||
subnet ; le scénario compare désormais ces couples.</p>
|
||
<p><code class="docutils literal notranslate"><span class="pre">s7-l3vni</span></code> le 2026-10-05, même lab, FRR 10.7.1 : <strong>46 réussi(s), 0 échoué(s)</strong> au dernier run.
|
||
Quatre constats pour #41, au-delà du routage inter-subnet qui fonctionne avec le route reflector
|
||
inchangé :</p>
|
||
<ul class="simple">
|
||
<li><p><strong>bgpd 10.7.1 plante</strong> (SIGSEGV dans <code class="docutils literal notranslate"><span class="pre">bgp_redistribute_add</span></code>) quand la VRF du noyau est
|
||
supprimée puis recréée sous 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> encore configurée — FRR refuse de
|
||
supprimer l’instance tant que <code class="docutils literal notranslate"><span class="pre">vni</span></code> est déclaré dans la VRF (« Please unconfigure l3vni »).
|
||
Le plantage a touché les deux hyperviseurs à une seconde d’intervalle. Avec le démontage dans
|
||
l’ordre — <code class="docutils literal notranslate"><span class="pre">no</span> <span class="pre">redistribute</span></code>, <code class="docutils literal notranslate"><span class="pre">no</span> <span class="pre">vni</span></code>, <code class="docutils literal notranslate"><span class="pre">no</span> <span class="pre">router</span> <span class="pre">bgp</span> <span class="pre">…</span> <span class="pre">vrf</span></code>, puis le noyau —, trois runs
|
||
consécutifs passent sans plantage.</p></li>
|
||
<li><p><strong>La configuration posée par vtysh est perdue</strong> au redémarrage de bgpd par watchfrr, qui
|
||
relit <code class="docutils literal notranslate"><span class="pre">frr.conf</span></code> seul.</p></li>
|
||
<li><p><strong>Le transit</strong> <code class="docutils literal notranslate"><span class="pre">169.254.0.0/30</span></code>, <strong>identique sur tous les hôtes</strong>, fait rejeter comme
|
||
« martiens » les ICMP émis par les sauts distants (VRF et netns de l’hôte de sortie) : le
|
||
noyau de l’hôte d’entrée possède la même adresse. Quatre routeurs sur le chemin, seuls les
|
||
deux premiers répondent. Même effet attendu sur un ICMP « fragmentation nécessaire ».</p></li>
|
||
<li><p><strong>La route du supernet n’existe pas dans le netns</strong> de la VPC avant la pose manuelle (premier
|
||
run, lab neuf) : two ne pose que la route connectée du subnet.</p></li>
|
||
</ul>
|
||
<p><code class="docutils literal notranslate"><span class="pre">s8-l3vni-migration</span></code> le 2026-10-06, <code class="docutils literal notranslate"><span class="pre">evpn-3hv.yml</span></code> : <strong>61 réussi(s), 0 échoué(s)</strong>. Le filet du
|
||
<code class="docutils literal notranslate"><span class="pre">/24</span></code> porte le trafic tant que la destination n’a pas annoncé son <code class="docutils literal notranslate"><span class="pre">/32</span></code> ; deux <code class="docutils literal notranslate"><span class="pre">/32</span></code>
|
||
coexistent sans perte tant que la source garde le subnet (40 sources sur 40, relais en L2). Si la
|
||
source supprime le subnet avant de retirer son <code class="docutils literal notranslate"><span class="pre">/32</span></code>, le trou noir est <strong>stable mais partiel</strong> :
|
||
hv3 installe les deux chemins en ECMP, et seuls les flux hachés vers la source échouent (17 sources
|
||
sur 40) — invisible avec un seul émetteur.</p>
|
||
<p>Le 2026-10-11, les mêmes qualifications <strong>par l’API</strong>, l’agent posant toute la configuration
|
||
(FRR 10.7.1) :</p>
|
||
<ul class="simple">
|
||
<li><p><code class="docutils literal notranslate"><span class="pre">s1</span></code> à <code class="docutils literal notranslate"><span class="pre">s6</span></code> sur <code class="docutils literal notranslate"><span class="pre">evpn-2hv.yml</span></code>, release <code class="docutils literal notranslate"><span class="pre">0.2.0rc004</span></code>, base BGP des hyperviseurs posée par
|
||
l’agent : 37, 22, 12, 14, 13 et 8 réussis, aucun échec.</p></li>
|
||
<li><p>Puis, release <code class="docutils literal notranslate"><span class="pre">0.2.0rc005</span></code> (correction du démontage FRR, ci-dessous), <code class="docutils literal notranslate"><span class="pre">evpn-3hv.yml</span></code> :</p></li>
|
||
<li><p><code class="docutils literal notranslate"><span class="pre">s7-l3vni</span></code> : <strong>52 réussi(s), 1 échoué(s)</strong>. Routage inter-subnet par le
|
||
L3VNI, MAC de routeur dérivée du VTEP, exports <code class="docutils literal notranslate"><span class="pre">/24</span></code> et <code class="docutils literal notranslate"><span class="pre">/32</span></code> automatiques, forwarding par
|
||
interface, L3VNI en double et subnet utilisé refusés (409), démontage complet d’une VPC sans
|
||
redémarrage de bgpd. L’échec — « TTL 1 », un seul paquet — ne s’est pas reproduit au run
|
||
précédent : probablement le débit limité des ICMP du noyau ; la vérification envoie désormais
|
||
trois paquets.</p></li>
|
||
<li><p><code class="docutils literal notranslate"><span class="pre">s8-l3vni-migration</span></code> : <strong>48 réussi(s), 1 échoué(s)</strong>. Migration simple (<code class="docutils literal notranslate"><span class="pre">/32</span></code> de la
|
||
destination installé sur hv3 sans délai mesurable, 50/50), séquence orchestrée (deux <code class="docutils literal notranslate"><span class="pre">/32</span></code> en
|
||
ECMP, 40 sources sur 40), ex-pire cas refusé (409), watchdog : <code class="docutils literal notranslate"><span class="pre">/32</span></code> orphelin signalé comme
|
||
trou noir, <code class="docutils literal notranslate"><span class="pre">/32</span></code> manquant signalé. L’échec est un constat : <strong>la MAC de gateway anycast est
|
||
annoncée en EVPN</strong> (route de type 2 sur rr1) et FRR la déclare en double sur la VNI du subnet
|
||
porté par deux hyperviseurs — apprise sur le veth du subnet, numéros de séquence croissants.</p></li>
|
||
</ul>
|
||
<p>Trois défauts trouvés et corrigés pendant la campagne :</p>
|
||
<ul class="simple">
|
||
<li><p><strong>FRR installé avant la migration réseau</strong> : zebra a perdu la route par défaut sur un
|
||
hyperviseur sur deux (route reflector <code class="docutils literal notranslate"><span class="pre">unresolved</span></code>). Retour à l’ordre « FRR après
|
||
<code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code> », puis redémarrage de l’agent (voir <a class="reference internal" href="#roles">Rôles</a>).</p></li>
|
||
<li><p><strong>Remarques de vtysh prises pour des erreurs</strong> : <code class="docutils literal notranslate"><span class="pre">no</span> <span class="pre">vni</span></code> répond
|
||
<code class="docutils literal notranslate"><span class="pre">%</span> <span class="pre">Configuration</span> <span class="pre">applied</span> <span class="pre">with</span> <span class="pre">notes:</span></code> avec un code de retour 0. Une vraie erreur (commande
|
||
inconnue, refus) sort en 1.</p></li>
|
||
<li><p><strong>L3VNI libérée de façon asynchrone</strong> : juste après <code class="docutils literal notranslate"><span class="pre">no</span> <span class="pre">vni</span></code>, <code class="docutils literal notranslate"><span class="pre">no</span> <span class="pre">router</span> <span class="pre">bgp</span> <span class="pre">…</span> <span class="pre">vrf</span></code> peut être
|
||
refusé (« Please unconfigure l3vni ») puis accepté un instant plus tard ; l’agent réessaie.</p></li>
|
||
</ul>
|
||
<p>Le 2026-10-12, release <code class="docutils literal notranslate"><span class="pre">0.2.0rc006</span></code>, <code class="docutils literal notranslate"><span class="pre">evpn-3hv.yml</span></code> : <code class="docutils literal notranslate"><span class="pre">s1</span></code> à <code class="docutils literal notranslate"><span class="pre">s7</span></code> sans échec,
|
||
<code class="docutils literal notranslate"><span class="pre">s8-l3vni-migration</span></code> <strong>50 réussi(s), 0 échoué(s)</strong> (MAC de gateway propre à chaque hôte, aucun
|
||
doublon EVPN), <code class="docutils literal notranslate"><span class="pre">s9-subnets-partages</span></code> <strong>75 réussi(s), 1 échoué(s)</strong>. L’échec est une session SSH
|
||
coupée (<code class="docutils literal notranslate"><span class="pre">Broken</span> <span class="pre">pipe</span></code>), pas un ping perdu : quand un hôte route vers une VM d’un autre hôte, son
|
||
netns émet une requête ARP au nom de la gateway, partagée par tous les hôtes ; la VM met son cache à
|
||
jour et, pendant ~8 s, envoie à la gateway de l’autre hôte ce qui était destiné à la sienne.
|
||
Détails et suite : <a class="reference external" href="https://git.g3e.fr/syonad/two/issues/57">#57</a>.</p>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p>Un <code class="docutils literal notranslate"><span class="pre">Broken</span> <span class="pre">pipe</span></code> (<code class="docutils literal notranslate"><span class="pre">client_loop:</span> <span class="pre">send</span> <span class="pre">disconnect</span></code>) ou une session SSH figée dans un scénario
|
||
n’est <strong>pas forcément un aléa du lab</strong> : c’est la signature de ce problème. Ne pas le classer
|
||
comme test instable ni ajouter un nouvel essai qui le masquerait ; regarder d’abord le cache ARP
|
||
de la VM (<code class="docutils literal notranslate"><span class="pre">ip</span> <span class="pre">neigh</span> <span class="pre">show</span> <span class="pre"><gateway></span></code>) et l’état de la session côté VM.</p>
|
||
</div>
|
||
<p>Les VM sont accessibles depuis le netns de leur VPC, sur l’hyperviseur, avec l’utilisateur
|
||
<code class="docutils literal notranslate"><span class="pre">syonad</span></code> créé par les métadonnées de two :</p>
|
||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>test/e2e/labctl.sh ssh "./labctl ssh hv1 'sudo ip netns exec vp-s4 ssh -i /root/.ssh/lab-vm syonad@10.240.1.10'"
|
||
</pre></div>
|
||
</div>
|
||
<section id="ecrire-un-scenario">
|
||
<h3>Écrire un scénario<a class="headerlink" href="#ecrire-un-scenario" title="Lien vers cette rubrique">#</a></h3>
|
||
<p>Le lab sert à qualifier des comportements qui ne se voient qu’à plusieurs hyperviseurs — la
|
||
campagne L3VNI de <a class="reference external" href="https://git.g3e.fr/syonad/two/issues/41">#41</a> en est le prochain exemple. Un
|
||
scénario est un fichier <code class="docutils literal notranslate"><span class="pre">test/e2e/scenarios/<n>-<nom>.sh</span></code>, exécuté par <code class="docutils literal notranslate"><span class="pre">run.sh</span></code> sur le
|
||
Mac ; il envoie des blocs aux nœuds :</p>
|
||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>on<span class="w"> </span>hv1<span class="w"> </span><span class="s"><<'NODE'</span>
|
||
<span class="s">two_image || { echo "ÉCHOUÉ: image compatible two"; exit 0; }</span>
|
||
<span class="s">KEY=$(vm_key)</span>
|
||
<span class="s">check "VPC vp-x" vpc_create vp-x 10.250.0.0/16</span>
|
||
<span class="s">check "subnet sn-x" subnet_create sn-x vp-x 2601 10.250.1.1 10.250.1.0/24</span>
|
||
<span class="s">check "VM x1" vm_create x1 sn-x 10.250.1.10 "${KEY}"</span>
|
||
<span class="s">check "x1 joignable" vm_wait vp-x 10.250.1.10</span>
|
||
<span class="s">check "x1 joint sa passerelle" vm_ssh vp-x 10.250.1.10 'ping -c 2 -W 2 10.250.1.1'</span>
|
||
<span class="s">check "x1 ne joint pas 10.251.1.10" vm_fails vp-x 10.250.1.10 'ping -c 2 -W 2 10.251.1.10'</span>
|
||
<span class="s">info "mesure : $(vtysh -c 'show evpn vni 2601' | grep -c 'flood')"</span>
|
||
<span class="s">NODE</span>
|
||
</pre></div>
|
||
</div>
|
||
<p>Les règles qui ont fait leurs preuves en E5 :</p>
|
||
<ul class="simple">
|
||
<li><p><strong>une vérification par ligne</strong>, avec <code class="docutils literal notranslate"><span class="pre">check</span></code> — jamais un <code class="docutils literal notranslate"><span class="pre">echo</span> <span class="pre">RÉUSSI</span></code> écrit à la main ;</p></li>
|
||
<li><p><strong>toute vérification négative a son témoin</strong> : avant « ne joint pas », une ligne qui prouve que
|
||
la cible est vivante et que le chemin du test fonctionne ;</p></li>
|
||
<li><p><strong>``vm_fails`` pour le négatif</strong>, jamais <code class="docutils literal notranslate"><span class="pre">!</span></code> devant un <code class="docutils literal notranslate"><span class="pre">vm_ssh</span></code> : un SSH en panne doit
|
||
échouer, pas passer pour une isolation ;</p></li>
|
||
<li><p><strong>une donnée qui distingue réellement les cas</strong> : two dérivant la MAC du rang de l’IP, deux
|
||
subnets ont les mêmes MAC — comparer des couples MAC/IP, pas des MAC ;</p></li>
|
||
<li><p><strong>les mesures en ``INFO``</strong>, les attentes en <code class="docutils literal notranslate"><span class="pre">check</span></code> : un temps de reconvergence se mesure,
|
||
il ne se décrète pas ;</p></li>
|
||
<li><p>chaque scénario crée ses propres VPC, plages et VNI, distinctes de celles des autres, pour que
|
||
<code class="docutils literal notranslate"><span class="pre">all</span></code> les enchaîne sur le même lab ; un scénario qui dépend d’un autre le vérifie en tête
|
||
(<code class="docutils literal notranslate"><span class="pre">check</span> <span class="pre">"prérequis</span> <span class="pre">:</span> <span class="pre">…"</span></code>) ;</p></li>
|
||
<li><p>variables vers un nœud : <code class="docutils literal notranslate"><span class="pre">on</span> <span class="pre">hv1</span> <span class="pre">NOM=valeur</span> <span class="pre"><<'NODE'</span></code> (valeurs échappées par
|
||
<code class="docutils literal notranslate"><span class="pre">run.sh</span></code>) ;</p></li>
|
||
<li><p><code class="docutils literal notranslate"><span class="pre">bash</span> <span class="pre">test/e2e/run_test.sh</span></code> vérifie la syntaxe de chaque bloc réellement envoyé — à
|
||
lancer avant toute session.</p></li>
|
||
</ul>
|
||
</section>
|
||
</section>
|
||
<section id="securite">
|
||
<h2>Sécurité<a class="headerlink" href="#securite" title="Lien vers cette rubrique">#</a></h2>
|
||
<p>Propre à two — celle de l’outil (clé d’API, clés SSH des VM, images) est décrite dans le guide de
|
||
<code class="docutils literal notranslate"><span class="pre">labctl</span></code> :</p>
|
||
<ul class="simple">
|
||
<li><p><code class="docutils literal notranslate"><span class="pre">labctl</span></code> et <code class="docutils literal notranslate"><span class="pre">lab-host.sh</span></code> sont vérifiés contre des sommes épinglées dans
|
||
<code class="docutils literal notranslate"><span class="pre">test/e2e/labctl.sh</span></code>, pas contre le <code class="docutils literal notranslate"><span class="pre">SHA256SUMS</span></code> téléchargé avec eux.</p></li>
|
||
<li><p><strong>Code exécuté sans épinglage par</strong> <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code> : la bibliothèque <code class="docutils literal notranslate"><span class="pre">shflags</span></code> est récupérée
|
||
par <code class="docutils literal notranslate"><span class="pre">curl</span></code> sur la branche <code class="docutils literal notranslate"><span class="pre">main</span></code> d’un autre dépôt (<code class="docutils literal notranslate"><span class="pre">H6N/tools</span></code>) et exécutée par <code class="docutils literal notranslate"><span class="pre">eval</span></code>,
|
||
sans vérification d’intégrité — dans le lab comme en production. Les artefacts de la release
|
||
sont, eux, vérifiés contre <code class="docutils literal notranslate"><span class="pre">SHA256SUMS</span></code>.</p></li>
|
||
<li><p>Le lab n’a aucune donnée personnelle ni secret de production.</p></li>
|
||
</ul>
|
||
</section>
|
||
<section id="tests">
|
||
<h2>Tests<a class="headerlink" href="#tests" title="Lien vers cette rubrique">#</a></h2>
|
||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>bash<span class="w"> </span>test/e2e/run_test.sh
|
||
</pre></div>
|
||
</div>
|
||
<p>Sans réseau : vérifie la syntaxe de chaque bloc réellement envoyé aux nœuds par les scénarios et
|
||
les fonctions de <code class="docutils literal notranslate"><span class="pre">test/e2e/lib/node.sh</span></code>. Les tests de l’outil sont dans le dépôt <code class="docutils literal notranslate"><span class="pre">labctl</span></code>.</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">Développement</p>
|
||
</div>
|
||
</a>
|
||
<a class="right-next"
|
||
href="../concepts/index.html"
|
||
title="page suivante">
|
||
<div class="prev-next-info">
|
||
<p class="prev-next-subtitle">suivant</p>
|
||
<p class="prev-next-title">Concepts</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="#l-outil">L’outil</a></li>
|
||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#topologies">Topologies</a><ul class="nav section-nav flex-column">
|
||
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#roles">Rôles</a></li>
|
||
</ul>
|
||
</li>
|
||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#scenarios">Scénarios</a><ul class="nav section-nav flex-column">
|
||
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#ecrire-un-scenario">Écrire un scénario</a></li>
|
||
</ul>
|
||
</li>
|
||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#securite">Sécurité</a></li>
|
||
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#tests">Tests</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> |