This commit is contained in:
forgejo-actions 2026-10-30 20:53:21 +00:00
commit 314bcd7d4e
40 changed files with 2298 additions and 34 deletions

View file

@ -670,6 +670,8 @@ window.runMermaid = runMermaid;</script>
<li class="toctree-l2 current active"><a class="current reference internal" href="#">Cycle de vie des ressources</a></li>
<li class="toctree-l2"><a class="reference internal" href="metadata-cloud-init.html">Metadata et cloud-init</a></li>
<li class="toctree-l2"><a class="reference internal" href="dns-ntp.html">DNS et NTP des VM</a></li>
<li class="toctree-l2"><a class="reference internal" href="passerelle-nat.html">Passerelle NAT</a></li>
<li class="toctree-l2"><a class="reference internal" href="ip-flottante.html">IP flottante</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>

View file

@ -491,7 +491,7 @@ window.runMermaid = runMermaid;</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="Architecture" href="../architecture/index.html" />
<link rel="next" title="Passerelle NAT" href="passerelle-nat.html" />
<link rel="prev" title="Metadata et cloud-init" href="metadata-cloud-init.html" />
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<meta name="docsearch:language" content="fr"/>
@ -670,6 +670,8 @@ window.runMermaid = runMermaid;</script>
<li class="toctree-l2"><a class="reference internal" href="cycle-de-vie.html">Cycle de vie des ressources</a></li>
<li class="toctree-l2"><a class="reference internal" href="metadata-cloud-init.html">Metadata et cloud-init</a></li>
<li class="toctree-l2 current active"><a class="current reference internal" href="#">DNS et NTP des VM</a></li>
<li class="toctree-l2"><a class="reference internal" href="passerelle-nat.html">Passerelle NAT</a></li>
<li class="toctree-l2"><a class="reference internal" href="ip-flottante.html">IP flottante</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>
@ -893,11 +895,11 @@ systemd le relance (<code class="docutils literal notranslate"><span class="pre"
</div>
</a>
<a class="right-next"
href="../architecture/index.html"
href="passerelle-nat.html"
title="page suivante">
<div class="prev-next-info">
<p class="prev-next-subtitle">suivant</p>
<p class="prev-next-title">Architecture</p>
<p class="prev-next-title">Passerelle NAT</p>
</div>
<i class="fa-solid fa-angle-right"></i>
</a>

View file

@ -234,6 +234,8 @@
<li class="toctree-l2"><a class="reference internal" href="cycle-de-vie.html">Cycle de vie des ressources</a></li>
<li class="toctree-l2"><a class="reference internal" href="metadata-cloud-init.html">Metadata et cloud-init</a></li>
<li class="toctree-l2"><a class="reference internal" href="dns-ntp.html">DNS et NTP des VM</a></li>
<li class="toctree-l2"><a class="reference internal" href="passerelle-nat.html">Passerelle NAT</a></li>
<li class="toctree-l2"><a class="reference internal" href="ip-flottante.html">IP flottante</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>
@ -358,6 +360,8 @@ fonctionnent entre eux. Le contrat HTTP correspondant est dans
<li class="toctree-l1"><a class="reference internal" href="cycle-de-vie.html">Cycle de vie des ressources</a></li>
<li class="toctree-l1"><a class="reference internal" href="metadata-cloud-init.html">Metadata et cloud-init</a></li>
<li class="toctree-l1"><a class="reference internal" href="dns-ntp.html">DNS et NTP des VM</a></li>
<li class="toctree-l1"><a class="reference internal" href="passerelle-nat.html">Passerelle NAT</a></li>
<li class="toctree-l1"><a class="reference internal" href="ip-flottante.html">IP flottante</a></li>
</ul>
</div>
</section>

View file

@ -0,0 +1,548 @@
<!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>IP flottante &#8212; Documentation two 0.2.0</title>
<script data-cfasync="false">
document.documentElement.dataset.mode = localStorage.getItem("mode") || "";
document.documentElement.dataset.theme = localStorage.getItem("theme") || "";
</script>
<!--
this give us a css class that will be invisible only if js is disabled
-->
<noscript>
<style>
.pst-js-only { display: none !important; }
</style>
</noscript>
<!-- Loaded before other Sphinx assets -->
<link href="../_static/styles/theme.css?digest=8878045cc6db502f8baf" rel="stylesheet" />
<link href="../_static/styles/pydata-sphinx-theme.css?digest=8878045cc6db502f8baf" rel="stylesheet" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=8f2a1f02" />
<link rel="stylesheet" type="text/css" href="../_static/styles/sphinx-book-theme.css?v=3c74b3bc" />
<!-- So that users can add custom icons -->
<script src="../_static/scripts/fontawesome.js?digest=8878045cc6db502f8baf"></script>
<!-- Pre-loaded scripts that we'll load fully later -->
<link rel="preload" as="script" href="../_static/scripts/bootstrap.js?digest=8878045cc6db502f8baf" />
<link rel="preload" as="script" href="../_static/scripts/pydata-sphinx-theme.js?digest=8878045cc6db502f8baf" />
<script src="../_static/documentation_options.js?v=7788c55d"></script>
<script src="../_static/doctools.js?v=fd6eb6e6"></script>
<script src="../_static/sphinx_highlight.js?v=6ffebe34"></script>
<script src="../_static/scripts/sphinx-book-theme.js?v=fab101a9"></script>
<script src="../_static/translations.js?v=e6b791cb"></script>
<script>DOCUMENTATION_OPTIONS.pagename = 'concepts/ip-flottante';</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="Architecture" href="../architecture/index.html" />
<link rel="prev" title="Passerelle NAT" href="passerelle-nat.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 current active has-children"><a class="reference internal" href="index.html">Concepts</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"><a class="reference internal" href="vpc-subnet-vm.html">VPC, subnet et VM</a></li>
<li class="toctree-l2"><a class="reference internal" href="modes-reseau.html">Modes réseau</a></li>
<li class="toctree-l2"><a class="reference internal" href="cycle-de-vie.html">Cycle de vie des ressources</a></li>
<li class="toctree-l2"><a class="reference internal" href="metadata-cloud-init.html">Metadata et cloud-init</a></li>
<li class="toctree-l2"><a class="reference internal" href="dns-ntp.html">DNS et NTP des VM</a></li>
<li class="toctree-l2"><a class="reference internal" href="passerelle-nat.html">Passerelle NAT</a></li>
<li class="toctree-l2 current active"><a class="current reference internal" href="#">IP flottante</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">0.2.0 — Bael</a></li>
<li class="toctree-l2"><a class="reference internal" href="../versions/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>IP flottante</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="#ce-que-l-agent-pose">Ce que l’agent pose</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#deplacer-une-ip-flottante">Déplacer une IP flottante</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#limites">Limites</a></li>
</ul>
</nav>
</div>
</div>
</div>
<div id="searchbox"></div>
<article class="bd-article">
<section id="ip-flottante">
<h1>IP flottante<a class="headerlink" href="#ip-flottante" title="Lien vers cette rubrique">#</a></h1>
<p>Une IP flottante rend une interface de VM <strong>joignable par une IP publique qu’elle ne porte pas</strong>.
C’est une ressource de l’API de l’agent (<code class="docutils literal notranslate"><span class="pre">/floating-ips</span></code>), créée sur l’hyperviseur de la VM :
la VM garde son adresse privée, et le netns de son VPC traduit l’IP publique vers cette adresse,
dans les deux sens, sans suivi de connexion propre à la traduction.</p>
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>POST /floating-ips
{ "name": "fip-7", "vm": "vm-7", "interface": "nic-a1b2",
"ip": "203.0.113.20/24", "gateway": "203.0.113.1" }
</pre></div>
</div>
<p><code class="docutils literal notranslate"><span class="pre">interface</span></code> est le <strong>nom</strong> d’une interface de la VM (<code class="docutils literal notranslate"><span class="pre">name</span></code> de l’interface, voir
<a class="reference internal" href="vpc-subnet-vm.html"><span class="doc">VPC, subnet et VM</span></a>), pas une interface Linux. L’IP publique, son préfixe et la gateway des
bordures sont fournis par l’appelant ; l’agent ne les vérifie pas. Une interface a au plus une IP
flottante, et une IP publique n’est portée que par une IP flottante de l’hôte. Le VPC n’a pas
besoin de <code class="docutils literal notranslate"><span class="pre">l3vni</span></code>.</p>
<p>On attache et détache une IP flottante sans toucher à la VM. Le <code class="docutils literal notranslate"><span class="pre">GET</span></code> d’une VM l’affiche sur
l’interface concernée (<code class="docutils literal notranslate"><span class="pre">floating_ip</span></code> : nom, IP, état), en lecture seule ; la suppression d’une
VM est refusée (409) tant qu’une IP flottante y est attachée.</p>
<section id="ce-que-l-agent-pose">
<h2>Ce que l’agent pose<a class="headerlink" href="#ce-que-l-agent-pose" title="Lien vers cette rubrique">#</a></h2>
<p>Dans le netns du VPC de l’interface, sur l’hôte de la VM :</p>
<ul>
<li><p>un <code class="docutils literal notranslate"><span class="pre">macvlan</span></code> <code class="docutils literal notranslate"><span class="pre">fip-&lt;IP</span> <span class="pre">publique</span> <span class="pre">en</span> <span class="pre">hexadécimal&gt;</span></code> (<code class="docutils literal notranslate"><span class="pre">203.0.113.20</span></code> → <code class="docutils literal notranslate"><span class="pre">fip-cb007114</span></code>) sur
le bridge <code class="docutils literal notranslate"><span class="pre">br-public</span></code> du netns. Sa MAC est <code class="docutils literal notranslate"><span class="pre">02:05</span></code> suivi des quatre octets de l’IP publique
(<code class="docutils literal notranslate"><span class="pre">02:05:cb:00:71:14</span></code>) : unique dans l’infrastructure, la même sur tout hôte ;</p></li>
<li><p>une entrée FDB locale de cette MAC, posée par remplacement (le bridge a pu l’apprendre sur le
segment tant que l’IP flottante vivait sur un autre hôte), et <code class="docutils literal notranslate"><span class="pre">arp_ignore=1</span></code>,
<code class="docutils literal notranslate"><span class="pre">arp_announce=2</span></code>, <code class="docutils literal notranslate"><span class="pre">arp_notify=1</span></code>, comme pour la <a class="reference internal" href="passerelle-nat.html"><span class="doc">passerelle NAT</span></a> ;</p></li>
<li><p>deux chaînes dans la table nftables <code class="docutils literal notranslate"><span class="pre">ip</span> <span class="pre">two</span></code> :</p>
<ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">pre-fip-…</span></code>, en <code class="docutils literal notranslate"><span class="pre">prerouting</span></code> à la priorité <code class="docutils literal notranslate"><span class="pre">raw</span></code> : ce qui arrive par <code class="docutils literal notranslate"><span class="pre">fip-…</span></code> vers
l’IP publique est réécrit vers l’adresse privée, <strong>avant</strong> conntrack ;</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">post-fip-…</span></code>, en <code class="docutils literal notranslate"><span class="pre">postrouting</span></code> : ce que la VM envoie par <code class="docutils literal notranslate"><span class="pre">fip-…</span></code> repart avec l’IP
publique pour source ;</p></li>
</ul>
<p>conntrack ne voit que l’échange entre l’adresse privée et l’extérieur. Il n’y a pas de
<code class="docutils literal notranslate"><span class="pre">notrack</span></code> : la redirection des métadonnées et le relais DNS et NTP, qui reposent sur
conntrack, restent servis à la VM. L’entrée est ouverte : c’est le but d’une IP flottante ;</p>
</li>
<li><p>l’IP publique en <code class="docutils literal notranslate"><span class="pre">/32</span></code> sur <code class="docutils literal notranslate"><span class="pre">fip-…</span></code> : aucune route du segment public n’est ajoutée à la table
<code class="docutils literal notranslate"><span class="pre">main</span></code> du netns ;</p></li>
<li><p>une table de routage propre, numérotée par l’adresse privée lue comme un entier sur 32 bits
(<code class="docutils literal notranslate"><span class="pre">10.47.1.10</span></code> → <code class="docutils literal notranslate"><span class="pre">170852618</span></code>), qui porte la route du segment public par <code class="docutils literal notranslate"><span class="pre">fip-…</span></code> puis la
route par défaut vers la gateway des bordures ;</p></li>
<li><p>deux règles de routage pour l’adresse privée :</p>
<ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">100:</span> <span class="pre">from</span> <span class="pre">&lt;privée&gt;</span> <span class="pre">to</span> <span class="pre">&lt;cidr</span> <span class="pre">du</span> <span class="pre">VPC&gt;</span> <span class="pre">lookup</span> <span class="pre">main</span></code> : le trafic interne au VPC suit les routes
habituelles ;</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">101:</span> <span class="pre">from</span> <span class="pre">&lt;privée&gt;</span> <span class="pre">lookup</span> <span class="pre">&lt;table</span> <span class="pre">propre&gt;</span></code> : tout le reste sort par l’IP flottante, y compris
dans un VPC qui a une passerelle NAT, et sur l’hôte de celle-ci.</p></li>
</ul>
<p>La table <code class="docutils literal notranslate"><span class="pre">local</span></code> passant avant ces règles, le trafic vers les adresses du netns (gateway,
métadonnées, DNS et NTP) n’est pas concerné.</p>
</li>
</ul>
<p>Les règles nftables sont posées avant l’adresse et les routes : rien ne sort par <code class="docutils literal notranslate"><span class="pre">fip-…</span></code> sans
traduction. La suppression retire d’abord les règles de routage, puis les règles nftables,
l’entrée FDB et le <code class="docutils literal notranslate"><span class="pre">macvlan</span></code>, dont les routes partent avec lui. Chaque étape tolère ce qui est
déjà absent : une suppression interrompue se relance depuis <code class="docutils literal notranslate"><span class="pre">error</span></code>.</p>
<p>Le segment public n’apparaît pas dans <code class="docutils literal notranslate"><span class="pre">main</span></code> du fait de l’IP flottante : sinon, une VM sans IP
flottante du même netns pourrait sortir par <code class="docutils literal notranslate"><span class="pre">fip-…</span></code> sans traduction, et la réponse d’une VM à
IP flottante vers une adresse du segment (la bordure elle-même) sortirait par la passerelle NAT
avec son adresse privée.</p>
</section>
<section id="deplacer-une-ip-flottante">
<h2>Déplacer une IP flottante<a class="headerlink" href="#deplacer-une-ip-flottante" title="Lien vers cette rubrique">#</a></h2>
<p>Quand la VM change d’hôte, l’appelant supprime l’IP flottante sur l’ancien hôte, puis la crée sur
le nouveau. La MAC étant la même, le déplacement se réduit à un ARP gratuit et à la mobilité MAC
d’EVPN. Les connexions en cours sont perdues.</p>
</section>
<section id="limites">
<h2>Limites<a class="headerlink" href="#limites" title="Lien vers cette rubrique">#</a></h2>
<ul class="simple">
<li><p>IPv4 seulement.</p></li>
<li><p>Refusée (409) sur une interface d’un subnet <code class="docutils literal notranslate"><span class="pre">public_ip</span></code> : la VM y porte déjà son IP publique.</p></li>
<li><p>Une VM qui joint l’IP flottante d’une autre VM passe par les bordures.</p></li>
</ul>
</section>
</section>
</article>
<footer class="prev-next-footer d-print-none">
<div class="prev-next-area">
<a class="left-prev"
href="passerelle-nat.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">Passerelle NAT</p>
</div>
</a>
<a class="right-next"
href="../architecture/index.html"
title="page suivante">
<div class="prev-next-info">
<p class="prev-next-subtitle">suivant</p>
<p class="prev-next-title">Architecture</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="#ce-que-l-agent-pose">Ce que l’agent pose</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#deplacer-une-ip-flottante">Déplacer une IP flottante</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#limites">Limites</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>

View file

@ -670,6 +670,8 @@ window.runMermaid = runMermaid;</script>
<li class="toctree-l2"><a class="reference internal" href="cycle-de-vie.html">Cycle de vie des ressources</a></li>
<li class="toctree-l2 current active"><a class="current reference internal" href="#">Metadata et cloud-init</a></li>
<li class="toctree-l2"><a class="reference internal" href="dns-ntp.html">DNS et NTP des VM</a></li>
<li class="toctree-l2"><a class="reference internal" href="passerelle-nat.html">Passerelle NAT</a></li>
<li class="toctree-l2"><a class="reference internal" href="ip-flottante.html">IP flottante</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>

View file

@ -670,6 +670,8 @@ window.runMermaid = runMermaid;</script>
<li class="toctree-l2"><a class="reference internal" href="cycle-de-vie.html">Cycle de vie des ressources</a></li>
<li class="toctree-l2"><a class="reference internal" href="metadata-cloud-init.html">Metadata et cloud-init</a></li>
<li class="toctree-l2"><a class="reference internal" href="dns-ntp.html">DNS et NTP des VM</a></li>
<li class="toctree-l2"><a class="reference internal" href="passerelle-nat.html">Passerelle NAT</a></li>
<li class="toctree-l2"><a class="reference internal" href="ip-flottante.html">IP flottante</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>
@ -788,6 +790,7 @@ window.runMermaid = runMermaid;</script>
</ul>
</li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#bridge">bridge</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#public-ip">public_ip</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#regles-de-pont">Règles de pont</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#routes-annoncees-aux-vm">Routes annoncées aux VM</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#route-par-defaut-default-route-et-gateway">Route par défaut : <code class="docutils literal notranslate"><span class="pre">default_route</span></code> et <code class="docutils literal notranslate"><span class="pre">gateway</span></code></a></li>
@ -829,8 +832,9 @@ annoncées aux VM.</p>
<td><p>disponible</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">public_ip</span></code></p></td>
<td><p>routé comme <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> côté DHCP</p></td>
<td><p><strong>mise en place host non implémentée</strong> — la création échoue à l’exécution</p></td>
<td><p>comme <code class="docutils literal notranslate"><span class="pre">bridge</span></code>, toujours au bridge public de l’host (<code class="docutils literal notranslate"><span class="pre">interfaces.internet</span></code>) ; la VM
porte son IP publique</p></td>
<td><p>disponible</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">vlan</span></code></p></td>
<td><p>—</p></td>
@ -839,12 +843,6 @@ annoncées aux VM.</p>
</tbody>
</table>
</div>
<div class="admonition warning">
<p class="admonition-title">Avertissement</p>
<p><code class="docutils literal notranslate"><span class="pre">public_ip</span></code> est accepté par l’API et traité comme <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> pour le DHCP, mais sa
configuration réseau côté host n’existe pas encore : la création part en <code class="docutils literal notranslate"><span class="pre">error</span></code> dans
<code class="docutils literal notranslate"><span class="pre">Execute</span></code>. Ne pas s’appuyer dessus en production.</p>
</div>
<section id="vxlan">
<h2>vxlan<a class="headerlink" href="#vxlan" title="Lien vers cette rubrique">#</a></h2>
<pre class="mermaid">
@ -943,6 +941,28 @@ Par conception, une VM ne joint pas le netns d’un autre hôte. Les règles son
suppression du subnet ; une règle déjà absente ne fait pas échouer la suppression. Le watchdog
signale les règles manquantes et celles qui ne sont pas de l’agent.</p>
</section>
<section id="public-ip">
<h2>public_ip<a class="headerlink" href="#public-ip" title="Lien vers cette rubrique">#</a></h2>
<p>La VM <strong>porte elle-même une IP publique</strong>, sans NAT. Le subnet est raccordé comme un subnet
<code class="docutils literal notranslate"><span class="pre">bridge</span></code>, mais toujours au <strong>bridge public</strong> de l’host (<code class="docutils literal notranslate"><span class="pre">interfaces.internet</span></code>, <code class="docutils literal notranslate"><span class="pre">br-public</span></code>
par défaut) ; <code class="docutils literal notranslate"><span class="pre">iface_type</span></code> est ignoré. Le bridge du subnet dans le netns porte
<code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> ; un veth <code class="docutils literal notranslate"><span class="pre">v-&lt;subnet&gt;-e</span></code> le relie au bridge public. Le <code class="docutils literal notranslate"><span class="pre">br-public</span></code> propre au
netns n’est pas utilisé.</p>
<p>Une plage publique (plusieurs /24 cohabitent sur le segment) est partagée par tous les VPC qui en
demandent : <strong>chaque VPC a son propre subnet</strong>, avec la <strong>même</strong> <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code>, sur un même
hôte comme sur des hôtes différents. Les règles de confinement du mode <code class="docutils literal notranslate"><span class="pre">bridge</span></code> sont posées sur
chaque <code class="docutils literal notranslate"><span class="pre">v-&lt;subnet&gt;-i</span></code> : une VM ne résout <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> que vers le netns de son VPC (sa
gateway, son DHCP, son DNS et son NTP), et <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> n’est jamais visible sur le segment.</p>
<p>Le <strong>nom</strong> de chaque subnet est choisi par l’appelant et doit être <strong>unique sur l’hyperviseur</strong> :
l’orchestrateur tient un seul subnet public (<code class="docutils literal notranslate"><span class="pre">pub-203</span></code> par exemple) et en crée une instance par
VPC (<code class="docutils literal notranslate"><span class="pre">pub-203a42</span></code> pour <code class="docutils literal notranslate"><span class="pre">vp-42</span></code>). La partie qui suit le premier tiret sert aux noms d’interface
(<code class="docutils literal notranslate"><span class="pre">br-&lt;id&gt;</span></code>, <code class="docutils literal notranslate"><span class="pre">v-&lt;id&gt;-e</span></code>) : 10 caractères au plus.</p>
<p>Routes annoncées : la route par défaut vers la <code class="docutils literal notranslate"><span class="pre">gateway</span></code> fournie (<code class="docutils literal notranslate"><span class="pre">default_route:</span> <span class="pre">true</span></code> et
<code class="docutils literal notranslate"><span class="pre">gateway</span></code> obligatoires ensemble), la route du <code class="docutils literal notranslate"><span class="pre">cidr</span></code> du VPC vers <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code>. Le contrôle
de MTU est celui du mode <code class="docutils literal notranslate"><span class="pre">bridge</span></code>, appliqué au bridge public. Les VM de plages publiques se
joignent directement sur le segment ; le filtrage au port les empêche d’usurper l’IP ou la MAC
d’une autre. Une interface d’un subnet <code class="docutils literal notranslate"><span class="pre">public_ip</span></code> ne reçoit pas d”<a class="reference internal" href="ip-flottante.html"><span class="doc">IP flottante</span></a> (409).</p>
</section>
<section id="regles-de-pont">
<h2>Règles de pont<a class="headerlink" href="#regles-de-pont" title="Lien vers cette rubrique">#</a></h2>
<p>Dans les deux modes, les règles de couche 2 vivent dans une table nftables <code class="docutils literal notranslate"><span class="pre">bridge</span> <span class="pre">two</span></code> du netns
@ -1067,6 +1087,7 @@ silencieusement.</p>
</ul>
</li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#bridge">bridge</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#public-ip">public_ip</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#regles-de-pont">Règles de pont</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#routes-annoncees-aux-vm">Routes annoncées aux VM</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#route-par-defaut-default-route-et-gateway">Route par défaut : <code class="docutils literal notranslate"><span class="pre">default_route</span></code> et <code class="docutils literal notranslate"><span class="pre">gateway</span></code></a></li>

File diff suppressed because it is too large Load diff

View file

@ -670,6 +670,8 @@ window.runMermaid = runMermaid;</script>
<li class="toctree-l2"><a class="reference internal" href="cycle-de-vie.html">Cycle de vie des ressources</a></li>
<li class="toctree-l2"><a class="reference internal" href="metadata-cloud-init.html">Metadata et cloud-init</a></li>
<li class="toctree-l2"><a class="reference internal" href="dns-ntp.html">DNS et NTP des VM</a></li>
<li class="toctree-l2"><a class="reference internal" href="passerelle-nat.html">Passerelle NAT</a></li>
<li class="toctree-l2"><a class="reference internal" href="ip-flottante.html">IP flottante</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>
@ -819,6 +821,13 @@ public est celui de <code class="docutils literal notranslate"><span class="pre"
<code class="docutils literal notranslate"><span class="pre">default_interface</span></code> (<a class="reference internal" href="../exploitation/configuration.html"><span class="doc">Configuration</span></a>). <code class="docutils literal notranslate"><span class="pre">deploy.sh</span> <span class="pre">-i</span></code> le crée et y
accroche <code class="docutils literal notranslate"><span class="pre">vxlan-public</span></code>, le VXLAN du segment public partagé avec les bordures
(<a class="reference internal" href="../demarrage/installation.html"><span class="doc">Installation d’un hyperviseur</span></a>) ; sans ce bridge, toute création de VPC échoue.</p>
<p>Le <code class="docutils literal notranslate"><span class="pre">br-public</span></code> du netns n’est qu’un point de raccordement : rien n’entre dans le VPC par lui.
L’agent y pose <code class="docutils literal notranslate"><span class="pre">arp_ignore=1</span></code> (il ne répond pas à l’ARP pour les adresses du netns) et, dans la
table nftables <code class="docutils literal notranslate"><span class="pre">ip</span> <span class="pre">two</span></code>, rejette tout IP arrivé par <code class="docutils literal notranslate"><span class="pre">br-public</span></code> (chaînes <code class="docutils literal notranslate"><span class="pre">in-br-public</span></code> et
<code class="docutils literal notranslate"><span class="pre">fwd-br-public</span></code>). Seules les interfaces publiques prévues — passerelle NAT, IP flottante — y
reçoivent du trafic. Il désactive aussi <code class="docutils literal notranslate"><span class="pre">br_netfilter</span></code> dans le netns
(<code class="docutils literal notranslate"><span class="pre">net.bridge.bridge-nf-call-{iptables,ip6tables,arptables}=0</span></code>, quand le module est chargé) : sinon
conntrack voit chaque trame pontée et le SNAT de la passerelle NAT ne s’applique plus.</p>
<p>Dans le netns, l’agent pose aussi la <code class="docutils literal notranslate"><span class="pre">dummy</span></code> <code class="docutils literal notranslate"><span class="pre">hostsvc</span></code> (<code class="docutils literal notranslate"><span class="pre">169.254.169.253/32</span></code>) et la chaîne
iptables <code class="docutils literal notranslate"><span class="pre">TWO-HOSTSVC</span></code>, puis demande à <code class="docutils literal notranslate"><span class="pre">two-hostsvc</span></code> de servir le VPC : c’est le chemin du
DNS et du NTP des VM (voir <a class="reference internal" href="dns-ntp.html"><span class="doc">DNS et NTP des VM</span></a>). Si <code class="docutils literal notranslate"><span class="pre">two-hostsvc</span></code> ne répond pas, la création du VPC
@ -845,19 +854,23 @@ passe en <code class="docutils literal notranslate"><span class="pre">error</spa
└── l3-&lt;id&gt;-o 169.254.0.1/30 ── l3-&lt;id&gt;-i 169.254.0.2/30, dans le netns du VPC
</pre></div>
</div>
<p>Dans le netns, le <code class="docutils literal notranslate"><span class="pre">cidr</span></code> du VPC est routé vers <code class="docutils literal notranslate"><span class="pre">169.254.0.1</span></code> ; le transit <code class="docutils literal notranslate"><span class="pre">/30</span></code> est le même
<p>Dans le netns, le <code class="docutils literal notranslate"><span class="pre">cidr</span></code> du VPC et la route par défaut sont routés vers <code class="docutils literal notranslate"><span class="pre">169.254.0.1</span></code> : sans
passerelle NAT, l”<code class="docutils literal notranslate"><span class="pre">unreachable</span> <span class="pre">default</span></code> de la VRF rejette ce qui n’est pas dans le VPC (voir
<a class="reference internal" href="passerelle-nat.html"><span class="doc">Passerelle NAT</span></a>) ; le transit <code class="docutils literal notranslate"><span class="pre">/30</span></code> est le même
sur tous les hyperviseurs et pour tous les VPC. L’agent active le forwarding IPv4 dans le netns,
et sur l’hôte sur <code class="docutils literal notranslate"><span class="pre">brl3-&lt;id&gt;</span></code> et <code class="docutils literal notranslate"><span class="pre">l3-&lt;id&gt;-o</span></code>, les deux interfaces d’entrée de la VRF ; il ne
touche pas au réglage global, que <code class="docutils literal notranslate"><span class="pre">bootstrap_kvm.sh</span></code> met déjà à 1. FRR reçoit la VRF, son <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">&lt;asn&gt;</span> <span class="pre">vrf</span> <span class="pre">vrf-&lt;id&gt;</span></code> avec RD <code class="docutils literal notranslate"><span class="pre">&lt;VTEP&gt;:&lt;l3vni&gt;</span></code> et RT <code class="docutils literal notranslate"><span class="pre">&lt;asn&gt;:&lt;l3vni&gt;</span></code>, et
l’export des routes du <code class="docutils literal notranslate"><span class="pre">cidr</span></code> présentes dans la VRF.</p>
l’export des routes du <code class="docutils literal notranslate"><span class="pre">cidr</span></code> présentes dans la VRF, et de la route par défaut de la passerelle
NAT.</p>
<p>La table de la VRF reçoit, juste après sa création, une route <code class="docutils literal notranslate"><span class="pre">unreachable</span> <span class="pre">default</span></code> de métrique
maximale (<code class="docutils literal notranslate"><span class="pre">4278198272</span></code>, valeur recommandée par la documentation VRF du noyau). Sans elle, une
recherche qui échoue dans la VRF continue dans les règles suivantes, donc dans la table <code class="docutils literal notranslate"><span class="pre">main</span></code>
de l’hôte : un paquet d’un locataire vers une adresse inconnue de la VRF sortirait par l’underlay,
avec <code class="docutils literal notranslate"><span class="pre">169.254.0.2</span></code> pour source (mesuré, <a class="reference external" href="https://git.g3e.fr/syonad/two/issues/81">#81</a>). La
métrique maximale laisse passer avant elle toute route réelle de la VRF. Cette route n’est pas
annoncée en EVPN : le route-map de la VRF n’exporte que le <code class="docutils literal notranslate"><span class="pre">cidr</span></code> du VPC. Elle n’est liée à
annoncée en EVPN : le route-map de la VRF n’exporte que le <code class="docutils literal notranslate"><span class="pre">cidr</span></code> du VPC, et la route par
défaut seulement quand son next-hop est <code class="docutils literal notranslate"><span class="pre">169.254.0.2</span></code>, celle d’une passerelle NAT. Elle n’est liée à
aucune interface et ne disparaît pas avec la VRF : la suppression la retire explicitement. IPv4
seulement.</p>
<p>La suppression retire d’abord la configuration de routage de FRR, puis les interfaces, la route
@ -885,7 +898,12 @@ filet qui couvre une VM tant que son <code class="docutils literal notranslate">
<h2>VM<a class="headerlink" href="#vm" title="Lien vers cette rubrique">#</a></h2>
<p>Une VM est un processus QEMU/KVM raccordé à un ou plusieurs subnets par des taps.</p>
<p><strong>Interfaces.</strong> L’ordre du tableau <code class="docutils literal notranslate"><span class="pre">interfaces</span></code> détermine le slot PCI (<code class="docutils literal notranslate"><span class="pre">0x03</span> <span class="pre">+</span> <span class="pre">index</span></code>), donc
le nom de l’interface dans le guest. Exactement une interface doit être <code class="docutils literal notranslate"><span class="pre">primary</span></code> : elle porte
le nom de l’interface dans le guest. Chaque interface porte un <code class="docutils literal notranslate"><span class="pre">name</span></code>, obligatoire et unique dans
la VM, choisi par l’appelant (<code class="docutils literal notranslate"><span class="pre">nic-a1b2</span></code> par exemple) : c’est l’identifiant stable par lequel
l’API désigne une interface, son rang pouvant changer. Aucune interface Linux n’en tire son nom,
ni dans le guest ni sur l’hôte. Une <a class="reference internal" href="ip-flottante.html"><span class="doc">IP flottante</span></a> désigne l’interface par ce
nom ; le <code class="docutils literal notranslate"><span class="pre">GET</span></code> de la VM l’affiche sur l’interface (<code class="docutils literal notranslate"><span class="pre">floating_ip</span></code>, en lecture seule, refusé à la
création), et la suppression de la VM est refusée (409) tant qu’elle est attachée. Exactement une interface doit être <code class="docutils literal notranslate"><span class="pre">primary</span></code> : elle porte
la route par défaut et le serveur de metadata. Tous les subnets d’une VM doivent appartenir au
<strong>même VPC</strong>.</p>
<p><strong>MAC.</strong> Chaque interface porte la MAC choisie par l’appelant, comme son IP. L’agent la donne