f-73: doc: network-config par MAC, exigence d'image DHCP sur toutes les interfaces #73

Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
This commit is contained in:
GnomeZworc 2026-10-22 22:51:51 +02:00
commit e2e8b0b8b8
Signed by: nicolas.boufideline
GPG key ID: 4406BBBF8845D632
3 changed files with 63 additions and 5 deletions

View file

@ -56,12 +56,45 @@ un provisionnement : changer de nom, repartir d'un disque neuf, ou exécuter
Configuration réseau
--------------------
Le ``network-config`` servi à une VM contient une entrée par interface, dans l'ordre de l'API,
visée par sa MAC et configurée en DHCP IPv4 :
.. code-block:: yaml
version: 2
ethernets:
eth0:
match:
macaddress: "52:54:00:19:01:0a"
dhcp4: true
eth1:
match:
macaddress: "52:54:00:19:02:14"
dhcp4: true
La correspondance se fait par la MAC, pas par le nom : l'entrée ``eth<index>`` s'applique à
``ens3`` comme à ``eth0``. La clé n'est qu'un identifiant pour netplan et NetworkManager ;
deux renderers de cloud-init s'en servent pourtant comme nom : ``sysconfig`` renomme
l'interface vers la clé, et ``networkd`` l'ajoute au ``[Match]``, qui ne correspond alors
qu'aux images démarrées avec ``net.ifnames=0``.
Le ``network-config`` ne pose **aucune métrique**. Toutes les interfaces reçoivent du serveur
DHCP les routes du VPC et des métadonnées (option 121) ; seule la primaire reçoit la route par
défaut. Départager les routes en double relève de l'utilisateur de la VM, par son ``user_data``.
.. warning::
``network-config.tmpl`` cible ``eth0`` alors que les guests utilisent ``ens3`` : il ne
s'applique donc à rien, et le réseau des VM vient du DHCP. **Ne pas le « corriger » ni le
supprimer.** Le rendre opérant ferait remplacer par cloud-init la configuration réseau de
l'image, sur toutes les VM.
Le ``network-config`` ne suffit pas à configurer les interfaces secondaires. La source
NoCloud en ``seedfrom`` HTTP n'est trouvée qu'à l'étape réseau de cloud-init :
* cloud-init 22.4 (Debian 12) ne demande jamais ``network-config`` par ``seedfrom`` et
applique sa configuration de repli, limitée à la première interface ;
* 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 ``network-config`` n'est pas
relu : les interfaces secondaires perdent leur configuration.
L'image doit donc faire du DHCP IPv4 sur **toutes** ses interfaces Ethernet, sans compter
sur cloud-init. Voir :doc:`/deploiement/image-qcow2`.
Sécurité
--------

View file

@ -259,6 +259,31 @@ C'est ce second fichier qui raccorde l'image au serveur de metadata de l'agent :
la seule source retenue, et elle pointe sur ``169.254.169.254``. La route ``/32`` vers cette
adresse est indispensable côté agent — voir :doc:`/concepts/modes-reseau`.
**DHCP sur toutes les interfaces**
L'image doit demander un bail DHCP IPv4 sur chaque interface Ethernet, et pas seulement sur la
première : cloud-init ne configure les interfaces secondaires qu'au premier démarrage, au mieux
(cf. :doc:`/concepts/metadata-cloud-init`). Pour une image sous systemd-networkd :
.. code-block:: bash
cat << 'ENDFILE' > /mnt/etc/systemd/network/90-all-en.network
[Match]
Name=en*
[Network]
DHCP=ipv4
ENDFILE
Le préfixe ``90`` laisse la priorité aux fichiers écrits par cloud-init pour la première
interface (``10-netplan-*``). Sur une image démarrée avec ``net.ifnames=0``, viser ``eth*``.
.. note::
**À établir pour NetworkManager** — l'équivalent pour une image sous NetworkManager, dont
l'image Rocky de cette page, n'est pas encore vérifié. Sans lui, une VM à plusieurs
interfaces n'a de bail que sur la première.
**Services et durcissement**
.. code-block:: bash

View file

@ -318,7 +318,7 @@ Générée par ``test/e2e/run.sh --matrice`` à partir des en-têtes ; à régé
* - ``25-multi-nic``
- VM à plusieurs interfaces — une NIC par subnet, adresses posées, route par défaut sur la primaire seule
- hv1
- #33, #62
- #33, #62, #73
* - ``26-multi-disque``
- VM à plusieurs disques — virtio (vdX) et SCSI (sdX), tailles et bus vus par la VM, démarrage sur vda
- hv1