two-images/README.md
GnomeZworc fe401b9a12
Some checks failed
Tests / check (push) Failing after 39s
two-images: construction reproductible de rocky10 et debian13 par Packer, test de démarrage syonad/two#53
Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
2026-10-24 13:53:56 +02:00

45 lines
2.3 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é…) |
| `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, 2 interfaces, 1 disque xvdb) et la vérifie
```
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`.