docs: build de c628e7072a
|
|
@ -1,4 +1,4 @@
|
|||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 900" width="1200" height="900" role="img" aria-label="Architecture du cluster : routeurs, route reflectors, hyperviseurs, plans de données et de contrôle">
|
||||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 900" width="1200" height="900" role="img" aria-label="Détail d'un cluster : routeurs, route reflectors, hyperviseurs, netns et VRF des VPC, plans de données et de contrôle">
|
||||
<style>
|
||||
.lbl { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 14px; fill: #e6edf3; }
|
||||
.sub { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; fill: #9198a1; }
|
||||
|
|
@ -50,7 +50,7 @@
|
|||
<text class="lbl" x="1020.0" y="77.0" text-anchor="middle">route reflector 2</text>
|
||||
<text class="sub" x="1020.0" y="94.0" text-anchor="middle">lo 10.255.255.2/32 · 169.254.0.4/28</text>
|
||||
<text class="sub" x="890" y="132" text-anchor="middle">router-id, cluster-id et source des sessions EVPN : la loopback</text>
|
||||
<text class="sub" x="890" y="148" text-anchor="middle">un par cluster (vue d'ensemble) ; le lab les réunit dans un seul</text>
|
||||
<text class="sub" x="890" y="148" text-anchor="middle">au moins un, deux prévus · AS 64600 face aux hyperviseurs (local-as)</text>
|
||||
<path class="ctrl" d="M480 80 H640" marker-start="url(#a-ctrl)" marker-end="url(#a-ctrl)"/>
|
||||
<text class="ctrlt" x="560" y="72" text-anchor="middle">eBGP · BFD</text>
|
||||
<text class="ctrlt" x="560" y="98" text-anchor="middle">loopbacks seules</text>
|
||||
|
|
@ -74,9 +74,11 @@
|
|||
<rect class="box" x="60" y="430" width="180" height="52" rx="6"/>
|
||||
<text class="lbl" x="150.0" y="453.0" text-anchor="middle">agent</text>
|
||||
<text class="sub" x="150.0" y="470.0" text-anchor="middle">API REST · Badger</text>
|
||||
<rect class="box" x="60" y="510" width="180" height="56" rx="6"/>
|
||||
<text class="lbl" x="150.0" y="535.0" text-anchor="middle">vxlan-<vni></text>
|
||||
<text class="sub" x="150.0" y="552.0" text-anchor="middle">dans br-<subnet>, sans learning</text>
|
||||
<rect class="box" x="60" y="510" width="180" height="66" rx="6"/>
|
||||
<text class="lbl" x="150.0" y="532.0" text-anchor="middle">br-<subnet> de l'hôte</text>
|
||||
<text class="sub" x="150.0" y="549.0" text-anchor="middle">vxlan-<vni>, sans learning</text>
|
||||
<text class="sub" x="150.0" y="564.0" text-anchor="middle">veth v-<id>-e</text>
|
||||
<text class="sub" x="150" y="596" text-anchor="middle">veth v-<id>-e ↔ v-<id>-i</text>
|
||||
<rect class="group" x="270" y="280" width="290" height="300" rx="8"/>
|
||||
<text class="grp" x="290" y="304">NETNS DU VPC</text>
|
||||
<rect class="box" x="285" y="312" width="125" height="66" rx="6"/>
|
||||
|
|
@ -88,8 +90,8 @@
|
|||
<text class="sub" x="482.5" y="351.0" text-anchor="middle">métadonnées</text>
|
||||
<text class="sub" x="482.5" y="366.0" text-anchor="middle">écoutent sur gw-</text>
|
||||
<rect class="box" x="285" y="400" width="260" height="52" rx="6"/>
|
||||
<text class="lbl" x="415.0" y="423.0" text-anchor="middle">br-<subnet></text>
|
||||
<text class="sub" x="415.0" y="440.0" text-anchor="middle">adresse d'émission .253</text>
|
||||
<text class="lbl" x="415.0" y="423.0" text-anchor="middle">br-<subnet> du netns</text>
|
||||
<text class="sub" x="415.0" y="440.0" text-anchor="middle">adresse d'émission .253 · v-<id>-i</text>
|
||||
<rect class="box" x="285" y="478" width="260" height="52" rx="6"/>
|
||||
<text class="lbl" x="415.0" y="501.0" text-anchor="middle">VM</text>
|
||||
<text class="sub" x="415.0" y="518.0" text-anchor="middle">QEMU / KVM · tap dans le netns</text>
|
||||
|
|
@ -120,9 +122,11 @@
|
|||
<rect class="box" x="640" y="430" width="180" height="52" rx="6"/>
|
||||
<text class="lbl" x="730.0" y="453.0" text-anchor="middle">agent</text>
|
||||
<text class="sub" x="730.0" y="470.0" text-anchor="middle">API REST · Badger</text>
|
||||
<rect class="box" x="640" y="510" width="180" height="56" rx="6"/>
|
||||
<text class="lbl" x="730.0" y="535.0" text-anchor="middle">vxlan-<vni></text>
|
||||
<text class="sub" x="730.0" y="552.0" text-anchor="middle">dans br-<subnet>, sans learning</text>
|
||||
<rect class="box" x="640" y="510" width="180" height="66" rx="6"/>
|
||||
<text class="lbl" x="730.0" y="532.0" text-anchor="middle">br-<subnet> de l'hôte</text>
|
||||
<text class="sub" x="730.0" y="549.0" text-anchor="middle">vxlan-<vni>, sans learning</text>
|
||||
<text class="sub" x="730.0" y="564.0" text-anchor="middle">veth v-<id>-e</text>
|
||||
<text class="sub" x="730" y="596" text-anchor="middle">veth v-<id>-e ↔ v-<id>-i</text>
|
||||
<rect class="group" x="850" y="280" width="290" height="300" rx="8"/>
|
||||
<text class="grp" x="870" y="304">NETNS DU VPC</text>
|
||||
<rect class="box" x="865" y="312" width="125" height="66" rx="6"/>
|
||||
|
|
@ -134,8 +138,8 @@
|
|||
<text class="sub" x="1062.5" y="351.0" text-anchor="middle">métadonnées</text>
|
||||
<text class="sub" x="1062.5" y="366.0" text-anchor="middle">écoutent sur gw-</text>
|
||||
<rect class="box" x="865" y="400" width="260" height="52" rx="6"/>
|
||||
<text class="lbl" x="995.0" y="423.0" text-anchor="middle">br-<subnet></text>
|
||||
<text class="sub" x="995.0" y="440.0" text-anchor="middle">adresse d'émission .253</text>
|
||||
<text class="lbl" x="995.0" y="423.0" text-anchor="middle">br-<subnet> du netns</text>
|
||||
<text class="sub" x="995.0" y="440.0" text-anchor="middle">adresse d'émission .253 · v-<id>-i</text>
|
||||
<rect class="box" x="865" y="478" width="260" height="52" rx="6"/>
|
||||
<text class="lbl" x="995.0" y="501.0" text-anchor="middle">VM</text>
|
||||
<text class="sub" x="995.0" y="518.0" text-anchor="middle">QEMU / KVM · tap dans le netns</text>
|
||||
|
|
|
|||
|
Before Width: | Height: | Size: 14 KiB After Width: | Height: | Size: 14 KiB |
|
|
@ -1,4 +1,4 @@
|
|||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 900" width="1200" height="900" role="img" aria-label="Architecture du cluster : routeurs, route reflectors, hyperviseurs, plans de données et de contrôle">
|
||||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 900" width="1200" height="900" role="img" aria-label="Détail d'un cluster : routeurs, route reflectors, hyperviseurs, netns et VRF des VPC, plans de données et de contrôle">
|
||||
<style>
|
||||
.lbl { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 14px; fill: #1f2328; }
|
||||
.sub { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; fill: #57606a; }
|
||||
|
|
@ -50,7 +50,7 @@
|
|||
<text class="lbl" x="1020.0" y="77.0" text-anchor="middle">route reflector 2</text>
|
||||
<text class="sub" x="1020.0" y="94.0" text-anchor="middle">lo 10.255.255.2/32 · 169.254.0.4/28</text>
|
||||
<text class="sub" x="890" y="132" text-anchor="middle">router-id, cluster-id et source des sessions EVPN : la loopback</text>
|
||||
<text class="sub" x="890" y="148" text-anchor="middle">un par cluster (vue d'ensemble) ; le lab les réunit dans un seul</text>
|
||||
<text class="sub" x="890" y="148" text-anchor="middle">au moins un, deux prévus · AS 64600 face aux hyperviseurs (local-as)</text>
|
||||
<path class="ctrl" d="M480 80 H640" marker-start="url(#a-ctrl)" marker-end="url(#a-ctrl)"/>
|
||||
<text class="ctrlt" x="560" y="72" text-anchor="middle">eBGP · BFD</text>
|
||||
<text class="ctrlt" x="560" y="98" text-anchor="middle">loopbacks seules</text>
|
||||
|
|
@ -74,9 +74,11 @@
|
|||
<rect class="box" x="60" y="430" width="180" height="52" rx="6"/>
|
||||
<text class="lbl" x="150.0" y="453.0" text-anchor="middle">agent</text>
|
||||
<text class="sub" x="150.0" y="470.0" text-anchor="middle">API REST · Badger</text>
|
||||
<rect class="box" x="60" y="510" width="180" height="56" rx="6"/>
|
||||
<text class="lbl" x="150.0" y="535.0" text-anchor="middle">vxlan-<vni></text>
|
||||
<text class="sub" x="150.0" y="552.0" text-anchor="middle">dans br-<subnet>, sans learning</text>
|
||||
<rect class="box" x="60" y="510" width="180" height="66" rx="6"/>
|
||||
<text class="lbl" x="150.0" y="532.0" text-anchor="middle">br-<subnet> de l'hôte</text>
|
||||
<text class="sub" x="150.0" y="549.0" text-anchor="middle">vxlan-<vni>, sans learning</text>
|
||||
<text class="sub" x="150.0" y="564.0" text-anchor="middle">veth v-<id>-e</text>
|
||||
<text class="sub" x="150" y="596" text-anchor="middle">veth v-<id>-e ↔ v-<id>-i</text>
|
||||
<rect class="group" x="270" y="280" width="290" height="300" rx="8"/>
|
||||
<text class="grp" x="290" y="304">NETNS DU VPC</text>
|
||||
<rect class="box" x="285" y="312" width="125" height="66" rx="6"/>
|
||||
|
|
@ -88,8 +90,8 @@
|
|||
<text class="sub" x="482.5" y="351.0" text-anchor="middle">métadonnées</text>
|
||||
<text class="sub" x="482.5" y="366.0" text-anchor="middle">écoutent sur gw-</text>
|
||||
<rect class="box" x="285" y="400" width="260" height="52" rx="6"/>
|
||||
<text class="lbl" x="415.0" y="423.0" text-anchor="middle">br-<subnet></text>
|
||||
<text class="sub" x="415.0" y="440.0" text-anchor="middle">adresse d'émission .253</text>
|
||||
<text class="lbl" x="415.0" y="423.0" text-anchor="middle">br-<subnet> du netns</text>
|
||||
<text class="sub" x="415.0" y="440.0" text-anchor="middle">adresse d'émission .253 · v-<id>-i</text>
|
||||
<rect class="box" x="285" y="478" width="260" height="52" rx="6"/>
|
||||
<text class="lbl" x="415.0" y="501.0" text-anchor="middle">VM</text>
|
||||
<text class="sub" x="415.0" y="518.0" text-anchor="middle">QEMU / KVM · tap dans le netns</text>
|
||||
|
|
@ -120,9 +122,11 @@
|
|||
<rect class="box" x="640" y="430" width="180" height="52" rx="6"/>
|
||||
<text class="lbl" x="730.0" y="453.0" text-anchor="middle">agent</text>
|
||||
<text class="sub" x="730.0" y="470.0" text-anchor="middle">API REST · Badger</text>
|
||||
<rect class="box" x="640" y="510" width="180" height="56" rx="6"/>
|
||||
<text class="lbl" x="730.0" y="535.0" text-anchor="middle">vxlan-<vni></text>
|
||||
<text class="sub" x="730.0" y="552.0" text-anchor="middle">dans br-<subnet>, sans learning</text>
|
||||
<rect class="box" x="640" y="510" width="180" height="66" rx="6"/>
|
||||
<text class="lbl" x="730.0" y="532.0" text-anchor="middle">br-<subnet> de l'hôte</text>
|
||||
<text class="sub" x="730.0" y="549.0" text-anchor="middle">vxlan-<vni>, sans learning</text>
|
||||
<text class="sub" x="730.0" y="564.0" text-anchor="middle">veth v-<id>-e</text>
|
||||
<text class="sub" x="730" y="596" text-anchor="middle">veth v-<id>-e ↔ v-<id>-i</text>
|
||||
<rect class="group" x="850" y="280" width="290" height="300" rx="8"/>
|
||||
<text class="grp" x="870" y="304">NETNS DU VPC</text>
|
||||
<rect class="box" x="865" y="312" width="125" height="66" rx="6"/>
|
||||
|
|
@ -134,8 +138,8 @@
|
|||
<text class="sub" x="1062.5" y="351.0" text-anchor="middle">métadonnées</text>
|
||||
<text class="sub" x="1062.5" y="366.0" text-anchor="middle">écoutent sur gw-</text>
|
||||
<rect class="box" x="865" y="400" width="260" height="52" rx="6"/>
|
||||
<text class="lbl" x="995.0" y="423.0" text-anchor="middle">br-<subnet></text>
|
||||
<text class="sub" x="995.0" y="440.0" text-anchor="middle">adresse d'émission .253</text>
|
||||
<text class="lbl" x="995.0" y="423.0" text-anchor="middle">br-<subnet> du netns</text>
|
||||
<text class="sub" x="995.0" y="440.0" text-anchor="middle">adresse d'émission .253 · v-<id>-i</text>
|
||||
<rect class="box" x="865" y="478" width="260" height="52" rx="6"/>
|
||||
<text class="lbl" x="995.0" y="501.0" text-anchor="middle">VM</text>
|
||||
<text class="sub" x="995.0" y="518.0" text-anchor="middle">QEMU / KVM · tap dans le netns</text>
|
||||
|
|
|
|||
|
Before Width: | Height: | Size: 14 KiB After Width: | Height: | Size: 14 KiB |
|
|
@ -1,4 +1,4 @@
|
|||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1500 1210" width="1500" height="1210" role="img" aria-label="Vue d'ensemble : Internet, bordures, routeurs du cluster, services, orchestration et hyperviseurs">
|
||||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1500 1210" width="1500" height="1210" role="img" aria-label="Vue d'ensemble : Internet, bordures, deux clusters, route reflectors, services partagés et hyperviseurs">
|
||||
<style>
|
||||
.lbl { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 14px; fill: #e6edf3; }
|
||||
.sub { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; fill: #9198a1; }
|
||||
|
|
@ -47,8 +47,8 @@
|
|||
<rect class="future" x="1200" y="50" width="240" height="52" rx="6"/>
|
||||
<text class="lbl" x="1320.0" y="73.0" text-anchor="middle">Terraform / OpenTofu</text>
|
||||
<text class="sub" x="1320.0" y="90.0" text-anchor="middle">provider two · #72</text>
|
||||
<text class="nett" x="1164" y="150" text-anchor="end">API publique de l'orchestrateur</text>
|
||||
<text class="nett" x="1164" y="166" text-anchor="end">par Internet et les bordures (VNI 66001)</text>
|
||||
<path class="net" d="M1180 64 H900" marker-end="url(#a-net)"/>
|
||||
<text class="nett" x="1040" y="56" text-anchor="middle">API publique de l'orchestrateur</text>
|
||||
<rect class="group" x="40" y="280" width="480" height="130" rx="8"/>
|
||||
<text class="grp" x="60" y="304">CLUSTER A</text>
|
||||
<rect class="box" x="60" y="312" width="210" height="56" rx="6"/>
|
||||
|
|
@ -173,7 +173,9 @@
|
|||
<path class="link" d="M300 635 V460"/>
|
||||
<path class="orch" d="M320 785 H332 V410" marker-end="url(#a-orch)"/>
|
||||
<text class="orcht" x="340" y="596" text-anchor="start">register · ordres · événements (mTLS, sortant)</text>
|
||||
<path class="net" d="M1180 76 H1172 V546 H1160" marker-end="url(#a-net)"/>
|
||||
<path class="net" d="M750 240 V300 H1140 V520" marker-end="url(#a-net)"/>
|
||||
<text class="nett" x="1132" y="430" text-anchor="end">API publique</text>
|
||||
<text class="nett" x="1132" y="446" text-anchor="end">VNI 66001</text>
|
||||
<path class="data" d="M60 1045 H110"/>
|
||||
<text class="sub" x="118" y="1049" text-anchor="start">plan de données : VXLAN</text>
|
||||
<path class="ctrl" d="M290 1045 H340"/>
|
||||
|
|
@ -184,10 +186,10 @@
|
|||
<text class="sub" x="748" y="1049" text-anchor="start">trafic Internet</text>
|
||||
<rect class="future" x="880" y="1035" width="34" height="20" rx="4"/>
|
||||
<text class="sub" x="922" y="1049" text-anchor="start">à venir (ticket indiqué)</text>
|
||||
<text class="sub" x="60" y="1089" text-anchor="start">Les agents ne sont jamais joints par l'orchestrateur : ils se connectent au broker en sortie, via leur passerelle ; les routeurs de leur cluster les NAT vers le VNI 66000.</text>
|
||||
<text class="sub" x="60" y="1089" text-anchor="start">Les agents ne sont jamais joints par l'orchestrateur : ils se connectent au broker en sortie, via leur passerelle ; les routeurs de leur cluster les traduisent (NAT) vers le VNI 66000.</text>
|
||||
<text class="sub" x="60" y="1107" text-anchor="start">L'orchestrateur a une patte dans le VNI 66001 : son API est joignable depuis Internet, par les bordures.</text>
|
||||
<text class="sub" x="60" y="1125" text-anchor="start">VM publique : un subnet public dans son VPC, relié au subnet public de l'hôte (VNI 66001), dont la gateway anycast est portée par toutes les bordures.</text>
|
||||
<text class="sub" x="60" y="1143" text-anchor="start">VM privée : route par défaut de type 5 vers la passerelle NAT de son VPC (IP de sortie du VPC) si le VPC autorise Internet, ou IP flottante 1:1 sur son hôte.</text>
|
||||
<text class="sub" x="60" y="1161" text-anchor="start">Les bordures restent sans état : tout NAT vit sur un hyperviseur. Broker et orchestrateur sont des VM du VNI 66000, partagé : elles tournent sur les hyperviseurs de n'importe quel cluster.</text>
|
||||
<text class="sub" x="60" y="1179" text-anchor="start">Un route reflector par cluster : un événement d'un cluster ne coupe pas les deux sessions. Chaque lien routeurs ↔ RR est en 169.254.0.0/28, propre à son cluster.</text>
|
||||
<text class="sub" x="60" y="1179" text-anchor="start">Au moins un route reflector ; deux prévus, ici un par cluster : un événement d'un cluster ne coupe pas les deux sessions. Chaque lien routeurs ↔ RR est en 169.254.0.0/28, propre à son cluster.</text>
|
||||
</svg>
|
||||
|
|
|
|||
|
Before Width: | Height: | Size: 16 KiB After Width: | Height: | Size: 16 KiB |
|
|
@ -1,4 +1,4 @@
|
|||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1500 1210" width="1500" height="1210" role="img" aria-label="Vue d'ensemble : Internet, bordures, routeurs du cluster, services, orchestration et hyperviseurs">
|
||||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1500 1210" width="1500" height="1210" role="img" aria-label="Vue d'ensemble : Internet, bordures, deux clusters, route reflectors, services partagés et hyperviseurs">
|
||||
<style>
|
||||
.lbl { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 14px; fill: #1f2328; }
|
||||
.sub { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; fill: #57606a; }
|
||||
|
|
@ -47,8 +47,8 @@
|
|||
<rect class="future" x="1200" y="50" width="240" height="52" rx="6"/>
|
||||
<text class="lbl" x="1320.0" y="73.0" text-anchor="middle">Terraform / OpenTofu</text>
|
||||
<text class="sub" x="1320.0" y="90.0" text-anchor="middle">provider two · #72</text>
|
||||
<text class="nett" x="1164" y="150" text-anchor="end">API publique de l'orchestrateur</text>
|
||||
<text class="nett" x="1164" y="166" text-anchor="end">par Internet et les bordures (VNI 66001)</text>
|
||||
<path class="net" d="M1180 64 H900" marker-end="url(#a-net)"/>
|
||||
<text class="nett" x="1040" y="56" text-anchor="middle">API publique de l'orchestrateur</text>
|
||||
<rect class="group" x="40" y="280" width="480" height="130" rx="8"/>
|
||||
<text class="grp" x="60" y="304">CLUSTER A</text>
|
||||
<rect class="box" x="60" y="312" width="210" height="56" rx="6"/>
|
||||
|
|
@ -173,7 +173,9 @@
|
|||
<path class="link" d="M300 635 V460"/>
|
||||
<path class="orch" d="M320 785 H332 V410" marker-end="url(#a-orch)"/>
|
||||
<text class="orcht" x="340" y="596" text-anchor="start">register · ordres · événements (mTLS, sortant)</text>
|
||||
<path class="net" d="M1180 76 H1172 V546 H1160" marker-end="url(#a-net)"/>
|
||||
<path class="net" d="M750 240 V300 H1140 V520" marker-end="url(#a-net)"/>
|
||||
<text class="nett" x="1132" y="430" text-anchor="end">API publique</text>
|
||||
<text class="nett" x="1132" y="446" text-anchor="end">VNI 66001</text>
|
||||
<path class="data" d="M60 1045 H110"/>
|
||||
<text class="sub" x="118" y="1049" text-anchor="start">plan de données : VXLAN</text>
|
||||
<path class="ctrl" d="M290 1045 H340"/>
|
||||
|
|
@ -184,10 +186,10 @@
|
|||
<text class="sub" x="748" y="1049" text-anchor="start">trafic Internet</text>
|
||||
<rect class="future" x="880" y="1035" width="34" height="20" rx="4"/>
|
||||
<text class="sub" x="922" y="1049" text-anchor="start">à venir (ticket indiqué)</text>
|
||||
<text class="sub" x="60" y="1089" text-anchor="start">Les agents ne sont jamais joints par l'orchestrateur : ils se connectent au broker en sortie, via leur passerelle ; les routeurs de leur cluster les NAT vers le VNI 66000.</text>
|
||||
<text class="sub" x="60" y="1089" text-anchor="start">Les agents ne sont jamais joints par l'orchestrateur : ils se connectent au broker en sortie, via leur passerelle ; les routeurs de leur cluster les traduisent (NAT) vers le VNI 66000.</text>
|
||||
<text class="sub" x="60" y="1107" text-anchor="start">L'orchestrateur a une patte dans le VNI 66001 : son API est joignable depuis Internet, par les bordures.</text>
|
||||
<text class="sub" x="60" y="1125" text-anchor="start">VM publique : un subnet public dans son VPC, relié au subnet public de l'hôte (VNI 66001), dont la gateway anycast est portée par toutes les bordures.</text>
|
||||
<text class="sub" x="60" y="1143" text-anchor="start">VM privée : route par défaut de type 5 vers la passerelle NAT de son VPC (IP de sortie du VPC) si le VPC autorise Internet, ou IP flottante 1:1 sur son hôte.</text>
|
||||
<text class="sub" x="60" y="1161" text-anchor="start">Les bordures restent sans état : tout NAT vit sur un hyperviseur. Broker et orchestrateur sont des VM du VNI 66000, partagé : elles tournent sur les hyperviseurs de n'importe quel cluster.</text>
|
||||
<text class="sub" x="60" y="1179" text-anchor="start">Un route reflector par cluster : un événement d'un cluster ne coupe pas les deux sessions. Chaque lien routeurs ↔ RR est en 169.254.0.0/28, propre à son cluster.</text>
|
||||
<text class="sub" x="60" y="1179" text-anchor="start">Au moins un route reflector ; deux prévus, ici un par cluster : un événement d'un cluster ne coupe pas les deux sessions. Chaque lien routeurs ↔ RR est en 169.254.0.0/28, propre à son cluster.</text>
|
||||
</svg>
|
||||
|
|
|
|||
|
Before Width: | Height: | Size: 16 KiB After Width: | Height: | Size: 16 KiB |
|
|
@ -363,11 +363,6 @@
|
|||
<h1>Invariants et pièges<a class="headerlink" href="#invariants-et-pieges" title="Lien vers cette rubrique">#</a></h1>
|
||||
<p>Contraintes découvertes en production ou en corrigeant des bugs. Les enfreindre casse quelque
|
||||
chose qui fonctionne, souvent en silence.</p>
|
||||
<div class="admonition note">
|
||||
<p class="admonition-title">Note</p>
|
||||
<p>Cette page reprend la section « Invariants et pièges » de <code class="docutils literal notranslate"><span class="pre">CLAUDE.md</span></code>, qui reste la
|
||||
référence de développement et fait foi en cas d’écart.</p>
|
||||
</div>
|
||||
<section id="reseau">
|
||||
<h2>Réseau<a class="headerlink" href="#reseau" title="Lien vers cette rubrique">#</a></h2>
|
||||
<ul class="simple">
|
||||
|
|
|
|||
|
|
@ -347,8 +347,7 @@
|
|||
<section id="architecture">
|
||||
<h1>Architecture<a class="headerlink" href="#architecture" title="Lien vers cette rubrique">#</a></h1>
|
||||
<p>L’organisation interne de l’agent : découpage en paquets, stockage, et contraintes à ne pas
|
||||
enfreindre. Ces pages s’adressent à qui modifie le code ; <code class="docutils literal notranslate"><span class="pre">CLAUDE.md</span></code>, à la racine du dépôt,
|
||||
reste la référence de développement et fait foi en cas d’écart.</p>
|
||||
enfreindre. Ces pages s’adressent à qui modifie le code.</p>
|
||||
<div class="toctree-wrapper compound">
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="vue-densemble.html">Vue d’ensemble</a></li>
|
||||
|
|
|
|||
|
|
@ -432,12 +432,26 @@ une erreur.</p>
|
|||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">internal/dhcp</span></code></p></td>
|
||||
<td><p>plan d’adressage ip → mac, et configurations dnsmasq du backend historique</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">internal/metadata</span></code></p></td>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">internal/dhcpbackend</span></code></p></td>
|
||||
<td><p>interface commune aux deux backends DHCP (<code class="docutils literal notranslate"><span class="pre">dnsmasq</span></code> et <code class="docutils literal notranslate"><span class="pre">two</span></code>), choisie par
|
||||
<code class="docutils literal notranslate"><span class="pre">dhcp.backend</span></code></p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">internal/dhcpd</span></code></p></td>
|
||||
<td><p>moteur du serveur DHCP intégré : réservations en mémoire, réponses, écoute</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">internal/api/dhcp</span></code>, <code class="docutils literal notranslate"><span class="pre">internal/client/dhcp</span></code></p></td>
|
||||
<td><p>protocole de la socket de contrôle du serveur DHCP intégré (<code class="docutils literal notranslate"><span class="pre">set-host</span></code>, <code class="docutils literal notranslate"><span class="pre">probe</span></code>,
|
||||
<code class="docutils literal notranslate"><span class="pre">get-state</span></code>…), côté serveur et côté agent</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">internal/metadata</span></code></p></td>
|
||||
<td><p>serveur de metadata cloud-init et ses templates</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">internal/watchdog</span></code></p></td>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">internal/watchdog</span></code></p></td>
|
||||
<td><p>vérification périodique en lecture seule</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">internal/watchdog/notify</span></code></p></td>
|
||||
<td><p>émission des écarts relevés par le watchdog (journal)</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">internal/config/agent</span></code></p></td>
|
||||
<td><p>chargement par viper — tags <code class="docutils literal notranslate"><span class="pre">mapstructure</span></code>, jamais <code class="docutils literal notranslate"><span class="pre">yaml</span></code></p></td>
|
||||
</tr>
|
||||
|
|
@ -447,13 +461,16 @@ une erreur.</p>
|
|||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">pkg/db/kv</span></code></p></td>
|
||||
<td><p>wrapper Badger ; toutes les valeurs sont des chaînes plates</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">pkg/worker</span></code></p></td>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">pkg/db/statefile</span></code></p></td>
|
||||
<td><p>fichier d’état JSON typé, écrit de façon atomique, utilisé par le backend DHCP <code class="docutils literal notranslate"><span class="pre">two</span></code></p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">pkg/worker</span></code></p></td>
|
||||
<td><p>pool de goroutines sur canal</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">pkg/systemd</span></code></p></td>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">pkg/systemd</span></code></p></td>
|
||||
<td><p>client D-Bus systemd</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">pkg/logger</span></code>, <code class="docutils literal notranslate"><span class="pre">pkg/prometheus</span></code></p></td>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">pkg/logger</span></code>, <code class="docutils literal notranslate"><span class="pre">pkg/prometheus</span></code></p></td>
|
||||
<td><p>journalisation <code class="docutils literal notranslate"><span class="pre">slog</span></code> et serveur de métriques</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
|
|
|
|||
|
|
@ -801,7 +801,6 @@ window.runMermaid = runMermaid;</script>
|
|||
creating --> running
|
||||
creating --> error
|
||||
running --> deleting
|
||||
running --> error
|
||||
deleting --> deleted
|
||||
deleting --> error
|
||||
error --> deleting
|
||||
|
|
@ -824,7 +823,9 @@ window.runMermaid = runMermaid;</script>
|
|||
<td><p>la ressource existe sur le système</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">error</span></code></p></td>
|
||||
<td><p><code class="docutils literal notranslate"><span class="pre">Execute</span></code> a échoué ; état <strong>terminal</strong>, il n’y a pas de reprise automatique</p></td>
|
||||
<td><p><code class="docutils literal notranslate"><span class="pre">Execute</span></code> a échoué, ou la migration du démarrage a trouvé la ressource en <code class="docutils literal notranslate"><span class="pre">creating</span></code> ou
|
||||
<code class="docutils literal notranslate"><span class="pre">deleting</span></code> ; état <strong>terminal</strong>, il n’y a pas de reprise automatique. Une ressource
|
||||
<code class="docutils literal notranslate"><span class="pre">running</span></code> ne passe jamais en <code class="docutils literal notranslate"><span class="pre">error</span></code></p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">deleting</span></code></p></td>
|
||||
<td><p>suppression en cours</p></td>
|
||||
|
|
|
|||
|
|
@ -811,14 +811,14 @@ deux processus ne doivent pas partager une même instance.</p>
|
|||
</section>
|
||||
<section id="documents-servis">
|
||||
<h2>Documents servis<a class="headerlink" href="#documents-servis" title="Lien vers cette rubrique">#</a></h2>
|
||||
<p>Chaque document suit la même règle :</p>
|
||||
<p>Quatre documents sont servis : <code class="docutils literal notranslate"><span class="pre">meta-data</span></code>, <code class="docutils literal notranslate"><span class="pre">user-data</span></code>, <code class="docutils literal notranslate"><span class="pre">network-config</span></code> et
|
||||
<code class="docutils literal notranslate"><span class="pre">vendor-data</span></code>. Seul <code class="docutils literal notranslate"><span class="pre">user-data</span></code> vient de l’appelant :</p>
|
||||
<ul class="simple">
|
||||
<li><p>fourni par l’appelant → servi <strong>verbatim</strong>, l’agent n’interprète rien ;</p></li>
|
||||
<li><p>absent → le template par défaut est rendu ;</p></li>
|
||||
<li><p>fourni <strong>vide</strong> → servi vide.</p></li>
|
||||
<li><p><code class="docutils literal notranslate"><span class="pre">user_data</span></code> fourni → servi <strong>verbatim</strong>, après décodage base64 ; l’agent n’interprète rien ;</p></li>
|
||||
<li><p><code class="docutils literal notranslate"><span class="pre">user_data</span></code> absent ou <strong>vide</strong> → <code class="docutils literal notranslate"><span class="pre">user-data</span></code> servi vide : les deux cas sont équivalents.</p></li>
|
||||
</ul>
|
||||
<p>Les deux derniers cas sont distincts, et c’est délibéré : fournir une chaîne vide est une façon
|
||||
explicite de neutraliser un document.</p>
|
||||
<p><code class="docutils literal notranslate"><span class="pre">meta-data</span></code>, <code class="docutils literal notranslate"><span class="pre">network-config</span></code> et <code class="docutils literal notranslate"><span class="pre">vendor-data</span></code> sont <strong>toujours</strong> rendus depuis les templates
|
||||
de l’agent ; <code class="docutils literal notranslate"><span class="pre">vendor-data</span></code> crée le compte <code class="docutils literal notranslate"><span class="pre">syonad</span></code> à partir de <code class="docutils literal notranslate"><span class="pre">password</span></code> et <code class="docutils literal notranslate"><span class="pre">sshkey</span></code>.</p>
|
||||
</section>
|
||||
<section id="champs-de-metadata">
|
||||
<h2>Champs de <code class="docutils literal notranslate"><span class="pre">metadata</span></code><a class="headerlink" href="#champs-de-metadata" title="Lien vers cette rubrique">#</a></h2>
|
||||
|
|
@ -874,11 +874,15 @@ NoCloud en <code class="docutils literal notranslate"><span class="pre">seedfrom
|
|||
<li><p>cloud-init 22.4 (Debian 12) ne demande jamais <code class="docutils literal notranslate"><span class="pre">network-config</span></code> par <code class="docutils literal notranslate"><span class="pre">seedfrom</span></code> et
|
||||
applique sa configuration de repli, limitée à la première interface ;</p></li>
|
||||
<li><p>cloud-init 25.1 (Debian 13) le lit et l’applique au premier démarrage, mais à chaque
|
||||
démarrage suivant l’étape locale réapplique le repli, et <code class="docutils literal notranslate"><span class="pre">network-config</span></code> n’est pas
|
||||
relu : les interfaces secondaires perdent leur configuration.</p></li>
|
||||
démarrage suivant l’étape locale réapplique le repli. L’étape réseau, qui trouve la
|
||||
source, émet alors l’événement <code class="docutils literal notranslate"><span class="pre">boot-legacy</span></code> : refusé par défaut, il est autorisé par
|
||||
<code class="docutils literal notranslate"><span class="pre">updates:</span> <span class="pre">network:</span> <span class="pre">when:</span> <span class="pre">[boot-new-instance,</span> <span class="pre">boot,</span> <span class="pre">boot-legacy]</span></code>, et <code class="docutils literal notranslate"><span class="pre">network-config</span></code>
|
||||
est alors réappliqué à chaque démarrage. Sans ce réglage, les interfaces secondaires
|
||||
perdent leur configuration.</p></li>
|
||||
</ul>
|
||||
<p>L’image doit donc faire du DHCP IPv4 sur <strong>toutes</strong> ses interfaces Ethernet, sans compter
|
||||
sur cloud-init. Voir <a class="reference internal" href="../deploiement/image-qcow2.html"><span class="doc">Construction de l’image qcow2</span></a>.</p>
|
||||
sur cloud-init, et autoriser <code class="docutils literal notranslate"><span class="pre">boot-legacy</span></code> pour que le <code class="docutils literal notranslate"><span class="pre">network-config</span></code> reste appliqué
|
||||
là où cloud-init le lit. Voir <a class="reference internal" href="../deploiement/image-qcow2.html"><span class="doc">Construction de l’image qcow2</span></a>.</p>
|
||||
</div>
|
||||
</section>
|
||||
<section id="securite">
|
||||
|
|
|
|||
|
|
@ -950,11 +950,12 @@ netns relève de #61.</p>
|
|||
<section id="routes-annoncees-aux-vm">
|
||||
<h2>Routes annoncées aux VM<a class="headerlink" href="#routes-annoncees-aux-vm" title="Lien vers cette rubrique">#</a></h2>
|
||||
<p>Les routes sont poussées par DHCP, dans l”<strong>option 121</strong> (routes statiques sans classe,
|
||||
RFC 3442). Trois entrées y figurent :</p>
|
||||
RFC 3442). Trois entrées au plus y figurent :</p>
|
||||
<ol class="arabic simple">
|
||||
<li><p>la route <code class="docutils literal notranslate"><span class="pre">/32</span></code> vers <code class="docutils literal notranslate"><span class="pre">169.254.169.254</span></code>, le serveur de metadata ;</p></li>
|
||||
<li><p>la route vers le CIDR du VPC ;</p></li>
|
||||
<li><p>la route par défaut <code class="docutils literal notranslate"><span class="pre">0.0.0.0/0</span></code>.</p></li>
|
||||
<li><p>la route vers le CIDR du VPC, <strong>sauf en mode</strong> <code class="docutils literal notranslate"><span class="pre">bridge</span></code> ;</p></li>
|
||||
<li><p>la route par défaut <code class="docutils literal notranslate"><span class="pre">0.0.0.0/0</span></code>, <strong>sur l’interface</strong> <code class="docutils literal notranslate"><span class="pre">primary</span></code> <strong>seulement</strong> : les autres
|
||||
interfaces d’une VM n’en reçoivent pas.</p></li>
|
||||
</ol>
|
||||
<div class="admonition important">
|
||||
<p class="admonition-title">Important</p>
|
||||
|
|
@ -964,8 +965,8 @@ dans l’option 121 ; l’option 3 ne sert que les clients qui n’implémentent
|
|||
</section>
|
||||
<section id="route-par-defaut-default-route-et-gateway">
|
||||
<h2>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 class="headerlink" href="#route-par-defaut-default-route-et-gateway" title="Lien vers cette rubrique">#</a></h2>
|
||||
<p>Une route par défaut est <strong>toujours</strong> annoncée. Le champ <code class="docutils literal notranslate"><span class="pre">default_route</span></code> ne choisit que son
|
||||
next-hop :</p>
|
||||
<p>Une route par défaut est <strong>toujours</strong> annoncée à l’interface <code class="docutils literal notranslate"><span class="pre">primary</span></code> d’une VM, et à elle
|
||||
seule. Le champ <code class="docutils literal notranslate"><span class="pre">default_route</span></code> ne choisit que son next-hop :</p>
|
||||
<dl class="simple">
|
||||
<dt><code class="docutils literal notranslate"><span class="pre">default_route:</span> <span class="pre">false</span></code> (défaut)</dt><dd><p>next-hop = <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> du subnet, la gateway calculée en <code class="docutils literal notranslate"><span class="pre">vxlan</span></code>.</p>
|
||||
</dd>
|
||||
|
|
@ -977,7 +978,7 @@ de l’host.</p>
|
|||
subnet relèvent de l’appelant. Fourni avec <code class="docutils literal notranslate"><span class="pre">default_route:</span> <span class="pre">false</span></code>, il est ignoré.</p>
|
||||
<p>Dans tous les modes sauf <code class="docutils literal notranslate"><span class="pre">bridge</span></code>, la route vers le CIDR du VPC garde <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> comme
|
||||
next-hop : sur un subnet à IP publique, le trafic interne ne doit pas sortir par la gateway
|
||||
publique.</p>
|
||||
publique. En mode <code class="docutils literal notranslate"><span class="pre">bridge</span></code>, cette route n’est pas annoncée du tout.</p>
|
||||
</section>
|
||||
<section id="pourquoi-la-route-32-vers-le-serveur-de-metadata-est-indispensable">
|
||||
<h2>Pourquoi la route <code class="docutils literal notranslate"><span class="pre">/32</span></code> vers le serveur de metadata est indispensable<a class="headerlink" href="#pourquoi-la-route-32-vers-le-serveur-de-metadata-est-indispensable" title="Lien vers cette rubrique">#</a></h2>
|
||||
|
|
|
|||
|
|
@ -811,6 +811,11 @@ window.runMermaid = runMermaid;</script>
|
|||
<h2>VPC<a class="headerlink" href="#vpc" title="Lien vers cette rubrique">#</a></h2>
|
||||
<p>Un VPC est un <strong>network namespace</strong> portant un espace d’adressage (<code class="docutils literal notranslate"><span class="pre">cidr</span></code>). C’est l’unité
|
||||
d’isolation : deux VPC ne se voient pas, et peuvent réutiliser les mêmes plages d’adresses.</p>
|
||||
<p>À la création, l’agent relie le netns au bridge <code class="docutils literal notranslate"><span class="pre">br-public</span></code> de l’host par un veth
|
||||
<code class="docutils literal notranslate"><span class="pre">vp-<id>-e</span></code> (côté host) ↔ <code class="docutils literal notranslate"><span class="pre">vp-<id>-i</span></code> (côté netns, rattaché à un <code class="docutils literal notranslate"><span class="pre">br-public</span></code> propre au
|
||||
netns). Ce nom de bridge est <strong>en dur</strong> : l’host doit porter un bridge <code class="docutils literal notranslate"><span class="pre">br-public</span></code>, celui que
|
||||
crée <code class="docutils literal notranslate"><span class="pre">deploy.sh</span> <span class="pre">-i</span></code> avec la valeur par défaut de <code class="docutils literal notranslate"><span class="pre">-P</span></code> (<a class="reference internal" href="../demarrage/installation.html"><span class="doc">Installation d’un hyperviseur</span></a>) ;
|
||||
sans lui, toute création de VPC échoue.</p>
|
||||
<p>Un VPC ne peut être supprimé que si tous ses subnets le sont déjà — sinon 409.</p>
|
||||
<section id="routage-entre-hyperviseurs-l3vni">
|
||||
<h3>Routage entre hyperviseurs : <code class="docutils literal notranslate"><span class="pre">l3vni</span></code><a class="headerlink" href="#routage-entre-hyperviseurs-l3vni" title="Lien vers cette rubrique">#</a></h3>
|
||||
|
|
@ -888,9 +893,12 @@ depuis le subnet, leur source canonique. Le schéma complet des clés est dans
|
|||
</section>
|
||||
<section id="nommage">
|
||||
<h2>Nommage<a class="headerlink" href="#nommage" title="Lien vers cette rubrique">#</a></h2>
|
||||
<p>L’API est machine-to-machine : elle <strong>ne valide pas</strong> les conventions de nommage, à l’exception
|
||||
du motif documenté pour les VPC (<code class="docutils literal notranslate"><span class="pre">vp-…</span></code>). Les exemples de cette documentation suivent la
|
||||
convention <code class="docutils literal notranslate"><span class="pre">vp-</span></code> / <code class="docutils literal notranslate"><span class="pre">sn-</span></code> / <code class="docutils literal notranslate"><span class="pre">i-</span></code>, mais c’est à l’appelant de la faire respecter.</p>
|
||||
<p>L’API est machine-to-machine : elle <strong>ne valide aucun nommage</strong>, pas même le motif <code class="docutils literal notranslate"><span class="pre">vp-…</span></code>
|
||||
indiqué par la spécification pour les VPC. Une contrainte est pourtant réelle : le nom d’un VPC
|
||||
ou d’un subnet doit <strong>contenir un « - »</strong>, car l’identifiant système (<code class="docutils literal notranslate"><span class="pre">vp-<id>-e</span></code>, <code class="docutils literal notranslate"><span class="pre">br-<id></span></code>,
|
||||
<code class="docutils literal notranslate"><span class="pre">gw-<id></span></code>…) est ce qui suit le premier tiret. Un nom sans tiret fait paniquer l’agent. Les
|
||||
exemples de cette documentation suivent la convention <code class="docutils literal notranslate"><span class="pre">vp-</span></code> / <code class="docutils literal notranslate"><span class="pre">sn-</span></code> / <code class="docutils literal notranslate"><span class="pre">i-</span></code>, mais c’est à
|
||||
l’appelant de la faire respecter.</p>
|
||||
</section>
|
||||
</section>
|
||||
|
||||
|
|
|
|||
|
|
@ -393,11 +393,13 @@ depuis la release, et les vérifie contre le manifeste <code class="docutils lit
|
|||
<tbody>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">-t</span> <span class="pre"><tag></span></code></p></td>
|
||||
<td><p>déployer une release donnée</p></td>
|
||||
<td><p>dernière</p></td>
|
||||
<td><p>dernière publiée, <strong>préversions comprises</strong></p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">-b</span> <span class="pre"><branche></span></code></p></td>
|
||||
<td><p>branche utilisée pour l’auto-mise à jour du script</p></td>
|
||||
<td><p><code class="docutils literal notranslate"><span class="pre">main</span></code></p></td>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">-b</span> <span class="pre"><branche>/</span></code></p></td>
|
||||
<td><p>branche d’où viennent l’auto-mise à jour du script et les scripts de <code class="docutils literal notranslate"><span class="pre">-i</span></code> ; les
|
||||
binaires viennent toujours d’une release. Le <code class="docutils literal notranslate"><span class="pre">/</span></code> final est <strong>obligatoire</strong> : l’URL est
|
||||
concaténée sans séparateur (<code class="docutils literal notranslate"><span class="pre">-b</span> <span class="pre">dev</span></code> donne <code class="docutils literal notranslate"><span class="pre">…/branch/devscripts/…</span></code>)</p></td>
|
||||
<td><p><code class="docutils literal notranslate"><span class="pre">main/</span></code></p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">-p</span> <span class="pre"><profil></span></code></p></td>
|
||||
<td><p>profil d’host ; seul <code class="docutils literal notranslate"><span class="pre">kvm</span></code> installe les units de l’agent</p></td>
|
||||
|
|
@ -416,7 +418,8 @@ depuis la release, et les vérifie contre le manifeste <code class="docutils lit
|
|||
<td><p><code class="docutils literal notranslate"><span class="pre">br-000000</span></code></p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">-P</span> <span class="pre"><bridge></span></code></p></td>
|
||||
<td><p>bridge supplémentaire, créé vide et réservé</p></td>
|
||||
<td><p>bridge supplémentaire, créé vide et réservé ; garder <code class="docutils literal notranslate"><span class="pre">br-public</span></code>, nom attendu par
|
||||
l’agent (voir ci-dessous)</p></td>
|
||||
<td><p><code class="docutils literal notranslate"><span class="pre">br-public</span></code></p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">-R</span> <span class="pre"><secondes></span></code></p></td>
|
||||
|
|
@ -457,6 +460,9 @@ le serveur de metadata : sans elle, iptables ne voit pas le trafic bridgé des V
|
|||
ne se provisionne pas. Contrepartie assumée : tout le trafic inter-VM traverse les tables NAT.</p>
|
||||
<p><strong>Réseau</strong> — création du bridge réservé, puis rattachement de l’uplink au bridge principal,
|
||||
l’adresse et la route par défaut étant déplacées de l’interface physique vers le bridge.</p>
|
||||
<p>Le nom <code class="docutils literal notranslate"><span class="pre">br-public</span></code> est <strong>en dur dans l’agent</strong> : chaque VPC <code class="docutils literal notranslate"><span class="pre">vp-<id></span></code> y raccorde un veth
|
||||
<code class="docutils literal notranslate"><span class="pre">vp-<id>-e</span></code> côté host, dont l’autre extrémité <code class="docutils literal notranslate"><span class="pre">vp-<id>-i</span></code> rejoint un <code class="docutils literal notranslate"><span class="pre">br-public</span></code> créé dans
|
||||
le netns du VPC. Avec un autre nom passé à <code class="docutils literal notranslate"><span class="pre">-P</span></code>, toute création de VPC échoue.</p>
|
||||
<div class="admonition danger">
|
||||
<p class="admonition-title">Danger</p>
|
||||
<p>La migration réseau <strong>coupe le réseau de l’host si elle échoue à mi-parcours</strong>, sans console
|
||||
|
|
@ -498,7 +504,8 @@ mécanisme normal, pas une réparation.</p>
|
|||
<td><p><code class="docutils literal notranslate"><span class="pre">-conf</span></code></p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">db</span></code></p></td>
|
||||
<td><p>inspection de la base clé-valeur en ligne de commande</p></td>
|
||||
<td><p>inspection de la base clé-valeur en ligne de commande ; <strong>ni publié ni déployé</strong> par
|
||||
<code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code>, à compiler depuis les sources (<a class="reference internal" href="../exploitation/observabilite.html"><span class="doc">Observabilité</span></a>)</p></td>
|
||||
<td><p><code class="docutils literal notranslate"><span class="pre">-conf</span></code></p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">dhcp</span></code></p></td>
|
||||
|
|
@ -509,7 +516,7 @@ avec <code class="docutils literal notranslate"><span class="pre">dhcp.backend:<
|
|||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<p>Les quatre partagent le même fichier, <code class="docutils literal notranslate"><span class="pre">/etc/two/agent.yml</span></code> — voir
|
||||
<p>Les quatre lisent le même fichier, <code class="docutils literal notranslate"><span class="pre">/etc/two/agent.yml</span></code> — voir
|
||||
<a class="reference internal" href="../exploitation/configuration.html"><span class="doc">Configuration</span></a>. <code class="docutils literal notranslate"><span class="pre">dhcp</span></code> reçoit en plus son bridge et ses deux chemins de
|
||||
fichiers en paramètres, posés par son script d’enrobage.</p>
|
||||
</section>
|
||||
|
|
|
|||
|
|
@ -806,15 +806,18 @@ plan de contrôle du cluster en place, cf. <a class="reference internal" href=".
|
|||
<pre class="mermaid">
|
||||
graph LR
|
||||
subgraph netns vp-admin
|
||||
BR["br-sn000001<br/>10.1.1.254"]
|
||||
BR["br-000001<br/>10.1.1.253"]
|
||||
GW["gw-000001<br/>gateway 10.1.1.254"]
|
||||
MD["metadata@i-web<br/>169.254.169.254"]
|
||||
end
|
||||
VM["VM i-web<br/>10.1.1.2"] --- BR
|
||||
BR --- MD
|
||||
BR --- VXLAN["VXLAN vni 1<br/>br-000000"]
|
||||
</pre><p>Le VPC est un network namespace ; le subnet y pose un bridge porteur de la gateway ; la VM s’y
|
||||
raccroche par un tap, reçoit son adresse en DHCP et son cloud-init depuis le serveur de metadata
|
||||
du netns.</p>
|
||||
BR --- GW
|
||||
GW --- MD
|
||||
BR --- VXLAN["VXLAN vni 65537<br/>br-000000"]
|
||||
</pre><p>Le VPC est un network namespace ; le subnet y pose un bridge <code class="docutils literal notranslate"><span class="pre">br-000001</span></code> — <code class="docutils literal notranslate"><span class="pre">br-</span></code> suivi de ce
|
||||
qui suit le premier tiret du nom du subnet — porteur de l’adresse d’émission, et un macvlan
|
||||
<code class="docutils literal notranslate"><span class="pre">gw-000001</span></code> porteur de la gateway ; la VM se raccroche au bridge par un tap, reçoit son
|
||||
adresse en DHCP et son cloud-init depuis le serveur de metadata du netns.</p>
|
||||
</section>
|
||||
<section id="le-vpc">
|
||||
<h2>1. Le VPC<a class="headerlink" href="#le-vpc" title="Lien vers cette rubrique">#</a></h2>
|
||||
|
|
@ -829,8 +832,10 @@ route interne, quel que soit le mode du subnet.</p>
|
|||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>curl<span class="w"> </span>-s<span class="w"> </span>http://127.0.0.1:8080/vpcs/vp-admin
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>Attendez <code class="docutils literal notranslate"><span class="pre">"state":</span> <span class="pre">"running"</span></code> avant l’étape suivante — un subnet dont le VPC parent n’est pas
|
||||
prêt est refusé en <strong>422</strong>. Le modèle d’attente est décrit dans <a class="reference internal" href="../exploitation/api-agent/asynchronisme.html"><span class="doc">Modèle asynchrone et codes de retour</span></a>.</p>
|
||||
<p>Un subnet peut être demandé dès maintenant : il est accepté tant que le VPC est en <code class="docutils literal notranslate"><span class="pre">creating</span></code>
|
||||
ou <code class="docutils literal notranslate"><span class="pre">running</span></code>, et sa création attend que le VPC soit <code class="docutils literal notranslate"><span class="pre">running</span></code>, dans la limite de
|
||||
<code class="docutils literal notranslate"><span class="pre">dispatcher.timeout_seconds</span></code>. Il n’est refusé en <strong>422</strong> que si le VPC est absent, en <code class="docutils literal notranslate"><span class="pre">error</span></code>
|
||||
ou en <code class="docutils literal notranslate"><span class="pre">deleting</span></code>. Le modèle d’attente est décrit dans <a class="reference internal" href="../exploitation/api-agent/asynchronisme.html"><span class="doc">Modèle asynchrone et codes de retour</span></a>.</p>
|
||||
</section>
|
||||
<section id="le-subnet">
|
||||
<h2>2. Le subnet<a class="headerlink" href="#le-subnet" title="Lien vers cette rubrique">#</a></h2>
|
||||
|
|
@ -839,7 +844,7 @@ prêt est refusé en <strong>422</strong>. Le modèle d’attente est décrit da
|
|||
<span class="w"> </span>-d<span class="w"> </span><span class="s1">'{"name": "sn-000001",</span>
|
||||
<span class="s1"> "vpc": "vp-admin",</span>
|
||||
<span class="s1"> "mode": "vxlan",</span>
|
||||
<span class="s1"> "vxlan_id": 1,</span>
|
||||
<span class="s1"> "vxlan_id": 65537,</span>
|
||||
<span class="s1"> "iface_type": "vms",</span>
|
||||
<span class="s1"> "cidr": "10.1.0.0/23"}'</span>
|
||||
</pre></div>
|
||||
|
|
@ -910,14 +915,14 @@ cloud-init, lui, se déroule dans le guest ; on l’observe par la console séri
|
|||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>socat<span class="w"> </span>-,raw,echo<span class="o">=</span><span class="m">0</span><span class="w"> </span>UNIX-CONNECT:/run/two/vms/serial/i-web.sock
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>Puis, depuis l’host :</p>
|
||||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>ssh<span class="w"> </span>syonad@10.1.1.2
|
||||
<p>Puis, depuis l’host, en passant par le netns du VPC :</p>
|
||||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>ip<span class="w"> </span>netns<span class="w"> </span><span class="nb">exec</span><span class="w"> </span>vp-admin<span class="w"> </span>ssh<span class="w"> </span>syonad@10.1.1.2
|
||||
</pre></div>
|
||||
</div>
|
||||
<div class="admonition note">
|
||||
<p class="admonition-title">Note</p>
|
||||
<p>En mode <code class="docutils literal notranslate"><span class="pre">vxlan</span></code>, la VM vit dans le netns du VPC : elle n’est pas joignable depuis l’host
|
||||
sans route explicite. En mode <code class="docutils literal notranslate"><span class="pre">bridge</span></code>, elle l’est directement.</p>
|
||||
sans route explicite, d’où le <code class="docutils literal notranslate"><span class="pre">ip</span> <span class="pre">netns</span> <span class="pre">exec</span></code>. En mode <code class="docutils literal notranslate"><span class="pre">bridge</span></code>, elle l’est directement.</p>
|
||||
</div>
|
||||
</section>
|
||||
<section id="supprimer">
|
||||
|
|
|
|||
|
|
@ -382,9 +382,9 @@
|
|||
élément à venir, avec son ticket.</span><a class="headerlink" href="#id5" title="Lien vers cette image">#</a></p>
|
||||
</figcaption>
|
||||
</figure>
|
||||
<p>Plusieurs clusters, chacun avec son underlay, ses deux routeurs et un route reflector, sont reliés
|
||||
en eBGP entre eux et aux <strong>routeurs de bordure</strong>. Ce qui n’existe pas encore est décrit sur son
|
||||
ticket :</p>
|
||||
<p>Plusieurs clusters, chacun avec son underlay et ses deux routeurs, sont reliés en eBGP entre eux
|
||||
et aux <strong>routeurs de bordure</strong> ; les route reflectors sont décrits plus bas. Ce qui n’existe pas
|
||||
encore est décrit sur son ticket :</p>
|
||||
<ul class="simple">
|
||||
<li><p><strong>Internet</strong> (<a class="reference external" href="https://git.g3e.fr/syonad/two/issues/31">#31</a>,
|
||||
<a class="reference external" href="https://git.g3e.fr/syonad/two/issues/42">#42</a>). Les bordures partagent avec les hyperviseurs
|
||||
|
|
@ -400,11 +400,17 @@ par défaut de type 5, si le VPC autorise Internet.</p></li>
|
|||
</li>
|
||||
<li><p><strong>Orchestration</strong> (<a class="reference external" href="https://git.g3e.fr/syonad/two/issues/72">#72</a>). Le broker et
|
||||
l’orchestrateur sont des VM du VNI 66000, partagé entre clusters. Les agents s’y connectent
|
||||
<strong>en sortie</strong>, par leur passerelle ; les routeurs de chaque cluster les NAT vers le VNI 66000.
|
||||
<strong>en sortie</strong>, par leur passerelle ; les routeurs de chaque cluster les traduisent (NAT) vers le
|
||||
VNI 66000.
|
||||
L’orchestrateur a aussi une patte dans le VNI 66001 : son API est joignable depuis Internet.</p></li>
|
||||
<li><p><strong>Route reflectors.</strong> Un par cluster, pour qu’un incident sur un cluster ne coupe pas les deux
|
||||
sessions EVPN. Chaque lien entre routeurs et route reflector est en <code class="docutils literal notranslate"><span class="pre">169.254.0.0/28</span></code>, propre
|
||||
à son cluster.</p></li>
|
||||
<li><p><strong>Route reflectors.</strong> Au moins un ; deux sont prévus dans l’architecture et dans les exemples
|
||||
(plages d’adresses de <a class="reference internal" href="route-reflector.html"><span class="doc">VM route reflector</span></a>), placés ici dans deux clusters différents pour
|
||||
qu’un incident sur un cluster ne coupe pas les deux sessions EVPN. Chaque lien entre routeurs
|
||||
et route reflector est en <code class="docutils literal notranslate"><span class="pre">169.254.0.0/28</span></code>, propre à son cluster. Le <code class="docutils literal notranslate"><span class="pre">bgp</span> <span class="pre">listen</span> <span class="pre">range</span></code> de
|
||||
chaque route reflector doit alors couvrir l’underlay de <strong>tous</strong> les clusters qu’il sert —
|
||||
l’exemple <code class="docutils literal notranslate"><span class="pre">rr1.conf</span></code> n’accepte que <code class="docutils literal notranslate"><span class="pre">192.168.14.0/24</span></code>.</p></li>
|
||||
<li><p><strong>ASN.</strong> Les routeurs de deux clusters étant voisins eBGP, chaque cluster a son propre ASN de
|
||||
routeurs : l’AS 65100 des exemples est la valeur d”<strong>un</strong> cluster.</p></li>
|
||||
</ul>
|
||||
<p>Le lab (<a class="reference internal" href="../developpement/lab.html"><span class="doc">Lab de test multi-nœud</span></a>) simplifie : un seul cluster, qui porte les deux route
|
||||
reflectors.</p>
|
||||
|
|
@ -432,7 +438,7 @@ violets : plan de contrôle (sessions BGP). Pointillé gris : créé par l’age
|
|||
<dt>Plan de données</dt><dd><p>les tunnels VXLAN entre hyperviseurs, encapsulés sur le réseau qui les relie.</p>
|
||||
</dd>
|
||||
<dt>Plan de contrôle</dt><dd><p>ce qui dit à chaque hyperviseur où se trouvent les adresses MAC des autres. C’est le rôle de
|
||||
FRR et du route reflector.</p>
|
||||
FRR et des route reflectors.</p>
|
||||
</dd>
|
||||
</dl>
|
||||
</section>
|
||||
|
|
@ -463,8 +469,8 @@ qu’un composant externe n’a pas peuplé la table de transfert (FDB) du VXLAN
|
|||
isolé le trafic reste sur le bridge local et cette absence ne se voit pas ; elle apparaît dès
|
||||
le deuxième nœud.</p>
|
||||
</div>
|
||||
<p>C’est exactement le rôle que remplissent FRR sur chaque hyperviseur et le route reflector qui
|
||||
les fait converger.</p>
|
||||
<p>C’est exactement le rôle que remplissent FRR sur chaque hyperviseur et les route reflectors qui
|
||||
les font converger.</p>
|
||||
</section>
|
||||
<section id="mtu">
|
||||
<h2>MTU<a class="headerlink" href="#mtu" title="Lien vers cette rubrique">#</a></h2>
|
||||
|
|
|
|||
|
|
@ -1082,6 +1082,21 @@ toutes les interfaces <code class="docutils literal notranslate"><span class="pr
|
|||
négative sert à laisser la première interface au profil écrit par cloud-init. Le fichier est en <code class="docutils literal notranslate"><span class="pre">0600</span></code>,
|
||||
comme les profils de NetworkManager. Vérifié sous Rocky 10.2 : la seconde interface obtient
|
||||
son bail au premier démarrage et après redémarrage (<code class="docutils literal notranslate"><span class="pre">nmcli</span></code> : connexion <code class="docutils literal notranslate"><span class="pre">two-all-en</span></code>).</p>
|
||||
<p><strong>Réappliquer le network-config à chaque démarrage</strong></p>
|
||||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>cat<span class="w"> </span><span class="s"><< 'ENDFILE' > /mnt/etc/cloud/cloud.cfg.d/98_network_updates.cfg</span>
|
||||
<span class="s">updates:</span>
|
||||
<span class="s"> network:</span>
|
||||
<span class="s"> when: [boot-new-instance, boot, boot-legacy]</span>
|
||||
<span class="s">ENDFILE</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>La source de metadata n’étant trouvée qu’à l’étape réseau de cloud-init, l’étape locale
|
||||
applique à chaque démarrage une configuration de repli limitée à la première interface. Au
|
||||
redémarrage, l’étape réseau émet l’événement <code class="docutils literal notranslate"><span class="pre">boot-legacy</span></code>, refusé par défaut : ce réglage
|
||||
l’autorise, et cloud-init réapplique alors le <code class="docutils literal notranslate"><span class="pre">network-config</span></code> servi par l’agent, qui vise
|
||||
chaque interface par sa MAC. Le <code class="docutils literal notranslate"><span class="pre">user_data</span></code> n’est pas rejoué. Sans effet sur un cloud-init
|
||||
qui ne lit pas le <code class="docutils literal notranslate"><span class="pre">network-config</span></code> (22.4, Debian 12) : la règle de DHCP ci-dessus reste
|
||||
nécessaire.</p>
|
||||
<p><strong>Noms stables des disques additionnels</strong></p>
|
||||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>cat<span class="w"> </span><span class="s"><< 'ENDFILE' > /mnt/etc/udev/rules.d/90-two-xvd.rules</span>
|
||||
<span class="s">SUBSYSTEM=="block", ENV{DEVTYPE}=="disk", ENV{ID_SERIAL_SHORT}=="xvd[a-z]", SYMLINK+="$env{ID_SERIAL_SHORT}"</span>
|
||||
|
|
|
|||
|
|
@ -361,7 +361,7 @@ même nœud. Cette section couvre la mise en place d’un <strong>cluster</stron
|
|||
étapes se font.</p>
|
||||
<p>Cet ordre n’est pas indifférent : chaque étape a besoin de la précédente. L’image doit exister
|
||||
avant qu’on puisse démarrer quoi que ce soit ; le réseau doit être en place avant le premier
|
||||
hyperviseur ; le route reflector est lui-même une VM, il lui faut donc un hyperviseur qui
|
||||
hyperviseur ; chaque route reflector est lui-même une VM, il lui faut donc un hyperviseur qui
|
||||
fonctionne.</p>
|
||||
<section id="etapes">
|
||||
<h2>Étapes<a class="headerlink" href="#etapes" title="Lien vers cette rubrique">#</a></h2>
|
||||
|
|
|
|||
|
|
@ -414,13 +414,13 @@ exit
|
|||
<p>Avec une section <code class="docutils literal notranslate"><span class="pre">bgp</span></code>, l’agent <strong>refuse de démarrer</strong> si <code class="docutils literal notranslate"><span class="pre">vtysh</span></code> ne répond pas, et
|
||||
<code class="docutils literal notranslate"><span class="pre">agent.service</span></code> ne le relance pas. L’ordre au démarrage est donc : migration réseau vers
|
||||
<code class="docutils literal notranslate"><span class="pre">br-000000</span></code>, <strong>puis</strong> FRR, <strong>puis</strong> l’agent. FRR démarré avant la migration peut perdre la
|
||||
route par défaut quand elle change d’interface, et ne plus joindre le route reflector.</p>
|
||||
route par défaut quand elle change d’interface, et ne plus joindre les route reflectors.</p>
|
||||
</div>
|
||||
<p>Ce qu’elle établit :</p>
|
||||
<ul class="simple">
|
||||
<li><p><strong>Une session par route reflector</strong>, en iBGP dans l’AS 64600, vers sa loopback
|
||||
(<code class="docutils literal notranslate"><span class="pre">10.255.255.1</span></code>, <code class="docutils literal notranslate"><span class="pre">10.255.255.2</span></code>), jointe par la passerelle par défaut — le routeur de
|
||||
cluster l’a apprise du route reflector (<a class="reference internal" href="routeurs.html"><span class="doc">Routeurs</span></a>). Aucune adresse d’un autre hyperviseur n’est écrite : ajouter
|
||||
cluster l’a apprise de ce route reflector (<a class="reference internal" href="routeurs.html"><span class="doc">Routeurs</span></a>). Aucune adresse d’un autre hyperviseur n’est écrite : ajouter
|
||||
un nœud ne touche pas la configuration des autres.</p></li>
|
||||
<li><p><strong>EVPN seulement</strong> : l’IPv4 unicast n’est pas activé (<code class="docutils literal notranslate"><span class="pre">no</span> <span class="pre">bgp</span> <span class="pre">default</span> <span class="pre">ipv4-unicast</span></code>).
|
||||
<code class="docutils literal notranslate"><span class="pre">advertise-all-vni</span></code> annonce les VNI de toutes les interfaces VXLAN que FRR voit, et donc
|
||||
|
|
@ -433,9 +433,9 @@ celles que l’agent crée.</p></li>
|
|||
<p>Rien à configurer à la création d’un subnet : la VXLAN apparaît, FRR la voit et l’annonce, sans
|
||||
action ni redémarrage. Il faut en revanche que la VXLAN porte une <strong>adresse VTEP locale</strong> : sans
|
||||
elle, FRR voit la VNI mais n’annonce rien, et deux hyperviseurs gérés par two ne se joignent pas.
|
||||
L’agent la pose à partir de la release <code class="docutils literal notranslate"><span class="pre">0.2.0rc003</span></code>
|
||||
(<a class="reference external" href="https://git.g3e.fr/syonad/two/issues/51">#51</a>) : l’adresse IPv4 primaire du <code class="docutils literal notranslate"><span class="pre">local_iface</span></code>
|
||||
du subnet.</p>
|
||||
L’agent la pose depuis la version 0.2.0 (préversions comprises à partir de <code class="docutils literal notranslate"><span class="pre">0.2.0rc003</span></code>,
|
||||
<a class="reference external" href="https://git.g3e.fr/syonad/two/issues/51">#51</a>, fermé) : l’adresse IPv4 primaire du
|
||||
<code class="docutils literal notranslate"><span class="pre">local_iface</span></code> du subnet.</p>
|
||||
<div class="admonition note">
|
||||
<p class="admonition-title">Note</p>
|
||||
<p><strong>À rédiger.</strong> Reste à documenter :</p>
|
||||
|
|
@ -444,11 +444,10 @@ du subnet.</p>
|
|||
et configuration doivent être posés à chaque démarrage, par le bootstrap ou un mécanisme
|
||||
équivalent (<a class="reference external" href="https://git.g3e.fr/syonad/two/issues/52">#52</a>) ;</p></li>
|
||||
<li><p>le démarrage à froid, selon que FRR démarre avant ou après l’agent ;</p></li>
|
||||
<li><p>les subnets <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> créés avant <code class="docutils literal notranslate"><span class="pre">0.2.0rc003</span></code>, dont la VXLAN n’a pas d’adresse VTEP
|
||||
locale : les recréer ou poser l’adresse à chaud, à trancher dans
|
||||
<a class="reference external" href="https://git.g3e.fr/syonad/two/issues/51">#51</a> ;</p></li>
|
||||
<li><p>les subnets <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> créés par une version antérieure, dont la VXLAN n’a pas d’adresse VTEP
|
||||
locale : aucune migration ne la pose, il faut les recréer ;</p></li>
|
||||
<li><p>le cas particulier du <strong>premier</strong> hyperviseur, dont la session ne peut pas s’établir tant
|
||||
que le route reflector n’existe pas.</p></li>
|
||||
qu’aucun route reflector n’existe.</p></li>
|
||||
</ul>
|
||||
</div>
|
||||
</section>
|
||||
|
|
|
|||
|
|
@ -360,9 +360,11 @@
|
|||
<h1>VM route reflector<a class="headerlink" href="#vm-route-reflector" title="Lien vers cette rubrique">#</a></h1>
|
||||
<p>Le route reflector est le point de rendez-vous du plan de contrôle : plutôt que de maintenir une
|
||||
session entre chaque paire d’hyperviseurs, chaque hyperviseur ouvre une session vers le route
|
||||
reflector, qui redistribue. Le cluster en compte <strong>deux</strong>, configurés à l’identique hormis leurs
|
||||
adresses : chaque hyperviseur ouvre une session vers chacun, et la perte de l’un ne doit pas
|
||||
interrompre le plan de contrôle (<a class="reference external" href="https://git.g3e.fr/syonad/two/issues/54">#54</a>).</p>
|
||||
reflector, qui redistribue. Un cluster en compte <strong>au moins un</strong> ; l’architecture et les exemples
|
||||
de cette page en prévoient <strong>deux</strong> (rr1 et rr2, d’où les plages d’adresses ci-dessous),
|
||||
configurés à l’identique hormis leurs adresses : chaque hyperviseur ouvre une session vers chacun,
|
||||
et la perte de l’un n’interrompt pas le plan de contrôle
|
||||
(<a class="reference external" href="https://git.g3e.fr/syonad/two/issues/54">#54</a>, fermé).</p>
|
||||
<p>Il tourne lui-même en machine virtuelle, ce qui crée une dépendance circulaire à traiter
|
||||
explicitement : la VM qui porte le plan de contrôle du cluster est hébergée par le cluster.</p>
|
||||
<section id="adressage">
|
||||
|
|
@ -484,13 +486,14 @@ fois par route reflector ; si l’un tombe, les routes reçues de l’autre rest
|
|||
</ul>
|
||||
<div class="admonition warning">
|
||||
<p class="admonition-title">Avertissement</p>
|
||||
<p><strong>Les tunnels ne survivent pas à la perte du route reflector.</strong> Avec un seul route reflector
|
||||
et sans <code class="docutils literal notranslate"><span class="pre">graceful-restart</span></code>, à l’arrêt de FRR sur le route reflector, la session EVPN des
|
||||
hyperviseurs tombe aussitôt, FRR retire les routes apprises et, avec elles, le VTEP distant et l’entrée d’inondation du VXLAN — <strong>plus
|
||||
aucun paquet ne passe</strong> entre hyperviseurs, à 30 s comme à 90 s. Au redémarrage de FRR sur le
|
||||
route reflector, VTEP distant et trafic reviennent <strong>31 s</strong> plus tard. Le trafic entre VM d’un
|
||||
même hyperviseur n’est pas concerné. La redondance (deux route reflectors) ou
|
||||
<code class="docutils literal notranslate"><span class="pre">graceful-restart</span></code> sont les deux leviers ; ni l’un ni l’autre n’est encore qualifié.</p>
|
||||
<p><strong>Les tunnels ne survivent pas à la perte de tous les route reflectors.</strong> Sans
|
||||
<code class="docutils literal notranslate"><span class="pre">graceful-restart</span></code>, quand plus aucun route reflector ne répond, les sessions EVPN des
|
||||
hyperviseurs tombent, FRR retire les routes apprises et, avec elles, le VTEP distant et
|
||||
l’entrée d’inondation du VXLAN : <strong>plus aucun paquet ne passe</strong> entre hyperviseurs, jusqu’au
|
||||
retour d’un route reflector et à la reconvergence des sessions. Le trafic entre VM d’un même
|
||||
hyperviseur n’est pas concerné. Avec deux route reflectors, la perte de l’un est sans effet sur
|
||||
le trafic, à condition qu’ils ne tombent jamais ensemble : <strong>jamais deux route reflectors sur le
|
||||
même hyperviseur</strong>. Les mesures du lab sont dans <a class="reference internal" href="../developpement/lab.html"><span class="doc">Lab de test multi-nœud</span></a>.</p>
|
||||
</div>
|
||||
<div class="admonition note">
|
||||
<p class="admonition-title">Note</p>
|
||||
|
|
@ -501,8 +504,8 @@ lancer sur n’importe quel hyperviseur), et s’il s’agit d’une VM créée
|
|||
autres ou d’un cas particulier — l’image, elle, est l’image golden de <a class="reference internal" href="image-qcow2.html"><span class="doc">Construction de l’image qcow2</span></a> ;</p></li>
|
||||
<li><p>le placement des deux VM : jamais sur le même hyperviseur, et de préférence pas sur un
|
||||
hyperviseur dont la perte isolerait l’autre ;</p></li>
|
||||
<li><p>la procédure de reconstruction — l’état du cluster pendant l’absence du route reflector est
|
||||
décrit ci-dessus : plus de trafic entre hyperviseurs ;</p></li>
|
||||
<li><p>la procédure de reconstruction — l’état du cluster pendant l’absence de tous les route
|
||||
reflectors est décrit ci-dessus : plus de trafic entre hyperviseurs ;</p></li>
|
||||
<li><p>la procédure d’amorçage : ce qui fonctionne, et dans quel ordre, quand on démarre un cluster
|
||||
entier depuis zéro — le premier hyperviseur n’a pas de session FRR établie tant que cette VM
|
||||
n’existe pas, cf. <a class="reference internal" href="premier-hyperviseur.html"><span class="doc">Premier hyperviseur</span></a>.</p></li>
|
||||
|
|
|
|||
|
|
@ -375,9 +375,10 @@ données VXLAN.</p>
|
|||
</dl>
|
||||
<section id="routeur-de-cluster">
|
||||
<h2>Routeur de cluster<a class="headerlink" href="#routeur-de-cluster" title="Lien vers cette rubrique">#</a></h2>
|
||||
<p>Le routeur de cluster est la passerelle des hyperviseurs et le voisin eBGP des deux route
|
||||
reflectors, dont il apprend les loopbacks : c’est par lui que chaque hyperviseur joint
|
||||
<code class="docutils literal notranslate"><span class="pre">10.255.255.1</span></code> et <code class="docutils literal notranslate"><span class="pre">10.255.255.2</span></code> pour ouvrir ses sessions EVPN (<a class="reference internal" href="route-reflector.html"><span class="doc">VM route reflector</span></a>).</p>
|
||||
<p>Le routeur de cluster est la passerelle des hyperviseurs et le voisin eBGP des route reflectors
|
||||
— au moins un ; deux sont prévus dans l’architecture et dans les exemples —, dont il apprend les
|
||||
loopbacks : c’est par lui que chaque hyperviseur joint <code class="docutils literal notranslate"><span class="pre">10.255.255.1</span></code> et <code class="docutils literal notranslate"><span class="pre">10.255.255.2</span></code> pour
|
||||
ouvrir ses sessions EVPN (<a class="reference internal" href="route-reflector.html"><span class="doc">VM route reflector</span></a>).</p>
|
||||
<section id="adressage">
|
||||
<h3>Adressage<a class="headerlink" href="#adressage" title="Lien vers cette rubrique">#</a></h3>
|
||||
<div class="pst-scrollable-table-container"><table class="table">
|
||||
|
|
@ -394,8 +395,9 @@ reflectors, dont il apprend les loopbacks : c’est par lui que chaque hypervise
|
|||
</thead>
|
||||
<tbody>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">192.168.14.1/24</span></code></p></td>
|
||||
<td><p>interface du segment des hyperviseurs</p></td>
|
||||
<td><p>passerelle par défaut des hyperviseurs et du route reflector</p></td>
|
||||
<td><p>interface du segment des hyperviseurs, <strong>adresse virtuelle VRRP</strong></p></td>
|
||||
<td><p>passerelle par défaut des hyperviseurs et des route reflectors, portée par le routeur
|
||||
maître ; chaque routeur a en plus sa propre adresse sur le segment</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">169.254.0.1/28</span></code></p></td>
|
||||
<td><p>même interface, <strong>adresse secondaire</strong></p></td>
|
||||
|
|
@ -457,9 +459,9 @@ reflector : chaque côté filtre, aucun ne dépend du filtre de l’autre.</p></
|
|||
<li><p><strong>Aucune session avec les hyperviseurs</strong> : le routeur leur sert de passerelle, pas de voisin BGP.</p></li>
|
||||
</ul>
|
||||
<p>Celle du second routeur (<code class="docutils literal notranslate"><span class="pre">test/e2e/topologies/frr/sw2.conf</span></code>) ne diffère que par <code class="docutils literal notranslate"><span class="pre">hostname</span></code> et
|
||||
<code class="docutils literal notranslate"><span class="pre">router-id</span></code> (<code class="docutils literal notranslate"><span class="pre">169.254.0.2</span></code>), que les route reflectors déclarent aussi. La redondance des
|
||||
routeurs — et le mécanisme qui fait basculer la passerelle <code class="docutils literal notranslate"><span class="pre">192.168.14.1</span></code> — est l’objet de
|
||||
<a class="reference external" href="https://git.g3e.fr/syonad/two/issues/54">#54</a>.</p>
|
||||
<code class="docutils literal notranslate"><span class="pre">router-id</span></code> (<code class="docutils literal notranslate"><span class="pre">169.254.0.2</span></code>), que les route reflectors déclarent aussi. Les deux routeurs se
|
||||
partagent la passerelle <code class="docutils literal notranslate"><span class="pre">192.168.14.1</span></code> en <strong>VRRP v3</strong> : le maître la porte, l’autre attend, sans
|
||||
préemption (<a class="reference external" href="https://git.g3e.fr/syonad/two/issues/54">#54</a>, fermé).</p>
|
||||
<div class="admonition note">
|
||||
<p class="admonition-title">Note</p>
|
||||
<p>Ce qui précède est le contrat du routeur de cluster : adresses, ASN, session, filtres. Sa
|
||||
|
|
@ -469,9 +471,8 @@ traduction dans la configuration d’un constructeur n’a pas sa place ici.</p>
|
|||
<p class="admonition-title">Note</p>
|
||||
<p><strong>À rédiger.</strong> Reste à documenter, faute d’éléments de terrain :</p>
|
||||
<ul class="simple">
|
||||
<li><p>pour le routeur de cluster : le matériel employé et sa version de référence ; la redondance
|
||||
— deux routeurs, mécanisme de bascule, comportement attendu pendant une bascule
|
||||
(<a class="reference external" href="https://git.g3e.fr/syonad/two/issues/54">#54</a>) ;</p></li>
|
||||
<li><p>pour le routeur de cluster : le matériel employé et sa version de référence ; la traduction
|
||||
de la redondance VRRP v3 dans sa configuration ;</p></li>
|
||||
<li><p>pour les routeurs de datacentre et de bordure : tout — équipement, configuration de
|
||||
référence, ce qui est annoncé et filtré à chaque niveau, redondance ;</p></li>
|
||||
<li><p>l’ordre de mise en service, et ce qui doit être opérationnel avant de préparer le premier
|
||||
|
|
|
|||
|
|
@ -372,7 +372,7 @@
|
|||
<p>Ce qui fait l’intérêt de two ne se voit qu’à partir de <strong>deux hyperviseurs</strong> : sur un nœud isolé,
|
||||
le trafic reste sur le bridge local et l’absence de plan de contrôle passe inaperçue (voir
|
||||
<a class="reference internal" href="../deploiement/architecture-cluster.html"><span class="doc">Architecture du cluster</span></a>). Le lab reproduit la topologie du cluster —
|
||||
hyperviseurs, route reflector, switch L3 — sous forme de VM, sur un serveur physique loué à
|
||||
hyperviseurs, route reflectors, switchs L3 — sous forme de VM, sur un serveur physique loué à
|
||||
l’heure.</p>
|
||||
<p>Le pourquoi des choix (serveur physique plutôt que VM cloud, câbles QEMU, MTU 9000, versions) est
|
||||
consigné sur le ticket <a class="reference external" href="https://git.g3e.fr/syonad/two/issues/50">#50</a>. Cette page décrit
|
||||
|
|
@ -383,7 +383,8 @@ comment s’en servir.</p>
|
|||
<a class="reference external" href="https://git.g3e.fr/syonad/labctl">labctl</a>, un dépôt à part, dont two épingle une release.
|
||||
Ce dépôt garde ce qui est propre à two — ses topologies, l’installation de two sur les
|
||||
hyperviseurs, les scénarios et leurs résultats. La redondance du plan de contrôle — deux route
|
||||
reflectors, deux switchs — est l’objet de <a class="reference external" href="https://git.g3e.fr/syonad/two/issues/54">#54</a>.</p>
|
||||
reflectors, deux switchs en VRRP v3 — est livrée par <a class="reference external" href="https://git.g3e.fr/syonad/two/issues/54">#54</a>
|
||||
(fermé), et qualifiée par les tests 71 et 72.</p>
|
||||
</div>
|
||||
<section id="l-outil">
|
||||
<h2>L’outil<a class="headerlink" href="#l-outil" title="Lien vers cette rubrique">#</a></h2>
|
||||
|
|
@ -473,7 +474,7 @@ et <code class="docutils literal notranslate"><span class="pre">evpn-3hv.yml</sp
|
|||
<span class="nt"> services</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">agent.service</span><span class="p p-Indicator">]</span><span class="w"> </span><span class="p p-Indicator">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>Les ASN, la loopback du route reflector, le lien <code class="docutils literal notranslate"><span class="pre">169.254.0.0/28</span></code> et le subnet des hyperviseurs
|
||||
<p>Les ASN, les loopbacks des route reflectors, le lien <code class="docutils literal notranslate"><span class="pre">169.254.0.0/28</span></code> et le subnet des hyperviseurs
|
||||
de l’exemple sont <strong>ceux de la production</strong> (décision du 2026-10-04, #50) : les fichiers de
|
||||
<code class="docutils literal notranslate"><span class="pre">test/e2e/topologies/</span></code> restent ainsi au plus près de ce qui tourne réellement. Toutes les adresses y sont
|
||||
<strong>fixées</strong> par <code class="docutils literal notranslate"><span class="pre">addresses</span></code> — les switchs en <code class="docutils literal notranslate"><span class="pre">.2</span></code> et <code class="docutils literal notranslate"><span class="pre">.3</span></code>, les route reflectors en <code class="docutils literal notranslate"><span class="pre">.4</span></code> et <code class="docutils literal notranslate"><span class="pre">.5</span></code>,
|
||||
|
|
@ -481,15 +482,16 @@ les hyperviseurs à partir de <code class="docutils literal notranslate"><span c
|
|||
de l’ordre de déclaration : le <code class="docutils literal notranslate"><span class="pre">frr.conf</span></code> d’un hyperviseur, écrit à la main, porte son adresse en
|
||||
<code class="docutils literal notranslate"><span class="pre">router-id</span></code>. Les deux switchs <code class="docutils literal notranslate"><span class="pre">sw1</span></code> et <code class="docutils literal notranslate"><span class="pre">sw2</span></code> sont les routeurs du segment (rôle <code class="docutils literal notranslate"><span class="pre">router</span></code> de
|
||||
labctl) : la passerelle, la première adresse du segment, est portée en VRRP v3 par celui qui est
|
||||
maître, sans préemption — voir la section du guide de labctl sur les routeurs. Leurs
|
||||
<code class="docutils literal notranslate"><span class="pre">frr.conf</span></code> ne diffèrent que par <code class="docutils literal notranslate"><span class="pre">hostname</span></code> et <code class="docutils literal notranslate"><span class="pre">router-id</span></code> ; labctl y ajoute la strophe VRRP.</p>
|
||||
maître, sans préemption (<code class="docutils literal notranslate"><span class="pre">no</span> <span class="pre">vrrp</span> <span class="pre">1</span> <span class="pre">preempt</span></code>) — voir la section du guide de labctl sur les
|
||||
routeurs. Leurs <code class="docutils literal notranslate"><span class="pre">frr.conf</span></code> ne diffèrent que par <code class="docutils literal notranslate"><span class="pre">hostname</span></code> et <code class="docutils literal notranslate"><span class="pre">router-id</span></code> ; labctl y ajoute
|
||||
la strophe VRRP.</p>
|
||||
<section id="roles">
|
||||
<h3>Rôles<a class="headerlink" href="#roles" title="Lien vers cette rubrique">#</a></h3>
|
||||
<p>Les configurations FRR du lab vivent dans <code class="docutils literal notranslate"><span class="pre">test/e2e/topologies/frr/</span></code>, une par nœud, <strong>écrites à la main</strong> :
|
||||
ce sont les mêmes fichiers que la documentation de déploiement inclut, pour que le lab qualifie
|
||||
exactement ce qu’elle prescrit. Celles des hyperviseurs se réduisent à <code class="docutils literal notranslate"><span class="pre">hostname</span></code> et <code class="docutils literal notranslate"><span class="pre">log</span></code> :
|
||||
la configuration BGP est posée par l’agent (section <code class="docutils literal notranslate"><span class="pre">bgp</span></code> de <code class="docutils literal notranslate"><span class="pre">agent.yml</span></code>). Celle du route
|
||||
reflector :</p>
|
||||
la configuration BGP est posée par l’agent (section <code class="docutils literal notranslate"><span class="pre">bgp</span></code> de <code class="docutils literal notranslate"><span class="pre">agent.yml</span></code>). Celle du premier
|
||||
route reflector (celle de <code class="docutils literal notranslate"><span class="pre">rr2</span></code> ne diffère que par son nom et sa loopback) :</p>
|
||||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>frr defaults traditional
|
||||
hostname rr1
|
||||
log syslog informational
|
||||
|
|
@ -699,7 +701,7 @@ correspondance sur #70).</p>
|
|||
<p>Les tests se lancent <strong>depuis le Mac</strong>, sur un lab démarré (<code class="docutils literal notranslate"><span class="pre">up</span></code>, <code class="docutils literal notranslate"><span class="pre">push</span></code>, <code class="docutils literal notranslate"><span class="pre">./labctl</span> <span class="pre">up</span></code>) :</p>
|
||||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>test/e2e/run.sh all # toute la suite, dans l'ordre
|
||||
test/e2e/run.sh 40 # une couche
|
||||
test/e2e/run.sh 41 43 # des tests, par numéro ou par nom
|
||||
test/e2e/run.sh 41 dhcp-two # des tests, par numéro à deux chiffres ou par nom exact
|
||||
test/e2e/run.sh --from 30 # à partir d'un numéro
|
||||
test/e2e/run.sh --continue all # sans s'arrêter sur une couche en échec
|
||||
test/e2e/run.sh --connus all # les échecs connus comptent comme des échecs
|
||||
|
|
@ -749,12 +751,12 @@ fait en fermant le ticket. Chaque ticket concerné liste ses marqueurs en commen
|
|||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">03-image</span></code></p></td>
|
||||
<td><p>hypothèses sur l’image de VM — outils (curl, python3), nom d’interface, effet réel de network-config, forme du compte verrouillé</p></td>
|
||||
<td><p>hv1</p></td>
|
||||
<td><p>#70</p></td>
|
||||
<td><p>#70, #73</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">11-validation</span></code></p></td>
|
||||
<td><p>validation de l’API — refus synchrones (400, 409, 422) des VPC, subnets et VM, sans trace en base</p></td>
|
||||
<td><p>hv1</p></td>
|
||||
<td><p>#41, #57, #33, #62</p></td>
|
||||
<td><p>#41, #57, #33, #62, #74</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">12-etats</span></code></p></td>
|
||||
<td><p>machine d’états — 409 pendant creating, suppression depuis error, dépendances VM → subnet → VPC, recréation sous le même nom</p></td>
|
||||
|
|
@ -787,7 +789,7 @@ fait en fermant le ticket. Chaque ticket concerné liste ses marqueurs en commen
|
|||
<td><p>#33, #62, #73</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">26-multi-disque</span></code></p></td>
|
||||
<td><p>VM à plusieurs disques — racine virtio (vda) et SCSI (xvdX), tailles et bus vus par la VM, liens <code class="docutils literal notranslate"><span class="pre">/dev/xvdX</span></code> et <code class="docutils literal notranslate"><span class="pre">by-id</span></code> par numéro de série, démarrage sur vda</p></td>
|
||||
<td><p>VM à plusieurs disques — racine virtio (vda) et SCSI (xvdX), tailles et bus vus par la VM, liens /dev/xvdX et by-id par numéro de série, démarrage sur vda</p></td>
|
||||
<td><p>hv1</p></td>
|
||||
<td><p>#32, #74</p></td>
|
||||
</tr>
|
||||
|
|
@ -797,7 +799,7 @@ fait en fermant le ticket. Chaque ticket concerné liste ses marqueurs en commen
|
|||
<td><p>#46</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">28-mtu</span></code></p></td>
|
||||
<td><p>MTU des VM (<code class="docutils literal notranslate"><span class="pre">network.mtu_vm</span></code>, 1500) — option DHCP 26 (serveur intégré et dnsmasq), <code class="docutils literal notranslate"><span class="pre">host_mtu</span></code> de QEMU, tap, bridge, veth et VXLAN du subnet ; subnet vxlan refusé sur un underlay qui n’est pas à 9000</p></td>
|
||||
<td><p>MTU des VM (network.mtu_vm, 1500 par défaut) — annoncé par le DHCP (option 26, serveur intégré sur hv1, dnsmasq sur hv2) et par QEMU (host_mtu), porté par le tap, le bridge, le veth et le VXLAN du subnet ; subnet vxlan refusé sur un underlay qui n’est pas à 9000</p></td>
|
||||
<td><p>hv1 hv2</p></td>
|
||||
<td><p>#56</p></td>
|
||||
</tr>
|
||||
|
|
@ -877,9 +879,9 @@ fait en fermant le ticket. Chaque ticket concerné liste ses marqueurs en commen
|
|||
<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>
|
||||
<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, le plus prioritaire redevient maître, seconde bascule mesurée</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</p></td>
|
||||
<td><p>#54, #69, #80</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
|
@ -896,7 +898,11 @@ tests ont été corrigées sur le serveur et les tests concernés rejoués. Il r
|
|||
(#73, #62), noms des disques SCSI (#74), mode <code class="docutils literal notranslate"><span class="pre">bridge</span></code> sur plusieurs hôtes (#75), filtrage au
|
||||
port (#76), socket DHCP (#77), fausse alerte du watchdog (#78) ;</p></li>
|
||||
<li><p>#69 vérifié : au retour de <code class="docutils literal notranslate"><span class="pre">sw1</span></code> (priorité 200), il redevient maître, seconde bascule en
|
||||
1,2 s, sessions EVPN jamais coupées ;</p></li>
|
||||
1,2 s, sessions EVPN jamais coupées. La préemption est pourtant <strong>désactivée</strong> dans la
|
||||
configuration (<code class="docutils literal notranslate"><span class="pre">no</span> <span class="pre">vrrp</span> <span class="pre">1</span> <span class="pre">preempt</span></code>, « Preempt Mode No » relevé le 2026-10-23) : la cause de ce
|
||||
retour, après coupure puis rétablissement de l’interface underlay du maître, <strong>n’est pas
|
||||
établie</strong>. <code class="docutils literal notranslate"><span class="pre">72-perte-switch</span></code> n’exige donc plus que le plus prioritaire redevienne maître : il
|
||||
vérifie qu’il n’y a qu’un maître, note lequel, et mesure le plus long silence après le retour ;</p></li>
|
||||
<li><p>une suppression de VM peut durer 300 s quand l’invité ignore l’arrêt ACPI (#79) : <code class="docutils literal notranslate"><span class="pre">wait_state</span></code>
|
||||
attend jusqu’à 360 s.</p></li>
|
||||
</ul>
|
||||
|
|
@ -922,16 +928,20 @@ gateway de son propre hôte. Une vérification entre hôtes passe par une VM.</p
|
|||
commence par un en-tête, puis envoie des blocs aux nœuds par <code class="docutils literal notranslate"><span class="pre">on</span> <span class="pre"><nœud></span> <span class="pre">[VAR=valeur…]</span> <span class="pre"><<'NODE'</span></code>.
|
||||
Chaque bloc est précédé des bibliothèques de <code class="docutils literal notranslate"><span class="pre">test/e2e/lib/</span></code> :</p>
|
||||
<ul class="simple">
|
||||
<li><p><code class="docutils literal notranslate"><span class="pre">core.sh</span></code> : <code class="docutils literal notranslate"><span class="pre">check</span></code>, <code class="docutils literal notranslate"><span class="pre">known</span></code>, <code class="docutils literal notranslate"><span class="pre">info</span></code>, appels à l’API, attente des états ;</p></li>
|
||||
<li><p><code class="docutils literal notranslate"><span class="pre">core.sh</span></code> : <code class="docutils literal notranslate"><span class="pre">check</span></code>, <code class="docutils literal notranslate"><span class="pre">known</span></code>, <code class="docutils literal notranslate"><span class="pre">known_flaky</span></code>, <code class="docutils literal notranslate"><span class="pre">info</span></code>, appels à l’API, attente des états ;</p></li>
|
||||
<li><p><code class="docutils literal notranslate"><span class="pre">vm.sh</span></code> : image Debian compatible two, clé SSH, <code class="docutils literal notranslate"><span class="pre">vm_launch</span></code> (plusieurs NIC et disques, UEFI,
|
||||
<code class="docutils literal notranslate"><span class="pre">user_data</span></code>, mot de passe), SSH, bail, métadonnées. La MAC de chaque NIC est fournie à l’API :
|
||||
<code class="docutils literal notranslate"><span class="pre">52:54:00</span></code> suivi des trois derniers octets de l’IP (<code class="docutils literal notranslate"><span class="pre">mac_for_ip</span></code>), unique dans la suite
|
||||
puisque chaque test a sa plage ; <code class="docutils literal notranslate"><span class="pre">--nic</span> <span class="pre">sn=ip=mac</span></code> en impose une autre ;</p></li>
|
||||
<li><p><code class="docutils literal notranslate"><span class="pre">net.sh</span></code> : VPC, subnets, MAC anycast, trames brutes, règles ebtables, VRRP ;</p></li>
|
||||
<li><p><code class="docutils literal notranslate"><span class="pre">evpn.sh</span></code> : VRF, BGP, L3VNI, watchdog ;</p></li>
|
||||
<li><p><code class="docutils literal notranslate"><span class="pre">fixture.sh</span></code> : nettoyage et <code class="docutils literal notranslate"><span class="pre">assert_clean</span></code>, appelés par le runner.</p></li>
|
||||
<li><p><code class="docutils literal notranslate"><span class="pre">fixture.sh</span></code> : nettoyage et <code class="docutils literal notranslate"><span class="pre">assert_clean</span></code>, appelés par le runner. Le nettoyage couvre les
|
||||
ressources <code class="docutils literal notranslate"><span class="pre">t<NN></span></code> de l’API, les netns <code class="docutils literal notranslate"><span class="pre">t<NN>-*</span></code> et les fichiers <code class="docutils literal notranslate"><span class="pre">t<NN>-*</span></code> / <code class="docutils literal notranslate"><span class="pre">t<NN>.*</span></code> de
|
||||
<code class="docutils literal notranslate"><span class="pre">/tmp</span></code> et <code class="docutils literal notranslate"><span class="pre">/var/tmp/e2e</span></code> (sauf l’état <code class="docutils literal notranslate"><span class="pre">t<NN>.avant</span></code>) ; il ne joue que pour un test dont
|
||||
l’en-tête « # hôtes: » est rempli. Un test sans aucune vérification propre, hors fixtures, est
|
||||
en échec.</p></li>
|
||||
</ul>
|
||||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="c1"># fonctionnalité: trafic entre deux VM d'un même subnet sur un hôte</span>
|
||||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="c1"># fonctionnalité: trafic entre deux VM d'un même subnet sur un hôte, isolation entre VPC</span>
|
||||
<span class="c1"># hôtes: hv1</span>
|
||||
<span class="c1"># tickets: #NN</span>
|
||||
|
||||
|
|
@ -943,7 +953,11 @@ on<span class="w"> </span>hv1<span class="w"> </span><span class="s"><<'NO
|
|||
<span class="s">check "VM t99-b" vm_launch t99-b --nic sn-t99=10.99.1.11 --sshkey "${KEY}"</span>
|
||||
<span class="s">check "t99-a joignable" vm_wait vp-t99 10.99.1.10</span>
|
||||
<span class="s">check "t99-a joint t99-b" vm_ssh vp-t99 10.99.1.10 'ping -c 2 -W 2 10.99.1.11'</span>
|
||||
<span class="s">check "t99-a ne joint pas 10.98.1.10" vm_fails vp-t99 10.99.1.10 'ping -c 2 -W 2 10.98.1.10'</span>
|
||||
<span class="s">check "VPC vp-t99b" vpc_create vp-t99b 10.99.0.0/16</span>
|
||||
<span class="s">check "subnet sn-t99b" subnet_create sn-t99b vp-t99b 9902 10.99.2.0/24</span>
|
||||
<span class="s">check "VM t99-c" vm_launch t99-c --nic sn-t99b=10.99.2.10 --sshkey "${KEY}"</span>
|
||||
<span class="s">check "t99-c joignable dans son VPC" vm_wait vp-t99b 10.99.2.10</span>
|
||||
<span class="s">check "t99-a ne joint pas t99-c (autre VPC)" vm_fails vp-t99 10.99.1.10 'ping -c 2 -W 2 10.99.2.10'</span>
|
||||
<span class="s">NODE</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
|
|
|
|||
|
|
@ -834,9 +834,10 @@ un état stable.</p>
|
|||
borne les opérations qui attendent une transition ; l’appelant doit avoir sa propre borne.</p></li>
|
||||
<li><p><strong>Traiter ``error`` comme terminal, pas comme un échec transitoire.</strong> Un <code class="docutils literal notranslate"><span class="pre">Execute</span></code> en échec
|
||||
ne se rejoue pas tout seul.</p></li>
|
||||
<li><p><strong>Ne pas enchaîner sans vérifier.</strong> Créer un subnet dont le VPC est encore en <code class="docutils literal notranslate"><span class="pre">creating</span></code>
|
||||
échoue en 422 ; démarrer une VM sur un subnet en <code class="docutils literal notranslate"><span class="pre">creating</span></code> ou <code class="docutils literal notranslate"><span class="pre">running</span></code> est en revanche
|
||||
accepté.</p></li>
|
||||
<li><p><strong>Savoir ce qui s’enchaîne.</strong> Créer un subnet dont le VPC est encore en <code class="docutils literal notranslate"><span class="pre">creating</span></code>, ou
|
||||
démarrer une VM sur un subnet en <code class="docutils literal notranslate"><span class="pre">creating</span></code>, est accepté : l”<code class="docutils literal notranslate"><span class="pre">Execute</span></code> attend que le parent
|
||||
passe <code class="docutils literal notranslate"><span class="pre">running</span></code>, dans la limite de <code class="docutils literal notranslate"><span class="pre">dispatcher.timeout_seconds</span></code> ; au-delà, la ressource passe
|
||||
en <code class="docutils literal notranslate"><span class="pre">error</span></code>. Le refus en 422 ne vaut que pour un parent absent, en <code class="docutils literal notranslate"><span class="pre">error</span></code> ou en <code class="docutils literal notranslate"><span class="pre">deleting</span></code>.</p></li>
|
||||
</ul>
|
||||
</section>
|
||||
<section id="codes-de-retour">
|
||||
|
|
@ -859,20 +860,29 @@ accepté.</p></li>
|
|||
<td><p>lecture réussie (<code class="docutils literal notranslate"><span class="pre">GET</span></code>)</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">400</span></code></p></td>
|
||||
<td><p>champ obligatoire manquant, corps invalide, <code class="docutils literal notranslate"><span class="pre">iface_type</span></code> inconnu, base64 invalide</p></td>
|
||||
<td><p>champ obligatoire manquant, corps invalide, base64 invalide ; CIDR de VPC invalide,
|
||||
<code class="docutils literal notranslate"><span class="pre">l3vni</span></code> hors plage ; <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> absent (<code class="docutils literal notranslate"><span class="pre">bridge</span></code>, <code class="docutils literal notranslate"><span class="pre">public_ip</span></code>) ou fourni
|
||||
(<code class="docutils literal notranslate"><span class="pre">vxlan</span></code>) ; interface de VM sans <code class="docutils literal notranslate"><span class="pre">mac</span></code>, nombre d’interfaces <code class="docutils literal notranslate"><span class="pre">primary</span></code> différent de 1</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">404</span></code></p></td>
|
||||
<td><p>ressource inexistante</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">409</span></code></p></td>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">405</span></code></p></td>
|
||||
<td><p>méthode non prise en charge ; corps <code class="docutils literal notranslate"><span class="pre">{"error":</span> <span class="pre">"method</span> <span class="pre">not</span> <span class="pre">allowed"}</span></code>, mais servi en
|
||||
<code class="docutils literal notranslate"><span class="pre">text/plain</span></code> par <code class="docutils literal notranslate"><span class="pre">/vpcs</span></code> et <code class="docutils literal notranslate"><span class="pre">/subnets</span></code> (et leurs <code class="docutils literal notranslate"><span class="pre">/{name}</span></code>), en JSON par <code class="docutils literal notranslate"><span class="pre">/vms</span></code></p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">409</span></code></p></td>
|
||||
<td><p>conflit d’existence ou d’état : ressource déjà créée, ou suppression depuis un état qui
|
||||
ne l’autorise pas ; pour un VPC, subnets encore présents ; pour un subnet, VM non
|
||||
supprimées qui l’utilisent encore</p></td>
|
||||
ne l’autorise pas ; pour un VPC, subnets encore présents, <code class="docutils literal notranslate"><span class="pre">l3vni</span></code> déjà utilisée par un
|
||||
autre VPC, ou <code class="docutils literal notranslate"><span class="pre">l3vni</span></code> demandée sans section <code class="docutils literal notranslate"><span class="pre">bgp</span></code> ; pour un subnet, VM non supprimées
|
||||
qui l’utilisent encore</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">422</span></code></p></td>
|
||||
<td><p>dépendance absente ou pas prête : VPC parent d’un subnet, subnet d’une VM</p></td>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">422</span></code></p></td>
|
||||
<td><p>dépendance absente ou inutilisable : VPC parent d’un subnet, subnet d’une VM, absent, en
|
||||
<code class="docutils literal notranslate"><span class="pre">error</span></code> ou en <code class="docutils literal notranslate"><span class="pre">deleting</span></code> ; <code class="docutils literal notranslate"><span class="pre">mode</span></code> de subnet inconnu ; CIDR <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> invalide ou plus
|
||||
petit que <code class="docutils literal notranslate"><span class="pre">/29</span></code> ; IP de VM hors du CIDR du subnet ou réservée</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">500</span></code></p></td>
|
||||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">500</span></code></p></td>
|
||||
<td><p>erreur interne</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
|
|
|
|||
|
|
@ -425,7 +425,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/400">400 Bad Request</a></span> – <p>Missing required field, invalid request body, or l3vni out of range</p>
|
||||
<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, invalid CIDR, or l3vni out of range</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>
|
||||
|
|
|
|||
|
|
@ -521,7 +521,7 @@ rechargée est perdue au prochain démarrage de l’agent.</p>
|
|||
<span class="nt">qemu</span><span class="p">:</span>
|
||||
<span class="w"> </span><span class="nt">ovmf_code_path</span><span class="p">:</span><span class="w"> </span><span class="s">"/usr/share/OVMF/OVMF_CODE.fd"</span>
|
||||
<span class="w"> </span><span class="nt">ovmf_vars_template</span><span class="p">:</span><span class="w"> </span><span class="s">"/usr/share/OVMF/OVMF_VARS.fd"</span>
|
||||
<span class="w"> </span><span class="nt">uefi_vars_dir</span><span class="p">:</span><span class="w"> </span><span class="s">"/run/two/vms/efi"</span>
|
||||
<span class="w"> </span><span class="nt">uefi_vars_dir</span><span class="p">:</span><span class="w"> </span><span class="s">"/run/two/vms/uefi"</span>
|
||||
<span class="w"> </span><span class="nt">serial_dir</span><span class="p">:</span><span class="w"> </span><span class="s">"/run/two/vms/serial"</span>
|
||||
<span class="w"> </span><span class="nt">monitor_dir</span><span class="p">:</span><span class="w"> </span><span class="s">"/run/two/vms/monitor"</span>
|
||||
<span class="w"> </span><span class="nt">qmp_dir</span><span class="p">:</span><span class="w"> </span><span class="s">"/run/two/vms/qmp"</span>
|
||||
|
|
@ -606,7 +606,8 @@ l’autre.</p>
|
|||
<span class="w"> </span><span class="nt">interval_seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">60</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>Vérification périodique <strong>en lecture seule</strong> — voir <a class="reference internal" href="observabilite.html"><span class="doc">Observabilité</span></a>.</p>
|
||||
<p>Vérification périodique <strong>en lecture seule</strong> — voir <a class="reference internal" href="observabilite.html"><span class="doc">Observabilité</span></a>.
|
||||
<strong>Désactivée par défaut</strong> (<code class="docutils literal notranslate"><span class="pre">enabled:</span> <span class="pre">false</span></code>) : sans cette section, aucun contrôle ne tourne.</p>
|
||||
</section>
|
||||
<section id="journalisation">
|
||||
<h2>Journalisation<a class="headerlink" href="#journalisation" title="Lien vers cette rubrique">#</a></h2>
|
||||
|
|
|
|||
|
|
@ -401,7 +401,7 @@ journalctl<span class="w"> </span>-u<span class="w"> </span><span class="s1">'dh
|
|||
|
||||
<span class="c1"># Ce qu'il enverrait à une MAC donnée, sans effet de bord</span>
|
||||
<span class="nb">echo</span><span class="w"> </span><span class="s1">'{"verb":"probe","mac":"00:22:33:00:00:0A"}'</span><span class="w"> </span><span class="se">\</span>
|
||||
<span class="w"> </span><span class="p">|</span><span class="w"> </span>socat<span class="w"> </span>-<span class="w"> </span>UNIX-CONNECT:/run/two/dhcp/<netns>_<bridge>.sock<span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>.lease
|
||||
<span class="w"> </span><span class="p">|</span><span class="w"> </span>socat<span class="w"> </span>-<span class="w"> </span>UNIX-CONNECT:/run/two/dhcp/<netns>_<bridge>.sock<span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span><span class="s1">'{served, lease}'</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<p><code class="docutils literal notranslate"><span class="pre">probe</span></code> est le point de départ le plus rapide : il montre l’adresse, le masque, le routeur, les
|
||||
|
|
@ -454,9 +454,11 @@ user-data. Vérification dans le guest :</p>
|
|||
ls<span class="w"> </span>/var/lib/cloud/instances/
|
||||
</pre></div>
|
||||
</div>
|
||||
<p><strong>2. Le serveur de metadata est injoignable.</strong> Depuis le guest :</p>
|
||||
<p><strong>2. Le serveur de metadata est injoignable.</strong> Depuis le guest — le serveur ne sert que
|
||||
<code class="docutils literal notranslate"><span class="pre">/meta-data</span></code>, <code class="docutils literal notranslate"><span class="pre">/user-data</span></code>, <code class="docutils literal notranslate"><span class="pre">/network-config</span></code> et <code class="docutils literal notranslate"><span class="pre">/vendor-data</span></code>, tout autre chemin
|
||||
renvoie 404 :</p>
|
||||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>ip<span class="w"> </span>route
|
||||
curl<span class="w"> </span>-s<span class="w"> </span>http://169.254.169.254/latest/meta-data/
|
||||
curl<span class="w"> </span>-s<span class="w"> </span>http://169.254.169.254/meta-data
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>La route <code class="docutils literal notranslate"><span class="pre">169.254.169.254/32</span></code> doit être présente, avec l”<code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> du subnet comme
|
||||
|
|
@ -471,8 +473,9 @@ ls<span class="w"> </span>-l<span class="w"> </span>/run/two/metadata/<vm>
|
|||
</section>
|
||||
<section id="le-user-data-est-servi-vide">
|
||||
<h2>Le user-data est servi vide<a class="headerlink" href="#le-user-data-est-servi-vide" title="Lien vers cette rubrique">#</a></h2>
|
||||
<p>Un document fourni explicitement vide est servi vide — ce n’est pas la même chose qu’un document
|
||||
absent, qui retombe sur le template. Vérifier le contenu réellement écrit :</p>
|
||||
<p>C’est le comportement attendu quand <code class="docutils literal notranslate"><span class="pre">user_data</span></code> est absent ou vide à la création : les deux cas
|
||||
sont équivalents, et aucun template ne prend le relais pour <code class="docutils literal notranslate"><span class="pre">user-data</span></code>. Vérifier le contenu
|
||||
réellement écrit :</p>
|
||||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>cat<span class="w"> </span>/run/two/metadata/<vm>/user-data
|
||||
</pre></div>
|
||||
</div>
|
||||
|
|
@ -482,7 +485,7 @@ absent, qui retombe sur le template. Vérifier le contenu réellement écrit :</
|
|||
<h2>La VM ne démarre pas (UEFI)<a class="headerlink" href="#la-vm-ne-demarre-pas-uefi" title="Lien vers cette rubrique">#</a></h2>
|
||||
<p><code class="docutils literal notranslate"><span class="pre">uefi:</span> <span class="pre">true</span></code> exige les fichiers OVMF déclarés dans la configuration :</p>
|
||||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>ls<span class="w"> </span>-l<span class="w"> </span>/usr/share/OVMF/OVMF_CODE.fd<span class="w"> </span>/usr/share/OVMF/OVMF_VARS.fd
|
||||
ls<span class="w"> </span>-l<span class="w"> </span>/run/two/vms/efi/
|
||||
ls<span class="w"> </span>-l<span class="w"> </span>/run/two/vms/uefi/
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>Sur Debian et Ubuntu, le paquet est <code class="docutils literal notranslate"><span class="pre">ovmf</span></code>.</p>
|
||||
|
|
|
|||
|
|
@ -392,7 +392,8 @@ ou <code class="docutils literal notranslate"><span class="pre">deleting</span><
|
|||
<section id="watchdog">
|
||||
<h2>Watchdog<a class="headerlink" href="#watchdog" title="Lien vers cette rubrique">#</a></h2>
|
||||
<p>Une goroutine périodique vérifie que les ressources marquées <code class="docutils literal notranslate"><span class="pre">running</span></code> en base existent
|
||||
toujours sur le système, et <strong>notifie les écarts sans jamais réparer</strong>.</p>
|
||||
toujours sur le système, et <strong>notifie les écarts sans jamais réparer</strong>. Il est <strong>désactivé par
|
||||
défaut</strong> (<code class="docutils literal notranslate"><span class="pre">enabled:</span> <span class="pre">false</span></code>) ; l’activer explicitement :</p>
|
||||
<div class="highlight-yaml notranslate"><div class="highlight"><pre><span></span><span class="nt">watchdog</span><span class="p">:</span>
|
||||
<span class="w"> </span><span class="nt">enabled</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
|
||||
<span class="w"> </span><span class="nt">interval_seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">60</span>
|
||||
|
|
@ -429,15 +430,18 @@ subsiste jusqu’à une action explicite (<code class="docutils literal notransl
|
|||
<code class="docutils literal notranslate"><span class="pre">logger.debug:</span> <span class="pre">true</span></code> forçant <code class="docutils literal notranslate"><span class="pre">debug</span></code>.</p>
|
||||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>journalctl<span class="w"> </span>-u<span class="w"> </span>agent<span class="w"> </span>-f
|
||||
journalctl<span class="w"> </span>-u<span class="w"> </span><span class="s1">'metadata@i-web'</span><span class="w"> </span>-n<span class="w"> </span><span class="m">50</span>
|
||||
tail<span class="w"> </span>-f<span class="w"> </span>/var/log/dnsmasq-vp-admin_br-sn000001.log<span class="w"> </span><span class="c1"># backend dnsmasq</span>
|
||||
journalctl<span class="w"> </span>-fu<span class="w"> </span><span class="s1">'dhcp@vp-admin_br-sn000001'</span><span class="w"> </span><span class="c1"># backend two</span>
|
||||
tail<span class="w"> </span>-f<span class="w"> </span>/var/log/dnsmasq-vp-admin_br-000001.log<span class="w"> </span><span class="c1"># backend dnsmasq</span>
|
||||
journalctl<span class="w"> </span>-fu<span class="w"> </span><span class="s1">'dhcp@vp-admin_br-000001'</span><span class="w"> </span><span class="c1"># backend two</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</section>
|
||||
<section id="inspection-de-la-base">
|
||||
<h2>Inspection de la base<a class="headerlink" href="#inspection-de-la-base" title="Lien vers cette rubrique">#</a></h2>
|
||||
<p>En ligne de commande, sur l’host :</p>
|
||||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>/opt/two/bin/db<span class="w"> </span>-conf<span class="w"> </span>/etc/two/agent.yml
|
||||
<p>En ligne de commande, sur l’host. Le binaire <code class="docutils literal notranslate"><span class="pre">db</span></code> n’est <strong>ni publié dans les releases ni
|
||||
déployé</strong> par <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code> : il se compile depuis les sources, puis se copie sur l’host. Sans
|
||||
sous-commande, il n’affiche que son usage ; <code class="docutils literal notranslate"><span class="pre">print</span></code> liste toute la base :</p>
|
||||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nv">CGO_ENABLED</span><span class="o">=</span><span class="m">0</span><span class="w"> </span><span class="nv">GOOS</span><span class="o">=</span>linux<span class="w"> </span><span class="nv">GOARCH</span><span class="o">=</span>amd64<span class="w"> </span>go<span class="w"> </span>build<span class="w"> </span>-o<span class="w"> </span>db<span class="w"> </span>./cmd/db
|
||||
./db<span class="w"> </span>-conf<span class="w"> </span>/etc/two/agent.yml<span class="w"> </span>print
|
||||
</pre></div>
|
||||
</div>
|
||||
<div class="admonition warning">
|
||||
|
|
|
|||
|
|
@ -361,7 +361,8 @@
|
|||
|
||||
<section id="services-systemd">
|
||||
<h1>Services systemd<a class="headerlink" href="#services-systemd" title="Lien vers cette rubrique">#</a></h1>
|
||||
<p>Quatre units, installées sous <code class="docutils literal notranslate"><span class="pre">/opt/two/bin</span></code> par <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code>. Les deux units DHCP
|
||||
<p>Quatre units, installées dans <code class="docutils literal notranslate"><span class="pre">/etc/systemd/system</span></code> par <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code> ; les binaires et scripts
|
||||
qu’elles lancent sont sous <code class="docutils literal notranslate"><span class="pre">/opt/two/bin</span></code>. Les deux units DHCP
|
||||
s’excluent : celle qui tourne dépend de <code class="docutils literal notranslate"><span class="pre">dhcp.backend</span></code> (voir <a class="reference internal" href="configuration.html"><span class="doc">Configuration</span></a>).</p>
|
||||
<div class="pst-scrollable-table-container"><table class="table">
|
||||
<colgroup>
|
||||
|
|
@ -398,8 +399,8 @@ s’excluent : celle qui tourne dépend de <code class="docutils literal notrans
|
|||
<p>Les instances sont créées et pilotées par l’agent au fil des créations de subnets et de VM : il
|
||||
n’y a pas à les démarrer à la main en fonctionnement normal.</p>
|
||||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>systemctl<span class="w"> </span>status<span class="w"> </span>agent
|
||||
systemctl<span class="w"> </span>status<span class="w"> </span><span class="s1">'dnsmasq@vp-admin_br-sn000001'</span><span class="w"> </span><span class="c1"># backend dnsmasq</span>
|
||||
systemctl<span class="w"> </span>status<span class="w"> </span><span class="s1">'dhcp@vp-admin_br-sn000001'</span><span class="w"> </span><span class="c1"># backend two</span>
|
||||
systemctl<span class="w"> </span>status<span class="w"> </span><span class="s1">'dnsmasq@vp-admin_br-000001'</span><span class="w"> </span><span class="c1"># backend dnsmasq</span>
|
||||
systemctl<span class="w"> </span>status<span class="w"> </span><span class="s1">'dhcp@vp-admin_br-000001'</span><span class="w"> </span><span class="c1"># backend two</span>
|
||||
systemctl<span class="w"> </span>status<span class="w"> </span><span class="s1">'metadata@i-web'</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
|
|
@ -437,9 +438,9 @@ pas d’adresse.</p>
|
|||
<code class="docutils literal notranslate"><span class="pre">dhcp</span></code>, à qui il passe le bridge à servir et ses deux chemins de fichiers — il ne déduit rien et
|
||||
ignore le netns dans lequel il tourne :</p>
|
||||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>/opt/two/bin/dhcp<span class="w"> </span>-conf<span class="w"> </span>/etc/two/agent.yml<span class="w"> </span><span class="se">\</span>
|
||||
<span class="w"> </span>-interface<span class="w"> </span>br-sn000001<span class="w"> </span><span class="se">\</span>
|
||||
<span class="w"> </span>-state<span class="w"> </span>/run/two/dhcp/vp-admin_br-sn000001.state<span class="w"> </span><span class="se">\</span>
|
||||
<span class="w"> </span>-socket<span class="w"> </span>/run/two/dhcp/vp-admin_br-sn000001.sock
|
||||
<span class="w"> </span>-interface<span class="w"> </span>br-000001<span class="w"> </span><span class="se">\</span>
|
||||
<span class="w"> </span>-state<span class="w"> </span>/run/two/dhcp/vp-admin_br-000001.state<span class="w"> </span><span class="se">\</span>
|
||||
<span class="w"> </span>-socket<span class="w"> </span>/run/two/dhcp/vp-admin_br-000001.sock
|
||||
</pre></div>
|
||||
</div>
|
||||
<div class="pst-scrollable-table-container"><table class="table">
|
||||
|
|
|
|||
|
|
@ -497,6 +497,9 @@ subnet, ce qui évite un trou noir partiel mesuré en lab</p></li>
|
|||
<li><p><strong>Un fichier de configuration présent mais invalide fait désormais échouer le démarrage.</strong>
|
||||
Jusqu’en 0.1.0 l’erreur de lecture était ignorée : l’agent tournait alors entièrement sur ses
|
||||
valeurs par défaut sans le dire, ce qui rendait indétectable une simple tabulation d’indentation</p></li>
|
||||
<li><p><strong>Réponses de l’API des subnets alignées sur la spécification</strong> : <code class="docutils literal notranslate"><span class="pre">gateway</span></code> est rendu aussi par
|
||||
<code class="docutils literal notranslate"><span class="pre">GET</span> <span class="pre">/subnets</span></code> et par la réponse 202 de <code class="docutils literal notranslate"><span class="pre">POST</span> <span class="pre">/subnets</span></code>, plus seulement par
|
||||
<code class="docutils literal notranslate"><span class="pre">GET</span> <span class="pre">/subnets/{name}</span></code> ; <code class="docutils literal notranslate"><span class="pre">vxlan_id</span></code> est omis hors mode <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> au lieu de valoir 0 (#80)</p></li>
|
||||
<li><p><code class="docutils literal notranslate"><span class="pre">probe</span></code> annonce explicitement <code class="docutils literal notranslate"><span class="pre">"served":</span> <span class="pre">false</span></code> pour une MAC non réservée, au lieu d’omettre le
|
||||
champ et de le rendre indistinguable d’une réponse tronquée</p></li>
|
||||
<li><p><strong>Le serveur DHCP intégré s’arrête proprement</strong> sur <code class="docutils literal notranslate"><span class="pre">SIGTERM</span></code> et <code class="docutils literal notranslate"><span class="pre">SIGINT</span></code> : il ferme sa socket de
|
||||
|
|
|
|||