docs: build de dae1d0a935
This commit is contained in:
parent
cfa8d8d82d
commit
314bcd7d4e
40 changed files with 2298 additions and 34 deletions
|
|
@ -234,6 +234,8 @@
|
|||
<li class="toctree-l2"><a class="reference internal" href="../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/ip-flottante.html">IP flottante</a></li>
|
||||
</ul>
|
||||
</details></li>
|
||||
<li class="toctree-l1 current active has-children"><a class="reference internal" href="index.html">Architecture</a><details open="open"><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul class="current">
|
||||
|
|
|
|||
|
|
@ -56,7 +56,7 @@
|
|||
<link rel="index" title="Index" href="../genindex.html" />
|
||||
<link rel="search" title="Recherche" href="../search.html" />
|
||||
<link rel="next" title="Vue d’ensemble" href="vue-densemble.html" />
|
||||
<link rel="prev" title="DNS et NTP des VM" href="../concepts/dns-ntp.html" />
|
||||
<link rel="prev" title="IP flottante" href="../concepts/ip-flottante.html" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1"/>
|
||||
<meta name="docsearch:language" content="fr"/>
|
||||
<meta name="docsearch:version" content="0.2" />
|
||||
|
|
@ -234,6 +234,8 @@
|
|||
<li class="toctree-l2"><a class="reference internal" href="../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/ip-flottante.html">IP flottante</a></li>
|
||||
</ul>
|
||||
</details></li>
|
||||
<li class="toctree-l1 current active has-children"><a class="current reference internal" href="#">Architecture</a><details open="open"><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
|
||||
|
|
@ -371,12 +373,12 @@ enfreindre. Ces pages s’adressent à qui modifie le code.</p>
|
|||
|
||||
<div class="prev-next-area">
|
||||
<a class="left-prev"
|
||||
href="../concepts/dns-ntp.html"
|
||||
href="../concepts/ip-flottante.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">DNS et NTP des VM</p>
|
||||
<p class="prev-next-title">IP flottante</p>
|
||||
</div>
|
||||
</a>
|
||||
<a class="right-next"
|
||||
|
|
|
|||
|
|
@ -234,6 +234,8 @@
|
|||
<li class="toctree-l2"><a class="reference internal" href="../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/ip-flottante.html">IP flottante</a></li>
|
||||
</ul>
|
||||
</details></li>
|
||||
<li class="toctree-l1 current active has-children"><a class="reference internal" href="index.html">Architecture</a><details open="open"><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul class="current">
|
||||
|
|
@ -376,6 +378,7 @@ subnet/<name>/default_route → "true" | "false"
|
|||
subnet/<name>/gateway → <ip> (optionnel)
|
||||
|
||||
vm/<name>/state → creating | running | error | deleting | deleted
|
||||
vm/<name>/nic/<i>/name → <nom> (choisi par l'appelant, unique dans la VM)
|
||||
vm/<name>/nic/<i>/subnet → <subnet-name> (une interface par index, ordre du tableau interfaces)
|
||||
vm/<name>/nic/<i>/ip → <ip>
|
||||
vm/<name>/nic/<i>/mac → <mac> (fournie par l'appelant, conservée telle quelle)
|
||||
|
|
@ -390,6 +393,17 @@ vm/<name>/uefi → "true" (absent si SeaBIOS)
|
|||
vm/<name>/password → <hash> (optionnel — un hash, pas un mot de passe)
|
||||
vm/<name>/sshkey → <pubkey> (optionnel)
|
||||
vm/<name>/metadata/<document> → <contenu brut> (optionnel : user-data, vendor-data, …)
|
||||
|
||||
nat-gateway/<name>/state → creating | running | error | deleting | deleted
|
||||
nat-gateway/<name>/vpc → <vpc-name> (une passerelle par VPC)
|
||||
nat-gateway/<name>/ip → <ip>/<préfixe> (IP de sortie, telle que fournie)
|
||||
nat-gateway/<name>/gateway → <ip> (gateway des bordures)
|
||||
|
||||
floating-ip/<name>/state → creating | running | error | deleting | deleted
|
||||
floating-ip/<name>/vm → <vm-name>
|
||||
floating-ip/<name>/interface → <nom> (nom de l'interface de la VM ; l'IP privée y est lue)
|
||||
floating-ip/<name>/ip → <ip>/<préfixe> (IP publique, telle que fournie)
|
||||
floating-ip/<name>/gateway → <ip> (gateway des bordures)
|
||||
</pre></div>
|
||||
</div>
|
||||
<section id="regles">
|
||||
|
|
@ -407,6 +421,8 @@ recopie la MAC de chaque interface existante dans <code class="docutils literal
|
|||
clés. Les VM <code class="docutils literal notranslate"><span class="pre">deleted</span></code> sont ignorées. Une interface dont la MAC est introuvable fait échouer le
|
||||
démarrage en la nommant, et la table reste en place tant que toutes les interfaces ne sont pas
|
||||
migrées.</p>
|
||||
<p><strong>Interfaces sans nom.</strong> Avant la 0.3.0, une interface n’avait pas de nom. Au démarrage, l’agent
|
||||
nomme <code class="docutils literal notranslate"><span class="pre">nic-<i></span></code> chaque interface qui n’en a pas, d’après son rang ; un nom existant est gardé.</p>
|
||||
<p><strong>Anciens noms de disques.</strong> Jusqu’en 0.1.0, les disques additionnels s’appelaient <code class="docutils literal notranslate"><span class="pre">sdX</span></code>. Au
|
||||
démarrage, l’agent renomme chaque clé <code class="docutils literal notranslate"><span class="pre">vm/<name>/disk/sdX</span></code> en <code class="docutils literal notranslate"><span class="pre">vm/<name>/disk/xvdX</span></code> (même
|
||||
lettre, même cible SCSI). Si <code class="docutils literal notranslate"><span class="pre">xvdX</span></code> existe déjà avec un autre chemin, le démarrage échoue en
|
||||
|
|
|
|||
|
|
@ -234,6 +234,8 @@
|
|||
<li class="toctree-l2"><a class="reference internal" href="../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/ip-flottante.html">IP flottante</a></li>
|
||||
</ul>
|
||||
</details></li>
|
||||
<li class="toctree-l1 current active has-children"><a class="reference internal" href="index.html">Architecture</a><details open="open"><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul class="current">
|
||||
|
|
|
|||
|
|
@ -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>
|
||||
|
|
|
|||
|
|
@ -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>
|
||||
|
|
|
|||
|
|
@ -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>
|
||||
|
|
|
|||
548
main/concepts/ip-flottante.html
Normal file
548
main/concepts/ip-flottante.html
Normal 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 — 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-<IP</span> <span class="pre">publique</span> <span class="pre">en</span> <span class="pre">hexadécimal></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"><privée></span> <span class="pre">to</span> <span class="pre"><cidr</span> <span class="pre">du</span> <span class="pre">VPC></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"><privée></span> <span class="pre">lookup</span> <span class="pre"><table</span> <span class="pre">propre></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>
|
||||
|
|
@ -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>
|
||||
|
|
|
|||
|
|
@ -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-<subnet>-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-<subnet>-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-<id></span></code>, <code class="docutils literal notranslate"><span class="pre">v-<id>-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>
|
||||
|
|
|
|||
1002
main/concepts/passerelle-nat.html
Normal file
1002
main/concepts/passerelle-nat.html
Normal file
File diff suppressed because it is too large
Load diff
|
|
@ -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-<id>-o 169.254.0.1/30 ── l3-<id>-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-<id></span></code> et <code class="docutils literal notranslate"><span class="pre">l3-<id>-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"><asn></span> <span class="pre">vrf</span> <span class="pre">vrf-<id></span></code> avec RD <code class="docutils literal notranslate"><span class="pre"><VTEP>:<l3vni></span></code> et RT <code class="docutils literal notranslate"><span class="pre"><asn>:<l3vni></span></code>, et
|
||||
l’export des routes du <code class="docutils literal notranslate"><span class="pre">cidr</span></code> 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
|
||||
|
|
|
|||
|
|
@ -234,6 +234,8 @@
|
|||
<li class="toctree-l2"><a class="reference internal" href="../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/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>
|
||||
|
|
|
|||
|
|
@ -234,6 +234,8 @@
|
|||
<li class="toctree-l2"><a class="reference internal" href="../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/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>
|
||||
|
|
|
|||
|
|
@ -670,6 +670,8 @@ window.runMermaid = runMermaid;</script>
|
|||
<li class="toctree-l2"><a class="reference internal" href="../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/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>
|
||||
|
|
|
|||
|
|
@ -234,6 +234,8 @@
|
|||
<li class="toctree-l2"><a class="reference internal" href="../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/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>
|
||||
|
|
|
|||
|
|
@ -670,6 +670,8 @@ window.runMermaid = runMermaid;</script>
|
|||
<li class="toctree-l2"><a class="reference internal" href="../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/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>
|
||||
|
|
|
|||
|
|
@ -234,6 +234,8 @@
|
|||
<li class="toctree-l2"><a class="reference internal" href="../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/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>
|
||||
|
|
|
|||
|
|
@ -234,6 +234,8 @@
|
|||
<li class="toctree-l2"><a class="reference internal" href="../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/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>
|
||||
|
|
|
|||
|
|
@ -234,6 +234,8 @@
|
|||
<li class="toctree-l2"><a class="reference internal" href="../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/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>
|
||||
|
|
|
|||
|
|
@ -234,6 +234,8 @@
|
|||
<li class="toctree-l2"><a class="reference internal" href="../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/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>
|
||||
|
|
|
|||
|
|
@ -234,6 +234,8 @@
|
|||
<li class="toctree-l2"><a class="reference internal" href="../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/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>
|
||||
|
|
|
|||
|
|
@ -234,6 +234,8 @@
|
|||
<li class="toctree-l2"><a class="reference internal" href="../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/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>
|
||||
|
|
@ -878,37 +880,52 @@ fait en fermant le ticket. Chaque ticket concerné liste ses marqueurs en commen
|
|||
<td><p>hv1 hv2 hv3</p></td>
|
||||
<td><p>#87</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">51-l3vni</span></code></p></td>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">46-passerelle-nat</span></code></p></td>
|
||||
<td><p>passerelle NAT d’un VPC — macvlan ng-<id> sur le br-public du netns, MAC 02:04:00 + l3vni, SNAT vers l’IP de sortie (source vue à la sortie du netns), route par défaut en type 5 importée par un autre hôte, unreachable default jamais annoncée, rien n’entre sans connexion établie, refus 409, suppression propre, bascule vers un autre hôte par mobilité MAC</p></td>
|
||||
<td><p>hv1 hv2 hv3</p></td>
|
||||
<td><p>#42</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">47-ip-flottante</span></code></p></td>
|
||||
<td><p>IP flottante d’une interface de VM — macvlan fip-<hex> sur le br-public du netns, MAC 02:05 + IP publique, NAT 1:1 sans état, routage par source (sortie par l’IP flottante, pas par la passerelle NAT du VPC), entrée neuve depuis le segment public, métadonnées servies, affichage sur la VM, refus 409, détachement, déplacement vers un autre hôte par mobilité MAC</p></td>
|
||||
<td><p>hv1 hv2 hv3</p></td>
|
||||
<td><p>#88</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">48-subnet-public</span></code></p></td>
|
||||
<td><p>subnet public_ip — VM qui porte son IP publique, subnet raccordé au bridge public de l’hôte (iface_type ignoré), même plage et même interface_ip pour plusieurs VPC sur un même hôte et sur deux hôtes, interface_ip invisible sur le segment, gateway et DNS propres à chaque VPC, sortie et entrée sans NAT, usurpation refusée, IP flottante refusée</p></td>
|
||||
<td><p>hv1 hv2 hv3</p></td>
|
||||
<td><p>#89</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">51-l3vni</span></code></p></td>
|
||||
<td><p>routage inter-subnet entre hôtes par L3VNI (IRB symétrique) — VRF, RMAC, exports /24 et /32, RT-5 réfléchies, TTL, isolation par RT, unreachable default dans la VRF, démontage d’un VPC routé</p></td>
|
||||
<td><p>hv1 hv2</p></td>
|
||||
<td><p>#41, #81</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">52-migration</span></code></p></td>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">52-migration</span></code></p></td>
|
||||
<td><p>migration d’une adresse de VM entre hôtes d’un VPC routé — /32 retiré en premier, /24 en filet puis en ECMP, séquence orchestrée, 40 sources, suppression du subnet refusée tant qu’une VM l’utilise, MAC anycast hors EVPN</p></td>
|
||||
<td><p>hv1 hv2 hv3</p></td>
|
||||
<td><p>#41, #57</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">53-watchdog-l3</span></code></p></td>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">53-watchdog-l3</span></code></p></td>
|
||||
<td><p>watchdog d’un VPC routé — /32 orphelin signalé comme trou noir, /32 manquant signalé, unreachable default absente signalée, aucune fausse alerte BGP ni L3VNI, trafic intact après les essais</p></td>
|
||||
<td><p>hv1 hv3</p></td>
|
||||
<td><p>#41, #81</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">61-redemarrage-agent</span></code></p></td>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">61-redemarrage-agent</span></code></p></td>
|
||||
<td><p>redémarrage de l’agent avec des VM en marche — rien ne disparaît ni n’est recréé, trafic routé sans perte, DHCP et métadonnées servis, base BGP réappliquée à l’identique, ressources toujours gérées</p></td>
|
||||
<td><p>hv1 hv2</p></td>
|
||||
<td><p>#41, #46</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">62-nettoyage-global</span></code></p></td>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">62-nettoyage-global</span></code></p></td>
|
||||
<td><p>nettoyage global en fin de suite — aucun hôte ne garde de ressource : API vide, ni netns, tap, VRF, unité, instance DHCP ou de métadonnées, processus QEMU, règle de port, volume ; FRR réduit à la base BGP</p></td>
|
||||
<td></td>
|
||||
<td><p>#70</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">71-perte-rr</span></code></p></td>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">71-perte-rr</span></code></p></td>
|
||||
<td><p>perte d’un route reflector — l’autre garde la session EVPN, le VTEP distant reste connu, le trafic L2 entre hôtes passe sans perte mesurable, retour du RR arrêté</p></td>
|
||||
<td><p>hv1 hv2</p></td>
|
||||
<td><p>#54</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">72-perte-switch</span></code></p></td>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">72-perte-switch</span></code></p></td>
|
||||
<td><p>perte d’un switch de la passerelle VRRP — bascule vers l’autre en moins de 5 s, sessions EVPN jamais coupées ; au retour, un seul maître (préemption désactivée : celui qui l’est est relevé), plus long silence mesuré</p></td>
|
||||
<td></td>
|
||||
<td><p>#54, #69, #80</p></td>
|
||||
|
|
|
|||
|
|
@ -670,6 +670,8 @@ window.runMermaid = runMermaid;</script>
|
|||
<li class="toctree-l2"><a class="reference internal" href="../../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../../concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../../concepts/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>
|
||||
|
|
|
|||
|
|
@ -234,6 +234,8 @@
|
|||
<li class="toctree-l2"><a class="reference internal" href="../../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../../concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../../concepts/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>
|
||||
|
|
|
|||
|
|
@ -234,6 +234,8 @@
|
|||
<li class="toctree-l2"><a class="reference internal" href="../../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../../concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../../concepts/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>
|
||||
|
|
@ -562,7 +564,7 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
|
|||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/409">409 Conflict</a></span> – <p>VPC not deletable — only running or error states can be deleted, and all its subnets must be deleted or deleting; subnets still deleting are awaited by the asynchronous deletion</p>
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/409">409 Conflict</a></span> – <p>VPC not deletable — only running or error states can be deleted, all its subnets must be deleted or deleting (subnets still deleting are awaited by the asynchronous deletion), and its NAT gateway, if any, must be deleted first</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">409</span> <span class="ne">Conflict</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
|
@ -615,11 +617,17 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
|
|||
<span class="w"> </span><span class="nt">"cpus"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"interfaces"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
|
||||
<span class="w"> </span><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"subnet"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"ip"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"mac"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"primary"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"dhcp_server"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span>
|
||||
<span class="w"> </span><span class="nt">"dhcp_server"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"floating_ip"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"ip"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"state"</span><span class="p">:</span><span class="w"> </span><span class="s2">"creating"</span>
|
||||
<span class="w"> </span><span class="p">}</span>
|
||||
<span class="w"> </span><span class="p">}</span>
|
||||
<span class="w"> </span><span class="p">],</span>
|
||||
<span class="w"> </span><span class="nt">"storage"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
|
||||
|
|
@ -670,6 +678,7 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
|
|||
<span class="w"> </span><span class="p">},</span>
|
||||
<span class="w"> </span><span class="nt">"interfaces"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
|
||||
<span class="w"> </span><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"subnet"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"ip"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"mac"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
|
|
@ -703,11 +712,17 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
|
|||
<span class="w"> </span><span class="nt">"cpus"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"interfaces"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
|
||||
<span class="w"> </span><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"subnet"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"ip"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"mac"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"primary"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"dhcp_server"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span>
|
||||
<span class="w"> </span><span class="nt">"dhcp_server"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"floating_ip"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"ip"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"state"</span><span class="p">:</span><span class="w"> </span><span class="s2">"creating"</span>
|
||||
<span class="w"> </span><span class="p">}</span>
|
||||
<span class="w"> </span><span class="p">}</span>
|
||||
<span class="w"> </span><span class="p">],</span>
|
||||
<span class="w"> </span><span class="nt">"storage"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
|
||||
|
|
@ -802,11 +817,17 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
|
|||
<span class="w"> </span><span class="nt">"cpus"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"interfaces"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
|
||||
<span class="w"> </span><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"subnet"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"ip"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"mac"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"primary"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"dhcp_server"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span>
|
||||
<span class="w"> </span><span class="nt">"dhcp_server"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"floating_ip"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"ip"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"state"</span><span class="p">:</span><span class="w"> </span><span class="s2">"creating"</span>
|
||||
<span class="w"> </span><span class="p">}</span>
|
||||
<span class="w"> </span><span class="p">}</span>
|
||||
<span class="w"> </span><span class="p">],</span>
|
||||
<span class="w"> </span><span class="nt">"storage"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
|
||||
|
|
@ -872,11 +893,17 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
|
|||
<span class="w"> </span><span class="nt">"cpus"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"interfaces"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
|
||||
<span class="w"> </span><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"subnet"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"ip"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"mac"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"primary"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"dhcp_server"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span>
|
||||
<span class="w"> </span><span class="nt">"dhcp_server"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"floating_ip"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"ip"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"state"</span><span class="p">:</span><span class="w"> </span><span class="s2">"creating"</span>
|
||||
<span class="w"> </span><span class="p">}</span>
|
||||
<span class="w"> </span><span class="p">}</span>
|
||||
<span class="w"> </span><span class="p">],</span>
|
||||
<span class="w"> </span><span class="nt">"storage"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
|
||||
|
|
@ -901,7 +928,7 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
|
|||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/409">409 Conflict</a></span> – <p>VM not stoppable — only running or error states can be stopped</p>
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/409">409 Conflict</a></span> – <p>VM not stoppable — only running or error states can be stopped, and its floating IPs must be deleted first</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">409</span> <span class="ne">Conflict</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
|
@ -1212,6 +1239,501 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
|
|||
</dl>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="http get">
|
||||
<dt class="sig sig-object http" id="get--nat-gateways">
|
||||
<span class="sig-name descname"><span class="pre">GET</span> </span><span class="sig-name descname"><span class="pre">/nat-gateways</span></span><a class="headerlink" href="#get--nat-gateways" title="Lien vers cette définition">#</a></dt>
|
||||
<dd><p><strong>List all NAT gateways of this agent</strong></p>
|
||||
<p><strong>Example request:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="nf">GET</span> <span class="nn">/nat-gateways</span> <span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span>
|
||||
<span class="na">Host</span><span class="o">:</span> <span class="l">example.com</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<dl class="field-list simple">
|
||||
<dt class="field-odd">Codes de statut<span class="colon">:</span></dt>
|
||||
<dd class="field-odd"><ul class="simple">
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/200">200 OK</a></span> – <p>List of NAT gateways</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">200</span> <span class="ne">OK</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">[</span>
|
||||
<span class="w"> </span><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"state"</span><span class="p">:</span><span class="w"> </span><span class="s2">"creating"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"vpc"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"ip"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"gateway"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="w"> </span><span class="p">}</span>
|
||||
<span class="p">]</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/500">500 Internal Server Error</a></span> – <p>Internal server error</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">500</span> <span class="ne">Internal Server Error</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
</ul>
|
||||
</dd>
|
||||
</dl>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="http post">
|
||||
<dt class="sig sig-object http" id="post--nat-gateways">
|
||||
<span class="sig-name descname"><span class="pre">POST</span> </span><span class="sig-name descname"><span class="pre">/nat-gateways</span></span><a class="headerlink" href="#post--nat-gateways" title="Lien vers cette définition">#</a></dt>
|
||||
<dd><p><strong>Create the NAT gateway of a VPC on this agent</strong></p>
|
||||
<p>Gives the VMs of a VPC without a public IP an Internet exit through this host. The gateway owns the given public IP on the public bridge (interfaces.internet) and announces a type-5 default route in the VRF of the VPC. Only VPCs created by this version or later route their default traffic to the VRF, and can use it. To move the gateway, delete it on the old host if it answers, then create it on the new one.</p>
|
||||
<p><strong>Example request:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="nf">POST</span> <span class="nn">/nat-gateways</span> <span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span>
|
||||
<span class="na">Host</span><span class="o">:</span> <span class="l">example.com</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"vpc"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"ip"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"gateway"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<dl class="field-list simple">
|
||||
<dt class="field-odd">Codes de statut<span class="colon">:</span></dt>
|
||||
<dd class="field-odd"><ul class="simple">
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/202">202 Accepted</a></span> – <p>NAT gateway creation accepted</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">202</span> <span class="ne">Accepted</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"state"</span><span class="p">:</span><span class="w"> </span><span class="s2">"creating"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"vpc"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"ip"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"gateway"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/400">400 Bad Request</a></span> – <p>Missing required field, invalid request body, ip without prefix length or not IPv4, or gateway not IPv4</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">400</span> <span class="ne">Bad Request</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/409">409 Conflict</a></span> – <p>NAT gateway already exists, VPC unknown on this agent or not running, VPC without l3vni, or VPC that already has a NAT gateway on this agent</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">409</span> <span class="ne">Conflict</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/500">500 Internal Server Error</a></span> – <p>Internal server error</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">500</span> <span class="ne">Internal Server Error</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
</ul>
|
||||
</dd>
|
||||
</dl>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="http get">
|
||||
<dt class="sig sig-object http" id="get--nat-gateways-name">
|
||||
<span class="sig-name descname"><span class="pre">GET</span> </span><span class="sig-name descname"><span class="pre">/nat-gateways/{name}</span></span><a class="headerlink" href="#get--nat-gateways-name" title="Lien vers cette définition">#</a></dt>
|
||||
<dd><p><strong>Get NAT gateway status and info</strong></p>
|
||||
<dl class="field-list simple">
|
||||
<dt class="field-odd">Paramètres<span class="colon">:</span></dt>
|
||||
<dd class="field-odd"><ul class="simple">
|
||||
<li><p><strong>name</strong> (<em>string</em>) – Resource name</p></li>
|
||||
</ul>
|
||||
</dd>
|
||||
</dl>
|
||||
<p><strong>Example request:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="nf">GET</span> <span class="nn">/nat-gateways/{name}</span> <span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span>
|
||||
<span class="na">Host</span><span class="o">:</span> <span class="l">example.com</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<dl class="field-list simple">
|
||||
<dt class="field-odd">Codes de statut<span class="colon">:</span></dt>
|
||||
<dd class="field-odd"><ul class="simple">
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/200">200 OK</a></span> – <p>NAT gateway found</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">200</span> <span class="ne">OK</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"state"</span><span class="p">:</span><span class="w"> </span><span class="s2">"creating"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"vpc"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"ip"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"gateway"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/404">404 Not Found</a></span> – <p>Resource not found</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">404</span> <span class="ne">Not Found</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/500">500 Internal Server Error</a></span> – <p>Internal server error</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">500</span> <span class="ne">Internal Server Error</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
</ul>
|
||||
</dd>
|
||||
</dl>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="http delete">
|
||||
<dt class="sig sig-object http" id="delete--nat-gateways-name">
|
||||
<span class="sig-name descname"><span class="pre">DELETE</span> </span><span class="sig-name descname"><span class="pre">/nat-gateways/{name}</span></span><a class="headerlink" href="#delete--nat-gateways-name" title="Lien vers cette définition">#</a></dt>
|
||||
<dd><p><strong>Delete a NAT gateway</strong></p>
|
||||
<dl class="field-list simple">
|
||||
<dt class="field-odd">Paramètres<span class="colon">:</span></dt>
|
||||
<dd class="field-odd"><ul class="simple">
|
||||
<li><p><strong>name</strong> (<em>string</em>) – Resource name</p></li>
|
||||
</ul>
|
||||
</dd>
|
||||
<dt class="field-even">Codes de statut<span class="colon">:</span></dt>
|
||||
<dd class="field-even"><ul class="simple">
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/202">202 Accepted</a></span> – <p>NAT gateway deletion accepted</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">202</span> <span class="ne">Accepted</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"state"</span><span class="p">:</span><span class="w"> </span><span class="s2">"creating"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"vpc"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"ip"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"gateway"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/404">404 Not Found</a></span> – <p>Resource not found</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">404</span> <span class="ne">Not Found</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/409">409 Conflict</a></span> – <p>NAT gateway not deletable — only running or error states can be deleted</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">409</span> <span class="ne">Conflict</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/500">500 Internal Server Error</a></span> – <p>Internal server error</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">500</span> <span class="ne">Internal Server Error</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
</ul>
|
||||
</dd>
|
||||
</dl>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="http get">
|
||||
<dt class="sig sig-object http" id="get--floating-ips">
|
||||
<span class="sig-name descname"><span class="pre">GET</span> </span><span class="sig-name descname"><span class="pre">/floating-ips</span></span><a class="headerlink" href="#get--floating-ips" title="Lien vers cette définition">#</a></dt>
|
||||
<dd><p><strong>List all floating IPs of this agent</strong></p>
|
||||
<p><strong>Example request:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="nf">GET</span> <span class="nn">/floating-ips</span> <span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span>
|
||||
<span class="na">Host</span><span class="o">:</span> <span class="l">example.com</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<dl class="field-list simple">
|
||||
<dt class="field-odd">Codes de statut<span class="colon">:</span></dt>
|
||||
<dd class="field-odd"><ul class="simple">
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/200">200 OK</a></span> – <p>List of floating IPs</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">200</span> <span class="ne">OK</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">[</span>
|
||||
<span class="w"> </span><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"state"</span><span class="p">:</span><span class="w"> </span><span class="s2">"creating"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"vm"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"interface"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"ip"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"gateway"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="w"> </span><span class="p">}</span>
|
||||
<span class="p">]</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/500">500 Internal Server Error</a></span> – <p>Internal server error</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">500</span> <span class="ne">Internal Server Error</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
</ul>
|
||||
</dd>
|
||||
</dl>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="http post">
|
||||
<dt class="sig sig-object http" id="post--floating-ips">
|
||||
<span class="sig-name descname"><span class="pre">POST</span> </span><span class="sig-name descname"><span class="pre">/floating-ips</span></span><a class="headerlink" href="#post--floating-ips" title="Lien vers cette définition">#</a></dt>
|
||||
<dd><p><strong>Attach a floating IP to an interface of a VM of this agent</strong></p>
|
||||
<p>Makes an interface of a VM reachable through a public IP it does not carry: stateless 1:1 translation in the netns of the VPC, on the host of the VM, the public IP answering ARP on the public bridge (interfaces.internet). The VM leaves through its floating IP, even in a VPC with a NAT gateway. To move it with the VM, delete it on the old host, then create it on the new one. Attach and detach without touching the VM.</p>
|
||||
<p><strong>Example request:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="nf">POST</span> <span class="nn">/floating-ips</span> <span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span>
|
||||
<span class="na">Host</span><span class="o">:</span> <span class="l">example.com</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"vm"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"interface"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"ip"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"gateway"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<dl class="field-list simple">
|
||||
<dt class="field-odd">Codes de statut<span class="colon">:</span></dt>
|
||||
<dd class="field-odd"><ul class="simple">
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/202">202 Accepted</a></span> – <p>Floating IP creation accepted</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">202</span> <span class="ne">Accepted</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"state"</span><span class="p">:</span><span class="w"> </span><span class="s2">"creating"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"vm"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"interface"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"ip"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"gateway"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/400">400 Bad Request</a></span> – <p>Missing required field, invalid request body, ip without prefix length or not IPv4, or gateway not IPv4</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">400</span> <span class="ne">Bad Request</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/409">409 Conflict</a></span> – <p>Floating IP already exists, VM unknown on this agent or not running, no interface of that name on the VM, interface on a public_ip subnet (it carries its public IP itself), interface that already has a floating IP, or public IP already used by another floating IP of this agent</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">409</span> <span class="ne">Conflict</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/500">500 Internal Server Error</a></span> – <p>Internal server error</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">500</span> <span class="ne">Internal Server Error</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
</ul>
|
||||
</dd>
|
||||
</dl>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="http get">
|
||||
<dt class="sig sig-object http" id="get--floating-ips-name">
|
||||
<span class="sig-name descname"><span class="pre">GET</span> </span><span class="sig-name descname"><span class="pre">/floating-ips/{name}</span></span><a class="headerlink" href="#get--floating-ips-name" title="Lien vers cette définition">#</a></dt>
|
||||
<dd><p><strong>Get floating IP status and info</strong></p>
|
||||
<dl class="field-list simple">
|
||||
<dt class="field-odd">Paramètres<span class="colon">:</span></dt>
|
||||
<dd class="field-odd"><ul class="simple">
|
||||
<li><p><strong>name</strong> (<em>string</em>) – Resource name</p></li>
|
||||
</ul>
|
||||
</dd>
|
||||
</dl>
|
||||
<p><strong>Example request:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="nf">GET</span> <span class="nn">/floating-ips/{name}</span> <span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span>
|
||||
<span class="na">Host</span><span class="o">:</span> <span class="l">example.com</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<dl class="field-list simple">
|
||||
<dt class="field-odd">Codes de statut<span class="colon">:</span></dt>
|
||||
<dd class="field-odd"><ul class="simple">
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/200">200 OK</a></span> – <p>Floating IP found</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">200</span> <span class="ne">OK</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"state"</span><span class="p">:</span><span class="w"> </span><span class="s2">"creating"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"vm"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"interface"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"ip"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"gateway"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/404">404 Not Found</a></span> – <p>Resource not found</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">404</span> <span class="ne">Not Found</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/500">500 Internal Server Error</a></span> – <p>Internal server error</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">500</span> <span class="ne">Internal Server Error</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
</ul>
|
||||
</dd>
|
||||
</dl>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="http delete">
|
||||
<dt class="sig sig-object http" id="delete--floating-ips-name">
|
||||
<span class="sig-name descname"><span class="pre">DELETE</span> </span><span class="sig-name descname"><span class="pre">/floating-ips/{name}</span></span><a class="headerlink" href="#delete--floating-ips-name" title="Lien vers cette définition">#</a></dt>
|
||||
<dd><p><strong>Detach and delete a floating IP</strong></p>
|
||||
<dl class="field-list simple">
|
||||
<dt class="field-odd">Paramètres<span class="colon">:</span></dt>
|
||||
<dd class="field-odd"><ul class="simple">
|
||||
<li><p><strong>name</strong> (<em>string</em>) – Resource name</p></li>
|
||||
</ul>
|
||||
</dd>
|
||||
<dt class="field-even">Codes de statut<span class="colon">:</span></dt>
|
||||
<dd class="field-even"><ul class="simple">
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/202">202 Accepted</a></span> – <p>Floating IP deletion accepted</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">202</span> <span class="ne">Accepted</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"state"</span><span class="p">:</span><span class="w"> </span><span class="s2">"creating"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"vm"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"interface"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"ip"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"gateway"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/404">404 Not Found</a></span> – <p>Resource not found</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">404</span> <span class="ne">Not Found</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/409">409 Conflict</a></span> – <p>Floating IP not deletable — only running or error states can be deleted</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">409</span> <span class="ne">Conflict</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/500">500 Internal Server Error</a></span> – <p>Internal server error</p>
|
||||
<p><strong>Example response:</strong></p>
|
||||
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">500</span> <span class="ne">Internal Server Error</span>
|
||||
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
|
||||
|
||||
<span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</p></li>
|
||||
</ul>
|
||||
</dd>
|
||||
</dl>
|
||||
</dd></dl>
|
||||
|
||||
</section>
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -234,6 +234,8 @@
|
|||
<li class="toctree-l2"><a class="reference internal" href="../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/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>
|
||||
|
|
|
|||
|
|
@ -234,6 +234,8 @@
|
|||
<li class="toctree-l2"><a class="reference internal" href="../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/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>
|
||||
|
|
@ -377,7 +379,8 @@
|
|||
</div>
|
||||
<p>Cas fréquents :</p>
|
||||
<ul class="simple">
|
||||
<li><p>subnet en mode <code class="docutils literal notranslate"><span class="pre">public_ip</span></code> — la mise en place host n’est pas implémentée, l’échec est attendu ;</p></li>
|
||||
<li><p>subnet en mode <code class="docutils literal notranslate"><span class="pre">public_ip</span></code> dont le nom n’est pas unique sur l’hyperviseur, ou dont la partie
|
||||
après le premier tiret dépasse 10 caractères (noms d’interface) ;</p></li>
|
||||
<li><p><code class="docutils literal notranslate"><span class="pre">vxlan_id</span></code> déjà utilisé sur l’host ;</p></li>
|
||||
<li><p>bridge cible absent : <code class="docutils literal notranslate"><span class="pre">iface_type</span></code> inconnu retombé sur <code class="docutils literal notranslate"><span class="pre">default_interface</span></code>, lui-même
|
||||
inexistant.</p></li>
|
||||
|
|
|
|||
|
|
@ -234,6 +234,8 @@
|
|||
<li class="toctree-l2"><a class="reference internal" href="../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/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>
|
||||
|
|
|
|||
|
|
@ -234,6 +234,8 @@
|
|||
<li class="toctree-l2"><a class="reference internal" href="../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/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>
|
||||
|
|
@ -384,6 +386,12 @@
|
|||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">syonad_vms_total</span></code></p></td>
|
||||
<td><p>nombre de VM, par état</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">syonad_nat_gateways_total</span></code></p></td>
|
||||
<td><p>nombre de passerelles NAT, par état</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">syonad_floating_ips_total</span></code></p></td>
|
||||
<td><p>nombre d’IP flottantes, par état</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
|
|
@ -427,7 +435,8 @@ cela : il est signalé à chaque tick jusqu’à sa recréation.</p></li>
|
|||
par une version antérieure à la 0.3.0 ne l’a pas : il est signalé à chaque tick jusqu’à sa
|
||||
recréation, l’agent ne la pose pas au démarrage.</p></li>
|
||||
<li><p><strong>Réconciliation des routes exportées</strong> dans la VRF : chaque <code class="docutils literal notranslate"><span class="pre">/24</span></code> de subnet <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> et chaque
|
||||
<code class="docutils literal notranslate"><span class="pre">/32</span></code> d’interface de VM <code class="docutils literal notranslate"><span class="pre">running</span></code> doit être exporté ; à l’inverse, une route exportée dont
|
||||
<code class="docutils literal notranslate"><span class="pre">/32</span></code> d’interface de VM <code class="docutils literal notranslate"><span class="pre">running</span></code> doit être exporté, ainsi que la route par défaut quand le
|
||||
VPC a une passerelle NAT <code class="docutils literal notranslate"><span class="pre">running</span></code> sur l’hôte (voir <a class="reference internal" href="../concepts/passerelle-nat.html"><span class="doc">Passerelle NAT</span></a>) ; à l’inverse, une route exportée dont
|
||||
le propriétaire n’existe plus — ni <code class="docutils literal notranslate"><span class="pre">running</span></code>, ni en <code class="docutils literal notranslate"><span class="pre">creating</span></code>, <code class="docutils literal notranslate"><span class="pre">deleting</span></code> ou <code class="docutils literal notranslate"><span class="pre">error</span></code> —
|
||||
est signalée comme un <strong>trou noir</strong> : l’annonce attire du trafic que plus rien ne reçoit.</p></li>
|
||||
</ul>
|
||||
|
|
|
|||
|
|
@ -234,6 +234,8 @@
|
|||
<li class="toctree-l2"><a class="reference internal" href="../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/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>
|
||||
|
|
|
|||
|
|
@ -669,6 +669,8 @@ window.runMermaid = runMermaid;</script>
|
|||
<li class="toctree-l2"><a class="reference internal" href="concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="concepts/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>
|
||||
|
|
|
|||
|
|
@ -676,6 +676,8 @@ window.runMermaid = runMermaid;</script>
|
|||
<li class="toctree-l2"><a class="reference internal" href="concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="concepts/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>
|
||||
|
|
@ -792,6 +794,8 @@ window.runMermaid = runMermaid;</script>
|
|||
<h1>Table de routage HTTP</h1>
|
||||
|
||||
<div class="modindex-jumpbox">
|
||||
<a href="#cap-/floating-ips"><strong>/floating-ips</strong></a> |
|
||||
<a href="#cap-/nat-gateways"><strong>/nat-gateways</strong></a> |
|
||||
<a href="#cap-/subnets"><strong>/subnets</strong></a> |
|
||||
<a href="#cap-/vms"><strong>/vms</strong></a> |
|
||||
<a href="#cap-/vpcs"><strong>/vpcs</strong></a>
|
||||
|
|
@ -799,6 +803,52 @@ window.runMermaid = runMermaid;</script>
|
|||
|
||||
<table class="indextable modindextable">
|
||||
<tr class="pcap"><td></td><td> </td><td></td></tr>
|
||||
<tr class="cap" id="cap-/floating-ips"><td></td><td>
|
||||
<strong>/floating-ips</strong></td><td></td></tr>
|
||||
<tr>
|
||||
<td></td>
|
||||
<td>
|
||||
<a href="exploitation/api-agent/reference.html#get--floating-ips"><code class="xref">GET /floating-ips</code></a></td><td>
|
||||
<em>List all floating IPs of this agent</em></td></tr>
|
||||
<tr>
|
||||
<td></td>
|
||||
<td>
|
||||
<a href="exploitation/api-agent/reference.html#get--floating-ips-name"><code class="xref">GET /floating-ips/{name}</code></a></td><td>
|
||||
<em>Get floating IP status and info</em></td></tr>
|
||||
<tr>
|
||||
<td></td>
|
||||
<td>
|
||||
<a href="exploitation/api-agent/reference.html#post--floating-ips"><code class="xref">POST /floating-ips</code></a></td><td>
|
||||
<em>Attach a floating IP to an interface of a VM of this agent</em></td></tr>
|
||||
<tr>
|
||||
<td></td>
|
||||
<td>
|
||||
<a href="exploitation/api-agent/reference.html#delete--floating-ips-name"><code class="xref">DELETE /floating-ips/{name}</code></a></td><td>
|
||||
<em>Detach and delete a floating IP</em></td></tr>
|
||||
<tr class="pcap"><td></td><td> </td><td></td></tr>
|
||||
<tr class="cap" id="cap-/nat-gateways"><td></td><td>
|
||||
<strong>/nat-gateways</strong></td><td></td></tr>
|
||||
<tr>
|
||||
<td></td>
|
||||
<td>
|
||||
<a href="exploitation/api-agent/reference.html#get--nat-gateways"><code class="xref">GET /nat-gateways</code></a></td><td>
|
||||
<em>List all NAT gateways of this agent</em></td></tr>
|
||||
<tr>
|
||||
<td></td>
|
||||
<td>
|
||||
<a href="exploitation/api-agent/reference.html#get--nat-gateways-name"><code class="xref">GET /nat-gateways/{name}</code></a></td><td>
|
||||
<em>Get NAT gateway status and info</em></td></tr>
|
||||
<tr>
|
||||
<td></td>
|
||||
<td>
|
||||
<a href="exploitation/api-agent/reference.html#post--nat-gateways"><code class="xref">POST /nat-gateways</code></a></td><td>
|
||||
<em>Create the NAT gateway of a VPC on this agent</em></td></tr>
|
||||
<tr>
|
||||
<td></td>
|
||||
<td>
|
||||
<a href="exploitation/api-agent/reference.html#delete--nat-gateways-name"><code class="xref">DELETE /nat-gateways/{name}</code></a></td><td>
|
||||
<em>Delete a NAT gateway</em></td></tr>
|
||||
<tr class="pcap"><td></td><td> </td><td></td></tr>
|
||||
<tr class="cap" id="cap-/subnets"><td></td><td>
|
||||
<strong>/subnets</strong></td><td></td></tr>
|
||||
<tr>
|
||||
|
|
|
|||
|
|
@ -235,6 +235,8 @@
|
|||
<li class="toctree-l2"><a class="reference internal" href="concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="concepts/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>
|
||||
|
|
|
|||
BIN
main/objects.inv
BIN
main/objects.inv
Binary file not shown.
|
|
@ -671,6 +671,8 @@ window.runMermaid = runMermaid;</script>
|
|||
<li class="toctree-l2"><a class="reference internal" href="concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="concepts/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>
|
||||
|
|
|
|||
File diff suppressed because one or more lines are too long
|
|
@ -233,6 +233,8 @@
|
|||
<li class="toctree-l2"><a class="reference internal" href="../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/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>
|
||||
|
|
|
|||
|
|
@ -234,6 +234,8 @@
|
|||
<li class="toctree-l2"><a class="reference internal" href="../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/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>
|
||||
|
|
|
|||
|
|
@ -234,6 +234,8 @@
|
|||
<li class="toctree-l2"><a class="reference internal" href="../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/passerelle-nat.html">Passerelle NAT</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="../concepts/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>
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue