Set-OPS-Public/roles/serveur_artefacts
Daniel Allaire 5812e0c6ca depot de binaires : le site tient ce que les runners allaient chercher
Le cache du site couvrait apt ; quatre artefacts arrivaient autrement, parce qu ils
ne vivent dans aucun depot apt. Le controleur les tire puis les pousse par SSH.

Mesure du 2026-09-12 : le cache du runner du site est ABSENT. Un second locataire
monte depuis lui sortait chercher 570 Mo sur codeberg.org, github.com et
download.nextcloud.com, alors que le meme ecosysteme ne demandait plus un seul
paquet a Debian. Le poste du mainteneur les a depuis toujours : personne ne l avait vu.

Pas de relais transparent, et la mesure tranche : github.com redirige vers une URL
signee valable une heure, differente a chaque requete. Un cache qui la prend pour
cle ne fait jamais mouche. Le relais marcherait pour deux amonts sur quatre.

Donc un vrai depot, dans le service qui existe deja. LocalDirs d apt-cacher-ng publie
un repertoire du disque sous un prefixe, eprouve AVANT d ecrire le role. Aucun service,
aucun port, aucun certificat, aucun flux nouveaux : l ingress 3142 pair flotte couvre
exactement ce chemin.

Les versions ne sont pas recopiees : le role lit les defauts des quatre consommateurs.
Les quatre roles recoivent une tache AJOUTEE, placee avant leur stat de cache — si le
depot sert, le stat le voit et la tache amont se saute d elle-meme. Aucune tache
existante n a change.

P70 exige que tout dest ecrit sous un cache_local figure au depot. Une liste qui suit
une autre prend du retard ; celle-ci est nee avec sa garde.

Deux marches payees en chemin :
- failed_when: false REECRIT le verdict, donc la premiere garde de signature ne
  gardait rien. Elles mesurent le fichier desormais.
- file: state=directory cree les parents en 0750 : apt-cacher-ng, qui ne tourne pas
  en root, rendait 403 sur chaque fichier. Un chemin se traverse en entier.

Verifie sur l infrastructure : 6/6 artefacts servis (200/206) depuis le runner du site
ET depuis une machine du locataire a travers la frontiere ; les 6 empreintes SHA-256
sont identiques a celles qui ont construit Chezlepro ; second passage changed=0.

make prouver : 69 OK, 0 echec, 1 saute. ansible-lint : 0 failure, profil production.

Inclut aussi force: true sur cinq telechargements de cles : une reprise conditionnelle
ne reprend rien (304 Not Modified, size 0, attempts 5).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Crgis8CxCWkAGFA1ecBz3q
2026-09-12 23:45:00 -04:00
..
defaults depot de binaires : le site tient ce que les runners allaient chercher 2026-09-12 23:45:00 -04:00
handlers artefacts : la forge sert le code, il manquait qui sert les binaires 2026-08-23 14:41:56 -04:00
meta cache-apt scindee — et la scission a revele que moteur aurait alarme a tort 2026-09-10 03:27:52 -04:00
tasks depot de binaires : le site tient ce que les runners allaient chercher 2026-09-12 23:45:00 -04:00
templates depot de binaires : le site tient ce que les runners allaient chercher 2026-09-12 23:45:00 -04:00
README.md artefacts : la forge sert le code, il manquait qui sert les binaires 2026-08-23 14:41:56 -04:00

serveur_artefacts

La source d'artefacts de l'écosystème : un cache apt (apt-cacher-ng) qui sert à toute la flotte les paquets qu'elle installe, au lieu de les faire chercher chez Debian.

Principe

La forge héberge le code. Il manquait qui héberge les binaires. Pour poser une seule machine, un écosystème allait chercher chez six serveurs étrangers : deb.debian.org, security.debian.org, packages.smallstep.com, apt.grafana.com, packages.icinga.com, codeberg.org.

Ce n'est pas théorique. packages.smallstep.com est intermittent — la même URL pend au premier essai et répond en 0,48 s au second — et a fait échouer un déploiement de quarante minutes sur la première machine.

Ce que ce rôle couvre, et ce qui est couvert ailleurs

dépôts apt ce rôle — un cache, servi à la flotte
téléchargements directs (Forgejo, Keycloak, Nextcloud, oauth2-proxy, collections) le cache du contrôleur : il télécharge une fois et pousse par SSH

Deux mécanismes parce que ce sont deux problèmes : on ne sert pas un dépôt apt par scp.

Ce qu'il ne couvre pas encore

Les dépôts tiers en HTTPS (Smallstep, Grafana, Icinga) continuent d'aller en direct. Les faire passer par le cache exigerait soit de casser le TLS de bout en bout, soit de réécrire leurs sources en http://cache/<remap>/…. La seconde voie est propre et reste à faire. Le dire vaut mieux que le laisser croire.

Le mode hors ligne, qui est aussi l'épreuve

serveur_artefacts_hors_ligne: true

Le cache cesse d'aller en amont : il sert ce qu'il détient et refuse le reste. C'est l'état d'un écosystème coupé du monde — et le seul moyen de prouver que le cache sert vraiment. Tant qu'internet répond, un apt update qui réussit ne dit pas d'où vient l'octet.

Pourquoi le trafic est en clair, et pourquoi c'est correct

L'intégrité d'un dépôt apt ne vient pas du transport mais des signatures, qu'apt vérifie de toute façon. Un intermédiaire ne peut pas altérer un paquet sans se faire prendre. Restreindre qui interroge le cache est le travail du pare-feu est-ouest, dérivé de meta/flux.yml — pas d'une authentification.

Variables principales

Variable Défaut Rôle
serveur_artefacts_port 3142 port d'écoute
serveur_artefacts_cache /var/cache/apt-cacher-ng où les paquets sont retenus
serveur_artefacts_expiration_jours 30 rétention sans redemande
serveur_artefacts_hors_ligne false couper l'amont (et éprouver)

Ce que ce rôle ne fait pas

Il ne sauvegarde rien : un cache se reconstitue en le re-remplissant. Le sauvegarder reviendrait à sauvegarder les binaires de Debian.