two-images/README.md
GnomeZworc 344363d49c
All checks were successful
Tests / check (push) Successful in 38s
two-images: rocky10, profils NM de cloud-init nommés par interface #1
cloud-init 24.4 nomme le profil NetworkManager d'après la clé du
network-config (eth0) et le cherche d'après l'interface (ens3) : la
2e interface n'est jamais activée, et au redémarrage le profil de
repli porte le même UUID, nmcli up échoue (degraded done).

Correctif dans l'image : fichier nommé par interface, contrôlé par
check.sh. test.sh sert un network-config au format de two (2 NIC
décrites, 1 sans entrée) et vérifie cloud-init après redémarrage.

Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
2026-11-06 00:32:01 +01:00

47 lines
2.6 KiB
Markdown

# two-images
Construit les images qcow2 des VM utilisées par le lab de [two](https://git.g3e.fr/syonad/two), de
façon **reproductible** : chaque entrée est épinglée avec sa somme (Packer, plugin qemu, image du
fournisseur), et une image se reconstruit à la demande plutôt que de se télécharger.
| Image | Source | Personnalisation |
|-------|--------|------------------|
| `rocky10` | Rocky Linux 10.2 GenericCloud Base `20260525.0` (SHA-256 signée par Rocky) | exigences two + `docs/deploiement/image-qcow2.rst` (sshd, utilisateur `syonad`, SELinux désactivé…), chrony sur les seuls serveurs NTP du DHCP, correctif cloud-init (profils NetworkManager nommés par interface) |
| `debian13` | Debian 13 genericcloud `20261021-2638` (SHA-512) | exigences two |
Exigences two, communes : source de métadonnées NoCloud vers `169.254.169.254`, `network-config`
réappliqué à chaque démarrage (`boot-legacy`), DHCP IPv4 sur toutes les interfaces (systemd-networkd
ou NetworkManager), liens `/dev/xvdX` des disques additionnels.
## Méthode
Celle de `docs/deploiement/image-qcow2.rst` dans two : une VM de construction **x86_64** démarre sur
un overlay de l'image du fournisseur, avec deux disques de plus — la **cible** et un disque de
**travail**. Dans la VM, l'image du fournisseur est téléchargée sur le disque de travail, vérifiée,
puis écrite en brut sur la cible ; la cible est montée sur `/mnt` et personnalisée (chroot), nettoyée
(identité cloud-init, machine-id, clés d'hôte SSH, journaux) et contrôlée. L'image produite est la
cible, compressée ; l'image du fournisseur n'est jamais démarrée.
Avant d'écrire, la cible est reconnue par sa taille et doit être vierge (ni table de partitions, ni
système de fichiers, premier Mio nul).
## Utilisation
```
./build.sh check formatage, validation des templates, shellcheck
./build.sh <image> construit dist/<image>.qcow2 et met à jour dist/SHA512SUMS
./test.sh <image> démarre l'image (seed NoCloud avec network-config au format de two,
3 interfaces dont 2 décrites, 1 disque xvdb) et la vérifie,
avant et après redémarrage
```
Prérequis : `qemu-system-x86_64`, `qemu-img`, `curl`, `unzip`, `ssh-keygen`, `shellcheck` (pour
`check`), `hdiutil` (macOS) ou `genisoimage`/`xorriso` (Linux). Packer et le plugin qemu sont
téléchargés et vérifiés dans `~/.cache/two-images` (`TWO_IMAGES_CACHE`).
Sous Linux la VM tourne avec KVM ; sur un Mac arm64 en émulation TCG, plus lente : le Mac ne sert
qu'aux essais.
## Licence
PolyForm Noncommercial 1.0.0 — voir `LICENSE`.