This commit is contained in:
forgejo-actions 2026-10-24 14:45:23 +00:00
commit b20e16ee62
28 changed files with 289 additions and 180 deletions

View file

@ -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> <style>
.lbl { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 14px; fill: #e6edf3; } .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; } .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="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="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="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)"/> <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="72" text-anchor="middle">eBGP · BFD</text>
<text class="ctrlt" x="560" y="98" text-anchor="middle">loopbacks seules</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"/> <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="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> <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"/> <rect class="box" x="60" y="510" width="180" height="66" rx="6"/>
<text class="lbl" x="150.0" y="535.0" text-anchor="middle">vxlan-&lt;vni&gt;</text> <text class="lbl" x="150.0" y="532.0" text-anchor="middle">br-&lt;subnet&gt; de l'hôte</text>
<text class="sub" x="150.0" y="552.0" text-anchor="middle">dans br-&lt;subnet&gt;, sans learning</text> <text class="sub" x="150.0" y="549.0" text-anchor="middle">vxlan-&lt;vni&gt;, sans learning</text>
<text class="sub" x="150.0" y="564.0" text-anchor="middle">veth v-&lt;id&gt;-e</text>
<text class="sub" x="150" y="596" text-anchor="middle">veth v-&lt;id&gt;-e ↔ v-&lt;id&gt;-i</text>
<rect class="group" x="270" y="280" width="290" height="300" rx="8"/> <rect class="group" x="270" y="280" width="290" height="300" rx="8"/>
<text class="grp" x="290" y="304">NETNS DU VPC</text> <text class="grp" x="290" y="304">NETNS DU VPC</text>
<rect class="box" x="285" y="312" width="125" height="66" rx="6"/> <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="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> <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"/> <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-&lt;subnet&gt;</text> <text class="lbl" x="415.0" y="423.0" text-anchor="middle">br-&lt;subnet&gt; du netns</text>
<text class="sub" x="415.0" y="440.0" text-anchor="middle">adresse d'émission .253</text> <text class="sub" x="415.0" y="440.0" text-anchor="middle">adresse d'émission .253 · v-&lt;id&gt;-i</text>
<rect class="box" x="285" y="478" width="260" height="52" rx="6"/> <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="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> <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"/> <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="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> <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"/> <rect class="box" x="640" y="510" width="180" height="66" rx="6"/>
<text class="lbl" x="730.0" y="535.0" text-anchor="middle">vxlan-&lt;vni&gt;</text> <text class="lbl" x="730.0" y="532.0" text-anchor="middle">br-&lt;subnet&gt; de l'hôte</text>
<text class="sub" x="730.0" y="552.0" text-anchor="middle">dans br-&lt;subnet&gt;, sans learning</text> <text class="sub" x="730.0" y="549.0" text-anchor="middle">vxlan-&lt;vni&gt;, sans learning</text>
<text class="sub" x="730.0" y="564.0" text-anchor="middle">veth v-&lt;id&gt;-e</text>
<text class="sub" x="730" y="596" text-anchor="middle">veth v-&lt;id&gt;-e ↔ v-&lt;id&gt;-i</text>
<rect class="group" x="850" y="280" width="290" height="300" rx="8"/> <rect class="group" x="850" y="280" width="290" height="300" rx="8"/>
<text class="grp" x="870" y="304">NETNS DU VPC</text> <text class="grp" x="870" y="304">NETNS DU VPC</text>
<rect class="box" x="865" y="312" width="125" height="66" rx="6"/> <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="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> <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"/> <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-&lt;subnet&gt;</text> <text class="lbl" x="995.0" y="423.0" text-anchor="middle">br-&lt;subnet&gt; du netns</text>
<text class="sub" x="995.0" y="440.0" text-anchor="middle">adresse d'émission .253</text> <text class="sub" x="995.0" y="440.0" text-anchor="middle">adresse d'émission .253 · v-&lt;id&gt;-i</text>
<rect class="box" x="865" y="478" width="260" height="52" rx="6"/> <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="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> <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

Before After
Before After

View file

@ -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> <style>
.lbl { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 14px; fill: #1f2328; } .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; } .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="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="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="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)"/> <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="72" text-anchor="middle">eBGP · BFD</text>
<text class="ctrlt" x="560" y="98" text-anchor="middle">loopbacks seules</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"/> <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="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> <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"/> <rect class="box" x="60" y="510" width="180" height="66" rx="6"/>
<text class="lbl" x="150.0" y="535.0" text-anchor="middle">vxlan-&lt;vni&gt;</text> <text class="lbl" x="150.0" y="532.0" text-anchor="middle">br-&lt;subnet&gt; de l'hôte</text>
<text class="sub" x="150.0" y="552.0" text-anchor="middle">dans br-&lt;subnet&gt;, sans learning</text> <text class="sub" x="150.0" y="549.0" text-anchor="middle">vxlan-&lt;vni&gt;, sans learning</text>
<text class="sub" x="150.0" y="564.0" text-anchor="middle">veth v-&lt;id&gt;-e</text>
<text class="sub" x="150" y="596" text-anchor="middle">veth v-&lt;id&gt;-e ↔ v-&lt;id&gt;-i</text>
<rect class="group" x="270" y="280" width="290" height="300" rx="8"/> <rect class="group" x="270" y="280" width="290" height="300" rx="8"/>
<text class="grp" x="290" y="304">NETNS DU VPC</text> <text class="grp" x="290" y="304">NETNS DU VPC</text>
<rect class="box" x="285" y="312" width="125" height="66" rx="6"/> <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="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> <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"/> <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-&lt;subnet&gt;</text> <text class="lbl" x="415.0" y="423.0" text-anchor="middle">br-&lt;subnet&gt; du netns</text>
<text class="sub" x="415.0" y="440.0" text-anchor="middle">adresse d'émission .253</text> <text class="sub" x="415.0" y="440.0" text-anchor="middle">adresse d'émission .253 · v-&lt;id&gt;-i</text>
<rect class="box" x="285" y="478" width="260" height="52" rx="6"/> <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="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> <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"/> <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="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> <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"/> <rect class="box" x="640" y="510" width="180" height="66" rx="6"/>
<text class="lbl" x="730.0" y="535.0" text-anchor="middle">vxlan-&lt;vni&gt;</text> <text class="lbl" x="730.0" y="532.0" text-anchor="middle">br-&lt;subnet&gt; de l'hôte</text>
<text class="sub" x="730.0" y="552.0" text-anchor="middle">dans br-&lt;subnet&gt;, sans learning</text> <text class="sub" x="730.0" y="549.0" text-anchor="middle">vxlan-&lt;vni&gt;, sans learning</text>
<text class="sub" x="730.0" y="564.0" text-anchor="middle">veth v-&lt;id&gt;-e</text>
<text class="sub" x="730" y="596" text-anchor="middle">veth v-&lt;id&gt;-e ↔ v-&lt;id&gt;-i</text>
<rect class="group" x="850" y="280" width="290" height="300" rx="8"/> <rect class="group" x="850" y="280" width="290" height="300" rx="8"/>
<text class="grp" x="870" y="304">NETNS DU VPC</text> <text class="grp" x="870" y="304">NETNS DU VPC</text>
<rect class="box" x="865" y="312" width="125" height="66" rx="6"/> <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="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> <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"/> <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-&lt;subnet&gt;</text> <text class="lbl" x="995.0" y="423.0" text-anchor="middle">br-&lt;subnet&gt; du netns</text>
<text class="sub" x="995.0" y="440.0" text-anchor="middle">adresse d'émission .253</text> <text class="sub" x="995.0" y="440.0" text-anchor="middle">adresse d'émission .253 · v-&lt;id&gt;-i</text>
<rect class="box" x="865" y="478" width="260" height="52" rx="6"/> <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="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> <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

Before After
Before After

View file

@ -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> <style>
.lbl { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 14px; fill: #e6edf3; } .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; } .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"/> <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="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="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> <path class="net" d="M1180 64 H900" marker-end="url(#a-net)"/>
<text class="nett" x="1164" y="166" text-anchor="end">par Internet et les bordures (VNI 66001)</text> <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"/> <rect class="group" x="40" y="280" width="480" height="130" rx="8"/>
<text class="grp" x="60" y="304">CLUSTER A</text> <text class="grp" x="60" y="304">CLUSTER A</text>
<rect class="box" x="60" y="312" width="210" height="56" rx="6"/> <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="link" d="M300 635 V460"/>
<path class="orch" d="M320 785 H332 V410" marker-end="url(#a-orch)"/> <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> <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"/> <path class="data" d="M60 1045 H110"/>
<text class="sub" x="118" y="1049" text-anchor="start">plan de données : VXLAN</text> <text class="sub" x="118" y="1049" text-anchor="start">plan de données : VXLAN</text>
<path class="ctrl" d="M290 1045 H340"/> <path class="ctrl" d="M290 1045 H340"/>
@ -184,10 +186,10 @@
<text class="sub" x="748" y="1049" text-anchor="start">trafic Internet</text> <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"/> <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="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="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="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="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="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> </svg>

Before

Width:  |  Height:  |  Size: 16 KiB

After

Width:  |  Height:  |  Size: 16 KiB

Before After
Before After

View file

@ -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> <style>
.lbl { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 14px; fill: #1f2328; } .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; } .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"/> <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="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="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> <path class="net" d="M1180 64 H900" marker-end="url(#a-net)"/>
<text class="nett" x="1164" y="166" text-anchor="end">par Internet et les bordures (VNI 66001)</text> <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"/> <rect class="group" x="40" y="280" width="480" height="130" rx="8"/>
<text class="grp" x="60" y="304">CLUSTER A</text> <text class="grp" x="60" y="304">CLUSTER A</text>
<rect class="box" x="60" y="312" width="210" height="56" rx="6"/> <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="link" d="M300 635 V460"/>
<path class="orch" d="M320 785 H332 V410" marker-end="url(#a-orch)"/> <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> <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"/> <path class="data" d="M60 1045 H110"/>
<text class="sub" x="118" y="1049" text-anchor="start">plan de données : VXLAN</text> <text class="sub" x="118" y="1049" text-anchor="start">plan de données : VXLAN</text>
<path class="ctrl" d="M290 1045 H340"/> <path class="ctrl" d="M290 1045 H340"/>
@ -184,10 +186,10 @@
<text class="sub" x="748" y="1049" text-anchor="start">trafic Internet</text> <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"/> <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="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="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="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="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="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> </svg>

Before

Width:  |  Height:  |  Size: 16 KiB

After

Width:  |  Height:  |  Size: 16 KiB

Before After
Before After

View file

@ -363,11 +363,6 @@
<h1>Invariants et pièges<a class="headerlink" href="#invariants-et-pieges" title="Lien vers cette rubrique">#</a></h1> <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 <p>Contraintes découvertes en production ou en corrigeant des bugs. Les enfreindre casse quelque
chose qui fonctionne, souvent en silence.</p> 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"> <section id="reseau">
<h2>Réseau<a class="headerlink" href="#reseau" title="Lien vers cette rubrique">#</a></h2> <h2>Réseau<a class="headerlink" href="#reseau" title="Lien vers cette rubrique">#</a></h2>
<ul class="simple"> <ul class="simple">

View file

@ -347,8 +347,7 @@
<section id="architecture"> <section id="architecture">
<h1>Architecture<a class="headerlink" href="#architecture" title="Lien vers cette rubrique">#</a></h1> <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 <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, enfreindre. Ces pages s’adressent à qui modifie le code.</p>
reste la référence de développement et fait foi en cas d’écart.</p>
<div class="toctree-wrapper compound"> <div class="toctree-wrapper compound">
<ul> <ul>
<li class="toctree-l1"><a class="reference internal" href="vue-densemble.html">Vue d’ensemble</a></li> <li class="toctree-l1"><a class="reference internal" href="vue-densemble.html">Vue d’ensemble</a></li>

View file

@ -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> <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> <td><p>plan d’adressage ip → mac, et configurations dnsmasq du backend historique</p></td>
</tr> </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> <td><p>serveur de metadata cloud-init et ses templates</p></td>
</tr> </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> <td><p>vérification périodique en lecture seule</p></td>
</tr> </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> <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> <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> </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> <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> <td><p>wrapper Badger ; toutes les valeurs sont des chaînes plates</p></td>
</tr> </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> <td><p>pool de goroutines sur canal</p></td>
</tr> </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> <td><p>client D-Bus systemd</p></td>
</tr> </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> <td><p>journalisation <code class="docutils literal notranslate"><span class="pre">slog</span></code> et serveur de métriques</p></td>
</tr> </tr>
</tbody> </tbody>

View file

@ -801,7 +801,6 @@ window.runMermaid = runMermaid;</script>
creating --&gt; running creating --&gt; running
creating --&gt; error creating --&gt; error
running --&gt; deleting running --&gt; deleting
running --&gt; error
deleting --&gt; deleted deleting --&gt; deleted
deleting --&gt; error deleting --&gt; error
error --&gt; deleting error --&gt; deleting
@ -824,7 +823,9 @@ window.runMermaid = runMermaid;</script>
<td><p>la ressource existe sur le système</p></td> <td><p>la ressource existe sur le système</p></td>
</tr> </tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">error</span></code></p></td> <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>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">deleting</span></code></p></td> <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> <td><p>suppression en cours</p></td>

View file

@ -811,14 +811,14 @@ deux processus ne doivent pas partager une même instance.</p>
</section> </section>
<section id="documents-servis"> <section id="documents-servis">
<h2>Documents servis<a class="headerlink" href="#documents-servis" title="Lien vers cette rubrique">#</a></h2> <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"> <ul class="simple">
<li><p>fourni par l’appelant → servi <strong>verbatim</strong>, l’agent n’interprète rien ;</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>absent → le template par défaut est rendu ;</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>
<li><p>fourni <strong>vide</strong> → servi vide.</p></li>
</ul> </ul>
<p>Les deux derniers cas sont distincts, et c’est délibéré : fournir une chaîne vide est une façon <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
explicite de neutraliser un document.</p> 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>
<section id="champs-de-metadata"> <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> <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 <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> 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 <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 démarrage suivant l’étape locale réapplique le repli. L’étape réseau, qui trouve la
relu : les interfaces secondaires perdent leur configuration.</p></li> 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> </ul>
<p>L’image doit donc faire du DHCP IPv4 sur <strong>toutes</strong> ses interfaces Ethernet, sans compter <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> </div>
</section> </section>
<section id="securite"> <section id="securite">

View file

@ -950,11 +950,12 @@ netns relève de #61.</p>
<section id="routes-annoncees-aux-vm"> <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> <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, <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"> <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 <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 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>.</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> </ol>
<div class="admonition important"> <div class="admonition important">
<p class="admonition-title">Important</p> <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>
<section id="route-par-defaut-default-route-et-gateway"> <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> <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 <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
next-hop :</p> 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"> <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> <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> </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> 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 <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 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>
<section id="pourquoi-la-route-32-vers-le-serveur-de-metadata-est-indispensable"> <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> <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>

View file

@ -811,6 +811,11 @@ window.runMermaid = runMermaid;</script>
<h2>VPC<a class="headerlink" href="#vpc" title="Lien vers cette rubrique">#</a></h2> <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é <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> 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-&lt;id&gt;-e</span></code> (côté host) ↔ <code class="docutils literal notranslate"><span class="pre">vp-&lt;id&gt;-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> <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"> <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> <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>
<section id="nommage"> <section id="nommage">
<h2>Nommage<a class="headerlink" href="#nommage" title="Lien vers cette rubrique">#</a></h2> <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 <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>
du motif documenté pour les VPC (<code class="docutils literal notranslate"><span class="pre">vp-…</span></code>). Les exemples de cette documentation suivent la indiqué par la spécification pour les VPC. Une contrainte est pourtant réelle : le nom d’un VPC
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> ou d’un subnet doit <strong>contenir un « - »</strong>, car l’identifiant système (<code class="docutils literal notranslate"><span class="pre">vp-&lt;id&gt;-e</span></code>, <code class="docutils literal notranslate"><span class="pre">br-&lt;id&gt;</span></code>,
<code class="docutils literal notranslate"><span class="pre">gw-&lt;id&gt;</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>
</section> </section>

View file

@ -393,11 +393,13 @@ depuis la release, et les vérifie contre le manifeste <code class="docutils lit
<tbody> <tbody>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">-t</span> <span class="pre">&lt;tag&gt;</span></code></p></td> <tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">-t</span> <span class="pre">&lt;tag&gt;</span></code></p></td>
<td><p>déployer une release donnée</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>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">-b</span> <span class="pre">&lt;branche&gt;</span></code></p></td> <tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">-b</span> <span class="pre">&lt;branche&gt;/</span></code></p></td>
<td><p>branche utilisée pour l’auto-mise à jour du script</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
<td><p><code class="docutils literal notranslate"><span class="pre">main</span></code></p></td> 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>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">-p</span> <span class="pre">&lt;profil&gt;</span></code></p></td> <tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">-p</span> <span class="pre">&lt;profil&gt;</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> <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> <td><p><code class="docutils literal notranslate"><span class="pre">br-000000</span></code></p></td>
</tr> </tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">-P</span> <span class="pre">&lt;bridge&gt;</span></code></p></td> <tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">-P</span> <span class="pre">&lt;bridge&gt;</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> <td><p><code class="docutils literal notranslate"><span class="pre">br-public</span></code></p></td>
</tr> </tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">-R</span> <span class="pre">&lt;secondes&gt;</span></code></p></td> <tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">-R</span> <span class="pre">&lt;secondes&gt;</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> 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, <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> 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-&lt;id&gt;</span></code> y raccorde un veth
<code class="docutils literal notranslate"><span class="pre">vp-&lt;id&gt;-e</span></code> côté host, dont l’autre extrémité <code class="docutils literal notranslate"><span class="pre">vp-&lt;id&gt;-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"> <div class="admonition danger">
<p class="admonition-title">Danger</p> <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 <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> <td><p><code class="docutils literal notranslate"><span class="pre">-conf</span></code></p></td>
</tr> </tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">db</span></code></p></td> <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> <td><p><code class="docutils literal notranslate"><span class="pre">-conf</span></code></p></td>
</tr> </tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">dhcp</span></code></p></td> <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> </tbody>
</table> </table>
</div> </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 <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> fichiers en paramètres, posés par son script d’enrobage.</p>
</section> </section>

View file

@ -806,15 +806,18 @@ plan de contrôle du cluster en place, cf. <a class="reference internal" href=".
<pre class="mermaid"> <pre class="mermaid">
graph LR graph LR
subgraph netns vp-admin subgraph netns vp-admin
BR[&quot;br-sn000001&lt;br/&gt;10.1.1.254&quot;] BR[&quot;br-000001&lt;br/&gt;10.1.1.253&quot;]
GW[&quot;gw-000001&lt;br/&gt;gateway 10.1.1.254&quot;]
MD[&quot;metadata&#64;i-web&lt;br/&gt;169.254.169.254&quot;] MD[&quot;metadata&#64;i-web&lt;br/&gt;169.254.169.254&quot;]
end end
VM[&quot;VM i-web&lt;br/&gt;10.1.1.2&quot;] --- BR VM[&quot;VM i-web&lt;br/&gt;10.1.1.2&quot;] --- BR
BR --- MD BR --- GW
BR --- VXLAN[&quot;VXLAN vni 1&lt;br/&gt;br-000000&quot;] GW --- MD
</pre><p>Le VPC est un network namespace ; le subnet y pose un bridge porteur de la gateway ; la VM s’y BR --- VXLAN[&quot;VXLAN vni 65537&lt;br/&gt;br-000000&quot;]
raccroche par un tap, reçoit son adresse en DHCP et son cloud-init depuis le serveur de metadata </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
du netns.</p> 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>
<section id="le-vpc"> <section id="le-vpc">
<h2>1. Le VPC<a class="headerlink" href="#le-vpc" title="Lien vers cette rubrique">#</a></h2> <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 <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> </pre></div>
</div> </div>
<p>Attendez <code class="docutils literal notranslate"><span class="pre">&quot;state&quot;:</span> <span class="pre">&quot;running&quot;</span></code> avant l’étape suivante — un subnet dont le VPC parent n’est pas <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>
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> 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>
<section id="le-subnet"> <section id="le-subnet">
<h2>2. Le subnet<a class="headerlink" href="#le-subnet" title="Lien vers cette rubrique">#</a></h2> <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="w"> </span>-d<span class="w"> </span><span class="s1">'{"name": "sn-000001",</span>
<span class="s1"> "vpc": "vp-admin",</span> <span class="s1"> "vpc": "vp-admin",</span>
<span class="s1"> "mode": "vxlan",</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"> "iface_type": "vms",</span>
<span class="s1"> "cidr": "10.1.0.0/23"}'</span> <span class="s1"> "cidr": "10.1.0.0/23"}'</span>
</pre></div> </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 <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> </pre></div>
</div> </div>
<p>Puis, depuis l’host :</p> <p>Puis, depuis l’host, en passant par le netns du VPC :</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>ssh<span class="w"> </span>syonad@10.1.1.2 <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> </pre></div>
</div> </div>
<div class="admonition note"> <div class="admonition note">
<p class="admonition-title">Note</p> <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 <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> </div>
</section> </section>
<section id="supprimer"> <section id="supprimer">

View file

@ -382,9 +382,9 @@
élément à venir, avec son ticket.</span><a class="headerlink" href="#id5" title="Lien vers cette image">#</a></p> élément à venir, avec son ticket.</span><a class="headerlink" href="#id5" title="Lien vers cette image">#</a></p>
</figcaption> </figcaption>
</figure> </figure>
<p>Plusieurs clusters, chacun avec son underlay, ses deux routeurs et un route reflector, sont reliés <p>Plusieurs clusters, chacun avec son underlay et ses deux routeurs, sont reliés en eBGP entre eux
en eBGP entre eux et aux <strong>routeurs de bordure</strong>. Ce qui n’existe pas encore est décrit sur son et aux <strong>routeurs de bordure</strong> ; les route reflectors sont décrits plus bas. Ce qui n’existe pas
ticket :</p> encore est décrit sur son ticket :</p>
<ul class="simple"> <ul class="simple">
<li><p><strong>Internet</strong> (<a class="reference external" href="https://git.g3e.fr/syonad/two/issues/31">#31</a>, <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 <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>
<li><p><strong>Orchestration</strong> (<a class="reference external" href="https://git.g3e.fr/syonad/two/issues/72">#72</a>). Le broker et <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 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> 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 <li><p><strong>Route reflectors.</strong> Au moins un ; deux sont prévus dans l’architecture et dans les exemples
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 (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
à son cluster.</p></li> 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> </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 <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> 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> <dt>Plan de données</dt><dd><p>les tunnels VXLAN entre hyperviseurs, encapsulés sur le réseau qui les relie.</p>
</dd> </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 <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> </dd>
</dl> </dl>
</section> </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 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> le deuxième nœud.</p>
</div> </div>
<p>C’est exactement le rôle que remplissent FRR sur chaque hyperviseur et le route reflector qui <p>C’est exactement le rôle que remplissent FRR sur chaque hyperviseur et les route reflectors qui
les fait converger.</p> les font converger.</p>
</section> </section>
<section id="mtu"> <section id="mtu">
<h2>MTU<a class="headerlink" href="#mtu" title="Lien vers cette rubrique">#</a></h2> <h2>MTU<a class="headerlink" href="#mtu" title="Lien vers cette rubrique">#</a></h2>

View file

@ -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>, 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 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> 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">&lt;&lt; 'ENDFILE' &gt; /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> <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">&lt;&lt; 'ENDFILE' &gt; /mnt/etc/udev/rules.d/90-two-xvd.rules</span> <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>cat<span class="w"> </span><span class="s">&lt;&lt; 'ENDFILE' &gt; /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> <span class="s">SUBSYSTEM=="block", ENV{DEVTYPE}=="disk", ENV{ID_SERIAL_SHORT}=="xvd[a-z]", SYMLINK+="$env{ID_SERIAL_SHORT}"</span>

View file

@ -361,7 +361,7 @@ même nœud. Cette section couvre la mise en place d’un <strong>cluster</stron
étapes se font.</p> é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 <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 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> fonctionne.</p>
<section id="etapes"> <section id="etapes">
<h2>Étapes<a class="headerlink" href="#etapes" title="Lien vers cette rubrique">#</a></h2> <h2>Étapes<a class="headerlink" href="#etapes" title="Lien vers cette rubrique">#</a></h2>

View file

@ -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 <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">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 <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> </div>
<p>Ce qu’elle établit :</p> <p>Ce qu’elle établit :</p>
<ul class="simple"> <ul class="simple">
<li><p><strong>Une session par route reflector</strong>, en iBGP dans l’AS 64600, vers sa loopback <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 (<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> 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>). <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 <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 <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 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. 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> 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>) : l’adresse IPv4 primaire du <code class="docutils literal notranslate"><span class="pre">local_iface</span></code> <a class="reference external" href="https://git.g3e.fr/syonad/two/issues/51">#51</a>, fermé) : l’adresse IPv4 primaire du
du subnet.</p> <code class="docutils literal notranslate"><span class="pre">local_iface</span></code> du subnet.</p>
<div class="admonition note"> <div class="admonition note">
<p class="admonition-title">Note</p> <p class="admonition-title">Note</p>
<p><strong>À rédiger.</strong> Reste à documenter :</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 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> é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>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 <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 : les recréer ou poser l’adresse à chaud, à trancher dans locale : aucune migration ne la pose, il faut les recréer ;</p></li>
<a class="reference external" href="https://git.g3e.fr/syonad/two/issues/51">#51</a> ;</p></li>
<li><p>le cas particulier du <strong>premier</strong> hyperviseur, dont la session ne peut pas s’établir tant <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> </ul>
</div> </div>
</section> </section>

View file

@ -360,9 +360,11 @@
<h1>VM route reflector<a class="headerlink" href="#vm-route-reflector" title="Lien vers cette rubrique">#</a></h1> <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 <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 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 reflector, qui redistribue. Un cluster en compte <strong>au moins un</strong> ; l’architecture et les exemples
adresses : chaque hyperviseur ouvre une session vers chacun, et la perte de l’un ne doit pas de cette page en prévoient <strong>deux</strong> (rr1 et rr2, d’où les plages d’adresses ci-dessous),
interrompre le plan de contrôle (<a class="reference external" href="https://git.g3e.fr/syonad/two/issues/54">#54</a>).</p> 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 <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> explicitement : la VM qui porte le plan de contrôle du cluster est hébergée par le cluster.</p>
<section id="adressage"> <section id="adressage">
@ -484,13 +486,14 @@ fois par route reflector ; si l’un tombe, les routes reçues de l’autre rest
</ul> </ul>
<div class="admonition warning"> <div class="admonition warning">
<p class="admonition-title">Avertissement</p> <p class="admonition-title">Avertissement</p>
<p><strong>Les tunnels ne survivent pas à la perte du route reflector.</strong> Avec un seul route reflector <p><strong>Les tunnels ne survivent pas à la perte de tous les route reflectors.</strong> Sans
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 <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 tombe aussitôt, FRR retire les routes apprises et, avec elles, le VTEP distant et l’entrée d’inondation du VXLAN — <strong>plus hyperviseurs tombent, FRR retire les routes apprises et, avec elles, le VTEP distant et
aucun paquet ne passe</strong> entre hyperviseurs, à 30 s comme à 90 s. Au redémarrage de FRR sur le l’entrée d’inondation du VXLAN : <strong>plus aucun paquet ne passe</strong> entre hyperviseurs, jusqu’au
route reflector, VTEP distant et trafic reviennent <strong>31 s</strong> plus tard. Le trafic entre VM d’un retour d’un route reflector et à la reconvergence des sessions. Le trafic entre VM d’un même
même hyperviseur n’est pas concerné. La redondance (deux route reflectors) ou hyperviseur n’est pas concerné. Avec deux route reflectors, la perte de l’un est sans effet sur
<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> 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>
<div class="admonition note"> <div class="admonition note">
<p class="admonition-title">Note</p> <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> 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 <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> 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 <li><p>la procédure de reconstruction — l’état du cluster pendant l’absence de tous les route
décrit ci-dessus : plus de trafic entre hyperviseurs ;</p></li> 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 <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 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> n’existe pas, cf. <a class="reference internal" href="premier-hyperviseur.html"><span class="doc">Premier hyperviseur</span></a>.</p></li>

View file

@ -375,9 +375,10 @@ données VXLAN.</p>
</dl> </dl>
<section id="routeur-de-cluster"> <section id="routeur-de-cluster">
<h2>Routeur de cluster<a class="headerlink" href="#routeur-de-cluster" title="Lien vers cette rubrique">#</a></h2> <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 <p>Le routeur de cluster est la passerelle des hyperviseurs et le voisin eBGP des route reflectors
reflectors, dont il apprend les loopbacks : c’est par lui que chaque hyperviseur joint — au moins un ; deux sont prévus dans l’architecture et dans les exemples —, dont il apprend les
<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> 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"> <section id="adressage">
<h3>Adressage<a class="headerlink" href="#adressage" title="Lien vers cette rubrique">#</a></h3> <h3>Adressage<a class="headerlink" href="#adressage" title="Lien vers cette rubrique">#</a></h3>
<div class="pst-scrollable-table-container"><table class="table"> <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> </thead>
<tbody> <tbody>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">192.168.14.1/24</span></code></p></td> <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>interface du segment des hyperviseurs, <strong>adresse virtuelle VRRP</strong></p></td>
<td><p>passerelle par défaut des hyperviseurs et du route reflector</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>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">169.254.0.1/28</span></code></p></td> <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> <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> <li><p><strong>Aucune session avec les hyperviseurs</strong> : le routeur leur sert de passerelle, pas de voisin BGP.</p></li>
</ul> </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 <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 <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
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 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
<a class="reference external" href="https://git.g3e.fr/syonad/two/issues/54">#54</a>.</p> préemption (<a class="reference external" href="https://git.g3e.fr/syonad/two/issues/54">#54</a>, fermé).</p>
<div class="admonition note"> <div class="admonition note">
<p class="admonition-title">Note</p> <p class="admonition-title">Note</p>
<p>Ce qui précède est le contrat du routeur de cluster : adresses, ASN, session, filtres. Sa <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 class="admonition-title">Note</p>
<p><strong>À rédiger.</strong> Reste à documenter, faute d’éléments de terrain :</p> <p><strong>À rédiger.</strong> Reste à documenter, faute d’éléments de terrain :</p>
<ul class="simple"> <ul class="simple">
<li><p>pour le routeur de cluster : le matériel employé et sa version de référence ; la redondance <li><p>pour le routeur de cluster : le matériel employé et sa version de référence ; la traduction
— deux routeurs, mécanisme de bascule, comportement attendu pendant une bascule de la redondance VRRP v3 dans sa configuration ;</p></li>
(<a class="reference external" href="https://git.g3e.fr/syonad/two/issues/54">#54</a>) ;</p></li>
<li><p>pour les routeurs de datacentre et de bordure : tout — équipement, configuration de <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> 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 <li><p>l’ordre de mise en service, et ce qui doit être opérationnel avant de préparer le premier

View file

@ -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é, <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 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 — <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> l’heure.</p>
<p>Le pourquoi des choix (serveur physique plutôt que VM cloud, câbles QEMU, MTU 9000, versions) est <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 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. <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 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 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> </div>
<section id="l-outil"> <section id="l-outil">
<h2>L’outil<a class="headerlink" href="#l-outil" title="Lien vers cette rubrique">#</a></h2> <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> <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> </pre></div>
</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 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 <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>, <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 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 <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 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 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
<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> 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"> <section id="roles">
<h3>Rôles<a class="headerlink" href="#roles" title="Lien vers cette rubrique">#</a></h3> <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> : <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 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> : 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 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
reflector :</p> 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 <div class="highlight-text notranslate"><div class="highlight"><pre><span></span>frr defaults traditional
hostname rr1 hostname rr1
log syslog informational 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> <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 <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 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 --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 --continue all # sans s'arrêter sur une couche en échec
test/e2e/run.sh --connus all # les échecs connus comptent comme des échecs 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> <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>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>hv1</p></td>
<td><p>#70</p></td> <td><p>#70, #73</p></td>
</tr> </tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">11-validation</span></code></p></td> <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>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>hv1</p></td>
<td><p>#41, #57, #33, #62</p></td> <td><p>#41, #57, #33, #62, #74</p></td>
</tr> </tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">12-etats</span></code></p></td> <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> <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> <td><p>#33, #62, #73</p></td>
</tr> </tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">26-multi-disque</span></code></p></td> <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>hv1</p></td>
<td><p>#32, #74</p></td> <td><p>#32, #74</p></td>
</tr> </tr>
@ -797,7 +799,7 @@ fait en fermant le ticket. Chaque ticket concerné liste ses marqueurs en commen
<td><p>#46</p></td> <td><p>#46</p></td>
</tr> </tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">28-mtu</span></code></p></td> <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>hv1 hv2</p></td>
<td><p>#56</p></td> <td><p>#56</p></td>
</tr> </tr>
@ -877,9 +879,9 @@ fait en fermant le ticket. Chaque ticket concerné liste ses marqueurs en commen
<td><p>#54</p></td> <td><p>#54</p></td>
</tr> </tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">72-perte-switch</span></code></p></td> <tr class="row-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></td>
<td><p>#54, #69</p></td> <td><p>#54, #69, #80</p></td>
</tr> </tr>
</tbody> </tbody>
</table> </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 (#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> 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 <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> <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> attend jusqu’à 360 s.</p></li>
</ul> </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">&lt;nœud&gt;</span> <span class="pre">[VAR=valeur…]</span> <span class="pre">&lt;&lt;'NODE'</span></code>. 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">&lt;nœud&gt;</span> <span class="pre">[VAR=valeur…]</span> <span class="pre">&lt;&lt;'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> 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"> <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, <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">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 <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> 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">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">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&lt;NN&gt;</span></code> de l’API, les netns <code class="docutils literal notranslate"><span class="pre">t&lt;NN&gt;-*</span></code> et les fichiers <code class="docutils literal notranslate"><span class="pre">t&lt;NN&gt;-*</span></code> / <code class="docutils literal notranslate"><span class="pre">t&lt;NN&gt;.*</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&lt;NN&gt;.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> </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"># hôtes: hv1</span>
<span class="c1"># tickets: #NN</span> <span class="c1"># tickets: #NN</span>
@ -943,7 +953,11 @@ on<span class="w"> </span>hv1<span class="w"> </span><span class="s">&lt;&lt;'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 "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 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 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> <span class="s">NODE</span>
</pre></div> </pre></div>
</div> </div>

View file

@ -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> 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 <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> 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> <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
é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 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
accepté.</p></li> 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> </ul>
</section> </section>
<section id="codes-de-retour"> <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> <td><p>lecture réussie (<code class="docutils literal notranslate"><span class="pre">GET</span></code>)</p></td>
</tr> </tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">400</span></code></p></td> <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>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">404</span></code></p></td> <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> <td><p>ressource inexistante</p></td>
</tr> </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">{&quot;error&quot;:</span> <span class="pre">&quot;method</span> <span class="pre">not</span> <span class="pre">allowed&quot;}</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 <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 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
supprimées qui l’utilisent encore</p></td> 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>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">422</span></code></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 pas prête : VPC parent d’un subnet, subnet d’une VM</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>
<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> <td><p>erreur interne</p></td>
</tr> </tr>
</tbody> </tbody>

View file

@ -425,7 +425,7 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
</pre></div> </pre></div>
</div> </div>
</p></li> </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> <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> <div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">400</span> <span class="ne">Bad Request</span>
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span> <span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>

View file

@ -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="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_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">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">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">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> <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> <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> </pre></div>
</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>
<section id="journalisation"> <section id="journalisation">
<h2>Journalisation<a class="headerlink" href="#journalisation" title="Lien vers cette rubrique">#</a></h2> <h2>Journalisation<a class="headerlink" href="#journalisation" title="Lien vers cette rubrique">#</a></h2>

View file

@ -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="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="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/&lt;netns&gt;_&lt;bridge&gt;.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/&lt;netns&gt;_&lt;bridge&gt;.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> </pre></div>
</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 <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/ ls<span class="w"> </span>/var/lib/cloud/instances/
</pre></div> </pre></div>
</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 <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> </pre></div>
</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 <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/&lt;vm&gt;
</section> </section>
<section id="le-user-data-est-servi-vide"> <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> <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 <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
absent, qui retombe sur le template. Vérifier le contenu réellement écrit :</p> 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/&lt;vm&gt;/user-data <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>cat<span class="w"> </span>/run/two/metadata/&lt;vm&gt;/user-data
</pre></div> </pre></div>
</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> <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> <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 <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> </pre></div>
</div> </div>
<p>Sur Debian et Ubuntu, le paquet est <code class="docutils literal notranslate"><span class="pre">ovmf</span></code>.</p> <p>Sur Debian et Ubuntu, le paquet est <code class="docutils literal notranslate"><span class="pre">ovmf</span></code>.</p>

View file

@ -392,7 +392,8 @@ ou <code class="docutils literal notranslate"><span class="pre">deleting</span><
<section id="watchdog"> <section id="watchdog">
<h2>Watchdog<a class="headerlink" href="#watchdog" title="Lien vers cette rubrique">#</a></h2> <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 <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> <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">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> <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> <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 <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> 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> 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-sn000001'</span><span class="w"> </span><span class="c1"># backend two</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> </pre></div>
</div> </div>
</section> </section>
<section id="inspection-de-la-base"> <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> <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> <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
<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 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> </pre></div>
</div> </div>
<div class="admonition warning"> <div class="admonition warning">

View file

@ -361,7 +361,8 @@
<section id="services-systemd"> <section id="services-systemd">
<h1>Services systemd<a class="headerlink" href="#services-systemd" title="Lien vers cette rubrique">#</a></h1> <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> 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"> <div class="pst-scrollable-table-container"><table class="table">
<colgroup> <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 <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> 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 <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">'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-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">'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> systemctl<span class="w"> </span>status<span class="w"> </span><span class="s1">'metadata@i-web'</span>
</pre></div> </pre></div>
</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 <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> 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> <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>-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-sn000001.state<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-sn000001.sock <span class="w"> </span>-socket<span class="w"> </span>/run/two/dhcp/vp-admin_br-000001.sock
</pre></div> </pre></div>
</div> </div>
<div class="pst-scrollable-table-container"><table class="table"> <div class="pst-scrollable-table-container"><table class="table">

File diff suppressed because one or more lines are too long

View file

@ -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> <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 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> 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">&quot;served&quot;:</span> <span class="pre">false</span></code> pour une MAC non réservée, au lieu d’omettre le <li><p><code class="docutils literal notranslate"><span class="pre">probe</span></code> annonce explicitement <code class="docutils literal notranslate"><span class="pre">&quot;served&quot;:</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> 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 <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