Beryl::Apply::PoudriereBuild

Primitive poudriere-build : maintient un dépôt pkg poudriere à la dernière MINEURE d'un majeur FreeBSD figé, construit depuis un ou plusieurs OVERLAYS de ports, et publie l'alias par ABI (FreeBSD:<major>:<arch> → set courant) pour un client agnostique à la version (url: https://…/${ABI}).

Idempotent & réconciliateur. À chaque apply :

. compare la dernière release de la branche (FreebsdRelease.latest_by_branch) à ce que vise l'alias ; . pour chaque overlay : clone s'il est absent, sinon mise à jour git en AVANCE RAPIDE uniquement (fetch + merge --ff-only, cf. plus bas), enregistrement dans poudriere s'il ne l'est pas (poudriere ports -c -p <name> -m null -M <path>) ; . compare le commit de chaque overlay à celui du dernier build RÉUSSI (fichier d'état <pkgdir>/.beryl-build-<major>.overlays, une ligne <name> <commit>, écrit par le script de build seulement en fin de succès, juste après le repointage de l'alias).

Nouvelle mineure OU commit d'overlay différent (ou état inconnu) → build en DÉTACHÉ (daemon -f + log + lock anti-double-build), qui crée la jail au besoin, met à jour l'arbre default, poudriere bulk avec TOUS les overlays (-O a -O b, accumulés par poudriere) et la réunion des build-lists (-f x -f y, idem), retire les paquets périmés (poudriere pkgclean : ni listés ni dépendances, ex. un port renommé ; catalogue reconstruit), puis repointe l'alias et enregistre les commits construits. Rien de changé → skip.

Git : avance rapide seulement, jamais reset --hard sur un overlay. Des modifications suivies non commitées, une branche autre que celle attendue ou un historique divergé → Failed avec message (rien n'est écrasé). Des commits locaux non poussés (en avance) sont conservés et construits (signalés). Les fichiers non suivis (ex. un script local) n'empêchent rien. En dry-run, le commit distant est lu par git ls-remote (rien n'est modifié).

major FIGÉ (ex. "15") : suit 15.0 → 15.1 → 15.2 (même ABI, sûr) mais JAMAIS un saut de majeur (16.0 = nouvelle ABI). Pour ouvrir 16 : une 2ᵉ instance major: 16 → l'alias FreeBSD:16:amd64 cohabite ; un client bascule quand SA base passe en 16.

- poudriere-build:
    major: "15"
    overlays:
      - name: maison                  # nom de l'arbre poudriere (-O)
        pkglist: /usr/local/etc/poudriere.d/maison-pkglist
      - name: partenaire
        git: https://github.com/example/ports-overlay  # optionnel : clone + MAJ
        branch: production            # optionnel (défaut : branche courante / distante par défaut)
        path: /usr/local/poudriere/partenaire-ports # optionnel (défaut : /usr/local/poudriere/<name>-ports)
        pkglist: /usr/local/etc/poudriere.d/partenaire-pkglist   # optionnel
    reapply: /usr/local/etc/poudriere.d/reapply-base-patches.sh  # optionnel
    schedule: "0 3 * * 0"         # optionnel : build planifié (cron)
    ports_branch: quarterly       # optionnel : branche de l'arbre de ports

ports_branch : branche git de l'arbre de ports de base (ports), mise en place avant chaque build. quarterly = branche du trimestre EN COURS (2026Q4…), calculée par le script lui-même à chaque build — le build planifié avance donc tout seul d'un trimestre à l'autre, comme le dépôt officiel quarterly des serveurs (repli sur le trimestre précédent tant que la nouvelle branche n'est pas publiée). Autre valeur = nom de branche fixe (main…). Absent = branche laissée telle quelle. Changer de branche reconstruit presque tout (versions différentes).

schedule (5 champs cron) : pose sur le builder un script /usr/local/etc/poudriere.d/beryl-build-<majeur>.sh et une entrée /usr/local/etc/cron.d/beryl-poudriere-<majeur> qui relancent LE MÊME build que beryl sync (verrou partagé, overlays gérés mis à jour en avance rapide, arbre de ports frais → correctifs de sécurité), sur la mineure visée au dernier apply. Régénérés à chaque apply. Échec signalé par mail (sortie de cron), détail dans le journal des builds.

Champs d'un overlay : name obligatoire ; sans git, l'overlay n'est pas mis à jour par beryl (son commit est tout de même suivi si path est un dépôt git) ; path par défaut = chemin enregistré dans poudriere, sinon /usr/local/poudriere/<name>-ports. Au moins une pkglist est requise (par overlay et/ou au niveau du step).

Ancien schéma, toujours accepté tel quel (un seul overlay) :

- poudriere-build:
    major: "15"
    pkglist: /usr/local/etc/poudriere.d/maison-pkglist
    overlay: maison               # obligatoire (nom de l'arbre overlay)